[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
master 2a314666e48 1/2: Revert "Revert "Use @xref more consistently; "S
|
From: |
Eli Zaretskii |
|
Subject: |
master 2a314666e48 1/2: Revert "Revert "Use @xref more consistently; "See @ref" -> "@xref""" |
|
Date: |
Sun, 19 Jan 2025 01:24:03 -0500 (EST) |
branch: master
commit 2a314666e4800639a81ff6562395c3d38cb97e7b
Author: Eli Zaretskii <eliz@gnu.org>
Commit: Eli Zaretskii <eliz@gnu.org>
Revert "Revert "Use @xref more consistently; "See @ref" -> "@xref"""
This reverts commit 59167e2de8a93341cd235d83e034c00be32403f6.
TRT to use reference in Texinfo is to place some punctuation
character after a reference. This is common both to @ref and
to @xref. So this is what should be done to fix the changeset,
not to revert it.
---
doc/lispref/commands.texi | 2 +-
doc/lispref/customize.texi | 2 +-
doc/lispref/edebug.texi | 8 ++++----
doc/lispref/frames.texi | 3 +--
doc/lispref/functions.texi | 38 +++++++++++++++++++-------------------
doc/lispref/keymaps.texi | 6 +++---
doc/lispref/minibuf.texi | 2 +-
doc/lispref/os.texi | 3 +--
doc/lispref/text.texi | 2 +-
doc/misc/calc.texi | 30 +++++++++++++++---------------
doc/misc/cc-mode.texi | 10 +++++-----
doc/misc/gnus.texi | 2 +-
doc/misc/htmlfontify.texi | 6 +++---
doc/misc/idlwave.texi | 2 +-
doc/misc/srecode.texi | 14 +++++++-------
doc/misc/tramp.texi | 18 +++++++++---------
doc/misc/transient.texi | 16 ++++++++--------
doc/misc/wisent.texi | 16 ++++++++--------
18 files changed, 89 insertions(+), 91 deletions(-)
diff --git a/doc/lispref/commands.texi b/doc/lispref/commands.texi
index 9fe8b4b9e21..6b660bdf5ba 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. See @ref{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 09c05fa18c6..95fa77c73a3 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. See @ref{Splicing into
+non-@code{nil} if the value is acceptable. @xref{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 0effe48e9a3..e234db6fce5 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). See
-@ref{Instrumenting}, for alternative ways to instrument code.
+@kbd{C-u C-M-x} (@code{eval-defun} with a prefix argument).
+@xref{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. See
-@ref{Backtracking}, for more details. Also see the @code{let} example.
+is primarily used to generate more specific syntax error messages.
+@xref{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 a0d0e489ad0..da89a46d7bc 100644
--- a/doc/lispref/frames.texi
+++ b/doc/lispref/frames.texi
@@ -774,8 +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.
-See @ref{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/functions.texi b/doc/lispref/functions.texi
index 2b5847d2f64..7f881bae7f5 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. See @ref{Writing Emacs Primitives}.
+Emacs. @xref{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
-See @ref{Calling Functions}.
+@xref{Calling Functions}.
@item autoload
-See @ref{Autoload}.
+@xref{Autoload}.
@item call-interactively
-See @ref{Interactive Call}.
+@xref{Interactive Call}.
@item called-interactively-p
-See @ref{Distinguish Interactive}.
+@xref{Distinguish Interactive}.
@item commandp
-See @ref{Interactive Call}.
+@xref{Interactive Call}.
@item documentation
-See @ref{Accessing Documentation}.
+@xref{Accessing Documentation}.
@item eval
-See @ref{Eval}.
+@xref{Eval}.
@item funcall
-See @ref{Calling Functions}.
+@xref{Calling Functions}.
@item function
-See @ref{Anonymous Functions}.
+@xref{Anonymous Functions}.
@item ignore
-See @ref{Calling Functions}.
+@xref{Calling Functions}.
@item indirect-function
-See @ref{Function Indirection}.
+@xref{Function Indirection}.
@item interactive
-See @ref{Using Interactive}.
+@xref{Using Interactive}.
@item interactive-p
-See @ref{Distinguish Interactive}.
+@xref{Distinguish Interactive}.
@item mapatoms
-See @ref{Creating Symbols}.
+@xref{Creating Symbols}.
@item mapcar
-See @ref{Mapping Functions}.
+@xref{Mapping Functions}.
@item map-char-table
-See @ref{Char-Tables}.
+@xref{Char-Tables}.
@item mapconcat
-See @ref{Mapping Functions}.
+@xref{Mapping Functions}.
@item undefined
-See @ref{Functions for Key Lookup}.
+@xref{Functions for Key Lookup}.
@end table
diff --git a/doc/lispref/keymaps.texi b/doc/lispref/keymaps.texi
index 7095942d7b2..eaba29a33e3 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.
-See @ref{Keymaps and Minor Modes}, for more information about minor
-modes. See also @code{minor-mode-key-binding} (@pxref{Functions for Key
+@xref{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. See @ref{Keyboard Macros}, for more information.
+binding. @xref{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 d8e7e6c2e76..ecd34b95294 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
-See @ref{Programmed Completion}, for a complete list of metadata entries.
+@xref{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 31ae373f6f3..9b92093f629 100644
--- a/doc/lispref/os.texi
+++ b/doc/lispref/os.texi
@@ -2518,8 +2518,7 @@ idleness. Here's an example:
@cindex terminal input
This section describes functions and variables for recording or
-manipulating terminal input. See @ref{Display}, for related
-functions.
+manipulating terminal input. @xref{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 2d24436d214..0e7fd17e7ed 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. See @ref{Process-based
+to JSONRPC endpoints using that strategy. @xref{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 0635ab7ac05..5fd3c6351de 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.
-See @ref{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,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.
-See @ref{Regexp Search,, Regular Expression Search, emacs, The GNU Emacs
Manual}
+@xref{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
-See @ref{Graphics}.@*
+@xref{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
-See @ref{Devices, ,Graphical Devices}.@*
+@xref{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
-See @ref{Basic Embedded Mode}.@*
+@xref{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
-See @ref{Customizing Embedded Mode}.@*
+@xref{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
-See @ref{Customizing Embedded Mode}.@*
+@xref{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
-See @ref{Customizing Embedded Mode}.@*
+@xref{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
-See @ref{Customizing Embedded Mode}.@*
+@xref{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
-See @ref{Customizing Embedded Mode}.@*
+@xref{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
-See @ref{Customizing Embedded Mode}.@*
+@xref{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
-See @ref{Logarithmic Units}.@*
+@xref{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
-See @ref{Musical Notes}.@*
+@xref{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
-See @ref{Displaying Selections}.@*
+@xref{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
-See @ref{Date Forms}.@*
+@xref{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 b46eb80055a..176087e20ca 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. See @ref{Defuns,,,@emacsman{},
+must be in column zero. @xref{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{;}. See @ref{Clean-ups} for a
+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
-See @ref{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
-See @ref{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. See @ref{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 41ec75a5ed2..db477d90d70 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. See @ref{Choosing a Mail Back End} for that.
+reading mail with Gnus. @xref{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 fd9b9435123..d8c1534edec 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}. See @ref{hfy-load-tags-cache}.
+Load the etags cache for @var{srcdir}. @xref{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}.
-See @ref{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
@@ -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.
-See @ref{hfy-load-tags-cache}.
+@xref{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 0db01faf3d1..bc3dcf70db6 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. See @ref{Routine Info} and
+abbreviations, online help, and completion. @xref{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 e8c0958c252..68c03d5ed6a 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.
-See @ref{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.
@@ -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. See @ref{Special Variables}.
+priority. @xref{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. See
-@ref{Variables} for more.
+@code{srecode-dictionary-compound-value} object subclass.
+@xref{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. See
-@ref{Compound Dictionary Values} for details on setting up compound
+New compound variables can only be setup from Lisp code.
+@xref{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. See @ref{Variables}.
+in the top-level variables. @xref{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 45ecf18b06e..31c7ad9c677 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)}. See
-@ref{Multi-hops} for an exception to this behavior.
+the host returned by the function @command{(system-name)}.
+@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. See @ref{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.
-@ref{GVFS-based methods} for example, methods @option{gdrive} and
+@xref{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.
-@ref{Temporary directory}.
+@xref{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}. See
-@ref{Inline methods} and @ref{External methods} for connection methods
+remote login shell, like @option{sshx} or @option{plink}.
+@xref{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. See
-@ref{Remote shell setup} for discussion of this technique,
+Alternatively, you can set the remote login shell explicitly.
+@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}:
diff --git a/doc/misc/transient.texi b/doc/misc/transient.texi
index 2f2e4cf7edd..fb8b6da145c 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. See @ref{Mode Line
Format,,,elisp,}, for details.
+Otherwise this can be any mode-line format. @xref{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. See @ref{Using History}.
+independently. @xref{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.
-See @ref{Enabling and Disabling Suffixes}.
+@xref{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. See @ref{Suffix Slots}.
+argument supported by the constructor of that class. @xref{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. See
-@ref{Pre-commands for Non-Suffixes}.
+pre-command function, or a shorthand for such a function.
+@xref{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. See @ref{Transient State}.
+non-suffix command is invoked. @xref{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.
-See @ref{Prefix Slots}.
+@xref{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 a92f61fd6c7..6c700779ba7 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. See
-@ref{Infix Calc, , , bison}, in the Bison manual for details.
+Here is an example to parse simple infix arithmetic expressions.
+@xref{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}. See @ref{Language and Grammar, , ,
+the @dfn{look-ahead token}. @xref{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.
-See @ref{Shift/Reduce , , , bison}, in the Bison manual for more
+@xref{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. See
-@ref{Reduce/Reduce , , , bison}, in the Bison manual for more
+reduce/reduce conflict must be studied and usually eliminated.
+@xref{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. See @ref{Understanding the automaton}, for
+the grammar was read. @xref{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. See @ref{Error Recovery, , , bison}, in the Bison
+one Bison uses. @xref{Error Recovery, , , bison}, in the Bison
manual for details.
@cindex error token