; Fix cross-references in Texinfo manuals

11 files changed, 25 insertions, 24 deletions

diff --git a/doc/lispref/commands.texi b/doc/lispref/commands.texi
index 6b660bdf5ba..39514145a1e 100644
--- a/doc/lispref/commands.texi
+++ b/doc/lispref/commands.texi
@@ -184,7 +184,7 @@ occurs within the body, the form simply returns @code{nil} without
 even evaluating its argument.
 
 The @var{modes} list allows specifying which modes the command is
-meant to be used in.  @xref{Command Modes} for more details about
+meant to be used in.  @xref{Command Modes}, for more details about
 the effect of specifying @var{modes}, and when to use it.
 
 By convention, you should put the @code{interactive} form in the
diff --git a/doc/lispref/customize.texi b/doc/lispref/customize.texi
index 95fa77c73a3..d257bb3a462 100644
--- a/doc/lispref/customize.texi
+++ b/doc/lispref/customize.texi
@@ -1222,7 +1222,7 @@ Specify how to decide whether an inline value matches the type.  The
 corresponding value, @var{function}, should be a function that accepts
 two arguments, a widget and an inline value; it should return
 non-@code{nil} if the value is acceptable.  @xref{Splicing into
-Lists} for more information about inline values.
+Lists}, for more information about inline values.
 
 @item :validate @var{function}
 Specify a validation function for input.  @var{function} takes a
diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi
index da89a46d7bc..7470716a587 100644
--- a/doc/lispref/frames.texi
+++ b/doc/lispref/frames.texi
@@ -774,7 +774,7 @@ As a rule, the inner frame is subdivided into the frame's root window
 rule: A @dfn{minibuffer-less frame} contains a root window only and does
 not contain a minibuffer window.  A @dfn{minibuffer-only frame} contains
 only a minibuffer window which also serves as that frame's root window.
-@xref{Initial Parameters} for how to create such frame configurations.
+@xref{Initial Parameters}, for how to create such frame configurations.
 
 @item Text Area
 @cindex text area
diff --git a/doc/lispref/text.texi b/doc/lispref/text.texi
index 0e7fd17e7ed..91ebd6cf233 100644
--- a/doc/lispref/text.texi
+++ b/doc/lispref/text.texi
@@ -6020,7 +6020,7 @@ subclass, see @ref{Inheritance,Inheritance,,eieio}.).  Users of the
 application-building interface can then instantiate objects of this
 concrete class (using the @code{make-instance} function) and connect
 to JSONRPC endpoints using that strategy.  @xref{Process-based
-JSONRPC connections} for a built-in transport implementation.
+JSONRPC connections}, for a built-in transport implementation.
 
 This API has mandatory and optional parts.
 
diff --git a/doc/misc/calc.texi b/doc/misc/calc.texi
index 5fd3c6351de..d4fbcabc1f1 100644
--- a/doc/misc/calc.texi
+++ b/doc/misc/calc.texi
@@ -30811,7 +30811,7 @@ embedded in a @TeX{} or @LaTeX{} document its plain version will be
 invisible in the final printed copy.  Certain major modes have different
 delimiters to ensure that the ``plain'' version will be
 in a comment for those modes, also.
-@xref{Customizing Embedded Mode} to see how to change the ``plain''
+@xref{Customizing Embedded Mode}, to see how to change the ``plain''
 formula delimiters.
 
 There are several notations which Calc's parser for ``big''
@@ -35323,8 +35323,8 @@ also be reset by putting the appropriate lines in your .emacs file;
 
 Some of the customizable variables are regular expressions.  A regular
 expression is basically a pattern that Calc can search for.
-@xref{Regexp Search,, Regular Expression Search, emacs, The GNU Emacs Manual}
-to see how regular expressions work.
+@xref{Regexp Search,, Regular Expression Search, emacs, The GNU Emacs
+Manual}, to see how regular expressions work.
 
 @defvar calc-settings-file
 The variable @code{calc-settings-file} holds the file name in
diff --git a/doc/misc/cc-mode.texi b/doc/misc/cc-mode.texi
index 176087e20ca..f98a21743ac 100644
--- a/doc/misc/cc-mode.texi
+++ b/doc/misc/cc-mode.texi
@@ -1485,8 +1485,8 @@ Sometimes @ccmode{} inserts an auto-newline where you don't want one,
 such as after a @samp{@}} when you're about to type a @samp{;}.
 Hungry deletion can help here (@pxref{Hungry WS Deletion}), or you can
 activate an appropriate @dfn{clean-up}, which will remove the excess
-whitespace after you've typed the @samp{;}.  @xref{Clean-ups} for a
-full description.  See also @ref{Electric Keys} for a summary of
+whitespace after you've typed the @samp{;}.  @xref{Clean-ups}, for a
+full description.  See also @ref{Electric Keys}, for a summary of
 clean-ups listed by key.
 
 
@@ -2420,7 +2420,7 @@ Mode and Java Mode buffers, you could do it like this:
 @end group
 @end example
 
-@xref{CC Hooks} for more details on the use of @ccmode{} hooks.
+@xref{CC Hooks}, for more details on the use of @ccmode{} hooks.
 
 @item Styles
 A @ccmode{} @dfn{style} is a coherent collection of customizations
@@ -2438,7 +2438,7 @@ in your @file{.emacs} file:
                         (other . "free-group-style")))
 @end example
 
-@xref{Styles} for fuller details on using @ccmode{} styles and how
+@xref{Styles}, for fuller details on using @ccmode{} styles and how
 to create them.
 
 @item File Local Variable setting
@@ -3312,7 +3312,7 @@ different ways, depending on the character just typed:
 an alist.  This element specifies where to put newlines: this is any
 combination of before and after the brace or colon.  If no alist
 element is found, newlines are inserted both before and after a brace,
-but none are inserted around a colon.  @xref{Hanging Braces} and
+but none are inserted around a colon.  @xref{Hanging Braces}, and
 @ref{Hanging Colons}.
 
 @item Semicolons and Commas
diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi
index db477d90d70..8a497ebb228 100644
--- a/doc/misc/gnus.texi
+++ b/doc/misc/gnus.texi
@@ -18252,7 +18252,8 @@ inherited.
 This section describes a special mail back end called @code{nndiary},
 and its companion library @code{gnus-diary}.  It is ``special'' in the
 sense that it is not meant to be one of the standard alternatives for
-reading mail with Gnus.  @xref{Choosing a Mail Back End} for that.
+reading mail with Gnus.  (@xref{Choosing a Mail Back End}, for
+description of the standard mail back ends.)
 Instead, it is used to treat @emph{some} of your mails in a special way,
 namely, as event reminders.
 
diff --git a/doc/misc/htmlfontify.texi b/doc/misc/htmlfontify.texi
index d8c1534edec..5d51c2dd518 100644
--- a/doc/misc/htmlfontify.texi
+++ b/doc/misc/htmlfontify.texi
@@ -828,7 +828,7 @@ If @var{class} is @code{nil}, then you just get whatever
 @code{face-attr-construct} returns; i.e., the current specification in
 effect for @var{face}.
 
-@xref{hfy-display-class} for details of valid values for @var{class}.
+@xref{hfy-display-class}, for details of valid values for @var{class}.
 
 @item hfy-face-at
 @findex hfy-face-at
diff --git a/doc/misc/idlwave.texi b/doc/misc/idlwave.texi
index bc3dcf70db6..0e10e2078a4 100644
--- a/doc/misc/idlwave.texi
+++ b/doc/misc/idlwave.texi
@@ -2546,8 +2546,8 @@ commands:
 In addition to these standard @file{comint} commands,
 @code{idlwave-shell-mode} provides many of the same commands which
 simplify writing IDL code available in IDLWAVE buffers.  This includes
-abbreviations, online help, and completion.  @xref{Routine Info} and
-@ref{Online Help} and @ref{Completion} for more information on these
+abbreviations, online help, and completion.  @xref{Routine Info}, and
+@ref{Online Help}, and @ref{Completion}, for more information on these
 commands.
 
 @cindex Completion, in the shell
diff --git a/doc/misc/srecode.texi b/doc/misc/srecode.texi
index 68c03d5ed6a..8e075da8c07 100644
--- a/doc/misc/srecode.texi
+++ b/doc/misc/srecode.texi
@@ -121,7 +121,7 @@ or add
 into a language hook function to force it on (which is the default) or
 pass in @code{-1} to force it off.
 
-@xref{SRecode Minor Mode} for more on using the minor mode.
+@xref{SRecode Minor Mode}, for more on using the minor mode.
 
 Use the menu to insert templates into the current file.
 
@@ -238,7 +238,7 @@ template such as a function to be made specific, such as a function
 named foo.  The value of a variable can be one of three things; a
 string, a list of more dictionaries, or a special
 @code{srecode-dictionary-compound-value} object subclass.
-@xref{Variables} for more.
+@xref{Variables}, for more about this.
 
 @section Template Insertion
 The template insertion layer involves extensions to the basic template
@@ -590,7 +590,7 @@ the variable is an @EIEIO{} object, which is a subclass of
 @code{srecode-dictionary-compound-value}.
 
 New compound variables can only be setup from Lisp code.
-@xref{Compound Dictionary Values} for details on setting up compound
+@xref{Compound Dictionary Values}, for details on setting up compound
 variables from Lisp.
 
 @node Templates
diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi
index 31c7ad9c677..3fef196219d 100644
--- a/doc/misc/tramp.texi
+++ b/doc/misc/tramp.texi
@@ -854,7 +854,7 @@ as the @option{rsh} method.
 Instead of connecting to a remote host, @command{su} program allows
 editing as another user.  The host can be either @samp{localhost} or
 the host returned by the function @command{(system-name)}.
-@xref{Multi-hops} for an exception to this behavior.
+@xref{Multi-hops}, for an exception to this behavior.
 
 @cindex method @option{androidsu}
 @cindex @option{androidsu} method
@@ -907,7 +907,7 @@ This is an optional method, @pxref{Optional methods}.
 The @command{sg} program allows editing as different group.  The host
 can be either @samp{localhost} or the host returned by the function
 @command{(system-name)}.  The user name must be specified, but it
-denotes a group name.  @xref{Multi-hops} for an exception to this
+denotes a group name.  @xref{Multi-hops}, for an exception to this
 behavior.
 
 @cindex method @option{sshx}
@@ -1566,7 +1566,7 @@ remote file name, it is ignored.
 
 Access via @option{rclone} is slow.  If you have an alternative method
 for accessing the system storage, you should use it.
-@xref{GVFS-based methods} for example, methods @option{gdrive} and
+For example, see @ref{GVFS-based methods}, methods @option{gdrive} and
 @option{nextcloud}.
 
 @cindex method @option{sshfs}
@@ -2536,7 +2536,7 @@ connection information}.  If you want, for example, use
 
 This works only for connection methods which allow overriding the
 remote login shell, like @option{sshx} or @option{plink}.
-@xref{Inline methods} and @ref{External methods} for connection methods
+@xref{Inline methods}, and @ref{External methods}, for connection methods
 which support this.
 
 @vindex tramp-sh-extra-args
@@ -5446,7 +5446,7 @@ another value for @env{TERM}, change @code{tramp-terminal-type} and
 this line accordingly.
 
 Alternatively, you can set the remote login shell explicitly.
-@xref{Remote shell setup} for discussion of this technique,
+@xref{Remote shell setup}, for discussion of this technique,
 
 When using fish shell on remote hosts, disable fancy formatting by
 adding the following to @file{~/.config/fish/config.fish}: