1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2025-12-06 06:20:55 -08:00

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

This reverts commit e54b94c28c,
which prevented building Emacs on a number of my machine(s).
This commit is contained in:
Po Lu 2025-01-19 08:58:45 +08:00
parent e54b94c28c
commit 59167e2de8
18 changed files with 91 additions and 89 deletions

View file

@ -184,7 +184,7 @@ occurs within the body, the form simply returns @code{nil} without
even evaluating its argument. even evaluating its argument.
The @var{modes} list allows specifying which modes the command is 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. the effect of specifying @var{modes}, and when to use it.
By convention, you should put the @code{interactive} form in the By convention, you should put the @code{interactive} form in the

View file

@ -1221,7 +1221,7 @@ the value is acceptable.
Specify how to decide whether an inline value matches the type. The Specify how to decide whether an inline value matches the type. The
corresponding value, @var{function}, should be a function that accepts corresponding value, @var{function}, should be a function that accepts
two arguments, a widget and an inline value; it should return 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. Lists} for more information about inline values.
@item :validate @var{function} @item :validate @var{function}

View file

@ -85,8 +85,8 @@ start using it.
To debug a Lisp program with Edebug, you must first @dfn{instrument} 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 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 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). @kbd{C-u C-M-x} (@code{eval-defun} with a prefix argument). See
@xref{Instrumenting}, for alternative ways to instrument code. @ref{Instrumenting}, for alternative ways to instrument code.
Once a function is instrumented, any call to the function activates Once a function is instrumented, any call to the function activates
Edebug. Depending on which Edebug execution mode you have selected, Edebug. Depending on which Edebug execution mode you have selected,
@ -1369,8 +1369,8 @@ specifications and the backquote example.
@cindex preventing backtracking @cindex preventing backtracking
No argument is matched but backtracking through the gate is disabled No argument is matched but backtracking through the gate is disabled
while matching the remainder of the specifications at this level. This while matching the remainder of the specifications at this level. This
is primarily used to generate more specific syntax error messages. is primarily used to generate more specific syntax error messages. See
@xref{Backtracking}, for more details. Also see the @code{let} example. @ref{Backtracking}, for more details. Also see the @code{let} example.
@item &error @item &error
@code{&error} should be followed by a string, an error message, in the @code{&error} should be followed by a string, an error message, in the

View file

@ -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 rule: A @dfn{minibuffer-less frame} contains a root window only and does
not contain a minibuffer window. A @dfn{minibuffer-only frame} contains not contain a minibuffer window. A @dfn{minibuffer-only frame} contains
only a minibuffer window which also serves as that frame's root window. 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 @item Text Area
@cindex text area @cindex text area

View file

@ -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 low-level interface to operating system services, or because it needs
to run fast. Unlike functions defined in Lisp, primitives can be to run fast. Unlike functions defined in Lisp, primitives can be
modified or added only by changing the C sources and recompiling 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 @item special form
A primitive that is like a function but does not evaluate all of its 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 @table @code
@item apply @item apply
@xref{Calling Functions}. See @ref{Calling Functions}.
@item autoload @item autoload
@xref{Autoload}. See @ref{Autoload}.
@item call-interactively @item call-interactively
@xref{Interactive Call}. See @ref{Interactive Call}.
@item called-interactively-p @item called-interactively-p
@xref{Distinguish Interactive}. See @ref{Distinguish Interactive}.
@item commandp @item commandp
@xref{Interactive Call}. See @ref{Interactive Call}.
@item documentation @item documentation
@xref{Accessing Documentation}. See @ref{Accessing Documentation}.
@item eval @item eval
@xref{Eval}. See @ref{Eval}.
@item funcall @item funcall
@xref{Calling Functions}. See @ref{Calling Functions}.
@item function @item function
@xref{Anonymous Functions}. See @ref{Anonymous Functions}.
@item ignore @item ignore
@xref{Calling Functions}. See @ref{Calling Functions}.
@item indirect-function @item indirect-function
@xref{Function Indirection}. See @ref{Function Indirection}.
@item interactive @item interactive
@xref{Using Interactive}. See @ref{Using Interactive}.
@item interactive-p @item interactive-p
@xref{Distinguish Interactive}. See @ref{Distinguish Interactive}.
@item mapatoms @item mapatoms
@xref{Creating Symbols}. See @ref{Creating Symbols}.
@item mapcar @item mapcar
@xref{Mapping Functions}. See @ref{Mapping Functions}.
@item map-char-table @item map-char-table
@xref{Char-Tables}. See @ref{Char-Tables}.
@item mapconcat @item mapconcat
@xref{Mapping Functions}. See @ref{Mapping Functions}.
@item undefined @item undefined
@xref{Functions for Key Lookup}. See @ref{Functions for Key Lookup}.
@end table @end table

View file

@ -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 minor modes so that they don't interfere with each other. If you do
this properly, the order will not matter. this properly, the order will not matter.
@xref{Keymaps and Minor Modes}, for more information about minor modes. See @ref{Keymaps and Minor Modes}, for more information about minor
See also @code{minor-mode-key-binding} (@pxref{Functions for Key modes. See also @code{minor-mode-key-binding} (@pxref{Functions for Key
Lookup}). Lookup}).
@end defvar @end defvar
@ -1204,7 +1204,7 @@ and @var{command} is its binding. @xref{What Is a Function}.
@cindex string in keymap @cindex string in keymap
The array (either a string or a vector) is a keyboard macro. The events 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 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} @item @var{keymap}
@cindex keymap in keymap @cindex keymap in keymap

View file

@ -1890,7 +1890,7 @@ The function to add prefixes and suffixes to completions.
@end table @end table
@noindent @noindent
@xref{Programmed Completion}, for a complete list of metadata entries. See @ref{Programmed Completion}, for a complete list of metadata entries.
@end defopt @end defopt
@defvar completion-extra-properties @defvar completion-extra-properties

View file

@ -2518,7 +2518,8 @@ idleness. Here's an example:
@cindex terminal input @cindex terminal input
This section describes functions and variables for recording or 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 @menu
* Input Modes:: Options for how input is processed. * Input Modes:: Options for how input is processed.

View file

@ -6019,7 +6019,7 @@ a different underlying transport strategy (for details on how to
subclass, see @ref{Inheritance,Inheritance,,eieio}.). Users of the subclass, see @ref{Inheritance,Inheritance,,eieio}.). Users of the
application-building interface can then instantiate objects of this application-building interface can then instantiate objects of this
concrete class (using the @code{make-instance} function) and connect 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. JSONRPC connections} for a built-in transport implementation.
This API has mandatory and optional parts. This API has mandatory and optional parts.

View file

@ -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 invisible in the final printed copy. Certain major modes have different
delimiters to ensure that the ``plain'' version will be delimiters to ensure that the ``plain'' version will be
in a comment for those modes, also. 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. formula delimiters.
There are several notations which Calc's parser for ``big'' 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 Some of the customizable variables are regular expressions. A regular
expression is basically a pattern that Calc can search for. 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. to see how regular expressions work.
@defvar calc-settings-file @defvar calc-settings-file
@ -35341,7 +35341,7 @@ value will be @code{"~/.calc.el"}.
@end defvar @end defvar
@defvar calc-gnuplot-name @defvar calc-gnuplot-name
@xref{Graphics}.@* See @ref{Graphics}.@*
The variable @code{calc-gnuplot-name} should be the name of the The variable @code{calc-gnuplot-name} should be the name of the
GNUPLOT program (a string). If you have GNUPLOT installed on your 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 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 @defvar calc-gnuplot-plot-command
@defvarx calc-gnuplot-print-command @defvarx calc-gnuplot-print-command
@xref{Devices, ,Graphical Devices}.@* See @ref{Devices, ,Graphical Devices}.@*
The variables @code{calc-gnuplot-plot-command} and The variables @code{calc-gnuplot-plot-command} and
@code{calc-gnuplot-print-command} represent system commands to @code{calc-gnuplot-print-command} represent system commands to
display and print the output of GNUPLOT, respectively. These may be 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 @end defvar
@defvar calc-language-alist @defvar calc-language-alist
@xref{Basic Embedded Mode}.@* See @ref{Basic Embedded Mode}.@*
The variable @code{calc-language-alist} controls the languages that The variable @code{calc-language-alist} controls the languages that
Calc will associate with major modes. When Calc embedded mode is Calc will associate with major modes. When Calc embedded mode is
enabled, it will try to use the current major mode to 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 @defvar calc-embedded-announce-formula
@defvarx calc-embedded-announce-formula-alist @defvarx calc-embedded-announce-formula-alist
@xref{Customizing Embedded Mode}.@* See @ref{Customizing Embedded Mode}.@*
The variable @code{calc-embedded-announce-formula} helps determine The variable @code{calc-embedded-announce-formula} helps determine
what formulas @kbd{C-x * a} will activate in a buffer. It is a what formulas @kbd{C-x * a} will activate in a buffer. It is a
regular expression, and when activating embedded formulas with 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 @defvar calc-embedded-open-formula
@defvarx calc-embedded-close-formula @defvarx calc-embedded-close-formula
@defvarx calc-embedded-open-close-formula-alist @defvarx calc-embedded-open-close-formula-alist
@xref{Customizing Embedded Mode}.@* See @ref{Customizing Embedded Mode}.@*
The variables @code{calc-embedded-open-formula} and The variables @code{calc-embedded-open-formula} and
@code{calc-embedded-close-formula} control the region that Calc will @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}. 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 @defvar calc-embedded-word-regexp
@defvarx calc-embedded-word-regexp-alist @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 The variable @code{calc-embedded-word-regexp} determines the expression
that Calc will activate when Embedded mode is entered with @kbd{C-x * that Calc will activate when Embedded mode is entered with @kbd{C-x *
w}. It is a regular expressions. 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 @defvar calc-embedded-open-plain
@defvarx calc-embedded-close-plain @defvarx calc-embedded-close-plain
@defvarx calc-embedded-open-close-plain-alist @defvarx calc-embedded-open-close-plain-alist
@xref{Customizing Embedded Mode}.@* See @ref{Customizing Embedded Mode}.@*
The variables @code{calc-embedded-open-plain} and The variables @code{calc-embedded-open-plain} and
@code{calc-embedded-open-plain} are used to delimit ``plain'' @code{calc-embedded-open-plain} are used to delimit ``plain''
formulas. Note that these are actual strings, not regular 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 @defvar calc-embedded-open-new-formula
@defvarx calc-embedded-close-new-formula @defvarx calc-embedded-close-new-formula
@defvarx calc-embedded-open-close-new-formula-alist @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 The variables @code{calc-embedded-open-new-formula} and
@code{calc-embedded-close-new-formula} are strings which are @code{calc-embedded-close-new-formula} are strings which are
inserted before and after a new formula when you type @kbd{C-x * f}. 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 @defvar calc-embedded-open-mode
@defvarx calc-embedded-close-mode @defvarx calc-embedded-close-mode
@defvarx calc-embedded-open-close-mode-alist @defvarx calc-embedded-open-close-mode-alist
@xref{Customizing Embedded Mode}.@* See @ref{Customizing Embedded Mode}.@*
The variables @code{calc-embedded-open-mode} and The variables @code{calc-embedded-open-mode} and
@code{calc-embedded-close-mode} are strings which Calc will place before @code{calc-embedded-close-mode} are strings which Calc will place before
and after any mode annotations that it inserts. Calc never scans for 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 @defvar calc-lu-power-reference
@defvarx calc-lu-field-reference @defvarx calc-lu-field-reference
@xref{Logarithmic Units}.@* See @ref{Logarithmic Units}.@*
The variables @code{calc-lu-power-reference} and The variables @code{calc-lu-power-reference} and
@code{calc-lu-field-reference} are unit expressions (written as @code{calc-lu-field-reference} are unit expressions (written as
strings) which Calc will use as reference quantities for logarithmic 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 @end defvar
@defvar calc-note-threshold @defvar calc-note-threshold
@xref{Musical Notes}.@* See @ref{Musical Notes}.@*
The variable @code{calc-note-threshold} is a number (written as a The variable @code{calc-note-threshold} is a number (written as a
string) which determines how close (in cents) a frequency needs to be string) which determines how close (in cents) a frequency needs to be
to a note to be recognized as that note. 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 @defvar calc-highlight-selections-with-faces
@defvarx calc-selected-face @defvarx calc-selected-face
@defvarx calc-nonselected-face @defvarx calc-nonselected-face
@xref{Displaying Selections}.@* See @ref{Displaying Selections}.@*
The variable @code{calc-highlight-selections-with-faces} The variable @code{calc-highlight-selections-with-faces}
determines how selected sub-formulas are distinguished. determines how selected sub-formulas are distinguished.
If @code{calc-highlight-selections-with-faces} is @code{nil}, then 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 @end defvar
@defvar calc-gregorian-switch @defvar calc-gregorian-switch
@xref{Date Forms}.@* See @ref{Date Forms}.@*
The variable @code{calc-gregorian-switch} is either a list of integers The variable @code{calc-gregorian-switch} is either a list of integers
@code{(@var{YEAR} @var{MONTH} @var{DAY})} or @code{nil}. @code{(@var{YEAR} @var{MONTH} @var{DAY})} or @code{nil}.
If it is @code{nil}, then Calc's date forms always represent Gregorian dates. If it is @code{nil}, then Calc's date forms always represent Gregorian dates.

View file

@ -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 These functions are analogous to the Emacs built-in commands
@code{beginning-of-defun} and @code{end-of-defun}, except they @code{beginning-of-defun} and @code{end-of-defun}, except they
eliminate the constraint that the top-level opening brace of the defun 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. @emacsmantitle{}}, for more information.
@item @kbd{C-M-a} (AWK Mode) (@code{c-awk-beginning-of-defun}) @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{;}. 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 Hungry deletion can help here (@pxref{Hungry WS Deletion}), or you can
activate an appropriate @dfn{clean-up}, which will remove the excess 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 full description. See also @ref{Electric Keys} for a summary of
clean-ups listed by key. clean-ups listed by key.
@ -2420,7 +2420,7 @@ Mode and Java Mode buffers, you could do it like this:
@end group @end group
@end example @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 @item Styles
A @ccmode{} @dfn{style} is a coherent collection of customizations A @ccmode{} @dfn{style} is a coherent collection of customizations
@ -2438,7 +2438,7 @@ in your @file{.emacs} file:
(other . "free-group-style"))) (other . "free-group-style")))
@end example @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. to create them.
@item File Local Variable setting @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 an alist. This element specifies where to put newlines: this is any
combination of before and after the brace or colon. If no alist combination of before and after the brace or colon. If no alist
element is found, newlines are inserted both before and after a brace, 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}. @ref{Hanging Colons}.
@item Semicolons and Commas @item Semicolons and Commas

View file

@ -18252,7 +18252,7 @@ inherited.
This section describes a special mail back end called @code{nndiary}, This section describes a special mail back end called @code{nndiary},
and its companion library @code{gnus-diary}. It is ``special'' in the 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 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, Instead, it is used to treat @emph{some} of your mails in a special way,
namely, as event reminders. namely, as event reminders.

View file

@ -141,7 +141,7 @@ and hyperlinks as appropriate.
(htmlfontify-run-etags @var{srcdir}) (htmlfontify-run-etags @var{srcdir})
@end lisp @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 @item htmlfontify-copy-and-link-dir
@findex 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 @code{face-attr-construct} returns; i.e., the current specification in
effect for @var{face}. 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 @item hfy-face-at
@findex 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. 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 @item hfy-tags-rmap
@vindex hfy-tags-rmap @vindex hfy-tags-rmap

View file

@ -2546,7 +2546,7 @@ commands:
In addition to these standard @file{comint} commands, In addition to these standard @file{comint} commands,
@code{idlwave-shell-mode} provides many of the same commands which @code{idlwave-shell-mode} provides many of the same commands which
simplify writing IDL code available in IDLWAVE buffers. This includes 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 @ref{Online Help} and @ref{Completion} for more information on these
commands. commands.

View file

@ -121,7 +121,7 @@ or add
into a language hook function to force it on (which is the default) or into a language hook function to force it on (which is the default) or
pass in @code{-1} to force it off. 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. 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 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 name as core templates. You can force your templates to override the
core templates for a particular major mode by setting 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 To get going quickly, open a new @file{.srt} file. It will start in
the @srecode{} template writing mode. Use the @srecode{} minor mode 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 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 named foo. The value of a variable can be one of three things; a
string, a list of more dictionaries, or a special string, a list of more dictionaries, or a special
@code{srecode-dictionary-compound-value} object subclass. @code{srecode-dictionary-compound-value} object subclass. See
@xref{Variables} for more. @ref{Variables} for more.
@section Template Insertion @section Template Insertion
The template insertion layer involves extensions to the basic template 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 the variable is an @EIEIO{} object, which is a subclass of
@code{srecode-dictionary-compound-value}. @code{srecode-dictionary-compound-value}.
New compound variables can only be setup from Lisp code. New compound variables can only be setup from Lisp code. See
@xref{Compound Dictionary Values} for details on setting up compound @ref{Compound Dictionary Values} for details on setting up compound
variables from Lisp. variables from Lisp.
@node Templates @node Templates
@ -707,7 +707,7 @@ major mode.
Template macros occur in the template text. The default escape Template macros occur in the template text. The default escape
characters are ``@{@{`` and ``@}@}'', though they can be changed 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: Thus, if you have the template code that looks like this:

View file

@ -853,8 +853,8 @@ as the @option{rsh} method.
Instead of connecting to a remote host, @command{su} program allows Instead of connecting to a remote host, @command{su} program allows
editing as another user. The host can be either @samp{localhost} or editing as another user. The host can be either @samp{localhost} or
the host returned by the function @command{(system-name)}. the host returned by the function @command{(system-name)}. See
@xref{Multi-hops} for an exception to this behavior. @ref{Multi-hops} for an exception to this behavior.
@cindex method @option{androidsu} @cindex method @option{androidsu}
@cindex @option{androidsu} method @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 The @command{sg} program allows editing as different group. The host
can be either @samp{localhost} or the host returned by the function can be either @samp{localhost} or the host returned by the function
@command{(system-name)}. The user name must be specified, but it @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. behavior.
@cindex method @option{sshx} @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 Access via @option{rclone} is slow. If you have an alternative method
for accessing the system storage, you should use it. 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}. @option{nextcloud}.
@cindex method @option{sshfs} @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 The temporary directory on the remote host. If not specified, the
default value is @t{"/data/local/tmp"} for the @option{adb} method, default value is @t{"/data/local/tmp"} for the @option{adb} method,
@t{"/C$/Temp"} for the @option{smb} method, and @t{"/tmp"} otherwise. @t{"/C$/Temp"} for the @option{smb} method, and @t{"/tmp"} otherwise.
@xref{Temporary directory}. @ref{Temporary directory}.
@item @t{"posix"} @item @t{"posix"}
@ -2535,8 +2535,8 @@ connection information}. If you want, for example, use
@end lisp @end lisp
This works only for connection methods which allow overriding the This works only for connection methods which allow overriding the
remote login shell, like @option{sshx} or @option{plink}. remote login shell, like @option{sshx} or @option{plink}. See
@xref{Inline methods} and @ref{External methods} for connection methods @ref{Inline methods} and @ref{External methods} for connection methods
which support this. which support this.
@vindex tramp-sh-extra-args @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 another value for @env{TERM}, change @code{tramp-terminal-type} and
this line accordingly. this line accordingly.
Alternatively, you can set the remote login shell explicitly. Alternatively, you can set the remote login shell explicitly. See
@xref{Remote shell setup} for discussion of this technique, @ref{Remote shell setup} for discussion of this technique,
When using fish shell on remote hosts, disable fancy formatting by When using fish shell on remote hosts, disable fancy formatting by
adding the following to @file{~/.config/fish/config.fish}: adding the following to @file{~/.config/fish/config.fish}:

View file

@ -789,7 +789,7 @@ used to draw the line.
This user option may be overridden if @code{:mode-line-format} is passed This user option may be overridden if @code{:mode-line-format} is passed
when creating a new prefix with @code{transient-define-prefix}. 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 @end defopt
@defopt transient-semantic-coloring @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 history not only on a global level (``this command was invoked using
these arguments, and previously it was invoked using those other these arguments, and previously it was invoked using those other
arguments''), but also remembers the values of individual arguments 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 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 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 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 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. 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 Transient ships with support for a few different types of specialized
infix commands. A command that sets a command line option, for example, 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. 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 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 @node Defining Suffix and Infix Commands
@section 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 @item
The behavior for non-suffixes can be set for a particular prefix, 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 by the prefix's @code{transient-non-suffix} slot to a boolean, a suitable
pre-command function, or a shorthand for such a function. pre-command function, or a shorthand for such a function. See
@xref{Pre-commands for Non-Suffixes}. @ref{Pre-commands for Non-Suffixes}.
@item @item
The common behavior for the suffixes of a particular prefix can be 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} @code{transient-suffix}, @code{transient-non-suffix} and @code{transient-switch-frame}
play a part when determining whether the currently active transient play a part when determining whether the currently active transient
prefix command remains active/transient when a suffix or arbitrary 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 @item
@code{refresh-suffixes} Normally suffix objects and keymaps are only setup @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, By default these predicates run when the prefix command is invoked,
but this can be changes, using the @code{refresh-suffixes} prefix slot. 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 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 the slots documented above, it is a predicate, but it is used for a

View file

@ -446,8 +446,8 @@ matching the empty string, for which the default action is to return
@section Example @section Example
@cindex grammar example @cindex grammar example
Here is an example to parse simple infix arithmetic expressions. Here is an example to parse simple infix arithmetic expressions. See
@xref{Infix Calc, , , bison}, in the Bison manual for details. @ref{Infix Calc, , , bison}, in the Bison manual for details.
@lisp @lisp
@group @group
@ -570,7 +570,7 @@ must be @dfn{LALR(1)}.
@cindex look-ahead token @cindex look-ahead token
A grammar is @acronym{LALR(1)} if it is possible to tell how to parse 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: 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. bison}, in the Bison manual for more information.
@cindex grammar compilation @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 Such conflicts are resolved by choosing to shift, unless otherwise
directed by operator precedence declarations. 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. information.
@cindex reduce/reduce conflicts @cindex reduce/reduce conflicts
@ -654,8 +654,8 @@ grammar.
Such conflicts are resolved by choosing to use the rule that appears 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 first in the grammar, but it is very risky to rely on this. Every
reduce/reduce conflict must be studied and usually eliminated. reduce/reduce conflict must be studied and usually eliminated. See
@xref{Reduce/Reduce , , , bison}, in the Bison manual for more @ref{Reduce/Reduce , , , bison}, in the Bison manual for more
information. information.
@end table @end table
@ -701,7 +701,7 @@ reports are separated from each other by a line like this:
@end example @end example
where @var{source-file} is the name of the Emacs Lisp file from which 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. details on the verbose report.
@table @strong @table @strong
@ -1312,7 +1312,7 @@ value of the variable @code{wisent-recovering} is non-@code{nil}.
@cindex error recovery @cindex error recovery
The error recovery mechanism of the Wisent's parser conforms to the 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. manual for details.
@cindex error token @cindex error token