[Emacs-diffs] Changes to emacs/man/info.texi

[Richard M. Stallman]

Index: emacs/man/info.texi
diff -c emacs/man/info.texi:1.20 emacs/man/info.texi:1.21
*** emacs/man/info.texi:1.20    Mon Mar 18 01:45:49 2002
--- emacs/man/info.texi Tue Apr 23 14:36:05 2002
***************
*** 6,12 ****
  @syncodeindex vr cp
  @syncodeindex ky cp
  @comment %**end of header
! @comment $Id: info.texi,v 1.20 2002/03/18 06:45:49 eliz Exp $
  
  @dircategory Texinfo documentation system
  @direntry
--- 6,12 ----
  @syncodeindex vr cp
  @syncodeindex ky cp
  @comment %**end of header
! @comment $Id: info.texi,v 1.21 2002/04/23 18:36:05 rms Exp $
  
  @dircategory Texinfo documentation system
  @direntry
***************
*** 85,103 ****
  command @kbd{h} now.  It brings you to a programmed instruction
  sequence.
  
! To learn advanced Info commands, type @kbd{n} twice.  This brings you to
  @cite{Info for Experts}, skipping over the `Getting Started' chapter.
  @end ifinfo
  @end ifnottex
  
  @menu
  * Getting Started::             Getting started using an Info reader.
! * Advanced Info::               Advanced commands within Info.
  * Creating an Info File::       How to make your own Info file.
  * Index::                       An index of topics, commands, and variables.
  @end menu
  
! @node Getting Started, Advanced Info, Top, Top
  @comment  node-name,  next,  previous,  up
  @chapter Getting Started
  
--- 85,103 ----
  command @kbd{h} now.  It brings you to a programmed instruction
  sequence.
  
! To learn expert-level Info commands, type @kbd{n} twice.  This brings you to
  @cite{Info for Experts}, skipping over the `Getting Started' chapter.
  @end ifinfo
  @end ifnottex
  
  @menu
  * Getting Started::             Getting started using an Info reader.
! * Expert Info::                 Info commands for experts.
  * Creating an Info File::       How to make your own Info file.
  * Index::                       An index of topics, commands, and variables.
  @end menu
  
! @node Getting Started, Expert Info, Top, Top
  @comment  node-name,  next,  previous,  up
  @chapter Getting Started
  
***************
*** 310,319 ****
  @comment  node-name,  next,  previous,  up
  @section The Space, DEL, B and ^L commands.
  
!   This node's mode line tells you that you are now at node @samp{Help-^L},
! and the header line tells you that @kbd{p} would get you back to
! @samp{Help-P}.  The node's title is underlined; it says what the node
! is about (most nodes have titles).
  
    This is a big node and it does not all fit on your display screen.
  You can tell that there is more that is not visible because you
--- 310,319 ----
  @comment  node-name,  next,  previous,  up
  @section The Space, DEL, B and ^L commands.
  
!   This node's mode line tells you that you are now at node
! @samp{Help-^L}, and the header line tells you that @kbd{p} would get
! you back to @samp{Help-P}.  The node's title is highlighted and may be
! underlined as well; it says what the node is about.
  
    This is a big node and it does not all fit on your display screen.
  You can tell that there is more that is not visible because you
***************
*** 398,404 ****
  >> Try that now.  (We have put in enough verbiage to push this past
     the first screenful, but screens are so big nowadays that perhaps it
     isn't enough.  You may need to shrink your Emacs or Info window.)
!    Then come back, with @key{SPS}s.
  @end format
  
    If your screen is very tall, all of this node might fit at once.
--- 398,404 ----
  >> Try that now.  (We have put in enough verbiage to push this past
     the first screenful, but screens are so big nowadays that perhaps it
     isn't enough.  You may need to shrink your Emacs or Info window.)
!    Then come back, by typing @key{SPC} one or more times.
  @end format
  
    If your screen is very tall, all of this node might fit at once.
***************
*** 459,465 ****
  not define additional subtopics.  Here is an example:
  
  @example
! * Foo:  Node about FOO      This tells about FOO
  @end example
  
  The subtopic name is Foo, and the node describing it is @samp{Node
--- 459,465 ----
  not define additional subtopics.  Here is an example:
  
  @example
! * Foo:  Node about FOO.      This tells about FOO.
  @end example
  
  The subtopic name is Foo, and the node describing it is @samp{Node
***************
*** 479,485 ****
  abbreviation for this:
  
  @example
! * Foo::   This tells about FOO
  @end example
  
  @noindent
--- 479,485 ----
  abbreviation for this:
  
  @example
! * Foo::   This tells about FOO.
  @end example
  
  @noindent
***************
*** 742,748 ****
  @kbd{l} command revisits nodes in the history list; each successive
  @kbd{l} command moves one step back through the history.
  
!   If you have been following directions, ad @kbd{l} command now will get
  you back to @samp{Help-M}.  Another @kbd{l} command would undo the
  @kbd{u} and get you back to @samp{Help-FOO}.  Another @kbd{l} would undo
  the @kbd{m} and get you back to @samp{Help-M}.
--- 742,748 ----
  @kbd{l} command revisits nodes in the history list; each successive
  @kbd{l} command moves one step back through the history.
  
!   If you have been following directions, an @kbd{l} command now will get
  you back to @samp{Help-M}.  Another @kbd{l} command would undo the
  @kbd{u} and get you back to @samp{Help-FOO}.  Another @kbd{l} would undo
  the @kbd{m} and get you back to @samp{Help-M}.
***************
*** 792,818 ****
  >> Now type @kbd{n} to see the last node of the course.
  @end format
  
!   @xref{Advanced Info}, for more advanced Info features.
  
  @c If a menu appears at the end of this node, remove it.
  @c It is an accident of the menu updating command.
  
! @node Advanced Info
  @chapter Info for Experts
  
!   This chapter describes various advanced Info commands.  (If you are
! using a stand-alone Info reader, there are additional commands
  specific to it, which are documented in several chapters of @ref{Top,,
  GNU Info, info-stnd, GNU Info}.)
  
    This chapter also explains how to write an Info as distinct from a
  Texinfo file.  (However, in most cases, writing a Texinfo file is
! better, since you can use it @emph{both} to generate an Info file and
! to make a printed manual.  @xref{Top,, Overview of Texinfo, texinfo,
! Texinfo: The GNU Documentation Format}.)
  
  @menu
! * Expert::               Advanced Info commands: g, s, e, and 1 - 5.
  * Info Search::          How to search Info documents for specific subjects.
  * Add::                  Describes how to add new nodes to the hierarchy.
                             Also tells what nodes look like.
--- 792,818 ----
  >> Now type @kbd{n} to see the last node of the course.
  @end format
  
!   @xref{Expert Info}, for more advanced Info features.
  
  @c If a menu appears at the end of this node, remove it.
  @c It is an accident of the menu updating command.
  
! @node Expert Info
  @chapter Info for Experts
  
!   This chapter describes various Info commands for experts.  (If you
! are using a stand-alone Info reader, there are additional commands
  specific to it, which are documented in several chapters of @ref{Top,,
  GNU Info, info-stnd, GNU Info}.)
  
    This chapter also explains how to write an Info as distinct from a
  Texinfo file.  (However, in most cases, writing a Texinfo file is
! better, since you can use it to make a printed manual or an HTML file
! as well as for generating Info files.)  @xref{Top,, Overview of
! Texinfo, texinfo, Texinfo: The GNU Documentation Format}.)
  
  @menu
! * Advanced::             Advanced Info commands: g, s, e, and 1 - 5.
  * Info Search::          How to search Info documents for specific subjects.
  * Add::                  Describes how to add new nodes to the hierarchy.
                             Also tells what nodes look like.
***************
*** 823,829 ****
  * Emacs Info Variables:: Variables modifying the behavior of Emacs Info.
  @end menu
  
! @node Expert, Info Search,  , Advanced Info
  @comment  node-name,  next,  previous,  up
  @section Advanced Info Commands
  
--- 823,829 ----
  * Emacs Info Variables:: Variables modifying the behavior of Emacs Info.
  @end menu
  
! @node Advanced, Info Search,  , Expert Info
  @comment  node-name,  next,  previous,  up
  @section Advanced Info Commands
  
***************
*** 837,843 ****
    If you know a node's name, you can go there by typing @kbd{g}, the
  name, and @key{RET}.  Thus, @address@hidden would go to the node
  called @samp{Top} in this file.  (This is equivalent to @kbd{t}, see
! @ref{Help-Int}.)  @address@hidden would come back here.
  @kbd{g} in Emacs runs the command @code{Info-goto-node}.
  
    Unlike @kbd{m}, @kbd{g} does not allow the use of abbreviations.
--- 837,843 ----
    If you know a node's name, you can go there by typing @kbd{g}, the
  name, and @key{RET}.  Thus, @address@hidden would go to the node
  called @samp{Top} in this file.  (This is equivalent to @kbd{t}, see
! @ref{Help-Int}.)  @kbd{gAdvanced{RET}} would come back here.
  @kbd{g} in Emacs runs the command @code{Info-goto-node}.
  
    Unlike @kbd{m}, @kbd{g} does not allow the use of abbreviations.
***************
*** 894,900 ****
  edit the Info file, so typing @kbd{e} there goes to the end of the
  current node.
  
! @node Info Search, Add, Expert, Advanced Info
  @comment  node-name,  next,  previous,  up
  @section How to search Info documents for specific subjects
  
--- 894,900 ----
  edit the Info file, so typing @kbd{e} there goes to the end of the
  current node.
  
! @node Info Search, Add, Advanced, Expert Info
  @comment  node-name,  next,  previous,  up
  @section How to search Info documents for specific subjects
  
***************
*** 970,976 ****
  command @code{Info-search}.
  
  
! @node Add, Menus, Info Search, Advanced Info
  @comment  node-name,  next,  previous,  up
  @section Adding a new node to Info
  
--- 970,976 ----
  command @code{Info-search}.
  
  
! @node Add, Menus, Info Search, Expert Info
  @comment  node-name,  next,  previous,  up
  @section Adding a new node to Info
  
***************
*** 985,992 ****
  
    Usually, the way to create the nodes is with Texinfo (@pxref{Top,,
  Overview of Texinfo, texinfo, Texinfo: The GNU Documentation Format});
! this has the advantage that you can also make a printed manual from
! them.  However, if you want to edit an Info file, here is how.
  
  @cindex node delimiters
    The new node can live in an existing documentation file, or in a new
--- 985,995 ----
  
    Usually, the way to create the nodes is with Texinfo (@pxref{Top,,
  Overview of Texinfo, texinfo, Texinfo: The GNU Documentation Format});
! this has the advantage that you can also make a printed manual or HTML
! from them.  You would use the @samp{@@dircategory} and
! @samp{@@direntry} commands to put the manual into the Info directory.
! However, if you want to edit an Info file manually and install it
! manually, here is how.
  
  @cindex node delimiters
    The new node can live in an existing documentation file, or in a new
***************
*** 1000,1011 ****
  @samp{^_}.}
  
    The @samp{^_} starting a node must be followed by a newline or a
! @samp{^L} newline, after which comes the node's header line.  The header
! line must give the node's name (by which Info finds it), and state the
! names of the @samp{Next}, @samp{Previous}, and @samp{Up} nodes (if there
! are any).  As you can see, this node's @samp{Up} node is the node
! @samp{Top}, which points at all the documentation for Info.  The
! @samp{Next} node is @samp{Menus}.
  
  @cindex node header line format
  @cindex format of node headers
--- 1003,1013 ----
  @samp{^_}.}
  
    The @samp{^_} starting a node must be followed by a newline or a
! @samp{^L} newline, after which comes the node's header line.  The
! header line must give the node's name (by which Info finds it), and
! state the names of the @samp{Next}, @samp{Previous}, and @samp{Up}
! nodes (if there are any).  As you can see, this node's @samp{Up} node
! is the node @samp{Expert Info}.  The @samp{Next} node is @samp{Menus}.
  
  @cindex node header line format
  @cindex format of node headers
***************
*** 1051,1057 ****
  line.  The file names are ignored by Info, but they serve as comments
  to help identify the node for the user.
  
! @node Menus, Cross-refs, Add, Advanced Info
  @comment  node-name,  next,  previous,  up
  @section How to Create Menus
  
--- 1053,1059 ----
  line.  The file names are ignored by Info, but they serve as comments
  to help identify the node for the user.
  
! @node Menus, Cross-refs, Add, Expert Info
  @comment  node-name,  next,  previous,  up
  @section How to Create Menus
  
***************
*** 1107,1113 ****
  to, but such a substructure is rather useless since nobody can
  ever find out that it exists.
  
! @node Cross-refs, Tags, Menus, Advanced Info
  @comment  node-name,  next,  previous,  up
  @section Creating Cross References
  
--- 1109,1115 ----
  to, but such a substructure is rather useless since nobody can
  ever find out that it exists.
  
! @node Cross-refs, Tags, Menus, Expert Info
  @comment  node-name,  next,  previous,  up
  @section Creating Cross References
  
***************
*** 1166,1172 ****
  
    Another set of Info commands is useful when you need to find
  something quickly in a manual---that is, when you need to use a manual
! as a reference rather than as a tutorial.  We urge you to make learn
  these search commands as well.  If you want to do that now, follow this
  cross reference to @ref{Info Search}.
  
--- 1168,1174 ----
  
    Another set of Info commands is useful when you need to find
  something quickly in a manual---that is, when you need to use a manual
! as a reference rather than as a tutorial.  We urge you to learn
  these search commands as well.  If you want to do that now, follow this
  cross reference to @ref{Info Search}.
  
***************
*** 1182,1188 ****
  @end format
  
  
! @node Tags, Checking, Cross-refs, Advanced Info
  @comment  node-name,  next,  previous,  up
  @section Tags Tables for Info Files
  
--- 1184,1190 ----
  @end format
  
  
! @node Tags, Checking, Cross-refs, Expert Info
  @comment  node-name,  next,  previous,  up
  @section Tags Tables for Info Files
  
***************
*** 1227,1233 ****
  beginning of the node.
  
  
! @node Checking, Emacs Info Variables, Tags, Advanced Info
  @section Checking an Info File
  
  When creating an Info file, it is easy to forget the name of a node when
--- 1229,1235 ----
  beginning of the node.
  
  
! @node Checking, Emacs Info Variables, Tags, Expert Info
  @section Checking an Info File
  
  When creating an Info file, it is easy to forget the name of a node when
***************
*** 1246,1252 ****
  To check an Info file, do @kbd{M-x Info-validate} while looking at any
  node of the file with Emacs Info mode.
  
! @node Emacs Info Variables, , Checking, Advanced Info
  @section Emacs Info-mode Variables
  
  The following variables may modify the behavior of Info-mode in Emacs;
--- 1248,1254 ----
  To check an Info file, do @kbd{M-x Info-validate} while looking at any
  node of the file with Emacs Info mode.
  
! @node Emacs Info Variables, , Checking, Expert Info
  @section Emacs Info-mode Variables
  
  The following variables may modify the behavior of Info-mode in Emacs;