Revert "Use @xref more consistently; "See @ref" -> "@xref""

This reverts commit e54b94c28cdf9699009e7691f7c8ffa5b2c7b741,
which prevented building Emacs on a number of my machine(s).

18 files changed, 91 insertions, 89 deletions

diff --git a/doc/lispref/commands.texi b/doc/lispref/commands.texi
index 6b660bdf5ba..9fe8b4b9e21 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.  See @ref{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..09c05fa18c6 100644
--- a/doc/lispref/customize.texi
+++ b/doc/lispref/customize.texi
@@ -1221,7 +1221,7 @@ the value is acceptable.
 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
+non-@code{nil} if the value is acceptable.  See @ref{Splicing into
 Lists} for more information about inline values.
 
 @item :validate @var{function}
diff --git a/doc/lispref/edebug.texi b/doc/lispref/edebug.texi
index e234db6fce5..0effe48e9a3 100644
--- a/doc/lispref/edebug.texi
+++ b/doc/lispref/edebug.texi
@@ -85,8 +85,8 @@ start using it.
   To debug a Lisp program with Edebug, you must first @dfn{instrument}
 the Lisp code that you want to debug.  A simple way to do this is to
 first move point into the definition of a function or macro and then do
-@kbd{C-u C-M-x} (@code{eval-defun} with a prefix argument).
-@xref{Instrumenting}, for alternative ways to instrument code.
+@kbd{C-u C-M-x} (@code{eval-defun} with a prefix argument).  See
+@ref{Instrumenting}, for alternative ways to instrument code.
 
   Once a function is instrumented, any call to the function activates
 Edebug.  Depending on which Edebug execution mode you have selected,
@@ -1369,8 +1369,8 @@ specifications and the backquote example.
 @cindex preventing backtracking
 No argument is matched but backtracking through the gate is disabled
 while matching the remainder of the specifications at this level.  This
-is primarily used to generate more specific syntax error messages.
-@xref{Backtracking}, for more details.  Also see the @code{let} example.
+is primarily used to generate more specific syntax error messages.  See
+@ref{Backtracking}, for more details.  Also see the @code{let} example.
 
 @item &error
 @code{&error} should be followed by a string, an error message, in the
diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi
index da89a46d7bc..a0d0e489ad0 100644
--- a/doc/lispref/frames.texi
+++ b/doc/lispref/frames.texi
@@ -774,7 +774,8 @@ 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.
+See @ref{Initial Parameters} for how to create such frame
+configurations.
 
 @item Text Area
 @cindex text area
diff --git a/doc/lispref/functions.texi b/doc/lispref/functions.texi
index 7f881bae7f5..2b5847d2f64 100644
--- a/doc/lispref/functions.texi
+++ b/doc/lispref/functions.texi
@@ -90,7 +90,7 @@ fundamental part of Lisp (e.g., @code{car}), or because it provides a
 low-level interface to operating system services, or because it needs
 to run fast.  Unlike functions defined in Lisp, primitives can be
 modified or added only by changing the C sources and recompiling
-Emacs.  @xref{Writing Emacs Primitives}.
+Emacs.  See @ref{Writing Emacs Primitives}.
 
 @item special form
 A primitive that is like a function but does not evaluate all of its
@@ -2976,56 +2976,56 @@ elsewhere, but we provide cross references here.
 
 @table @code
 @item apply
-@xref{Calling Functions}.
+See @ref{Calling Functions}.
 
 @item autoload
-@xref{Autoload}.
+See @ref{Autoload}.
 
 @item call-interactively
-@xref{Interactive Call}.
+See @ref{Interactive Call}.
 
 @item called-interactively-p
-@xref{Distinguish Interactive}.
+See @ref{Distinguish Interactive}.
 
 @item commandp
-@xref{Interactive Call}.
+See @ref{Interactive Call}.
 
 @item documentation
-@xref{Accessing Documentation}.
+See @ref{Accessing Documentation}.
 
 @item eval
-@xref{Eval}.
+See @ref{Eval}.
 
 @item funcall
-@xref{Calling Functions}.
+See @ref{Calling Functions}.
 
 @item function
-@xref{Anonymous Functions}.
+See @ref{Anonymous Functions}.
 
 @item ignore
-@xref{Calling Functions}.
+See @ref{Calling Functions}.
 
 @item indirect-function
-@xref{Function Indirection}.
+See @ref{Function Indirection}.
 
 @item interactive
-@xref{Using Interactive}.
+See @ref{Using Interactive}.
 
 @item interactive-p
-@xref{Distinguish Interactive}.
+See @ref{Distinguish Interactive}.
 
 @item mapatoms
-@xref{Creating Symbols}.
+See @ref{Creating Symbols}.
 
 @item mapcar
-@xref{Mapping Functions}.
+See @ref{Mapping Functions}.
 
 @item map-char-table
-@xref{Char-Tables}.
+See @ref{Char-Tables}.
 
 @item mapconcat
-@xref{Mapping Functions}.
+See @ref{Mapping Functions}.
 
 @item undefined
-@xref{Functions for Key Lookup}.
+See @ref{Functions for Key Lookup}.
 @end table
diff --git a/doc/lispref/keymaps.texi b/doc/lispref/keymaps.texi
index eaba29a33e3..7095942d7b2 100644
--- a/doc/lispref/keymaps.texi
+++ b/doc/lispref/keymaps.texi
@@ -1046,8 +1046,8 @@ When more than one minor mode keymap is active, the earlier one in
 minor modes so that they don't interfere with each other.  If you do
 this properly, the order will not matter.
 
-@xref{Keymaps and Minor Modes}, for more information about minor modes.
-See also @code{minor-mode-key-binding} (@pxref{Functions for Key
+See @ref{Keymaps and Minor Modes}, for more information about minor
+modes.  See also @code{minor-mode-key-binding} (@pxref{Functions for Key
 Lookup}).
 @end defvar
 
@@ -1204,7 +1204,7 @@ and @var{command} is its binding.  @xref{What Is a Function}.
 @cindex string in keymap
 The array (either a string or a vector) is a keyboard macro.  The events
 used so far in the lookup form a complete key, and the array is its
-binding.  @xref{Keyboard Macros}, for more information.
+binding.  See @ref{Keyboard Macros}, for more information.
 
 @item @var{keymap}
 @cindex keymap in keymap
diff --git a/doc/lispref/minibuf.texi b/doc/lispref/minibuf.texi
index ecd34b95294..d8e7e6c2e76 100644
--- a/doc/lispref/minibuf.texi
+++ b/doc/lispref/minibuf.texi
@@ -1890,7 +1890,7 @@ The function to add prefixes and suffixes to completions.
 @end table
 
 @noindent
-@xref{Programmed Completion}, for a complete list of metadata entries.
+See @ref{Programmed Completion}, for a complete list of metadata entries.
 @end defopt
 
 @defvar completion-extra-properties
diff --git a/doc/lispref/os.texi b/doc/lispref/os.texi
index 9b92093f629..31ae373f6f3 100644
--- a/doc/lispref/os.texi
+++ b/doc/lispref/os.texi
@@ -2518,7 +2518,8 @@ idleness.  Here's an example:
 @cindex terminal input
 
   This section describes functions and variables for recording or
-manipulating terminal input.  @xref{Display}, for related functions.
+manipulating terminal input.  See @ref{Display}, for related
+functions.
 
 @menu
 * Input Modes::         Options for how input is processed.
diff --git a/doc/lispref/text.texi b/doc/lispref/text.texi
index 0e7fd17e7ed..2d24436d214 100644
--- a/doc/lispref/text.texi
+++ b/doc/lispref/text.texi
@@ -6019,7 +6019,7 @@ a different underlying transport strategy (for details on how to
 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
+to JSONRPC endpoints using that strategy.  See @ref{Process-based
 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..0635ab7ac05 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''
+See @ref{Customizing Embedded Mode} to see how to change the ``plain''
 formula delimiters.
 
 There are several notations which Calc's parser for ``big''
@@ -35323,7 +35323,7 @@ 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}
+See @ref{Regexp Search,, Regular Expression Search, emacs, The GNU Emacs Manual}
 to see how regular expressions work.
 
 @defvar calc-settings-file
@@ -35341,7 +35341,7 @@ value will be @code{"~/.calc.el"}.
 @end defvar
 
 @defvar calc-gnuplot-name
-@xref{Graphics}.@*
+See @ref{Graphics}.@*
 The variable @code{calc-gnuplot-name} should be the name of the
 GNUPLOT program (a string).  If you have GNUPLOT installed on your
 system but Calc is unable to find it, you may need to set this
@@ -35352,7 +35352,7 @@ The default value of @code{calc-gnuplot-name} is @code{"gnuplot"}.
 
 @defvar  calc-gnuplot-plot-command
 @defvarx calc-gnuplot-print-command
-@xref{Devices, ,Graphical Devices}.@*
+See @ref{Devices, ,Graphical Devices}.@*
 The variables @code{calc-gnuplot-plot-command} and
 @code{calc-gnuplot-print-command} represent system commands to
 display and print the output of GNUPLOT, respectively.  These may be
@@ -35367,7 +35367,7 @@ and the default value of @code{calc-gnuplot-print-command} is
 @end defvar
 
 @defvar calc-language-alist
-@xref{Basic Embedded Mode}.@*
+See @ref{Basic Embedded Mode}.@*
 The variable @code{calc-language-alist} controls the languages that
 Calc will associate with major modes.  When Calc embedded mode is
 enabled, it will try to use the current major mode to
@@ -35396,7 +35396,7 @@ The default value of @code{calc-language-alist} is
 
 @defvar calc-embedded-announce-formula
 @defvarx calc-embedded-announce-formula-alist
-@xref{Customizing Embedded Mode}.@*
+See @ref{Customizing Embedded Mode}.@*
 The variable @code{calc-embedded-announce-formula} helps determine
 what formulas @kbd{C-x * a} will activate in a buffer.  It is a
 regular expression, and when activating embedded formulas with
@@ -35434,7 +35434,7 @@ and @code{calc-embedded-open-close-mode-alist}.
 @defvar  calc-embedded-open-formula
 @defvarx calc-embedded-close-formula
 @defvarx calc-embedded-open-close-formula-alist
-@xref{Customizing Embedded Mode}.@*
+See @ref{Customizing Embedded Mode}.@*
 The variables @code{calc-embedded-open-formula} and
 @code{calc-embedded-close-formula} control the region that Calc will
 activate as a formula when Embedded mode is entered with @kbd{C-x * e}.
@@ -35471,7 +35471,7 @@ It consists of a list of lists of the form
 
 @defvar  calc-embedded-word-regexp
 @defvarx calc-embedded-word-regexp-alist
-@xref{Customizing Embedded Mode}.@*
+See @ref{Customizing Embedded Mode}.@*
 The variable @code{calc-embedded-word-regexp} determines the expression
 that Calc will activate when Embedded mode is entered with @kbd{C-x *
 w}.  It is a regular expressions.
@@ -35490,7 +35490,7 @@ It consists of a list of lists of the form
 @defvar  calc-embedded-open-plain
 @defvarx calc-embedded-close-plain
 @defvarx calc-embedded-open-close-plain-alist
-@xref{Customizing Embedded Mode}.@*
+See @ref{Customizing Embedded Mode}.@*
 The variables @code{calc-embedded-open-plain} and
 @code{calc-embedded-open-plain} are used to delimit ``plain''
 formulas.  Note that these are actual strings, not regular
@@ -35531,7 +35531,7 @@ and @code{calc-embedded-open-close-mode-alist}.
 @defvar  calc-embedded-open-new-formula
 @defvarx calc-embedded-close-new-formula
 @defvarx calc-embedded-open-close-new-formula-alist
-@xref{Customizing Embedded Mode}.@*
+See @ref{Customizing Embedded Mode}.@*
 The variables @code{calc-embedded-open-new-formula} and
 @code{calc-embedded-close-new-formula} are strings which are
 inserted before and after a new formula when you type @kbd{C-x * f}.
@@ -35559,7 +35559,7 @@ It consists of a list of lists of the form
 @defvar  calc-embedded-open-mode
 @defvarx calc-embedded-close-mode
 @defvarx calc-embedded-open-close-mode-alist
-@xref{Customizing Embedded Mode}.@*
+See @ref{Customizing Embedded Mode}.@*
 The variables @code{calc-embedded-open-mode} and
 @code{calc-embedded-close-mode} are strings which Calc will place before
 and after any mode annotations that it inserts.  Calc never scans for
@@ -35600,7 +35600,7 @@ and @code{calc-embedded-open-close-plain-alist}.
 
 @defvar  calc-lu-power-reference
 @defvarx calc-lu-field-reference
-@xref{Logarithmic Units}.@*
+See @ref{Logarithmic Units}.@*
 The variables @code{calc-lu-power-reference} and
 @code{calc-lu-field-reference} are unit expressions (written as
 strings) which Calc will use as reference quantities for logarithmic
@@ -35612,7 +35612,7 @@ and the default value of @code{calc-lu-field-reference} is
 @end defvar
 
 @defvar calc-note-threshold
-@xref{Musical Notes}.@*
+See @ref{Musical Notes}.@*
 The variable @code{calc-note-threshold} is a number (written as a
 string) which determines how close (in cents) a frequency needs to be
 to a note to be recognized as that note.
@@ -35623,7 +35623,7 @@ The default value of @code{calc-note-threshold} is 1.
 @defvar calc-highlight-selections-with-faces
 @defvarx calc-selected-face
 @defvarx calc-nonselected-face
-@xref{Displaying Selections}.@*
+See @ref{Displaying Selections}.@*
 The variable @code{calc-highlight-selections-with-faces}
 determines how selected sub-formulas are distinguished.
 If @code{calc-highlight-selections-with-faces} is @code{nil}, then
@@ -35671,7 +35671,7 @@ be preserved.  The default value of @code{calc-undo-length} is @expr{100}.
 @end defvar
 
 @defvar calc-gregorian-switch
-@xref{Date Forms}.@*
+See @ref{Date Forms}.@*
 The variable @code{calc-gregorian-switch} is either a list of integers
 @code{(@var{YEAR} @var{MONTH} @var{DAY})} or @code{nil}.
 If it is @code{nil}, then Calc's date forms always represent Gregorian dates.
diff --git a/doc/misc/cc-mode.texi b/doc/misc/cc-mode.texi
index 176087e20ca..b46eb80055a 100644
--- a/doc/misc/cc-mode.texi
+++ b/doc/misc/cc-mode.texi
@@ -925,7 +925,7 @@ behavior prior to version 5.32.}, set @code{c-defun-tactic} to
 These functions are analogous to the Emacs built-in commands
 @code{beginning-of-defun} and @code{end-of-defun}, except they
 eliminate the constraint that the top-level opening brace of the defun
-must be in column zero.  @xref{Defuns,,,@emacsman{},
+must be in column zero.  See @ref{Defuns,,,@emacsman{},
 @emacsmantitle{}}, for more information.
 
 @item @kbd{C-M-a} (AWK Mode) (@code{c-awk-beginning-of-defun})
@@ -1485,7 +1485,7 @@ 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
+whitespace after you've typed the @samp{;}.  See @ref{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.
+See @ref{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
+See @ref{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.  See @ref{Hanging Braces} and
 @ref{Hanging Colons}.
 
 @item Semicolons and Commas
diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi
index db477d90d70..41ec75a5ed2 100644
--- a/doc/misc/gnus.texi
+++ b/doc/misc/gnus.texi
@@ -18252,7 +18252,7 @@ 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.  See @ref{Choosing a Mail Back End} for that.
 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..fd9b9435123 100644
--- a/doc/misc/htmlfontify.texi
+++ b/doc/misc/htmlfontify.texi
@@ -141,7 +141,7 @@ and hyperlinks as appropriate.
 (htmlfontify-run-etags @var{srcdir})
 @end lisp
 
-Load the etags cache for @var{srcdir}.  @xref{hfy-load-tags-cache}.
+Load the etags cache for @var{srcdir}.  See @ref{hfy-load-tags-cache}.
 
 @item htmlfontify-copy-and-link-dir
 @findex htmlfontify-copy-and-link-dir
@@ -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}.
+See @ref{hfy-display-class} for details of valid values for @var{class}.
 
 @item hfy-face-at
 @findex hfy-face-at
@@ -1069,7 +1069,7 @@ Each tag hash entry then contains entries of the form:
 
 i.e., an alist mapping (relative) file paths to line and character offsets.
 
-@xref{hfy-load-tags-cache}.
+See @ref{hfy-load-tags-cache}.
 
 @item hfy-tags-rmap
 @vindex hfy-tags-rmap
diff --git a/doc/misc/idlwave.texi b/doc/misc/idlwave.texi
index bc3dcf70db6..0db01faf3d1 100644
--- a/doc/misc/idlwave.texi
+++ b/doc/misc/idlwave.texi
@@ -2546,7 +2546,7 @@ 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
+abbreviations, online help, and completion.  See @ref{Routine Info} and
 @ref{Online Help} and @ref{Completion} for more information on these
 commands.
 
diff --git a/doc/misc/srecode.texi b/doc/misc/srecode.texi
index 68c03d5ed6a..e8c0958c252 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.
+See @ref{SRecode Minor Mode} for more on using the minor mode.
 
 Use the menu to insert templates into the current file.
 
@@ -169,7 +169,7 @@ Each template file you write is dedicated to a single major mode.  In
 it, you can write templates within the same context and with the same
 name as core templates.  You can force your templates to override the
 core templates for a particular major mode by setting the
-priority.  @xref{Special Variables}.
+priority.  See @ref{Special Variables}.
 
 To get going quickly, open a new @file{.srt} file.  It will start in
 the @srecode{} template writing mode.  Use the @srecode{} minor mode
@@ -237,8 +237,8 @@ used in macros in a template.  Variables are what allows a generic
 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.
+@code{srecode-dictionary-compound-value} object subclass.  See
+@ref{Variables} for more.
 
 @section Template Insertion
 The template insertion layer involves extensions to the basic template
@@ -589,8 +589,8 @@ A variable can also have a compound value.  This means the value of
 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
+New compound variables can only be setup from Lisp code.  See
+@ref{Compound Dictionary Values} for details on setting up compound
 variables from Lisp.
 
 @node Templates
@@ -707,7 +707,7 @@ major mode.
 
 Template macros occur in the template text.  The default escape
 characters are ``@{@{`` and ``@}@}'', though they can be changed
-in the top-level variables.  @xref{Variables}.
+in the top-level variables.  See @ref{Variables}.
 
 Thus, if you have the template code that looks like this:
 
diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi
index 31c7ad9c677..45ecf18b06e 100644
--- a/doc/misc/tramp.texi
+++ b/doc/misc/tramp.texi
@@ -853,8 +853,8 @@ 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.
+the host returned by the function @command{(system-name)}.  See
+@ref{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.  See @ref{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
+@ref{GVFS-based methods} for example, methods @option{gdrive} and
 @option{nextcloud}.
 
 @cindex method @option{sshfs}
@@ -2390,7 +2390,7 @@ to a remote home directory, like @option{adb}, @option{rclone} and
 The temporary directory on the remote host.  If not specified, the
 default value is @t{"/data/local/tmp"} for the @option{adb} method,
 @t{"/C$/Temp"} for the @option{smb} method, and @t{"/tmp"} otherwise.
-@xref{Temporary directory}.
+@ref{Temporary directory}.
 
 @item @t{"posix"}
 
@@ -2535,8 +2535,8 @@ connection information}.  If you want, for example, use
 @end lisp
 
 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
+remote login shell, like @option{sshx} or @option{plink}.  See
+@ref{Inline methods} and @ref{External methods} for connection methods
 which support this.
 
 @vindex tramp-sh-extra-args
@@ -5445,8 +5445,8 @@ as value of the @env{TERM} environment variable.  If you want to use
 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,
+Alternatively, you can set the remote login shell explicitly.  See
+@ref{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}:
diff --git a/doc/misc/transient.texi b/doc/misc/transient.texi
index fb8b6da145c..2f2e4cf7edd 100644
--- a/doc/misc/transient.texi
+++ b/doc/misc/transient.texi
@@ -789,7 +789,7 @@ used to draw the line.
 This user option may be overridden if @code{:mode-line-format} is passed
 when creating a new prefix with @code{transient-define-prefix}.
 
-Otherwise this can be any mode-line format.  @xref{Mode Line Format,,,elisp,}, for details.
+Otherwise this can be any mode-line format.  See @ref{Mode Line Format,,,elisp,}, for details.
 @end defopt
 
 @defopt transient-semantic-coloring
@@ -1089,14 +1089,14 @@ enabled.  One benefit of the Transient interface is that it remembers
 history not only on a global level (``this command was invoked using
 these arguments, and previously it was invoked using those other
 arguments''), but also remembers the values of individual arguments
-independently.  @xref{Using History}.
+independently.  See @ref{Using History}.
 
 After a transient prefix command is invoked, @kbd{C-h @var{KEY}} can be used to
 show the documentation for the infix or suffix command that @kbd{@var{KEY}} is
 bound to (see @ref{Getting Help for Suffix Commands}), and infixes and
 suffixes can be removed from the transient using @kbd{C-x l @var{KEY}}.  Infixes
 and suffixes that are disabled by default can be enabled the same way.
-@xref{Enabling and Disabling Suffixes}.
+See @ref{Enabling and Disabling Suffixes}.
 
 Transient ships with support for a few different types of specialized
 infix commands.  A command that sets a command line option, for example,
@@ -1444,7 +1444,7 @@ guessed based on the long argument.  If the argument ends with @samp{=}
 
 Finally, details can be specified using optional @var{KEYWORD}-@var{VALUE} pairs.
 Each keyword has to be a keyword symbol, either @code{:class} or a keyword
-argument supported by the constructor of that class.  @xref{Suffix Slots}.
+argument supported by the constructor of that class.  See @ref{Suffix Slots}.
 
 @node Defining Suffix and Infix Commands
 @section Defining Suffix and Infix Commands
@@ -1726,8 +1726,8 @@ means that all outer prefixes are exited at once.
 @item
 The behavior for non-suffixes can be set for a particular prefix,
 by the prefix's @code{transient-non-suffix} slot to a boolean, a suitable
-pre-command function, or a shorthand for such a function.
-@xref{Pre-commands for Non-Suffixes}.
+pre-command function, or a shorthand for such a function.  See
+@ref{Pre-commands for Non-Suffixes}.
 
 @item
 The common behavior for the suffixes of a particular prefix can be
@@ -2424,7 +2424,7 @@ secondary value, called a ``scope''.  See @code{transient-define-prefix}.
 @code{transient-suffix}, @code{transient-non-suffix} and @code{transient-switch-frame}
 play a part when determining whether the currently active transient
 prefix command remains active/transient when a suffix or arbitrary
-non-suffix command is invoked.  @xref{Transient State}.
+non-suffix command is invoked.  See @ref{Transient State}.
 
 @item
 @code{refresh-suffixes} Normally suffix objects and keymaps are only setup
@@ -2760,7 +2760,7 @@ currently cannot be invoked.
 
 By default these predicates run when the prefix command is invoked,
 but this can be changes, using the @code{refresh-suffixes} prefix slot.
-@xref{Prefix Slots}.
+See @ref{Prefix Slots}.
 
 One more slot is shared between group and suffix classes, @code{level}.  Like
 the slots documented above, it is a predicate, but it is used for a
diff --git a/doc/misc/wisent.texi b/doc/misc/wisent.texi
index 6c700779ba7..a92f61fd6c7 100644
--- a/doc/misc/wisent.texi
+++ b/doc/misc/wisent.texi
@@ -446,8 +446,8 @@ matching the empty string, for which the default action is to return
 @section Example
 
 @cindex grammar example
-Here is an example to parse simple infix arithmetic expressions.
-@xref{Infix Calc, , , bison}, in the Bison manual for details.
+Here is an example to parse simple infix arithmetic expressions.  See
+@ref{Infix Calc, , , bison}, in the Bison manual for details.
 
 @lisp
 @group
@@ -570,7 +570,7 @@ must be @dfn{LALR(1)}.
 @cindex look-ahead token
 A grammar is @acronym{LALR(1)} if it is possible to tell how to parse
 any portion of an input string with just a single token of look-ahead:
-the @dfn{look-ahead token}.  @xref{Language and Grammar, , ,
+the @dfn{look-ahead token}.  See @ref{Language and Grammar, , ,
 bison}, in the Bison manual for more information.
 
 @cindex grammar compilation
@@ -643,7 +643,7 @@ When either a shift or a reduction would be valid at the same state.
 
 Such conflicts are resolved by choosing to shift, unless otherwise
 directed by operator precedence declarations.
-@xref{Shift/Reduce , , , bison}, in the Bison manual for more
+See @ref{Shift/Reduce , , , bison}, in the Bison manual for more
 information.
 
 @cindex reduce/reduce conflicts
@@ -654,8 +654,8 @@ grammar.
 
 Such conflicts are resolved by choosing to use the rule that appears
 first in the grammar, but it is very risky to rely on this.  Every
-reduce/reduce conflict must be studied and usually eliminated.
-@xref{Reduce/Reduce , , , bison}, in the Bison manual for more
+reduce/reduce conflict must be studied and usually eliminated.  See
+@ref{Reduce/Reduce , , , bison}, in the Bison manual for more
 information.
 @end table
 
@@ -701,7 +701,7 @@ reports are separated from each other by a line like this:
 @end example
 
 where @var{source-file} is the name of the Emacs Lisp file from which
-the grammar was read.  @xref{Understanding the automaton}, for
+the grammar was read.  See @ref{Understanding the automaton}, for
 details on the verbose report.
 
 @table @strong
@@ -1312,7 +1312,7 @@ value of the variable @code{wisent-recovering} is non-@code{nil}.
 
 @cindex error recovery
 The error recovery mechanism of the Wisent's parser conforms to the
-one Bison uses.  @xref{Error Recovery, , , bison}, in the Bison
+one Bison uses.  See @ref{Error Recovery, , , bison}, in the Bison
 manual for details.
 
 @cindex error token