aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--man/info.texi61
1 files changed, 29 insertions, 32 deletions
diff --git a/man/info.texi b/man/info.texi
index 532478ca521..ce8bc6a2bf4 100644
--- a/man/info.texi
+++ b/man/info.texi
@@ -92,8 +92,8 @@ Started' chapter.
92This first part of this Info manual describes how to get around inside 92This first part of this Info manual describes how to get around inside
93of Info. The second part of the manual describes various advanced 93of Info. The second part of the manual describes various advanced
94Info commands. The third part briefly explains how to generate Info 94Info commands. The third part briefly explains how to generate Info
95files from Texinfo files, and describes how to write an Info as 95files from Texinfo files, and describes how to write an Info file
96distinct from a Texinfo file. 96by hand.
97 97
98@ifnotinfo 98@ifnotinfo
99This manual is primarily designed for browsing with an Info reader 99This manual is primarily designed for browsing with an Info reader
@@ -954,7 +954,7 @@ by @key{RET} will do. The file's nodes are scanned in the order
954they are in the file, which has no necessary relationship to the 954they are in the file, which has no necessary relationship to the
955order that they may be in the tree structure of menus and @samp{next} 955order that they may be in the tree structure of menus and @samp{next}
956pointers. But normally the two orders are not very different. In any 956pointers. But normally the two orders are not very different. In any
957case, you can always look at the echo area to find out what node you have 957case, you can always look at the mode line to find out what node you have
958reached, if the header is not visible (this can happen, because @kbd{s} 958reached, if the header is not visible (this can happen, because @kbd{s}
959puts your cursor at the occurrence of the string, not at the beginning 959puts your cursor at the occurrence of the string, not at the beginning
960of the node). 960of the node).
@@ -982,8 +982,8 @@ if the variable @code{Info-isearch-search} is non-@code{nil}
982@cindex searching Info indices 982@cindex searching Info indices
983@kindex i @r{(Info mode)} 983@kindex i @r{(Info mode)}
984@findex Info-index 984@findex Info-index
985 Since most subjects related to what the manual describes should be 985 Since most topics in the manual should be indexed, you should try
986indexed, you should try the index search first. The @kbd{i} command 986the index search first before the text search. The @kbd{i} command
987prompts you for a subject and then looks up that subject in the 987prompts you for a subject and then looks up that subject in the
988indices. If it finds an index entry with the subject you typed, it 988indices. If it finds an index entry with the subject you typed, it
989goes to the node to which that index entry points. You should browse 989goes to the node to which that index entry points. You should browse
@@ -991,13 +991,13 @@ through that node to see whether the issue you are looking for is
991described there. If it isn't, type @kbd{,} one or more times to go 991described there. If it isn't, type @kbd{,} one or more times to go
992through additional index entries which match your subject. 992through additional index entries which match your subject.
993 993
994 The @kbd{i} command finds all index entries which include the string 994 The @kbd{i} command and subsequent @kbd{,} commands find all index
995you typed @emph{as a substring}. For each match, Info shows in the 995entries which include the string you typed @emph{as a substring}.
996echo area the full index entry it found. Often, the text of the full 996For each match, Info shows in the echo area the full index entry it
997index entry already gives you enough information to decide whether it 997found. Often, the text of the full index entry already gives you
998is relevant to what you are looking for, so we recommend that you read 998enough information to decide whether it is relevant to what you are
999what Info shows in the echo area before looking at the node it 999looking for, so we recommend that you read what Info shows in the echo
1000displays. 1000area before looking at the node it displays.
1001 1001
1002 Since @kbd{i} looks for a substring, you can search for subjects even 1002 Since @kbd{i} looks for a substring, you can search for subjects even
1003if you are not sure how they are spelled in the index. For example, 1003if you are not sure how they are spelled in the index. For example,
@@ -1010,20 +1010,18 @@ to catch index entries that refer to ``complete'', ``completion'', and
1010options, and key sequences that the program provides. If you are 1010options, and key sequences that the program provides. If you are
1011looking for a description of a command, an option, or a key, just type 1011looking for a description of a command, an option, or a key, just type
1012their names when @kbd{i} prompts you for a topic. For example, if you 1012their names when @kbd{i} prompts you for a topic. For example, if you
1013want to read the description of what the @kbd{C-f} key does, type 1013want to read the description of what the @kbd{C-l} key does, type
1014@kbd{i C - f @key{RET}}. Here @kbd{C-f} are 3 literal characters 1014@kbd{iC-l@key{RET}} literally.
1015@samp{C}, @samp{-}, and @samp{f}, not the ``Control-f'' command key
1016you type inside Emacs to run the command bound to @kbd{C-f}.
1017 1015
1018 In Emacs, @kbd{i} runs the command @code{Info-index}. 1016 In Emacs, @kbd{i} runs the command @code{Info-index}.
1019 1017
1020@findex info-apropos 1018@findex info-apropos
1021@findex index-apropos 1019@findex index-apropos
1022If you don't know what manual documents something, try the @kbd{M-x 1020If you aren't sure which manual documents the topic you are looking
1023info-apropos} command in Emacs, or the @kbd{M-x index-apropos} command 1021for, try the @kbd{M-x info-apropos} command in Emacs, or the @kbd{M-x
1024in the stand-alone reader. It prompts for a string and then looks up 1022index-apropos} command in the stand-alone reader. It prompts for
1025that string in all the indices of all the Info documents installed on 1023a string and then looks up that string in all the indices of all the
1026your system. 1024Info documents installed on your system.
1027 1025
1028@node Go to node, Choose menu subtopic, Search Index, Advanced 1026@node Go to node, Choose menu subtopic, Search Index, Advanced
1029@comment node-name, next, previous, up 1027@comment node-name, next, previous, up
@@ -1193,24 +1191,23 @@ this:
1193@node Expert Info 1191@node Expert Info
1194@chapter Info for Experts 1192@chapter Info for Experts
1195 1193
1196 This chapter explains how to write an Info as distinct from a 1194 This chapter explains how to write an Info file by hand. However,
1197Texinfo file. However, in most cases, writing a Texinfo file is 1195in most cases, writing a Texinfo file is better, since you can use it
1198better, since you can use it to make a printed manual or produce other 1196to make a printed manual or produce other formats, such as HTML and
1199formats, such as HTML and DocBook, as well as for generating Info 1197DocBook, as well as for generating Info files.
1200files.
1201 1198
1202@code{makeinfo} is a utility that converts a Texinfo file into an Info 1199The @code{makeinfo} command converts a Texinfo file into an Info file;
1203file; @code{texinfo-format-region} and @code{texinfo-format-buffer} are 1200@code{texinfo-format-region} and @code{texinfo-format-buffer} are GNU
1204GNU Emacs functions that do the same. 1201Emacs functions that do the same.
1205 1202
1206@xref{Top,, Overview of Texinfo, texinfo, Texinfo: The GNU 1203@xref{Top,, Overview of Texinfo, texinfo, Texinfo: The GNU
1207Documentation Format}, to learn how to write a Texinfo file. 1204Documentation Format}, for how to write a Texinfo file.
1208 1205
1209@xref{Creating an Info File,,, texinfo, Texinfo: The GNU Documentation 1206@xref{Creating an Info File,,, texinfo, Texinfo: The GNU Documentation
1210Format}, to learn how to create an Info file from a Texinfo file. 1207Format}, for how to create an Info file from a Texinfo file.
1211 1208
1212@xref{Installing an Info File,,, texinfo, Texinfo: The GNU 1209@xref{Installing an Info File,,, texinfo, Texinfo: The GNU
1213Documentation Format}, to learn how to install an Info file after you 1210Documentation Format}, for how to install an Info file after you
1214have created one. 1211have created one.
1215 1212
1216However, if you want to edit an Info file manually and install it manually, 1213However, if you want to edit an Info file manually and install it manually,