From: Eli Zaretskii Date: Sun, 19 Jan 2025 06:23:23 +0000 (+0200) Subject: ; Fix cross-references in Texinfo manuals X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=bbbd9280c88d6eb56e6069e6f0d6d1dc74e37907;p=emacs.git ; Fix cross-references in Texinfo manuals (cherry picked from commit 0f75a01acd3fe880da6884018565870ba800f30e) --- diff --git a/doc/lispref/commands.texi b/doc/lispref/commands.texi index 77502079185..97b9712f4a7 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. @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 diff --git a/doc/lispref/customize.texi b/doc/lispref/customize.texi index 95fa77c73a3..d257bb3a462 100644 --- a/doc/lispref/customize.texi +++ b/doc/lispref/customize.texi @@ -1222,7 +1222,7 @@ 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. @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 diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi index da89a46d7bc..7470716a587 100644 --- a/doc/lispref/frames.texi +++ b/doc/lispref/frames.texi @@ -774,7 +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. -@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 diff --git a/doc/lispref/text.texi b/doc/lispref/text.texi index c3adc78c267..a8713dbf923 100644 --- a/doc/lispref/text.texi +++ b/doc/lispref/text.texi @@ -6027,7 +6027,7 @@ 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. @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. diff --git a/doc/misc/calc.texi b/doc/misc/calc.texi index 5fd3c6351de..d4fbcabc1f1 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. -@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'' @@ -35323,8 +35323,8 @@ 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. -@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 diff --git a/doc/misc/cc-mode.texi b/doc/misc/cc-mode.texi index eebf575da86..3bcf7824ce2 100644 --- a/doc/misc/cc-mode.texi +++ b/doc/misc/cc-mode.texi @@ -1485,8 +1485,8 @@ 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{;}. @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. @@ -2420,7 +2420,7 @@ Mode and Java Mode buffers, you could do it like this: @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 @@ -2438,7 +2438,7 @@ in your @file{.emacs} file: (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 @@ -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. @xref{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 b6e1241f62a..2f9244b9413 100644 --- a/doc/misc/gnus.texi +++ b/doc/misc/gnus.texi @@ -18252,7 +18252,8 @@ 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. @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. diff --git a/doc/misc/htmlfontify.texi b/doc/misc/htmlfontify.texi index d8c1534edec..5d51c2dd518 100644 --- a/doc/misc/htmlfontify.texi +++ b/doc/misc/htmlfontify.texi @@ -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}. -@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 diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi index 30293d7ec26..74adea57d23 100644 --- a/doc/misc/tramp.texi +++ b/doc/misc/tramp.texi @@ -854,7 +854,7 @@ 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)}. -@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 @@ -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. @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} @@ -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. -@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} @@ -2526,7 +2526,7 @@ connection information}. If you want, for example, use 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 @@ -5436,7 +5436,7 @@ another value for @env{TERM}, change @code{tramp-terminal-type} and 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}: