[Emacs-diffs] emacs-26 759569f: Improve the "Buffers" chapter of the user manual

[Eli Zaretskii]

branch: emacs-26
commit 759569fe40ecf7d4dc4e1ec300c9d6f41ea6ac4b
Author: Eli Zaretskii <address@hidden>
Commit: Eli Zaretskii <address@hidden>

    Improve the "Buffers" chapter of the user manual
    
    * doc/emacs/buffers.texi (Several Buffers): Correct description of
    prefix arguments.  Clarify "bury".
    (Buffer Menus): Clarify wording.  Reported by John Cummings
    <address@hidden> in address@hidden
---
 doc/emacs/buffers.texi | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/doc/emacs/buffers.texi b/doc/emacs/buffers.texi
index 6a8e32b..f8c1856 100644
--- a/doc/emacs/buffers.texi
+++ b/doc/emacs/buffers.texi
@@ -414,7 +414,8 @@ Perform all flagged deletions and saves 
(@code{Buffer-menu-execute}).
 @findex Buffer-menu-unmark
 @kindex u @r{(Buffer Menu)}
 Remove all flags from the current line, and move down
-(@code{Buffer-menu-unmark}).
+(@code{Buffer-menu-unmark}).  With a prefix argument, moves up after
+removing the flags.
 
 @item @key{DEL}
 @findex Buffer-menu-backup-unmark
@@ -438,8 +439,8 @@ Remove all flags from all the lines
 @end table
 
 @noindent
-The commands for adding or removing flags, @kbd{d}, @kbd{C-d}, @kbd{s}
-and @kbd{u}, all accept a numeric argument as a repeat count.
+The commands for removing flags, @kbd{d} and @kbd{C-d}, accept a
+numeric argument as a repeat count.
 
   The following commands operate immediately on the buffer listed on
 the current line.  They also accept a numeric argument as a repeat
@@ -511,7 +512,8 @@ selected in one, and a previously current buffer (aside from
 @item b
 @findex Buffer-menu-bury
 @kindex b @r{(Buffer Menu)}
-Bury this line's buffer (@code{Buffer-menu-bury}).
+Bury this line's buffer (@code{Buffer-menu-bury}) (i.e., move it to
+the end of the buffer list).
 
 @item m
 @findex Buffer-menu-mark
@@ -733,10 +735,10 @@ C-b}.  To customize this buffer list, use the @code{bs} 
Custom group
 @kindex C-Down-mouse-1
   MSB global minor mode (``MSB'' stands for ``mouse select buffer'')
 provides a different and customizable mouse buffer menu which you may
-prefer.  It replaces the bindings of @code{mouse-buffer-menu},
-normally on @kbd{C-Down-mouse-1} and @address@hidden, and the menu
-bar buffer menu.  You can customize the menu in the @code{msb} Custom
-group.
+prefer.  It replaces the @code{mouse-buffer-menu} commands, normally
+bound to @kbd{C-Down-mouse-1} and @address@hidden, with its own
+commands, and also modifies the menu-bar buffer menu.  You can
+customize the menu in the @code{msb} Custom group.
 
 @findex ibuffer
    IBuffer is a major mode for viewing a list of buffers and operating