aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorRichard M. Stallman2002-04-23 18:36:05 +0000
committerRichard M. Stallman2002-04-23 18:36:05 +0000
commit9170767df1eed4f65eed817c9703c359de9b09af (patch)
tree6641090c94443cf9e1b7f0bced7fc23dc4a48b48
parent314dbe9a7f28624812679ebc458f03cf1ba12ab2 (diff)
downloademacs-9170767df1eed4f65eed817c9703c359de9b09af.tar.gz
emacs-9170767df1eed4f65eed817c9703c359de9b09af.zip
Rename Advanced Info to Expert Info.
Rename Expert to Advanced. Fix many small errors.
-rw-r--r--man/info.texi78
1 files changed, 40 insertions, 38 deletions
diff --git a/man/info.texi b/man/info.texi
index e9896233c29..bf13577ae03 100644
--- a/man/info.texi
+++ b/man/info.texi
@@ -6,7 +6,7 @@
6@syncodeindex vr cp 6@syncodeindex vr cp
7@syncodeindex ky cp 7@syncodeindex ky cp
8@comment %**end of header 8@comment %**end of header
9@comment $Id: info.texi,v 1.19 2002/03/16 19:32:15 eliz Exp $ 9@comment $Id: info.texi,v 1.20 2002/03/18 06:45:49 eliz Exp $
10 10
11@dircategory Texinfo documentation system 11@dircategory Texinfo documentation system
12@direntry 12@direntry
@@ -85,19 +85,19 @@ If you are new to Info and want to learn how to use it, type the
85command @kbd{h} now. It brings you to a programmed instruction 85command @kbd{h} now. It brings you to a programmed instruction
86sequence. 86sequence.
87 87
88To learn advanced Info commands, type @kbd{n} twice. This brings you to 88To learn expert-level Info commands, type @kbd{n} twice. This brings you to
89@cite{Info for Experts}, skipping over the `Getting Started' chapter. 89@cite{Info for Experts}, skipping over the `Getting Started' chapter.
90@end ifinfo 90@end ifinfo
91@end ifnottex 91@end ifnottex
92 92
93@menu 93@menu
94* Getting Started:: Getting started using an Info reader. 94* Getting Started:: Getting started using an Info reader.
95* Advanced Info:: Advanced commands within Info. 95* Expert Info:: Info commands for experts.
96* Creating an Info File:: How to make your own Info file. 96* Creating an Info File:: How to make your own Info file.
97* Index:: An index of topics, commands, and variables. 97* Index:: An index of topics, commands, and variables.
98@end menu 98@end menu
99 99
100@node Getting Started, Advanced Info, Top, Top 100@node Getting Started, Expert Info, Top, Top
101@comment node-name, next, previous, up 101@comment node-name, next, previous, up
102@chapter Getting Started 102@chapter Getting Started
103 103
@@ -310,10 +310,10 @@ you may make Info skip past an important warning that was coming up.
310@comment node-name, next, previous, up 310@comment node-name, next, previous, up
311@section The Space, DEL, B and ^L commands. 311@section The Space, DEL, B and ^L commands.
312 312
313 This node's mode line tells you that you are now at node @samp{Help-^L}, 313 This node's mode line tells you that you are now at node
314and the header line tells you that @kbd{p} would get you back to 314@samp{Help-^L}, and the header line tells you that @kbd{p} would get
315@samp{Help-P}. The node's title is underlined; it says what the node 315you back to @samp{Help-P}. The node's title is highlighted and may be
316is about (most nodes have titles). 316underlined as well; it says what the node is about.
317 317
318 This is a big node and it does not all fit on your display screen. 318 This is a big node and it does not all fit on your display screen.
319You can tell that there is more that is not visible because you 319You can tell that there is more that is not visible because you
@@ -398,7 +398,7 @@ beginning.
398>> Try that now. (We have put in enough verbiage to push this past 398>> Try that now. (We have put in enough verbiage to push this past
399 the first screenful, but screens are so big nowadays that perhaps it 399 the first screenful, but screens are so big nowadays that perhaps it
400 isn't enough. You may need to shrink your Emacs or Info window.) 400 isn't enough. You may need to shrink your Emacs or Info window.)
401 Then come back, with @key{SPS}s. 401 Then come back, by typing @key{SPC} one or more times.
402@end format 402@end format
403 403
404 If your screen is very tall, all of this node might fit at once. 404 If your screen is very tall, all of this node might fit at once.
@@ -459,7 +459,7 @@ special meaning---they are only for the human reader's benefit and do
459not define additional subtopics. Here is an example: 459not define additional subtopics. Here is an example:
460 460
461@example 461@example
462* Foo: Node about FOO This tells about FOO 462* Foo: Node about FOO. This tells about FOO.
463@end example 463@end example
464 464
465The subtopic name is Foo, and the node describing it is @samp{Node 465The subtopic name is Foo, and the node describing it is @samp{Node
@@ -479,7 +479,7 @@ and so both it and the subtopic name are the same. There is an
479abbreviation for this: 479abbreviation for this:
480 480
481@example 481@example
482* Foo:: This tells about FOO 482* Foo:: This tells about FOO.
483@end example 483@end example
484 484
485@noindent 485@noindent
@@ -742,7 +742,7 @@ records the nodes where you have been in a special history list. The
742@kbd{l} command revisits nodes in the history list; each successive 742@kbd{l} command revisits nodes in the history list; each successive
743@kbd{l} command moves one step back through the history. 743@kbd{l} command moves one step back through the history.
744 744
745 If you have been following directions, ad @kbd{l} command now will get 745 If you have been following directions, an @kbd{l} command now will get
746you back to @samp{Help-M}. Another @kbd{l} command would undo the 746you back to @samp{Help-M}. Another @kbd{l} command would undo the
747@kbd{u} and get you back to @samp{Help-FOO}. Another @kbd{l} would undo 747@kbd{u} and get you back to @samp{Help-FOO}. Another @kbd{l} would undo
748the @kbd{m} and get you back to @samp{Help-M}. 748the @kbd{m} and get you back to @samp{Help-M}.
@@ -792,27 +792,27 @@ underlying text and the mouse pointer change in response.
792>> Now type @kbd{n} to see the last node of the course. 792>> Now type @kbd{n} to see the last node of the course.
793@end format 793@end format
794 794
795 @xref{Advanced Info}, for more advanced Info features. 795 @xref{Expert Info}, for more advanced Info features.
796 796
797@c If a menu appears at the end of this node, remove it. 797@c If a menu appears at the end of this node, remove it.
798@c It is an accident of the menu updating command. 798@c It is an accident of the menu updating command.
799 799
800@node Advanced Info 800@node Expert Info
801@chapter Info for Experts 801@chapter Info for Experts
802 802
803 This chapter describes various advanced Info commands. (If you are 803 This chapter describes various Info commands for experts. (If you
804using a stand-alone Info reader, there are additional commands 804are using a stand-alone Info reader, there are additional commands
805specific to it, which are documented in several chapters of @ref{Top,, 805specific to it, which are documented in several chapters of @ref{Top,,
806GNU Info, info-stnd, GNU Info}.) 806GNU Info, info-stnd, GNU Info}.)
807 807
808 This chapter also explains how to write an Info as distinct from a 808 This chapter also explains how to write an Info as distinct from a
809Texinfo file. (However, in most cases, writing a Texinfo file is 809Texinfo file. (However, in most cases, writing a Texinfo file is
810better, since you can use it @emph{both} to generate an Info file and 810better, since you can use it to make a printed manual or an HTML file
811to make a printed manual. @xref{Top,, Overview of Texinfo, texinfo, 811as well as for generating Info files.) @xref{Top,, Overview of
812Texinfo: The GNU Documentation Format}.) 812Texinfo, texinfo, Texinfo: The GNU Documentation Format}.)
813 813
814@menu 814@menu
815* Expert:: Advanced Info commands: g, s, e, and 1 - 5. 815* Advanced:: Advanced Info commands: g, s, e, and 1 - 5.
816* Info Search:: How to search Info documents for specific subjects. 816* Info Search:: How to search Info documents for specific subjects.
817* Add:: Describes how to add new nodes to the hierarchy. 817* Add:: Describes how to add new nodes to the hierarchy.
818 Also tells what nodes look like. 818 Also tells what nodes look like.
@@ -823,7 +823,7 @@ Texinfo: The GNU Documentation Format}.)
823* Emacs Info Variables:: Variables modifying the behavior of Emacs Info. 823* Emacs Info Variables:: Variables modifying the behavior of Emacs Info.
824@end menu 824@end menu
825 825
826@node Expert, Info Search, , Advanced Info 826@node Advanced, Info Search, , Expert Info
827@comment node-name, next, previous, up 827@comment node-name, next, previous, up
828@section Advanced Info Commands 828@section Advanced Info Commands
829 829
@@ -837,7 +837,7 @@ Here are some more Info commands that make it easier to move around.
837 If you know a node's name, you can go there by typing @kbd{g}, the 837 If you know a node's name, you can go there by typing @kbd{g}, the
838name, and @key{RET}. Thus, @kbd{gTop@key{RET}} would go to the node 838name, and @key{RET}. Thus, @kbd{gTop@key{RET}} would go to the node
839called @samp{Top} in this file. (This is equivalent to @kbd{t}, see 839called @samp{Top} in this file. (This is equivalent to @kbd{t}, see
840@ref{Help-Int}.) @kbd{gExpert@key{RET}} would come back here. 840@ref{Help-Int}.) @kbd{gAdvanced{RET}} would come back here.
841@kbd{g} in Emacs runs the command @code{Info-goto-node}. 841@kbd{g} in Emacs runs the command @code{Info-goto-node}.
842 842
843 Unlike @kbd{m}, @kbd{g} does not allow the use of abbreviations. 843 Unlike @kbd{m}, @kbd{g} does not allow the use of abbreviations.
@@ -894,7 +894,7 @@ only if the variable @code{Info-enable-edit} is non-@code{nil}.
894edit the Info file, so typing @kbd{e} there goes to the end of the 894edit the Info file, so typing @kbd{e} there goes to the end of the
895current node. 895current node.
896 896
897@node Info Search, Add, Expert, Advanced Info 897@node Info Search, Add, Advanced, Expert Info
898@comment node-name, next, previous, up 898@comment node-name, next, previous, up
899@section How to search Info documents for specific subjects 899@section How to search Info documents for specific subjects
900 900
@@ -970,7 +970,7 @@ kind of search command. Both @kbd{s} and @kbd{M-s} run in Emacs the
970command @code{Info-search}. 970command @code{Info-search}.
971 971
972 972
973@node Add, Menus, Info Search, Advanced Info 973@node Add, Menus, Info Search, Expert Info
974@comment node-name, next, previous, up 974@comment node-name, next, previous, up
975@section Adding a new node to Info 975@section Adding a new node to Info
976 976
@@ -985,8 +985,11 @@ Put that topic in the menu in the directory. @xref{Menus, Menu}.
985 985
986 Usually, the way to create the nodes is with Texinfo (@pxref{Top,, 986 Usually, the way to create the nodes is with Texinfo (@pxref{Top,,
987Overview of Texinfo, texinfo, Texinfo: The GNU Documentation Format}); 987Overview of Texinfo, texinfo, Texinfo: The GNU Documentation Format});
988this has the advantage that you can also make a printed manual from 988this has the advantage that you can also make a printed manual or HTML
989them. However, if you want to edit an Info file, here is how. 989from them. You would use the @samp{@@dircategory} and
990@samp{@@direntry} commands to put the manual into the Info directory.
991However, if you want to edit an Info file manually and install it
992manually, here is how.
990 993
991@cindex node delimiters 994@cindex node delimiters
992 The new node can live in an existing documentation file, or in a new 995 The new node can live in an existing documentation file, or in a new
@@ -1000,12 +1003,11 @@ page boundary as well is to put a @samp{^L} @emph{right after} the
1000@samp{^_}.} 1003@samp{^_}.}
1001 1004
1002 The @samp{^_} starting a node must be followed by a newline or a 1005 The @samp{^_} starting a node must be followed by a newline or a
1003@samp{^L} newline, after which comes the node's header line. The header 1006@samp{^L} newline, after which comes the node's header line. The
1004line must give the node's name (by which Info finds it), and state the 1007header line must give the node's name (by which Info finds it), and
1005names of the @samp{Next}, @samp{Previous}, and @samp{Up} nodes (if there 1008state the names of the @samp{Next}, @samp{Previous}, and @samp{Up}
1006are any). As you can see, this node's @samp{Up} node is the node 1009nodes (if there are any). As you can see, this node's @samp{Up} node
1007@samp{Top}, which points at all the documentation for Info. The 1010is the node @samp{Expert Info}. The @samp{Next} node is @samp{Menus}.
1008@samp{Next} node is @samp{Menus}.
1009 1011
1010@cindex node header line format 1012@cindex node header line format
1011@cindex format of node headers 1013@cindex format of node headers
@@ -1051,7 +1053,7 @@ node is in the same file, it was not necessary to use one.
1051line. The file names are ignored by Info, but they serve as comments 1053line. The file names are ignored by Info, but they serve as comments
1052to help identify the node for the user. 1054to help identify the node for the user.
1053 1055
1054@node Menus, Cross-refs, Add, Advanced Info 1056@node Menus, Cross-refs, Add, Expert Info
1055@comment node-name, next, previous, up 1057@comment node-name, next, previous, up
1056@section How to Create Menus 1058@section How to Create Menus
1057 1059
@@ -1107,7 +1109,7 @@ collector, nothing terrible happens if a substructure is not pointed
1107to, but such a substructure is rather useless since nobody can 1109to, but such a substructure is rather useless since nobody can
1108ever find out that it exists. 1110ever find out that it exists.
1109 1111
1110@node Cross-refs, Tags, Menus, Advanced Info 1112@node Cross-refs, Tags, Menus, Expert Info
1111@comment node-name, next, previous, up 1113@comment node-name, next, previous, up
1112@section Creating Cross References 1114@section Creating Cross References
1113 1115
@@ -1166,7 +1168,7 @@ as new users should do when they learn a new package.
1166 1168
1167 Another set of Info commands is useful when you need to find 1169 Another set of Info commands is useful when you need to find
1168something quickly in a manual---that is, when you need to use a manual 1170something quickly in a manual---that is, when you need to use a manual
1169as a reference rather than as a tutorial. We urge you to make learn 1171as a reference rather than as a tutorial. We urge you to learn
1170these search commands as well. If you want to do that now, follow this 1172these search commands as well. If you want to do that now, follow this
1171cross reference to @ref{Info Search}. 1173cross reference to @ref{Info Search}.
1172 1174
@@ -1182,7 +1184,7 @@ manner.
1182@end format 1184@end format
1183 1185
1184 1186
1185@node Tags, Checking, Cross-refs, Advanced Info 1187@node Tags, Checking, Cross-refs, Expert Info
1186@comment node-name, next, previous, up 1188@comment node-name, next, previous, up
1187@section Tags Tables for Info Files 1189@section Tags Tables for Info Files
1188 1190
@@ -1227,7 +1229,7 @@ a @samp{DEL} character, and the character position in the file of the
1227beginning of the node. 1229beginning of the node.
1228 1230
1229 1231
1230@node Checking, Emacs Info Variables, Tags, Advanced Info 1232@node Checking, Emacs Info Variables, Tags, Expert Info
1231@section Checking an Info File 1233@section Checking an Info File
1232 1234
1233When creating an Info file, it is easy to forget the name of a node when 1235When creating an Info file, it is easy to forget the name of a node when
@@ -1246,7 +1248,7 @@ usually few.
1246To check an Info file, do @kbd{M-x Info-validate} while looking at any 1248To check an Info file, do @kbd{M-x Info-validate} while looking at any
1247node of the file with Emacs Info mode. 1249node of the file with Emacs Info mode.
1248 1250
1249@node Emacs Info Variables, , Checking, Advanced Info 1251@node Emacs Info Variables, , Checking, Expert Info
1250@section Emacs Info-mode Variables 1252@section Emacs Info-mode Variables
1251 1253
1252The following variables may modify the behavior of Info-mode in Emacs; 1254The following variables may modify the behavior of Info-mode in Emacs;