mirrors/emacs
1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2025-12-22 13:40:44 -08:00
Code Issues Projects Releases Wiki Activity

Improve documentation of 'Info-hide-note-references' in info.texi

Browse source 
* doc/misc/info.texi (Help-Xref): Improve the wording.
(Emacs Info Variables): Update the documentation of
'Info-hide-note-references'.  (Bug#44043)
This commit is contained in:
Eli Zaretskii 2020-10-17 14:43:25 +03:00
parent 47b8a1c767
commit 18c0e20bea
1 changed files with 25 additions and 17 deletions
Download patch file Download diff file Expand all files Collapse all files

42
doc/misc/info.texi
View file

@ -798,17 +798,17 @@ in cross references and node names if it differs from the current
file, so you can always know that you are going to be switching to file, so you can always know that you are going to be switching to
another manual and which one. another manual and which one.
However, Emacs normally hides some other text in cross-references. Emacs normally hides some text in cross references. If you put your
If you put your mouse over the cross reference, then the information mouse over the cross reference, then the information appearing in a
appearing in a separate box (tool tip) or in the echo area will show separate box (tool tip) or in the echo area will show the full
the full cross-reference including the file name and the node name of cross reference, including the file name and the node name of the
the cross reference. If you have a mouse, just leave it over the cross reference if it leads to another file. If you have a mouse,
cross reference @xref{Top,, Overview of Texinfo, texinfo, Texinfo: just leave it over the next cross reference: @xref{Top,, Overview of
The GNU Documentation Format}, and watch what happens. If you Texinfo, texinfo, Texinfo: The GNU Documentation Format}, and watch
always like to have that information visible without having to move what happens. If you always like to have that information visible
your mouse over the cross reference, use @kbd{M-x visible-mode}, or without having to move your mouse over the cross reference, use
set @code{Info-hide-note-references} to a value other than @code{t} @kbd{M-x visible-mode}, or set @code{Info-hide-note-references} to a
(@pxref{Emacs Info Variables}). value other than @code{t} (@pxref{Emacs Info Variables}).
@format @format
>> Now type @kbd{n} to learn more commands. >> Now type @kbd{n} to learn more commands.
@ -1227,12 +1227,20 @@ not scroll with the rest of the buffer, making these links always
visible. visible.
@item Info-hide-note-references @item Info-hide-note-references
As explained in earlier nodes, the Emacs version of Info normally As explained in earlier sections, the Emacs version of Info normally
hides some text in menus and cross-references. You can completely hides some text in menus and cross references. It also replaces the
disable this feature, by setting this option to @code{nil}. Setting @samp{*note} prefix of each cross reference with a more grammatically
it to a value that is neither @code{nil} nor @code{t} produces an correct @samp{see}. This is the effect of the default value of this
intermediate behavior, hiding a limited amount of text, but showing option, @code{t}. Setting this option to @code{nil} disables both
all text that could potentially be useful. hiding and replacing of the original cross reference text, and Emacs
will then display them as they are in the Info file. If you set it to
the value @code{hide}, Emacs will do the same as with @code{t}, but
will also remove @samp{*note} without replacing it with anything.
Setting it to any other non-@code{nil} value produces an intermediate
behavior, hiding a limited amount of text, but showing all text that
could potentially be useful, including the name of the node that is
the target of the cross reference and its file if it is different from
the current file.
@item Info-scroll-prefer-subnodes @item Info-scroll-prefer-subnodes
If set to a non-@code{nil} value, @key{SPC} and @key{BACKSPACE} (or If set to a non-@code{nil} value, @key{SPC} and @key{BACKSPACE} (or