procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Improve documentation of buffer-list commands and features

Browse source 
* 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 <alex.branham@gmail.com> in
emacs-manual-bugs@gnu.org.
This commit is contained in:
Eli Zaretskii 2017-12-02 12:56:45 +02:00
parent 66ec92af00
commit 77cf972592
1 changed files with 21 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

25
doc/emacs/buffers.texi
View file

@ -174,10 +174,15 @@ List the existing buffers (@code{list-buffers}).
@cindex listing current buffers @cindex listing current buffers
@kindex C-x C-b @kindex C-x C-b
@findex list-buffers @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. 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 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 @samp{.} in the first field of a line indicates that the buffer is
current. @samp{%} indicates a read-only buffer. @samp{*} indicates current. @samp{%} indicates a read-only buffer. @samp{*} indicates
@ -700,13 +705,20 @@ Customization}).
@item M-x bs-show @item M-x bs-show
Make a list of buffers similarly to @kbd{M-x list-buffers} but Make a list of buffers similarly to @kbd{M-x list-buffers} but
customizable. customizable.
@item M-x ibuffer
Make a list of buffers and operate on them in Dired-like fashion.
@end table @end table
@findex bs-customize
@kbd{M-x bs-show} pops up a buffer list similar to the one normally @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 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 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 @findex msb-mode
@cindex mode, MSB @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 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 bar buffer menu. You can customize the menu in the @code{msb} Custom
group. 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.