From 41278b775bd3ebc213ff8b9eda2f2c04a5354bba Mon Sep 17 00:00:00 2001 From: Paul Eggert Date: Tue, 17 Mar 2015 16:55:02 -0700 Subject: [PATCH] Spacing and punctuation fixes --- doc/emacs/ack.texi | 2 +- doc/emacs/buffers.texi | 2 +- doc/emacs/display.texi | 2 +- doc/emacs/frames.texi | 2 +- doc/emacs/killing.texi | 2 +- doc/emacs/mule.texi | 2 +- doc/emacs/trouble.texi | 10 +++++----- doc/lispintro/emacs-lisp-intro.texi | 6 +++--- doc/lispref/commands.texi | 6 +++--- doc/lispref/display.texi | 2 +- doc/lispref/elisp.texi | 4 ++-- doc/lispref/frames.texi | 4 ++-- doc/lispref/functions.texi | 4 ++-- doc/lispref/internals.texi | 2 +- doc/lispref/loading.texi | 2 +- doc/lispref/minibuf.texi | 2 +- doc/lispref/numbers.texi | 2 +- doc/lispref/streams.texi | 2 +- doc/lispref/text.texi | 4 ++-- doc/misc/auth.texi | 4 ++-- doc/misc/calc.texi | 2 +- doc/misc/cc-mode.texi | 4 ++-- doc/misc/eieio.texi | 2 +- doc/misc/erc.texi | 6 +++--- doc/misc/eshell.texi | 2 +- doc/misc/eww.texi | 4 ++-- doc/misc/gnus.texi | 6 +++--- doc/misc/htmlfontify.texi | 4 ++-- doc/misc/idlwave.texi | 4 ++-- doc/misc/ido.texi | 2 +- doc/misc/newsticker.texi | 2 +- doc/misc/org.texi | 8 ++++---- doc/misc/pgg.texi | 2 +- doc/misc/reftex.texi | 6 +++--- doc/misc/todo-mode.texi | 4 ++-- doc/misc/tramp.texi | 2 +- doc/misc/vhdl-mode.texi | 6 +++--- doc/misc/vip.texi | 2 +- doc/misc/viper.texi | 2 +- doc/misc/woman.texi | 2 +- 40 files changed, 69 insertions(+), 69 deletions(-) diff --git a/doc/emacs/ack.texi b/doc/emacs/ack.texi index f97964b6a68..151c3f1b848 100644 --- a/doc/emacs/ack.texi +++ b/doc/emacs/ack.texi @@ -204,7 +204,7 @@ for Korean Hanja. @item Andrew Choi and Yamamoto Mitsuharu wrote the Carbon support, used -prior to Emacs 23 for Mac OS. Yamamoto Mitsuharu continued to +prior to Emacs 23 for Mac OS@. Yamamoto Mitsuharu continued to contribute to Mac OS support in the newer Nextstep port; and also improved support for multi-monitor displays. diff --git a/doc/emacs/buffers.texi b/doc/emacs/buffers.texi index 88a122c8283..25b13d660a4 100644 --- a/doc/emacs/buffers.texi +++ b/doc/emacs/buffers.texi @@ -642,7 +642,7 @@ the directory names in reverse order, so that @file{/top/middle/file} becomes @samp{file\middle\top}, while @code{post-forward} puts them in forward order after the file name, as in @samp{file|top/middle}. If @code{uniquify-buffer-name-style} is set to @code{nil}, the buffer -names simply get @samp{<2>}, @samp{<3>}, etc. appended. +names simply get @samp{<2>}, @samp{<3>}, etc.@: appended. Which rule to follow for putting the directory names in the buffer name is not very important if you are going to @emph{look} at the diff --git a/doc/emacs/display.texi b/doc/emacs/display.texi index ae723b8d68c..38acc20955e 100644 --- a/doc/emacs/display.texi +++ b/doc/emacs/display.texi @@ -138,7 +138,7 @@ instructs the scrolling commands not to fontify (@pxref{Font Lock}) any unfontified text they scroll over, instead to assume it has the default face. This can cause Emacs to scroll to somewhat wrong buffer positions when the faces in use are not all the same size, even with -single (i.e. without auto-repeat) scrolling operations. +single (i.e., without auto-repeat) scrolling operations. @vindex scroll-up @vindex scroll-down diff --git a/doc/emacs/frames.texi b/doc/emacs/frames.texi index b5b9dbd7daa..f401c8f645f 100644 --- a/doc/emacs/frames.texi +++ b/doc/emacs/frames.texi @@ -955,7 +955,7 @@ bar width, change the @code{scroll-bar-width} frame parameter @cindex overscrolling If you're using Emacs on X (with GTK+ or Motif), you can customize the variable @code{scroll-bar-adjust-thumb-portion} to control -@dfn{overscrolling} of the scroll bar, i.e. dragging the thumb down even +@dfn{overscrolling} of the scroll bar, i.e., dragging the thumb down even when the end of the buffer is visible. If its value is non-@code{nil}, the scroll bar can be dragged downwards even if the end of the buffer is shown; if @code{nil}, the thumb will be at the diff --git a/doc/emacs/killing.texi b/doc/emacs/killing.texi index 3092d34b566..4b90bf468d5 100644 --- a/doc/emacs/killing.texi +++ b/doc/emacs/killing.texi @@ -848,7 +848,7 @@ shifting the original text to the right. The command @kbd{C-x @key{SPC}} (@code{rectangle-mark-mode}) toggles whether the region-rectangle or the standard region is highlighted (first activating the region if necessary). When this mode is enabled, -commands that resize the region (@kbd{C-f}, @kbd{C-n} etc.) do +commands that resize the region (@kbd{C-f}, @kbd{C-n} etc.)@: do so in a rectangular fashion, and killing and yanking operate on the rectangle. @xref{Killing}. The mode persists only as long as the region is active. diff --git a/doc/emacs/mule.texi b/doc/emacs/mule.texi index f8b06bdb5d9..a80f942f61a 100644 --- a/doc/emacs/mule.texi +++ b/doc/emacs/mule.texi @@ -266,7 +266,7 @@ for more information about the language environment @var{lang-env}. Supported language environments include: @c @cindex entries below are split between portions of the list to -@c make them more accurate, i.e. land on the line that mentions the +@c make them more accurate, i.e., land on the line that mentions the @c language. However, makeinfo 4.x doesn't fill inside @quotation @c lines that follow a @cindex entry and whose text has no whitespace. @c To work around, we group the language environments together, so diff --git a/doc/emacs/trouble.texi b/doc/emacs/trouble.texi index 2faa5d91cc6..22ec215d5e6 100644 --- a/doc/emacs/trouble.texi +++ b/doc/emacs/trouble.texi @@ -342,7 +342,7 @@ Here, @var{backtrace} is the name of a text file containing a copy of the backtrace, @var{bindir} is the name of the directory that contains the Emacs executable, and @var{emacs-binary} is the name of the Emacs executable file, normally @file{emacs} on GNU and Unix -systems and @file{emacs.exe} on MS-Windows and MS-DOS. Omit the +systems and @file{emacs.exe} on MS-Windows and MS-DOS@. Omit the @option{-p} option if your version of @command{addr2line} is too old to have it. @@ -1142,7 +1142,7 @@ making diffs of C code. This shows the name of the function that each change occurs in. If you are using the Emacs repository, make sure your copy is -up-to-date (e.g. with @code{git pull}). You can commit your changes +up-to-date (e.g., with @code{git pull}). You can commit your changes to a private branch and generate a patch from the master version by using @code{git format-patch master}. Or you can leave your changes uncommitted and use @code{git diff}. @@ -1173,7 +1173,7 @@ explanation in comments in the code. It will be more useful there. Please look at the change log entries of recent commits to see what sorts of information to put in, and to learn the style that we use. Note that, unlike some other projects, we do require change logs for -documentation, i.e. Texinfo files. +documentation, i.e., Texinfo files. @xref{Change Log}, @ifset WWW_GNU_ORG see @@ -1389,7 +1389,7 @@ user freedom and to defend the rights of all free software users. For general information, see the website @url{http://www.fsf.org/}. Generally speaking, for non-trivial contributions to GNU Emacs we -require that the copyright be assigned to the FSF. For the reasons +require that the copyright be assigned to the FSF@. For the reasons behind this, see @url{http://www.gnu.org/licenses/why-assign.html}. Copyright assignment is a simple process. Residents of some countries @@ -1408,7 +1408,7 @@ is not enough). Also, a disclaimer cannot be applied to future work, it has to be repeated each time you want to send something new. We can accept small changes (roughly, fewer than 15 lines) without -an assignment. This is a cumulative limit (e.g. three separate 5 line +an assignment. This is a cumulative limit (e.g., three separate 5 line patches) over all your contributions. @node Service diff --git a/doc/lispintro/emacs-lisp-intro.texi b/doc/lispintro/emacs-lisp-intro.texi index b6eff2de0dc..c67623d89cb 100644 --- a/doc/lispintro/emacs-lisp-intro.texi +++ b/doc/lispintro/emacs-lisp-intro.texi @@ -387,7 +387,7 @@ Truth and Falsehood in Emacs Lisp * Point and mark:: A review of various locations. * Template for save-excursion:: -A Few Buffer--Related Functions +A Few Buffer-Related Functions * Finding More:: How to find more information. * simplified-beginning-of-buffer:: Shows @code{goto-char}, @@ -4547,7 +4547,7 @@ and if so, prints an appropriate message. @end itemize @node Buffer Walk Through -@chapter A Few Buffer--Related Functions +@chapter A Few Buffer-Related Functions In this chapter we study in detail several of the functions used in GNU Emacs. This is called a ``walk-through''. These functions are used as @@ -12114,7 +12114,7 @@ Internet, see @uref{http://www.gnu.org/software/texinfo/manual/texinfo/} @end ifhtml @iftex -``Indicating Definitions, Commands, etc.'' in @cite{Texinfo, The GNU +``Indicating Definitions, Commands, etc.''@: in @cite{Texinfo, The GNU Documentation Format}. @end iftex @end itemize diff --git a/doc/lispref/commands.texi b/doc/lispref/commands.texi index 6fdc8e2ec79..b81d0f84e5c 100644 --- a/doc/lispref/commands.texi +++ b/doc/lispref/commands.texi @@ -132,7 +132,7 @@ byte compiler to warn if the command is called from Lisp. The output of @code{describe-function} will include similar information. The value of the property can be: a string, which the byte-compiler will use directly in its warning (it should end with a period, and not -start with a capital, e.g. ``use @dots{} instead.''); @code{t}; any +start with a capital, e.g., ``use @dots{} instead.''); @code{t}; any other symbol, which should be an alternative function to use in Lisp code. @@ -1043,8 +1043,8 @@ the current Emacs session. If a symbol has not yet been so used, @end defun @menu -* Keyboard Events:: Ordinary characters--keys with symbols on them. -* Function Keys:: Function keys--keys with names, not symbols. +* Keyboard Events:: Ordinary characters -- keys with symbols on them. +* Function Keys:: Function keys -- keys with names, not symbols. * Mouse Events:: Overview of mouse events. * Click Events:: Pushing and releasing a mouse button. * Drag Events:: Moving the mouse before releasing the button. diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi index 5dd74d25e8f..b73e70d1079 100644 --- a/doc/lispref/display.texi +++ b/doc/lispref/display.texi @@ -2154,7 +2154,7 @@ stipple patterns. Alternative foreground color, a string. This is like @code{:foreground} but the color is only used as a foreground when the background color is near to the foreground that would have been used. This is useful for -example when marking text (i.e. the region face). If the text has a foreground +example when marking text (i.e., the region face). If the text has a foreground that is visible with the region face, that foreground is used. If the foreground is near the region face background, @code{:distant-foreground} is used instead so the text is readable. diff --git a/doc/lispref/elisp.texi b/doc/lispref/elisp.texi index fc552be161b..fc8ba7b4116 100644 --- a/doc/lispref/elisp.texi +++ b/doc/lispref/elisp.texi @@ -753,8 +753,8 @@ Defining Commands Input Events -* Keyboard Events:: Ordinary characters--keys with symbols on them. -* Function Keys:: Function keys--keys with names, not symbols. +* Keyboard Events:: Ordinary characters -- keys with symbols on them. +* Function Keys:: Function keys -- keys with names, not symbols. * Mouse Events:: Overview of mouse events. * Click Events:: Pushing and releasing a mouse button. * Drag Events:: Moving the mouse before releasing the button. diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi index 0b8106dfc9c..85695c614c8 100644 --- a/doc/lispref/frames.texi +++ b/doc/lispref/frames.texi @@ -360,7 +360,7 @@ coordinates might be negative. Position of the top-left corner and size of the work area (``usable'' space) in pixels as @samp{(@var{x} @var{y} @var{width} @var{height})}. This may be different from @samp{geometry} in that space occupied by -various window manager features (docks, taskbars, etc.) may be +various window manager features (docks, taskbars, etc.)@: may be excluded from the work area. Whether or not such features actually subtract from the work area depends on the platform and environment. Again, if the monitor is not the primary monitor, some of the @@ -1218,7 +1218,7 @@ These functions return the canonical height and width of a character in @var{frame}, measured in pixels. Together, these values establish the size of the default font on @var{frame}. The values depend on the choice of font for @var{frame}, see @ref{Font and Color Parameters}. -@end defun +@end defun The default font can be also set directly with the following function: diff --git a/doc/lispref/functions.texi b/doc/lispref/functions.texi index 40b8322c73e..a853d2fbab5 100644 --- a/doc/lispref/functions.texi +++ b/doc/lispref/functions.texi @@ -1222,7 +1222,7 @@ This macro is the handy way to add the advice @var{function} to the function stored in @var{place} (@pxref{Generalized Variables}). @var{where} determines how @var{function} is composed with the -existing function, e.g. whether @var{function} should be called before, or +existing function, e.g., whether @var{function} should be called before, or after the original function. @xref{Advice combinators}, for the list of available ways to compose the two functions. @@ -1310,7 +1310,7 @@ and its properties. @defun advice-eval-interactive-spec spec Evaluate the interactive @var{spec} just like an interactive call to a function with such a spec would, and then return the corresponding list of arguments -that was built. E.g. @code{(advice-eval-interactive-spec "r\nP")} will +that was built. E.g., @code{(advice-eval-interactive-spec "r\nP")} will return a list of three elements, containing the boundaries of the region and the current prefix argument. @end defun diff --git a/doc/lispref/internals.texi b/doc/lispref/internals.texi index 2627ab74623..a5fff724ea1 100644 --- a/doc/lispref/internals.texi +++ b/doc/lispref/internals.texi @@ -1624,7 +1624,7 @@ similar advice may apply to the unsigned counterparts (e.g., of @code{intptr_t}). @item -Prefer @code{int} for Emacs character codes, in the range 0 ..@: 0x3FFFFF. +Prefer @code{int} for Emacs character codes, in the range 0 ..@: 0x3FFFFF@. More generally, prefer @code{int} for integers known to be in @code{int} range, e.g., screen column counts. diff --git a/doc/lispref/loading.texi b/doc/lispref/loading.texi index cf2f0007ca7..0ae8fbd0686 100644 --- a/doc/lispref/loading.texi +++ b/doc/lispref/loading.texi @@ -95,7 +95,7 @@ suffix), unless it contains an explicit directory name. If the option @code{load-prefer-newer} is non-@code{nil}, then when searching suffixes, @code{load} selects whichever version of a file -(@samp{.elc}, @samp{.el}, etc.) has been modified most recently. +(@samp{.elc}, @samp{.el}, etc.)@: has been modified most recently. If @var{filename} is a relative file name, such as @file{foo} or @file{baz/foo.bar}, @code{load} searches for the file using the variable diff --git a/doc/lispref/minibuf.texi b/doc/lispref/minibuf.texi index 82039ba450f..4fec757393f 100644 --- a/doc/lispref/minibuf.texi +++ b/doc/lispref/minibuf.texi @@ -102,7 +102,7 @@ the minibuffer is in a separate frame. @xref{Minibuffers and Frames}. When Emacs is running in batch mode, any request to read from the minibuffer actually reads a line from the standard input descriptor that was supplied when Emacs was started. This supports only basic input: -none of the special minibuffer features (history, completion, etc.) +none of the special minibuffer features (history, completion, etc.)@: are available in batch mode. @node Text from Minibuffer diff --git a/doc/lispref/numbers.texi b/doc/lispref/numbers.texi index 1ee70504a73..8d1d3a798eb 100644 --- a/doc/lispref/numbers.texi +++ b/doc/lispref/numbers.texi @@ -261,7 +261,7 @@ If @var{x} is finite, then @var{s} is a floating-point number between 0.5 @math{x = s 2^e}. @end tex If @var{x} is zero or infinity, then @var{s} is the same as @var{x}. -If @var{x} is a NaN, then @var{s} is also a NaN. +If @var{x} is a NaN, then @var{s} is also a NaN@. If @var{x} is zero, then @var{e} is 0. @end defun diff --git a/doc/lispref/streams.texi b/doc/lispref/streams.texi index e52a543110b..dfad2d83d54 100644 --- a/doc/lispref/streams.texi +++ b/doc/lispref/streams.texi @@ -344,7 +344,7 @@ When reading or writing from the standard input/output streams of the Emacs process in batch mode, it is sometimes required to make sure any arbitrary binary data will be read/written verbatim, and/or that no translation of newlines to or from CR-LF pairs are performed. This -issue does not exist on Posix hosts, only on MS-Windows and MS-DOS. +issue does not exist on Posix hosts, only on MS-Windows and MS-DOS@. The following function allows to control the I/O mode of any standard stream of the Emacs process. diff --git a/doc/lispref/text.texi b/doc/lispref/text.texi index a7cfb22e889..da67ec2b541 100644 --- a/doc/lispref/text.texi +++ b/doc/lispref/text.texi @@ -811,7 +811,7 @@ Delete trailing whitespace in the region defined by @var{start} and This command deletes whitespace characters after the last non-whitespace character in each line in the region. -If this command acts on the entire buffer (i.e. if called +If this command acts on the entire buffer (i.e., if called interactively with the mark inactive, or called from Lisp with @var{end} @code{nil}), it also deletes all trailing lines at the end of the buffer if the variable @code{delete-trailing-lines} is non-@code{nil}. @@ -2720,7 +2720,7 @@ text properties are considered, since strings never have overlays. @defun get-pos-property position prop &optional object This function is like @code{get-char-property}, except that it pays attention to properties' stickiness and overlays' advancement settings -instead of the property of the character at (i.e. right after) +instead of the property of the character at (i.e., right after) @var{position}. @end defun diff --git a/doc/misc/auth.texi b/doc/misc/auth.texi index 8dbde4d5ea0..7a2fd9b2e35 100644 --- a/doc/misc/auth.texi +++ b/doc/misc/auth.texi @@ -111,9 +111,9 @@ You can use spaces inside a password or other token by surrounding the token with either single or double quotes. You can use single quotes inside a password or other token by -surrounding it with double quotes, e.g. @code{"he'llo"}. Similarly you +surrounding it with double quotes, e.g., @code{"he'llo"}. Similarly you can use double quotes inside a password or other token by surrounding -it with single quotes, e.g. @code{'he"llo'}. You can't mix both (so a +it with single quotes, e.g., @code{'he"llo'}. You can't mix both (so a password or other token can't have both single and double quotes). All this is optional. You could just say (but we don't recommend it, diff --git a/doc/misc/calc.texi b/doc/misc/calc.texi index 30e39c43112..62a81b81ec7 100644 --- a/doc/misc/calc.texi +++ b/doc/misc/calc.texi @@ -36800,7 +36800,7 @@ desired function, or with @kbd{x} or @kbd{z} followed by a function name, or with @kbd{$} to take a formula from the top of the stack, or with @kbd{'} and a typed formula. In the last two cases, the formula may be a nameless function like @samp{<#1+#2>} or @samp{}, or it -may include @kbd{$}, @kbd{$$}, etc. (where @kbd{$} will correspond to the +may include @kbd{$}, @kbd{$$}, etc.@: (where @kbd{$} will correspond to the last argument of the created function), or otherwise you will be prompted for an argument list. The number of vectors popped from the stack by @kbd{V M} depends on the number of arguments of the function. diff --git a/doc/misc/cc-mode.texi b/doc/misc/cc-mode.texi index 1b79640d77a..068706a9158 100644 --- a/doc/misc/cc-mode.texi +++ b/doc/misc/cc-mode.texi @@ -1038,7 +1038,7 @@ Movement}. They might be removed from a future release of @ccmode{}. Since there's a lot of normal text in comments and string literals, @ccmode{} provides features to edit these like in text mode. The goal is to do it seamlessly, i.e., you can use auto fill mode, sentence and -paragraph movement, paragraph filling, adaptive filling etc. wherever +paragraph movement, paragraph filling, adaptive filling etc.@: wherever there's a piece of normal text without having to think much about it. @ccmode{} keeps the indentation, fixes suitable comment line prefixes, and so on. @@ -7140,7 +7140,7 @@ of XEmacs since 19.16. Due to release schedule skew, it is likely that all of these Emacsen have old versions of @ccmode{} and so should be upgraded. Access to the @ccmode{} source code, as well as more detailed information on Emacsen -compatibility, etc. are all available on the web site: +compatibility, etc.@: are all available on the web site: @quotation @uref{http://cc-mode.sourceforge.net/} diff --git a/doc/misc/eieio.texi b/doc/misc/eieio.texi index 3f42862f07a..f17fd31a7f2 100644 --- a/doc/misc/eieio.texi +++ b/doc/misc/eieio.texi @@ -178,7 +178,7 @@ error. @ref{Signals}. First off, please note that this manual cannot serve as a complete introduction to object oriented programming and generic functions in -LISP. Although EIEIO is not a complete implementation of the Common +LISP@. Although EIEIO is not a complete implementation of the Common Lisp Object System (CLOS) and also differs from it in several aspects, it follows the same basic concepts. Therefore, it is highly recommended to learn those from a textbook or tutorial first, diff --git a/doc/misc/erc.texi b/doc/misc/erc.texi index 2f4ffae87c1..3a86e1ba1ad 100644 --- a/doc/misc/erc.texi +++ b/doc/misc/erc.texi @@ -716,8 +716,8 @@ stuff, to the current ERC buffer." (setq erc-autojoin-channels-alist '(("freenode.net" "#emacs" "#erc"))) ;; Rename server buffers to reflect the current network name instead -;; of SERVER:PORT. (e.g. "freenode" instead of "irc.freenode.net:6667"). This -;; is useful when using a bouncer like ZNC where you have multiple +;; of SERVER:PORT (e.g., "freenode" instead of "irc.freenode.net:6667"). +;; This is useful when using a bouncer like ZNC where you have multiple ;; connections to the same server. (setq erc-rename-buffers t) @@ -780,7 +780,7 @@ or if you have bugs to report, there are several places you can go. @item @uref{http://www.emacswiki.org/cgi-bin/wiki/ERC} is the -emacswiki.org page for ERC@. Anyone may add tips, hints, etc. to it. +emacswiki.org page for ERC@. Anyone may add tips, hints, etc.@: to it. @item You can ask questions about using ERC on the Emacs mailing list, diff --git a/doc/misc/eshell.texi b/doc/misc/eshell.texi index ca90573f30b..6d57a78d170 100644 --- a/doc/misc/eshell.texi +++ b/doc/misc/eshell.texi @@ -649,7 +649,7 @@ Programs that need a terminal to display output properly are referred to in this manual as ``visual commands,'' because they are not simply line-oriented. You must tell Eshell which commands are visual, by adding them to @code{eshell-visual-commands}; for commands that are -visual for only certain @emph{sub}-commands -- e.g. @samp{git log} but +visual for only certain @emph{sub}-commands -- e.g., @samp{git log} but not @samp{git status} -- use @code{eshell-visual-subcommands}; and for commands that are visual only when passed certain options, use @code{eshell-visual-options}. diff --git a/doc/misc/eww.texi b/doc/misc/eww.texi index f60354d6d68..c7f84b5d4f0 100644 --- a/doc/misc/eww.texi +++ b/doc/misc/eww.texi @@ -126,7 +126,7 @@ specified in @code{eww-download-directory} (Default: @file{~/Downloads/}). @cindex History EWW remembers the URLs you have visited to allow you to go back and forth between them. By pressing @kbd{l} (@code{eww-back-url}) you go -to the previous URL. You can go forward again with @kbd{r} +to the previous URL@. You can go forward again with @kbd{r} (@code{eww-forward-url}). If you want an overview of your browsing history press @kbd{H} (@code{eww-list-histories}) to open the history buffer @file{*eww history*}. The history is lost when EWW is quit. @@ -247,7 +247,7 @@ Sessions, , emacs, The GNU Emacs Manual}. @vindex eww-desktop-remove-duplicates EWW history may sensibly contain multiple entries for the same page -URI. At run-time, these entries may still have different associated +URI@. At run-time, these entries may still have different associated point positions or the actual Web page contents. The latter, however, tend to be overly large to preserve in the desktop file, so they get omitted, thus rendering the respective diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi index d714656457f..ed4d1a58f79 100644 --- a/doc/misc/gnus.texi +++ b/doc/misc/gnus.texi @@ -11482,7 +11482,7 @@ who wrote the article, the date it was written and the subject of the article. That's well and nice, but there's also lots of information most people do not want to see---what systems the article has passed through before reaching you, the @code{Message-ID}, the -@code{References}, etc. ad nauseam---and you'll probably want to get rid +@code{References}, etc.@: ad nauseam---and you'll probably want to get rid of some of those lines. If you want to keep all those lines in the article buffer, you can set @code{gnus-show-all-headers} to @code{t}. @@ -25905,7 +25905,7 @@ Store custom flags and keywords The registry can store custom flags and keywords for a message. For instance, you can mark a message ``To-Do'' this way and the flag will persist whether the message is in the nnimap, nnml, nnmaildir, -etc. backends. +etc.@: backends. @item Store arbitrary data @@ -25988,7 +25988,7 @@ registry will be pruned back to less than @code{gnus-registry-max-entries}. This option controls exactly how much less: the target is calculated as the maximum number of entries minus the maximum number times this factor. The default is 0.1: -i.e. if your registry is limited to 50000 entries, pruning will try to +i.e., if your registry is limited to 50000 entries, pruning will try to cut back to 45000 entries. Entries with keys marked as precious will not be pruned. @end defvar diff --git a/doc/misc/htmlfontify.texi b/doc/misc/htmlfontify.texi index 630b5f798a1..6579cd6c7d1 100644 --- a/doc/misc/htmlfontify.texi +++ b/doc/misc/htmlfontify.texi @@ -839,7 +839,7 @@ See @ref{hfy-display-class} for details of valid values for @var{class}. (hfy-face-at P) @end lisp -Find face in effect at point P. If overlays are to be considered +Find face in effect at point P@. If overlays are to be considered (see @ref{hfy-optimisations}) then this may return a @code{defface} style list of face properties instead of a face symbol. @@ -1418,7 +1418,7 @@ Add @samp{
} tags around the fontified body. a page with different colors than the fontified code.) @item keep-overlays -Preserve overlay highlighting (c.f. @code{ediff} or @code{goo-font-lock}) +Preserve overlay highlighting (cf.@: @code{ediff} or @code{goo-font-lock}) as well as basic faces. Can result in extremely verbose highlighting if there are many overlays (as is the case with @code{goo-font-lock}). diff --git a/doc/misc/idlwave.texi b/doc/misc/idlwave.texi index 1858a51dd81..7cf9673add5 100644 --- a/doc/misc/idlwave.texi +++ b/doc/misc/idlwave.texi @@ -1010,7 +1010,7 @@ Non-@code{nil} means use last match on line for @cindex Highlighting of syntax @cindex Font lock -Highlighting of keywords, comments, strings etc. can be accomplished +Highlighting of keywords, comments, strings etc.@: can be accomplished with @code{font-lock}. If you are using @code{global-font-lock-mode} (in Emacs), or have @code{font-lock} turned on in any other buffer in XEmacs, it should also automatically work in IDLWAVE buffers. If you'd @@ -3111,7 +3111,7 @@ window, but is useful for immediate stepping, etc. @kindex C-c C-d C-p Do you find yourself repeatedly typing, e.g., @code{print,n_elements(x)}, and similar statements to remind yourself of the -type/size/structure/value/etc. of variables and expressions in your code +type/size/structure/value/etc.@: of variables and expressions in your code or at the command line? IDLWAVE has a suite of special commands to automate these types of variable or expression examinations. They work by sending statements to the shell formatted to include the indicated diff --git a/doc/misc/ido.texi b/doc/misc/ido.texi index 25380c08bef..a80620f681f 100644 --- a/doc/misc/ido.texi +++ b/doc/misc/ido.texi @@ -305,7 +305,7 @@ the files in that directory, simply move the directory to the head of the list and hit @key{RET}. To go up to the parent directory, delete any partial file name already -specified (e.g. using @key{DEL}) and hit @key{DEL}. +specified (e.g., using @key{DEL}) and hit @key{DEL}. @c @deffn Command ido-delete-backward-updir diff --git a/doc/misc/newsticker.texi b/doc/misc/newsticker.texi index a9ebc203e31..aa1ad72e382 100644 --- a/doc/misc/newsticker.texi +++ b/doc/misc/newsticker.texi @@ -123,7 +123,7 @@ You may select any number of feeds from this list of (sample) news feeds. @vindex newsticker-url-list @item newsticker-url-list All your personal news feeds are defined here. Each feed is -identified by its name and an URL. You may set the start-time and the +identified by its name and an URL@. You may set the start-time and the retrieval interval for each feed as well as the retrieval command arguments in case that the default values do not fit a certain feed. diff --git a/doc/misc/org.texi b/doc/misc/org.texi index 2cb80abb0db..d2721f6e35e 100644 --- a/doc/misc/org.texi +++ b/doc/misc/org.texi @@ -891,7 +891,7 @@ Recent Emacs distributions include a packaging system which lets you install Elisp libraries. You can install Org with @kbd{M-x package-install RET org}. @noindent @b{Important}: you need to do this in a session where no @code{.org} file has -been visited, i.e. where no Org built-in function have been loaded. +been visited, i.e., where no Org built-in function have been loaded. Otherwise autoload Org functions will mess up the installation. Then, to make sure your Org configuration is taken into account, initialize @@ -10444,7 +10444,7 @@ You can change the default state of this option by setting @item C-v Toggle visible-only export. Only export the text that is currently -visible, i.e. not hidden by outline visibility in the buffer. +visible, i.e., not hidden by outline visibility in the buffer. @end table @@ -12103,7 +12103,7 @@ Internet-style links for all other links. A link with no description and destined to a regular (un-itemized) outline heading is replaced with a cross-reference and section number of the heading. -A @samp{\ref@{label@}}-style reference to an image, table etc. is replaced +A @samp{\ref@{label@}}-style reference to an image, table etc.@: is replaced with a cross-reference and sequence number of the labeled entity. @xref{Labels and captions in ODT export}. @@ -13410,7 +13410,7 @@ from it (e.g., @code{beamer}). This is obviously the most powerful customization, since the changes happen at the parser level. Indeed, some export back-ends are built as extensions -of other ones (e.g. Markdown back-end an extension of HTML back-end). +of other ones (e.g., Markdown back-end an extension of HTML back-end). Extending a back-end means that if an element type is not transcoded by the new back-end, it will be handled by the original one. Hence you can extend diff --git a/doc/misc/pgg.texi b/doc/misc/pgg.texi index 4518de41415..a46c0fb8b4a 100644 --- a/doc/misc/pgg.texi +++ b/doc/misc/pgg.texi @@ -82,7 +82,7 @@ communication. Even though Mailcrypt has similar feature, it does not deal with detached PGP messages, normally used in PGP/MIME infrastructure. This was the main reason why I wrote the new library. -Note that the PGG library is now obsolete, replaced by EasyPG. +Note that the PGG library is now obsolete, replaced by EasyPG@. @xref{Top,, EasyPG, epa, EasyPG Assistant User's Manual}. PGP/MIME is an application of MIME Object Security Services (RFC1848). diff --git a/doc/misc/reftex.texi b/doc/misc/reftex.texi index facfb4376db..1497b1f5f1d 100644 --- a/doc/misc/reftex.texi +++ b/doc/misc/reftex.texi @@ -608,7 +608,7 @@ Show calling point in another window. This is the point from where @item < Promote the current section. This will convert @code{\section} to -@code{\chapter}, @code{\subsection} to @code{\section} etc. If there is +@code{\chapter}, @code{\subsection} to @code{\section} etc. If there is an active region, all sections in the region will be promoted, including the one at point. To avoid mistakes, @RefTeX{} requires a fresh document scan before executing this command; if necessary, it will @@ -1567,7 +1567,7 @@ Here is the setup: @cindex @code{linguex}, LaTeX package @cindex LaTeX packages, @code{linguex} A more complex example is the @file{linguex.sty} package which defines -list macros @samp{\ex.}, @samp{\a.}, @samp{\b.} etc. for lists which are +list macros @samp{\ex.}, @samp{\a.}, @samp{\b.} etc.@: for lists which are terminated by @samp{\z.} or by an empty line. @example @@ -5906,7 +5906,7 @@ When no BibTeX database files are specified, citations can also use @noindent @b{Version 3.11} @itemize @bullet @item -Fixed bug which led to naked label in (e.g.@:) footnotes. +Fixed bug which led to naked label in (e.g.)@: footnotes. @item Added scroll-other-window functions to RefTeX-Select. @end itemize diff --git a/doc/misc/todo-mode.texi b/doc/misc/todo-mode.texi index 6f684dea5d5..f58965cadab 100644 --- a/doc/misc/todo-mode.texi +++ b/doc/misc/todo-mode.texi @@ -1421,7 +1421,7 @@ Advance point to the next button. Put point on the previous button. @end table -These commands are cyclic, e.g. when point is on the last button, +These commands are cyclic, e.g., when point is on the last button, pressing @kbd{n} moves it to the first button. Typing @kbd{q} exits Todo Categories mode, killing the buffer and returning @@ -1787,7 +1787,7 @@ current file: @item F h @itemx h Hide the item headers if visible, or show them if they are hidden. -With done items, only the done header (i.e. the done tag and date-time +With done items, only the done header (i.e., the done tag and date-time string inserted when the item was marked done) is hidden, the original date-time string is not. With filtered items, the category (or category-file) tag is not hidden. diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi index 5d02d909791..d9cb933cb6c 100644 --- a/doc/misc/tramp.texi +++ b/doc/misc/tramp.texi @@ -1001,7 +1001,7 @@ name. This special method uses the Android Debug Bridge for accessing Android devices. The Android Debug Bridge must be installed locally. Some GNU/Linux distributions offer it for installation, otherwise it -can be installed as part of the Android SDK. If the @command{adb} +can be installed as part of the Android SDK@. If the @command{adb} program is not found via the @env{PATH} environment variable, the variable @var{tramp-adb-program} must point to its absolute path. diff --git a/doc/misc/vhdl-mode.texi b/doc/misc/vhdl-mode.texi index 524a534c38d..777bb107772 100644 --- a/doc/misc/vhdl-mode.texi +++ b/doc/misc/vhdl-mode.texi @@ -159,7 +159,7 @@ the construct on that line. A @dfn{syntactic component} consists of a pair of information (in lisp parlance, a @emph{cons cell}), where the first part is a @dfn{syntactic symbol}, and the second part is a @dfn{relative buffer position}. Syntactic symbols describe elements of -VHDL code, e.g. @code{statement}, @code{comment}, @code{block-open}, +VHDL code, e.g., @code{statement}, @code{comment}, @code{block-open}, @code{block-close}, etc. @xref{Syntactic Symbols}, for a complete list of currently recognized syntactic symbols and their semantics. Also, the variable @code{vhdl-offsets-alist} contains the list of currently @@ -633,8 +633,8 @@ similar to what is allowed in @code{vhdl-offsets-alist}. When the file is visited, VHDL Mode will automatically institute these offsets using @code{vhdl-set-offset}. @xref{Customizing Indentation}. -Note that file style settings (i.e. @code{vhdl-file-style}) are applied -before file offset settings (i.e. @code{vhdl-file-offsets}). +Note that file style settings (i.e., @code{vhdl-file-style}) are applied +before file offset settings (i.e., @code{vhdl-file-offsets}). @node Advanced Customizations diff --git a/doc/misc/vip.texi b/doc/misc/vip.texi index 9a5255d43af..ebb14944e24 100644 --- a/doc/misc/vip.texi +++ b/doc/misc/vip.texi @@ -436,7 +436,7 @@ Jump to mark (and pop mark off the mark ring). @cindex region -Vi operators like @kbd{d}, @kbd{c} etc. are usually used in combination +Vi operators like @kbd{d}, @kbd{c} etc.@: are usually used in combination with motion commands. It is now possible to use current region as the argument to these operators. (A @dfn{region} is a part of buffer delimited by point and mark.) The key @kbd{r} is used for this purpose. diff --git a/doc/misc/viper.texi b/doc/misc/viper.texi index bea7f47edbb..0ccc6ac91d5 100644 --- a/doc/misc/viper.texi +++ b/doc/misc/viper.texi @@ -1224,7 +1224,7 @@ Facilities like this make Vi's @kbd{:ab} command obsolete. @cindex Ex style motion @cindex line editor motion -Viper can be set free from the line--limited movements in Vi, such as @kbd{l} +Viper can be set free from the line-limited movements in Vi, such as @kbd{l} refusing to move beyond the line, @key{ESC} moving one character back, etc. These derive from Ex, which is a line editor. If your Viper customization file contains diff --git a/doc/misc/woman.texi b/doc/misc/woman.texi index d199afcf99f..a25924919a5 100644 --- a/doc/misc/woman.texi +++ b/doc/misc/woman.texi @@ -1141,7 +1141,7 @@ headings. Default is @code{t}. [Heading emboldening is @emph{not} standard @code{man} behavior.] @item woman-ignore -A boolean value. If non-@code{nil} then unrecognized requests etc. are +A boolean value. If non-@code{nil} then unrecognized requests etc.@: are ignored. Default is @code{t}. This gives the standard @code{roff} behavior. If @code{nil} then they are left in the buffer, which may aid debugging. -- 2.39.2