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

[Luc Teirlinck]

I propose the following changes to the documentation strings of
`Info-mode' and `clone-buffer'.  The change to the Info-mode doc just
adds a line documenting M-n.  I propose to change the doc string of
`clone-buffer' because right now it is incomplete and, in particular,
does not properly document the, in my opinion, important, interactive
use.  If desired, I could install the patches below:

===File ~/info.el-diff======================================
*** info.el.~1.376.~    Mon Dec 29 13:27:09 2003
--- info.el     Thu Mar 11 22:56:38 2004
***************
*** 2495,2500 ****
--- 2495,2501 ----
  
  Advanced commands:
  \\[Info-copy-current-node-name]       Put name of current info node in the 
kill ring.
+ \\[clone-buffer]      Select a new cloned Info buffer in another window.
  \\[Info-edit] Edit contents of selected node.
  1     Pick first item in node's menu.
  2, 3, 4, 5   Pick second ... fifth item in node's menu.
============================================================

===File ~/simple.el-diff====================================
*** simple.el.~1.632.~  Thu Mar  4 15:37:21 2004
--- simple.el   Thu Mar 11 22:27:38 2004
***************
*** 4313,4323 ****
  ;; - syntax-table
  ;; - overlays
  (defun clone-buffer (&optional newname display-flag)
!   "Create a twin copy of the current buffer.
! If NEWNAME is nil, it defaults to the current buffer's name;
! NEWNAME is modified by adding or incrementing <N> at the end as necessary.
  
- If DISPLAY-FLAG is non-nil, the new buffer is shown with `pop-to-buffer'.
  This runs the normal hook `clone-buffer-hook' in the new buffer
  after it has been set up properly in other respects."
    (interactive
--- 4313,4334 ----
  ;; - syntax-table
  ;; - overlays
  (defun clone-buffer (&optional newname display-flag)
!   "Create and return a twin copy of the current buffer.
! Unlike an indirect buffer, the new buffer can be edited
! independently of the old one (if it is not read-only).
! NEWNAME is the name of the new buffer.  It may be modified by
! adding or incrementing <N> at the end as necessary to create a
! unique buffer name.  If nil, it defaults to the name of the
! current buffer, with the proper suffix.  If DISPLAY-FLAG is
! non-nil, the new buffer is shown with `pop-to-buffer'.  Trying to
! clone a file-visiting buffer, or a buffer whose major mode symbol
! has a non-nil `no-clone' property, results in an error.
! 
! Interactively, DISPLAY-FLAG is t and NEWNAME is the name of the
! current buffer with appropriate suffix.  However, if a prefix
! argument is given, then the command prompts for NEWNAME in the
! minibuffer.
  
  This runs the normal hook `clone-buffer-hook' in the new buffer
  after it has been set up properly in other respects."
    (interactive
============================================================