even evaluating its argument.
The @var{modes} list allows specifying which modes the command is
-meant to be used in. @xref{Command Modes} for more details about
+meant to be used in. @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
corresponding value, @var{function}, should be a function that accepts
two arguments, a widget and an inline value; it should return
non-@code{nil} if the value is acceptable. @xref{Splicing into
-Lists} for more information about inline values.
+Lists}, for more information about inline values.
@item :validate @var{function}
Specify a validation function for input. @var{function} takes a
rule: A @dfn{minibuffer-less frame} contains a root window only and does
not contain a minibuffer window. A @dfn{minibuffer-only frame} contains
only a minibuffer window which also serves as that frame's root window.
-@xref{Initial Parameters} for how to create such frame configurations.
+@xref{Initial Parameters}, for how to create such frame configurations.
@item Text Area
@cindex text area
application-building interface can then instantiate objects of this
concrete class (using the @code{make-instance} function) and connect
to JSONRPC endpoints using that strategy. @xref{Process-based
-JSONRPC connections} for a built-in transport implementation.
+JSONRPC connections}, for a built-in transport implementation.
This API has mandatory and optional parts.
invisible in the final printed copy. Certain major modes have different
delimiters to ensure that the ``plain'' version will be
in a comment for those modes, also.
-@xref{Customizing Embedded Mode} to see how to change the ``plain''
+@xref{Customizing Embedded Mode}, to see how to change the ``plain''
formula delimiters.
There are several notations which Calc's parser for ``big''
Some of the customizable variables are regular expressions. A regular
expression is basically a pattern that Calc can search for.
-@xref{Regexp Search,, Regular Expression Search, emacs, The GNU Emacs Manual}
-to see how regular expressions work.
+@xref{Regexp Search,, Regular Expression Search, emacs, The GNU Emacs
+Manual}, to see how regular expressions work.
@defvar calc-settings-file
The variable @code{calc-settings-file} holds the file name in
such as after a @samp{@}} when you're about to type a @samp{;}.
Hungry deletion can help here (@pxref{Hungry WS Deletion}), or you can
activate an appropriate @dfn{clean-up}, which will remove the excess
-whitespace after you've typed the @samp{;}. @xref{Clean-ups} for a
-full description. See also @ref{Electric Keys} for a summary of
+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.
@end group
@end example
-@xref{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
(other . "free-group-style")))
@end example
-@xref{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
an alist. This element specifies where to put newlines: this is any
combination of before and after the brace or colon. If no alist
element is found, newlines are inserted both before and after a brace,
-but none are inserted around a colon. @xref{Hanging Braces} and
+but none are inserted around a colon. @xref{Hanging Braces}, and
@ref{Hanging Colons}.
@item Semicolons and Commas
This section describes a special mail back end called @code{nndiary},
and its companion library @code{gnus-diary}. It is ``special'' in the
sense that it is not meant to be one of the standard alternatives for
-reading mail with Gnus. @xref{Choosing a Mail Back End} for that.
+reading mail with Gnus. (@xref{Choosing a Mail Back End}, for
+description of the standard mail back ends.)
Instead, it is used to treat @emph{some} of your mails in a special way,
namely, as event reminders.
@code{face-attr-construct} returns; i.e., the current specification in
effect for @var{face}.
-@xref{hfy-display-class} for details of valid values for @var{class}.
+@xref{hfy-display-class}, for details of valid values for @var{class}.
@item hfy-face-at
@findex hfy-face-at
Instead of connecting to a remote host, @command{su} program allows
editing as another user. The host can be either @samp{localhost} or
the host returned by the function @command{(system-name)}.
-@xref{Multi-hops} for an exception to this behavior.
+@xref{Multi-hops}, for an exception to this behavior.
@cindex method @option{androidsu}
@cindex @option{androidsu} method
The @command{sg} program allows editing as different group. The host
can be either @samp{localhost} or the host returned by the function
@command{(system-name)}. The user name must be specified, but it
-denotes a group name. @xref{Multi-hops} for an exception to this
+denotes a group name. @xref{Multi-hops}, for an exception to this
behavior.
@cindex method @option{sshx}
Access via @option{rclone} is slow. If you have an alternative method
for accessing the system storage, you should use it.
-@xref{GVFS-based methods} for example, methods @option{gdrive} and
+For example, see @ref{GVFS-based methods}, methods @option{gdrive} and
@option{nextcloud}.
@cindex method @option{sshfs}
This works only for connection methods which allow overriding the
remote login shell, like @option{sshx} or @option{plink}.
-@xref{Inline methods} and @ref{External methods} for connection methods
+@xref{Inline methods}, and @ref{External methods}, for connection methods
which support this.
@vindex tramp-sh-extra-args
this line accordingly.
Alternatively, you can set the remote login shell explicitly.
-@xref{Remote shell setup} for discussion of this technique,
+@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}:
projects / emacs.git / commitdiff