From 4fdcdfda3c40675be358cd033c151f85400e174b Mon Sep 17 00:00:00 2001 From: Stefan Kangas Date: Fri, 24 Jan 2025 17:32:17 +0100 Subject: [PATCH] Avoid double spaces around abbrevations in Texinfo * doc/emacs/custom.texi (Init Rebinding): * doc/emacs/dired.texi (Operating on Files): * doc/emacs/emacs.texi (Top): * doc/emacs/emerge-xtra.texi (Emerge): * doc/emacs/files.texi (Files): * doc/emacs/frames.texi (Drag and Drop): * doc/emacs/misc.texi (Hyperlinking): * doc/emacs/modes.texi (Modes): * doc/emacs/mule.texi (Input Methods): * doc/emacs/windows.texi (Window Tool Bar): * doc/lispintro/emacs-lisp-intro.texi (Lexical & Dynamic Binding Differences): * doc/lispref/elisp.texi (Top): * doc/lispref/functions.texi (Functions, Generic Functions): * doc/lispref/hash.texi (Defining Hash): * doc/lispref/keymaps.texi (Creating Keymaps): * doc/lispref/lists.texi (Property Lists): * doc/lispref/modes.texi (%-Constructs): * doc/lispref/nonascii.texi (Character Properties): * doc/lispref/processes.texi (Misc Network): * doc/lispref/searching.texi (Regexp Functions): * doc/lispref/syntax.texi (Syntax Table Internals): * doc/lispref/text.texi (Filling, Checksum/Hash) (JSONRPC deferred requests): * doc/misc/calc.texi (What is Calc, Modes Tutorial): * doc/misc/cc-mode.texi (List Line-Up, Operator Line-Up) (Custom Macros, Indenting Directives): * doc/misc/efaq.texi (Colors on a TTY, Security risks with Emacs): * doc/misc/eglot.texi (Eglot Variables): * doc/misc/erc.texi (Connecting): * doc/misc/eshell.texi (Aliases, Completion): * doc/misc/flymake.texi (Backend functions): * doc/misc/gnus-faq.texi (FAQ 5 - Composing messages): * doc/misc/gnus.texi (Gnus Unplugged, Window Layout) (Filtering Incoming Mail, History): * doc/misc/idlwave.texi (Online Help, Catalogs): * doc/misc/wisent.texi (Wisent Overview): Be more consistent with abbreviations. Use @: or comma or rewrite to avoid double spaces. --- doc/emacs/custom.texi | 2 +- doc/emacs/dired.texi | 2 +- doc/emacs/emacs.texi | 8 ++++---- doc/emacs/emerge-xtra.texi | 2 +- doc/emacs/files.texi | 2 +- doc/emacs/frames.texi | 2 +- doc/emacs/misc.texi | 2 +- doc/emacs/modes.texi | 2 +- doc/emacs/mule.texi | 5 +++-- doc/emacs/windows.texi | 2 +- doc/lispintro/emacs-lisp-intro.texi | 2 +- doc/lispref/elisp.texi | 2 +- doc/lispref/functions.texi | 4 ++-- doc/lispref/hash.texi | 2 +- doc/lispref/keymaps.texi | 4 ++-- doc/lispref/lists.texi | 4 ++-- doc/lispref/modes.texi | 2 +- doc/lispref/nonascii.texi | 4 ++-- doc/lispref/processes.texi | 2 +- doc/lispref/searching.texi | 2 +- doc/lispref/syntax.texi | 2 +- doc/lispref/text.texi | 6 +++--- doc/misc/calc.texi | 6 +++--- doc/misc/cc-mode.texi | 16 ++++++++-------- doc/misc/efaq.texi | 8 ++++---- doc/misc/eglot.texi | 2 +- doc/misc/erc.texi | 2 +- doc/misc/eshell.texi | 4 ++-- doc/misc/flymake.texi | 2 +- doc/misc/gnus-faq.texi | 2 +- doc/misc/gnus.texi | 8 ++++---- doc/misc/idlwave.texi | 4 ++-- doc/misc/wisent.texi | 2 +- 33 files changed, 61 insertions(+), 60 deletions(-) diff --git a/doc/emacs/custom.texi b/doc/emacs/custom.texi index 426c3d6748a..22c8bf417e3 100644 --- a/doc/emacs/custom.texi +++ b/doc/emacs/custom.texi @@ -2044,7 +2044,7 @@ Init Rebinding @end example Non-@acronym{ASCII} characters can be specified directly in the -string. To bind to e.g. @samp{ol@'a}, use: +string. To bind to, for example, @samp{ol@'a}, use: @example (keymap-global-set "C-c h" (key-description "ol@'a")) diff --git a/doc/emacs/dired.texi b/doc/emacs/dired.texi index 2160039eaf1..8882049dae1 100644 --- a/doc/emacs/dired.texi +++ b/doc/emacs/dired.texi @@ -749,7 +749,7 @@ Operating on Files a Dired buffer, or to use any other function. When the value is a function, it will be called with no arguments and is expected to return a list of directories which will be used as defaults -(i.e. default target and ``future history''). +(i.e., default target and ``future history''). Here are the file-manipulating Dired commands that operate on files. diff --git a/doc/emacs/emacs.texi b/doc/emacs/emacs.texi index 4455046c8a1..a81c7134a70 100644 --- a/doc/emacs/emacs.texi +++ b/doc/emacs/emacs.texi @@ -462,7 +462,7 @@ Top * Copying and Naming:: Copying, naming and renaming files. * Misc File Ops:: Other things you can do on files. * Compressed Files:: Accessing compressed files. -* File Archives:: Operating on tar, zip, jar etc. archive files. +* File Archives:: Operating on tar, zip, jar etc.@: archive files. * Remote Files:: Accessing files on other machines. * Quoted File Names:: Quoting special characters in file names. * File Name Cache:: Completion against a list of files you often use. @@ -588,7 +588,7 @@ Top Major and Minor Modes -* Major Modes:: Text mode vs. Lisp mode vs. C mode... +* Major Modes:: Text mode vs.@: Lisp mode vs.@: C mode... * Minor Modes:: Each minor mode is a feature you can turn on independently of any others. * Choosing Modes:: How modes are chosen when visiting files. @@ -909,7 +909,7 @@ Top Merging Files with Emerge * Overview of Emerge:: How to start Emerge. Basic concepts. -* Submodes of Emerge:: Fast mode vs. Edit mode. +* Submodes of Emerge:: Fast mode vs.@: Edit mode. Skip Prefers mode and Auto Advance mode. * State of Difference:: You do the merge by specifying state A or B for each difference. @@ -1121,7 +1121,7 @@ Top * Embedded WebKit Widgets:: Embedding browser widgets in Emacs buffers. * Browse-URL:: Following URLs. * Goto Address mode:: Activating URLs. -* FFAP:: Finding files etc. at point. +* FFAP:: Finding files etc.@: at point. Emacs Lisp Packages diff --git a/doc/emacs/emerge-xtra.texi b/doc/emacs/emerge-xtra.texi index cea0424814e..d80c3f3b3a3 100644 --- a/doc/emacs/emerge-xtra.texi +++ b/doc/emacs/emerge-xtra.texi @@ -23,7 +23,7 @@ Emerge @menu * Overview of Emerge:: How to start Emerge. Basic concepts. -* Submodes of Emerge:: Fast mode vs. Edit mode. +* Submodes of Emerge:: Fast mode vs.@: Edit mode. Skip Prefers mode and Auto Advance mode. * State of Difference:: You do the merge by specifying state A or B for each difference. diff --git a/doc/emacs/files.texi b/doc/emacs/files.texi index 3dc6efe17cf..c04ac685ee0 100644 --- a/doc/emacs/files.texi +++ b/doc/emacs/files.texi @@ -34,7 +34,7 @@ Files * Copying and Naming:: Copying, naming and renaming files. * Misc File Ops:: Other things you can do on files. * Compressed Files:: Accessing compressed files. -* File Archives:: Operating on tar, zip, jar etc. archive files. +* File Archives:: Operating on tar, zip, jar etc.@: archive files. * Remote Files:: Accessing files on other machines. * Quoted File Names:: Quoting special characters in file names. * File Name Cache:: Completion against a list of files you often use. diff --git a/doc/emacs/frames.texi b/doc/emacs/frames.texi index 696d3df44ae..e0d8a607072 100644 --- a/doc/emacs/frames.texi +++ b/doc/emacs/frames.texi @@ -1233,7 +1233,7 @@ Drag and Drop Emacs can also optionally drag the region with the mouse into another portion of this or another buffer. To enable that, customize the variable @code{mouse-drag-and-drop-region} to a non-@code{nil} -value. Normally, the text is moved, i.e. cut and pasted, when the +value. Normally, the text is moved, i.e.@: cut and pasted, when the destination is the same buffer as the origin; dropping the region on another buffer copies the text instead. If the value of this variable names a modifier key, such as @samp{shift}, @samp{control} or diff --git a/doc/emacs/misc.texi b/doc/emacs/misc.texi index 393d3def574..5896dc83fe1 100644 --- a/doc/emacs/misc.texi +++ b/doc/emacs/misc.texi @@ -2996,7 +2996,7 @@ Hyperlinking * Embedded WebKit Widgets:: Embedding browser widgets in Emacs buffers. * Browse-URL:: Following URLs. * Goto Address mode:: Activating URLs. -* FFAP:: Finding files etc. at point. +* FFAP:: Finding files etc.@: at point. @end menu @node EWW diff --git a/doc/emacs/modes.texi b/doc/emacs/modes.texi index 3089a2543e5..c3008a48b04 100644 --- a/doc/emacs/modes.texi +++ b/doc/emacs/modes.texi @@ -23,7 +23,7 @@ Modes one another, and of the selected major mode. @menu -* Major Modes:: Text mode vs. Lisp mode vs. C mode... +* Major Modes:: Text mode vs.@: Lisp mode vs.@: C mode... * Minor Modes:: Each minor mode is a feature you can turn on independently of any others. * Choosing Modes:: How modes are chosen when visiting files. diff --git a/doc/emacs/mule.texi b/doc/emacs/mule.texi index 4db0febbef8..397315867e4 100644 --- a/doc/emacs/mule.texi +++ b/doc/emacs/mule.texi @@ -516,8 +516,9 @@ Input Methods rather than in the echo area. To enter characters according to the @dfn{p@=iny@=in} transliteration -method instead, use the @code{chinese-sisheng} input method. This is -a composition based method, where e.g. @kbd{pi1} results in @samp{p@=i}. +method instead, use the @code{chinese-sisheng} input method. This is a +composition based method, where, for example, @kbd{pi1} results in +@samp{p@=i}. In Japanese input methods, first you input a whole word using phonetic spelling; then, after the word is in the buffer, Emacs diff --git a/doc/emacs/windows.texi b/doc/emacs/windows.texi index c5502b54091..a992f26fcdd 100644 --- a/doc/emacs/windows.texi +++ b/doc/emacs/windows.texi @@ -713,7 +713,7 @@ Window Tool Bar The command @code{global-window-tool-bar-mode} toggles the display of a tool bar at the top of each window. When enabled, multiple windows can display their own tool bar simultaneously. To conserve space, a -window tool bar is hidden if there are no buttons to show, i.e. if +window tool bar is hidden if there are no buttons to show, i.e.@: if @code{tool-bar-map} is @code{nil}. @findex window-tool-bar-mode diff --git a/doc/lispintro/emacs-lisp-intro.texi b/doc/lispintro/emacs-lisp-intro.texi index 2c94e7f407e..b041678d8c8 100644 --- a/doc/lispintro/emacs-lisp-intro.texi +++ b/doc/lispintro/emacs-lisp-intro.texi @@ -3812,7 +3812,7 @@ Lexical & Dynamic Binding Differences revealing the one it had (if any) before the @code{let} expression. @node Lexical vs Dynamic Binding Example -@unnumberedsubsubsec Example of Lexical vs. Dynamic Binding +@unnumberedsubsubsec Example of Lexical vs.@: Dynamic Binding In some cases, both lexical and dynamic binding behave identically. However, in other cases, they can change the meaning of your program. For example, see what happens in this code under lexical binding: diff --git a/doc/lispref/elisp.texi b/doc/lispref/elisp.texi index cc5762e37e5..772267453e0 100644 --- a/doc/lispref/elisp.texi +++ b/doc/lispref/elisp.texi @@ -560,7 +560,7 @@ Top Functions -* What Is a Function:: Lisp functions vs. primitives; terminology. +* What Is a Function:: Lisp functions vs.@: primitives; terminology. * Lambda Expressions:: How functions are expressed as Lisp objects. * Function Names:: A symbol can serve as the name of a function. * Defining Functions:: Lisp expressions for defining functions. diff --git a/doc/lispref/functions.texi b/doc/lispref/functions.texi index 6f65ff95c44..569e7b93400 100644 --- a/doc/lispref/functions.texi +++ b/doc/lispref/functions.texi @@ -11,7 +11,7 @@ Functions define them. @menu -* What Is a Function:: Lisp functions vs. primitives; terminology. +* What Is a Function:: Lisp functions vs.@: primitives; terminology. * Lambda Expressions:: How functions are expressed as Lisp objects. * Function Names:: A symbol can serve as the name of a function. * Defining Functions:: Lisp expressions for defining functions. @@ -1378,7 +1378,7 @@ Generic Functions The type specializer, @code{(@var{arg} @var{type})}, can specify one of the @dfn{system types} in the following list. When a parent type is specified, an argument whose type is any of its more specific child -types, as well as grand-children, grand-grand-children, etc. will also +types, as well as grand-children, grand-grand-children, etc.@: will also be compatible. @table @code diff --git a/doc/lispref/hash.texi b/doc/lispref/hash.texi index 3b40e3f2c59..a7c2108a492 100644 --- a/doc/lispref/hash.texi +++ b/doc/lispref/hash.texi @@ -292,7 +292,7 @@ Defining Hash @defun sxhash-eql obj This function returns a hash code for Lisp object @var{obj} suitable -for @code{eql} comparison. I.e. it reflects identity of @var{obj} +for @code{eql} comparison. In other words, it reflects identity of @var{obj} except for the case where the object is a bignum or a float number, in which case a hash code is generated for the value. diff --git a/doc/lispref/keymaps.texi b/doc/lispref/keymaps.texi index 8c3f21bf18f..56bfb550974 100644 --- a/doc/lispref/keymaps.texi +++ b/doc/lispref/keymaps.texi @@ -459,9 +459,9 @@ Creating Keymaps @kindex :repeat @kindex repeat-mode @cindex repeatable key bindings -Each command in the keymap can be marked as `repeatable', i.e. usable +Each command in the keymap can be marked as `repeatable', i.e.@: usable in @code{repeat-mode}, by putting a @code{repeat-map} property on it, -e.g. +for example: @lisp (put 'undo 'repeat-map 'undo-repeat-map) diff --git a/doc/lispref/lists.texi b/doc/lispref/lists.texi index a660a9b7ecf..37a07421e94 100644 --- a/doc/lispref/lists.texi +++ b/doc/lispref/lists.texi @@ -1980,8 +1980,8 @@ Property Lists @node Plists and Alists @subsection Property Lists and Association Lists -@cindex plist vs. alist -@cindex alist vs. plist +@cindex plist vs.@: alist +@cindex alist vs.@: plist @cindex property lists vs association lists Association lists (@pxref{Association Lists}) are very similar to diff --git a/doc/lispref/modes.texi b/doc/lispref/modes.texi index 43a1d75cd67..aa13f1316c6 100644 --- a/doc/lispref/modes.texi +++ b/doc/lispref/modes.texi @@ -2608,7 +2608,7 @@ %-Constructs @item %o The degree of @dfn{travel} of the window through (the visible portion -of) the buffer, i.e. the size of the text above the top of the window +of) the buffer, i.e.@: the size of the text above the top of the window expressed as a percentage of all the text outside the window, or @samp{Top}, @samp{Bottom} or @samp{All}. diff --git a/doc/lispref/nonascii.texi b/doc/lispref/nonascii.texi index 43d4181e045..eccca96df0a 100644 --- a/doc/lispref/nonascii.texi +++ b/doc/lispref/nonascii.texi @@ -644,7 +644,7 @@ Character Properties Corresponds to Unicode language- and context-independent special lower-casing rules. The value of this property is a string (which may be empty). For example for U+0130 @sc{latin capital letter i -with dot above} the value is @code{"i\u0307"} (i.e. a 2-character string +with dot above} the value is @code{"i\u0307"} (i.e., a 2-character string consisting of @sc{latin small letter i} followed by U+0307 @sc{combining dot above}). This mapping overrides the @code{lowercase} property, and thus the current case table. For characters with no @@ -741,7 +741,7 @@ Character Properties Unicode code space into script-specific blocks. This char-table has a single extra slot whose value is the list of all script symbols. Note that Emacs's classification of characters into scripts is not a 1-for-1 -reflection of the Unicode standard, e.g. there is no @samp{symbol} +reflection of the Unicode standard, for example there is no @samp{symbol} script in Unicode. @end defvar diff --git a/doc/lispref/processes.texi b/doc/lispref/processes.texi index df08f82c86a..bde6fa2e871 100644 --- a/doc/lispref/processes.texi +++ b/doc/lispref/processes.texi @@ -3159,7 +3159,7 @@ Misc Network form @code{(@var{ifname} . @var{address})}. @var{ifname} is a string naming the interface, @var{address} has the same form as the @var{local-address} and @var{remote-address} arguments to -@code{make-network-process}, i.e. a vector of integers. By default +@code{make-network-process}, i.e.@: a vector of integers. By default both IPv4 and IPv6 addresses are returned if possible. Optional argument @var{full} non-@code{nil} means to instead return a diff --git a/doc/lispref/searching.texi b/doc/lispref/searching.texi index 77362b3b401..09ff6202afa 100644 --- a/doc/lispref/searching.texi +++ b/doc/lispref/searching.texi @@ -1835,7 +1835,7 @@ Regexp Functions @table @asis @item a string The resulting regexp is preceded by @var{paren} and followed by -@samp{\)}, e.g. use @samp{"\\(?1:"} to produce an explicitly +@samp{\)}. For example, use @samp{"\\(?1:"} to produce an explicitly numbered group. @item @code{words} diff --git a/doc/lispref/syntax.texi b/doc/lispref/syntax.texi index c4f6a073bb1..3ab349df8f3 100644 --- a/doc/lispref/syntax.texi +++ b/doc/lispref/syntax.texi @@ -996,7 +996,7 @@ Syntax Table Internals @cindex syntax tables (accessing elements of) Use @code{aref} (@pxref{Array Functions}) to get the raw syntax -descriptor of a character, e.g. @w{@code{(aref (syntax-table) ch)}}. +descriptor of a character, for example @w{@code{(aref (syntax-table) ch)}}. Here are the syntax codes corresponding to the various syntax classes: diff --git a/doc/lispref/text.texi b/doc/lispref/text.texi index 5e072b8697b..f3cf0294c81 100644 --- a/doc/lispref/text.texi +++ b/doc/lispref/text.texi @@ -1695,7 +1695,7 @@ Filling pixel width to use. If given no arguments, it'll return a value slightly less than the width of the current window. The first optional value, @var{columns}, specifies the number of columns using -the standard, monospaced fonts, e.g. @code{fill-column}. The second +the standard, monospaced fonts, for example @code{fill-column}. The second optional value is the window to use. You'd typically use it like this: @@ -4970,7 +4970,7 @@ Checksum/Hash possible to deliberately design different pieces of data which have the same MD5 or SHA-1 hash), so you should not use them for anything security-related. For security-related applications you should use -the other hash types, such as SHA-2 (e.g. @code{sha256} or +the other hash types, such as SHA-2 (e.g., @code{sha256} or @code{sha512}). @defun secure-hash-algorithms @@ -6136,7 +6136,7 @@ JSONRPC deferred requests application: when synchronization is needed, requests (which are blocking) should be used; when it isn't, notifications should suffice. However, when Emacs acts as one of these endpoints, asynchronous -events (e.g. timer- or process-related) may be triggered while there +events (e.g., timer- or process-related) may be triggered while there is still uncertainty about the state of the remote endpoint. Furthermore, acting on these events may only sometimes demand synchronization, depending on the event's specific nature. diff --git a/doc/misc/calc.texi b/doc/misc/calc.texi index 0635ab7ac05..9127e3c41cf 100644 --- a/doc/misc/calc.texi +++ b/doc/misc/calc.texi @@ -234,7 +234,7 @@ What is Calc @itemize @bullet @item Choice of algebraic or Reverse Polish notation (RPN), -i.e. stack-based, entry of calculations. +i.e.@: stack-based, entry of calculations. @item Arbitrary precision integers and floating-point numbers. @@ -2630,8 +2630,8 @@ Modes Tutorial produce exact fractional results; Fraction mode only says what to do when dividing two integers. -@cindex Fractions vs. floats -@cindex Floats vs. fractions +@cindex Fractions vs.@: floats +@cindex Floats vs.@: fractions (@bullet{}) @strong{Exercise 4.} If fractional arithmetic is exact, why would you ever use floating-point numbers instead? @xref{Modes Answer 4, 4}. (@bullet{}) diff --git a/doc/misc/cc-mode.texi b/doc/misc/cc-mode.texi index 6bda333b4f9..65f178c2fa5 100644 --- a/doc/misc/cc-mode.texi +++ b/doc/misc/cc-mode.texi @@ -6047,7 +6047,7 @@ List Line-Up first line is also contained in an arglist or an enclosing brace @emph{on that line}. -I.e. handle something like the following: +In other words, handle something like the following: @example @group @@ -6081,7 +6081,7 @@ List Line-Up @code{c-basic-offset} characters in from the identifier when: @enumerate @item -The type is a class, struct, union, etc. (but not an enum); +The type is a class, struct, union, etc.@: (but not an enum); @item There is a brace block in the type declaration, specifying it; and @item @@ -6089,7 +6089,7 @@ List Line-Up opening brace. @end enumerate -I.e. we have a construct like this: +In other words, we have a construct like this: @example @group @@ -6123,7 +6123,7 @@ List Line-Up opening brace when: @enumerate @item -The type is a class, struct, union, etc. (but not an enum); +The type is a class, struct, union, etc.@: (but not an enum); @item There is a brace block in the type declaration, specifying it; and @item @@ -6131,7 +6131,7 @@ List Line-Up opening brace. @end enumerate -I.e. we have a construct like this: +In other words, we have a construct like this: @example @group @@ -6445,7 +6445,7 @@ Operator Line-Up @defun c-lineup-ternary-bodies @findex lineup-ternary-bodies @r{(c-)} Line up true and false branches of a ternary operator -(i.e. @code{?:}). More precisely, if the line starts with a colon +(i.e., @code{?:}). More precisely, if the line starts with a colon which is a part of a said operator, align it with corresponding question mark. For example: @@ -7018,7 +7018,7 @@ Custom Macros @end defopt Sometimes you may want to indent particular directives -(e.g. @code{#pragma}) as though they were statements. To do this, see +(e.g., @code{#pragma}) as though they were statements. To do this, see @ref{Indenting Directives}. Because a macro can expand into anything at all, near where one is @@ -7210,7 +7210,7 @@ Indenting Directives @comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Sometimes you may want to indent particular preprocessor directives -(e.g. @code{#pragma}) as though they were statements. To do this, +(e.g., @code{#pragma}) as though they were statements. To do this, first set up @code{c-cpp-indent-to-body-directives} to include the directive name(s), then enable the ``indent to body'' feature with @code{c-toggle-cpp-indent-to-body}. diff --git a/doc/misc/efaq.texi b/doc/misc/efaq.texi index 087342f012f..34f45d6fdfc 100644 --- a/doc/misc/efaq.texi +++ b/doc/misc/efaq.texi @@ -1889,7 +1889,7 @@ Colors on a TTY If by contrast you wish to @emph{disable} tty color support, either start emacs with the @samp{--color=no} command-line option, or ensure -that the frame parameter @code{tty-color-mode} is @code{no}, e.g. by +that the frame parameter @code{tty-color-mode} is @code{no}, for example by putting the following in your init file: @lisp @@ -3687,9 +3687,9 @@ Security risks with Emacs @item Third party packages. -Any package you install into Emacs can run arbitrary code with the -same privileges as the Emacs process itself. Be aware of this when -you use the package system (e.g. @code{M-x list-packages}) with third +Any package you install into Emacs can run arbitrary code with the same +privileges as the Emacs process itself. Be aware of this when you use +the package system (for example, @code{M-x list-packages}) with third party archives. Use only third parties that you can trust! @item diff --git a/doc/misc/eglot.texi b/doc/misc/eglot.texi index af38adc094a..d7bd78e134b 100644 --- a/doc/misc/eglot.texi +++ b/doc/misc/eglot.texi @@ -872,7 +872,7 @@ Eglot Variables (@code{xref-find-definitions}) lands you in a file outside of your project, such as a system-installed library or header file, transiently consider that file as managed by the same language server. -That file is still outside your project (i.e. @code{project-find-file} +That file is still outside your project (i.e., @code{project-find-file} won't find it), but Eglot and the server will consider it to be part of the workspace. The default is @code{nil}. diff --git a/doc/misc/erc.texi b/doc/misc/erc.texi index 19fb9eaa7d7..ab46753e709 100644 --- a/doc/misc/erc.texi +++ b/doc/misc/erc.texi @@ -851,7 +851,7 @@ Connecting In the case of @code{:client-certificate t}, you will need to add a line like the following to your authinfo file -(e.g. @file{~/.authinfo.gpg}): +(for example, @file{~/.authinfo.gpg}): @example machine irc.libera.chat key /home/bandali/my-cert.key cert /home/bandali/my-cert.crt diff --git a/doc/misc/eshell.texi b/doc/misc/eshell.texi index 944092f61c2..d1cf8945bc7 100644 --- a/doc/misc/eshell.texi +++ b/doc/misc/eshell.texi @@ -1593,7 +1593,7 @@ Aliases Note that unlike aliases in Bash, arguments must be handled explicitly. Within aliases, you can use the special variables -@samp{$*}, @samp{$0}, @samp{$1}, @samp{$2}, etc. to refer to the +@samp{$*}, @samp{$0}, @samp{$1}, @samp{$2}, etc.@: to refer to the arguments passed to the alias. @table @code @@ -2536,7 +2536,7 @@ Completion replaced by the completion. @kindex M-? -If you want to see the entire list of possible completions (e.g. when it's +If you want to see the entire list of possible completions (e.g., when it's below the @code{completion-cycle-threshold}), press @kbd{M-?}. @subsection pcomplete diff --git a/doc/misc/flymake.texi b/doc/misc/flymake.texi index 8782089613a..54835767928 100644 --- a/doc/misc/flymake.texi +++ b/doc/misc/flymake.texi @@ -582,7 +582,7 @@ Backend functions indicates that no changes have been recorded. If it is the first time that this backend function is called for this activation of @code{flymake-mode}, then this argument isn't provided at all -(i.e. it's not merely nil). +(in other words, it's not merely nil). Each element is in the form (@var{beg} @var{end} @var{text}) where @var{beg} and @var{end} are buffer positions, and @var{text} is a diff --git a/doc/misc/gnus-faq.texi b/doc/misc/gnus-faq.texi index 914de5320f0..c4bec5a273f 100644 --- a/doc/misc/gnus-faq.texi +++ b/doc/misc/gnus-faq.texi @@ -1054,7 +1054,7 @@ FAQ 5 - Composing messages messages? * FAQ 5-3:: How to set stuff like From, Organization, Reply-To, signature...? -* FAQ 5-4:: Can I set things like From, Signature etc. group based on +* FAQ 5-4:: Can I set things like From, Signature etc.@: group based on the group I post too? * FAQ 5-5:: Is there a spell-checker? Perhaps even on-the-fly spell-checking? diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi index 41ec75a5ed2..7bfe580f768 100644 --- a/doc/misc/gnus.texi +++ b/doc/misc/gnus.texi @@ -18611,7 +18611,7 @@ Gnus Unplugged @cindex Gnus agent @cindex Gnus unplugged -In olden times (ca. February '88), people used to run their newsreaders +In olden times (ca.@: February '88), people used to run their newsreaders on big machines with permanent connections to the net. News transport was dealt with by news servers, and all the newsreaders had to do was to read news. Believe it or not. @@ -23348,7 +23348,7 @@ Window Layout Lastly, it's possible to make Gnus window layouts ``atomic'' (@pxref{Atomic Windows, , Atomic Windows, elisp, The GNU Emacs Lisp Reference Manual}) by setting @code{gnus-use-atomic-windows} to -@code{t}. This will ensure that pop-up buffers (e.g. help or +@code{t}. This will ensure that pop-up buffers (e.g., help or completion buffers), will appear below or to the side of the entire Gnus window layout and not, for example, squashed between the summary and article buffers. @@ -24858,7 +24858,7 @@ Filtering Incoming Mail spam tests. Another reason why this is nice is that messages to mailing lists you have rules for don't have to have resource-intensive blackhole checks performed on them. You could also specify different -spam checks for your nnmail split vs. your nnimap split. Go crazy. +spam checks for your nnmail split vs.@: your nnimap split. Go crazy. You should set the @code{spam-use-*} variables for whatever spam back ends you intend to use. The reason is that when loading @@ -26979,7 +26979,7 @@ History In any case, after spending all that energy on coming up with a new and spunky name, we decided that the name was @emph{too} spunky, so we renamed it back again to ``Gnus''. But in mixed case. ``Gnus'' vs. -``@sc{gnus}''. New vs. old. +``@sc{gnus}''. New vs.@: old. @menu * Gnus Versions:: What Gnus versions have been released. diff --git a/doc/misc/idlwave.texi b/doc/misc/idlwave.texi index 0db01faf3d1..3e431cd1886 100644 --- a/doc/misc/idlwave.texi +++ b/doc/misc/idlwave.texi @@ -1333,7 +1333,7 @@ Online Help When using completion and Emacs pops up a @file{*Completions*} buffer with possible completions, clicking with @kbd{mouse-3} on a completion item invokes help on that item (@pxref{Completion}). Items for which -help is available in the online system documentation (vs. just the +help is available in the online system documentation (vs.@: just the program source itself) will be emphasized (e.g., colored blue). @end itemize @noindent @@ -3495,7 +3495,7 @@ Catalogs @emph{Catalogs} are files containing scanned information on individual routines, including arguments and keywords, calling sequence, file path, -class and procedure vs. function type, etc. They represent a way of +class and procedure vs.@: function type, etc. They represent a way of extending the internal built-in information available for IDL system routines (@pxref{Routine Info}) to other source collections. diff --git a/doc/misc/wisent.texi b/doc/misc/wisent.texi index a92f61fd6c7..bf9837d65fc 100644 --- a/doc/misc/wisent.texi +++ b/doc/misc/wisent.texi @@ -126,7 +126,7 @@ Wisent Overview tables, described in Corbett's PhD thesis from Berkeley: @quotation @cite{Static Semantics in Compiler Error Recovery}@* -June 1985, Report No. UCB/CSD 85/251. +June 1985, Report No.@: UCB/CSD 85/251. @end quotation @item -- 2.48.1