Re: Documentation for "Clone Buffers" (corrected version)

[Luc Teirlinck <teirllm@dms.auburn.edu>]

Emacs Info now colors the third, sixth and ninth stars in a menu,
instead of the fifth and ninth, so unless there are objections, I plan
to apply the following patch whose only differences with the previous
one are the @unnumberedsubsec vs @subheading change we agreed on and
the *-coloring stuff:

===File ~/info-diff=========================================
*** info.texi.~1.39.~	Mon Mar  8 18:17:14 2004
--- info.texi	Sun Mar 14 18:36:11 2004
***************
*** 614,619 ****
--- 614,624 ----
  stands for the subtopic of the line you are on.  You can also click
  the middle mouse button directly on the subtopic line to go there.
  
+   As a more advanced feature, if you type @kbd{C-u m}, everything
+ works exactly as if you just typed @kbd{m}, except that the command
+ goes to the node in a new independent Info buffer, which it selects in
+ another window.  The current Info node remains visible in its window.
+ 
  Here is a menu to give you a chance to practice.  This menu gives you
  three ways of going to one place, Help-FOO:
  
***************
*** 939,945 ****
  
  Here are some more Info commands that make it easier to move around.
  
! @unnumberedsubsec @kbd{g} goes to a node by name
  
  @kindex g @r{(Info mode)}
  @findex Info-goto-node
--- 944,950 ----
  
  Here are some more Info commands that make it easier to move around.
  
! @subheading @kbd{g} goes to a node by name
  
  @kindex g @r{(Info mode)}
  @findex Info-goto-node
***************
*** 965,971 ****
  all of the current file by typing @kbd{g*@key{RET}} or all of any
  other file with @kbd{g(@var{filename})@key{RET}}.
  
! @unnumberedsubsec @kbd{1} -- @kbd{9} choose a menu subtopic by its number
  
  @kindex 1 @r{through} 9 @r{(Info mode)}
  @findex Info-nth-menu-item
--- 970,976 ----
  all of the current file by typing @kbd{g*@key{RET}} or all of any
  other file with @kbd{g(@var{filename})@key{RET}}.
  
! @subheading @kbd{1} -- @kbd{9} choose a menu subtopic by its number
  
  @kindex 1 @r{through} 9 @r{(Info mode)}
  @findex Info-nth-menu-item
***************
*** 980,995 ****
  the digit keys run the command @code{Info-nth-menu-item}.
  
    If your display supports multiple fonts, and you are using Emacs'
! Info mode to read Info files, the @samp{*} for the fifth menu item
! stands out, either in color or in some other attribute, such as
! underline, and so is the @samp{*} for the ninth item; this makes it
! easy to see at a glance which number to use for an item.
  
    Some terminals don't support colors or underlining.  If you need to
  actually count items, it is better to use @kbd{m} instead, and specify
  the name, or use @key{TAB} to quickly move between menu items.
  
! @unnumberedsubsec @kbd{e} makes Info document editable
  
  @kindex e @r{(Info mode)}
  @findex Info-edit
--- 985,1000 ----
  the digit keys run the command @code{Info-nth-menu-item}.
  
    If your display supports multiple fonts, and you are using Emacs'
! Info mode to read Info files, the third, sixth and ninth menu item
! have a @samp{*} that stands out, either in color or in some other
! attribute, such as underline; this makes it easy to see at a glance
! which number to use for an item.
  
    Some terminals don't support colors or underlining.  If you need to
  actually count items, it is better to use @kbd{m} instead, and specify
  the name, or use @key{TAB} to quickly move between menu items.
  
! @subheading @kbd{e} makes Info document editable
  
  @kindex e @r{(Info mode)}
  @findex Info-edit
***************
*** 1004,1009 ****
--- 1009,1031 ----
  edit the Info file, so typing @kbd{e} there goes to the end of the
  current node.
  
+ @subheading @kbd{M-n} creates a new independent Info buffer in Emacs
+ 
+ @kindex M-n @r{(Info mode)}
+ @findex clone-buffer
+ @cindex creating multiple Info buffers
+   If you are reading Info in Emacs, you can select a new independent
+ Info buffer in another window by typing @kbd{M-n}.  The new buffer
+ starts out as an exact copy of the old one, but you will be able to
+ move independently between nodes in the two buffers.  (In Info mode,
+ @kbd{M-n} runs the Emacs command @code{clone-buffer}.)
+ 
+   In Emacs Info, you can also produce new Info buffers by giving a
+ numeric prefix argument to the @kbd{m} and @kbd{g} commands.  @kbd{C-u
+ m} and @kbd{C-u g} go to a new node in exactly the same way that
+ @kbd{m} and @kbd{g} do, but they do so in a new Info buffer which they
+ select in another window.
+ 
  @node Info Search, Add, Advanced, Expert Info
  @comment  node-name,  next,  previous,  up
  @section How to search Info documents for specific subjects
============================================================