From 4315770a4750d32002e3a6c6b76a4288155ec4e2 Mon Sep 17 00:00:00 2001 From: Stefan Kangas Date: Sun, 19 Jan 2025 01:34:44 +0100 Subject: [PATCH] Use @xref more consistently; "See @ref" -> "@xref" * doc/lispref/commands.texi (Using Interactive): * doc/lispref/customize.texi (Type Keywords): * doc/lispref/edebug.texi (Using Edebug, Specification List): * doc/lispref/frames.texi (Frame Layout): * doc/lispref/functions.texi (What Is a Function, Related Topics): * doc/lispref/keymaps.texi (Controlling Active Maps, Key Lookup): * doc/lispref/minibuf.texi (Completion Variables): * doc/lispref/os.texi (Terminal Input): * doc/lispref/text.texi (JSONRPC Overview): * doc/misc/calc.texi (More About Embedded Mode, Customizing Calc): * doc/misc/cc-mode.texi (Movement Commands, Auto-newlines) (Config Basics, Custom Auto-newlines): * doc/misc/gnus.texi (Email Based Diary): * doc/misc/htmlfontify.texi (Interactive, Non-interactive): (Variables): * doc/misc/idlwave.texi (Using the Shell): * doc/misc/srecode.texi (Quick Start, User Templates) (Parts of SRecode, Compound Variable Values, Template Macros): * doc/misc/tramp.texi (Inline methods, FUSE-based methods) (Predefined connection information, Remote shell setup) (Frequently Asked Questions): * doc/misc/transient.texi (Configuration, Technical Introduction): (Binding Suffix and Infix Commands, Transient State): (Prefix Slots, Predicate Slots): * doc/misc/wisent.texi (Example, Compiling a grammar, Conflicts): (Grammar Debugging, Error recovery): (cherry picked from commit e54b94c28cdf9699009e7691f7c8ffa5b2c7b741) --- 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/tramp.texi | 18 +++++++++--------- doc/misc/transient.texi | 16 ++++++++-------- 15 files changed, 73 insertions(+), 75 deletions(-) diff --git a/doc/lispref/commands.texi b/doc/lispref/commands.texi index b7f7035c1ad..77502079185 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 772ffd8a136..d5c549eb404 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 aea6f330966..c10b6709db5 100644 --- a/doc/lispref/minibuf.texi +++ b/doc/lispref/minibuf.texi @@ -1883,7 +1883,7 @@ Function that reads and returns a completions predicate. @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-local-styles diff --git a/doc/lispref/os.texi b/doc/lispref/os.texi index 94268b142df..e28b150ad73 100644 --- a/doc/lispref/os.texi +++ b/doc/lispref/os.texi @@ -2503,8 +2503,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 cf76463c148..c3adc78c267 100644 --- a/doc/lispref/text.texi +++ b/doc/lispref/text.texi @@ -6026,7 +6026,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 6751dd8f6fa..eebf575da86 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 1e7894c42d4..b6e1241f62a 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/tramp.texi b/doc/misc/tramp.texi index 61686bf1c5e..30293d7ec26 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} @@ -1556,7 +1556,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} @@ -2380,7 +2380,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"} @@ -2525,8 +2525,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 @@ -5435,8 +5435,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 -- 2.39.5