diff options
| -rw-r--r-- | man/info.texi | 61 |
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. | |||
| 92 | This first part of this Info manual describes how to get around inside | 92 | This first part of this Info manual describes how to get around inside |
| 93 | of Info. The second part of the manual describes various advanced | 93 | of Info. The second part of the manual describes various advanced |
| 94 | Info commands. The third part briefly explains how to generate Info | 94 | Info commands. The third part briefly explains how to generate Info |
| 95 | files from Texinfo files, and describes how to write an Info as | 95 | files from Texinfo files, and describes how to write an Info file |
| 96 | distinct from a Texinfo file. | 96 | by hand. |
| 97 | 97 | ||
| 98 | @ifnotinfo | 98 | @ifnotinfo |
| 99 | This manual is primarily designed for browsing with an Info reader | 99 | This 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 | |||
| 954 | they are in the file, which has no necessary relationship to the | 954 | they are in the file, which has no necessary relationship to the |
| 955 | order that they may be in the tree structure of menus and @samp{next} | 955 | order that they may be in the tree structure of menus and @samp{next} |
| 956 | pointers. But normally the two orders are not very different. In any | 956 | pointers. But normally the two orders are not very different. In any |
| 957 | case, you can always look at the echo area to find out what node you have | 957 | case, you can always look at the mode line to find out what node you have |
| 958 | reached, if the header is not visible (this can happen, because @kbd{s} | 958 | reached, if the header is not visible (this can happen, because @kbd{s} |
| 959 | puts your cursor at the occurrence of the string, not at the beginning | 959 | puts your cursor at the occurrence of the string, not at the beginning |
| 960 | of the node). | 960 | of 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 |
| 986 | indexed, you should try the index search first. The @kbd{i} command | 986 | the index search first before the text search. The @kbd{i} command |
| 987 | prompts you for a subject and then looks up that subject in the | 987 | prompts you for a subject and then looks up that subject in the |
| 988 | indices. If it finds an index entry with the subject you typed, it | 988 | indices. If it finds an index entry with the subject you typed, it |
| 989 | goes to the node to which that index entry points. You should browse | 989 | goes 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 | |||
| 991 | described there. If it isn't, type @kbd{,} one or more times to go | 991 | described there. If it isn't, type @kbd{,} one or more times to go |
| 992 | through additional index entries which match your subject. | 992 | through 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 |
| 995 | you typed @emph{as a substring}. For each match, Info shows in the | 995 | entries which include the string you typed @emph{as a substring}. |
| 996 | echo area the full index entry it found. Often, the text of the full | 996 | For each match, Info shows in the echo area the full index entry it |
| 997 | index entry already gives you enough information to decide whether it | 997 | found. Often, the text of the full index entry already gives you |
| 998 | is relevant to what you are looking for, so we recommend that you read | 998 | enough information to decide whether it is relevant to what you are |
| 999 | what Info shows in the echo area before looking at the node it | 999 | looking for, so we recommend that you read what Info shows in the echo |
| 1000 | displays. | 1000 | area 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 |
| 1003 | if you are not sure how they are spelled in the index. For example, | 1003 | if 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 | |||
| 1010 | options, and key sequences that the program provides. If you are | 1010 | options, and key sequences that the program provides. If you are |
| 1011 | looking for a description of a command, an option, or a key, just type | 1011 | looking for a description of a command, an option, or a key, just type |
| 1012 | their names when @kbd{i} prompts you for a topic. For example, if you | 1012 | their names when @kbd{i} prompts you for a topic. For example, if you |
| 1013 | want to read the description of what the @kbd{C-f} key does, type | 1013 | want 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 | ||
| 1016 | you 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 |
| 1022 | If you don't know what manual documents something, try the @kbd{M-x | 1020 | If you aren't sure which manual documents the topic you are looking |
| 1023 | info-apropos} command in Emacs, or the @kbd{M-x index-apropos} command | 1021 | for, try the @kbd{M-x info-apropos} command in Emacs, or the @kbd{M-x |
| 1024 | in the stand-alone reader. It prompts for a string and then looks up | 1022 | index-apropos} command in the stand-alone reader. It prompts for |
| 1025 | that string in all the indices of all the Info documents installed on | 1023 | a string and then looks up that string in all the indices of all the |
| 1026 | your system. | 1024 | Info 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, |
| 1197 | Texinfo file. However, in most cases, writing a Texinfo file is | 1195 | in most cases, writing a Texinfo file is better, since you can use it |
| 1198 | better, since you can use it to make a printed manual or produce other | 1196 | to make a printed manual or produce other formats, such as HTML and |
| 1199 | formats, such as HTML and DocBook, as well as for generating Info | 1197 | DocBook, as well as for generating Info files. |
| 1200 | files. | ||
| 1201 | 1198 | ||
| 1202 | @code{makeinfo} is a utility that converts a Texinfo file into an Info | 1199 | The @code{makeinfo} command converts a Texinfo file into an Info file; |
| 1203 | file; @code{texinfo-format-region} and @code{texinfo-format-buffer} are | 1200 | @code{texinfo-format-region} and @code{texinfo-format-buffer} are GNU |
| 1204 | GNU Emacs functions that do the same. | 1201 | Emacs 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 |
| 1207 | Documentation Format}, to learn how to write a Texinfo file. | 1204 | Documentation 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 |
| 1210 | Format}, to learn how to create an Info file from a Texinfo file. | 1207 | Format}, 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 |
| 1213 | Documentation Format}, to learn how to install an Info file after you | 1210 | Documentation Format}, for how to install an Info file after you |
| 1214 | have created one. | 1211 | have created one. |
| 1215 | 1212 | ||
| 1216 | However, if you want to edit an Info file manually and install it manually, | 1213 | However, if you want to edit an Info file manually and install it manually, |