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):
This commit is contained in:
Stefan Kangas
parent
2c7b08c60a
commit
e54b94c28c
18 changed files with 89 additions and 91 deletions
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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}
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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.
|
||||
|
|
|
|||
|
|
@ -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.
|
||||
|
|
|
|||
|
|
@ -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.
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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.
|
||||
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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.
|
||||
|
||||
|
|
|
|||
|
|
@ -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:
|
||||
|
||||
|
|
|
|||
|
|
@ -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}:
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue