From 77cf972592ee1c86ca330a42d4009f99bed1a349 Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Sat, 2 Dec 2017 12:56:45 +0200 Subject: [PATCH] Improve documentation of buffer-list commands and features * doc/emacs/buffers.texi (List Buffers): Add a cross-reference to "Several Buffers", to establish a relation between the two sections. (Buffer Menus): Expand on customizability of alternative buffer menu offered by bs.el. Mention IBuffer. Suggested by Alex Branham in emacs-manual-bugs@gnu.org. --- doc/emacs/buffers.texi | 25 +++++++++++++++++++++---- 1 file changed, 21 insertions(+), 4 deletions(-) diff --git a/doc/emacs/buffers.texi b/doc/emacs/buffers.texi index 362d3b36453..1a27fe877e0 100644 --- a/doc/emacs/buffers.texi +++ b/doc/emacs/buffers.texi @@ -174,10 +174,15 @@ List the existing buffers (@code{list-buffers}). @cindex listing current buffers @kindex C-x C-b @findex list-buffers - To display a list of existing buffers, type @kbd{C-x C-b}. Each + To display a list of existing buffers, type @kbd{C-x C-b}. This +pops up a buffer menu in a buffer named @file{*Buffer List*}. Each line in the list shows one buffer's name, size, major mode and visited file. The buffers are listed in the order that they were current; the -buffers that were current most recently come first. +buffers that were current most recently come first. This section +describes how the list of buffers is displayed and how to interpret +the various indications in the list; see @ref{Several Buffers}, for +description of the special mode in the @file{*Buffer List*} buffer and +the commands available there. @samp{.} in the first field of a line indicates that the buffer is current. @samp{%} indicates a read-only buffer. @samp{*} indicates @@ -700,13 +705,20 @@ Customization}). @item M-x bs-show Make a list of buffers similarly to @kbd{M-x list-buffers} but customizable. +@item M-x ibuffer +Make a list of buffers and operate on them in Dired-like fashion. @end table +@findex bs-customize @kbd{M-x bs-show} pops up a buffer list similar to the one normally -displayed by @kbd{C-x C-b} but which you can customize. If you prefer +displayed by @kbd{C-x C-b}, but whose display you can customize in a +more flexible fashion. For example, you can specify the list of +buffer attributes to show, the minimum and maximum width of buffer +name column, a regexp for names of buffers that will never be shown +and those which will always be shown, etc. If you prefer this to the usual buffer list, you can bind this command to @kbd{C-x C-b}. To customize this buffer list, use the @code{bs} Custom group -(@pxref{Easy Customization}). +(@pxref{Easy Customization}), or invoke @kbd{bs-customize}. @findex msb-mode @cindex mode, MSB @@ -719,3 +731,8 @@ prefer. It replaces the bindings of @code{mouse-buffer-menu}, normally on @kbd{C-Down-mouse-1} and @kbd{C-@key{F10}}, and 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 +on them in a way analogous to that of Dired (@pxref{Dired}), including +filtering, marking, sorting in various ways, and acting on buffers. -- 2.39.2