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

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

So what about the following version which incorporates your latest
suggestions?

===File ~/info-diff=========================================
*** info.texi.~1.39.~	Mon Mar  8 18:17:14 2004
--- info.texi	Mon Mar 15 17:23:24 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
***************
*** 979,995 ****
  this is so you need not count how many entries are there.  In Emacs,
  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
--- 984,1001 ----
  this is so you need not count how many entries are there.  In Emacs,
  the digit keys run the command @code{Info-nth-menu-item}.
  
!   If your display supports multiple fonts, colors or underlining, and
! you are using Emacs' Info mode to read Info files, the third, sixth
! and ninth menu items 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 either multiple fonts, 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 ****
--- 1010,1032 ----
  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 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
============================================================