Commit 7354ca01 authored by Richard M. Stallman's avatar Richard M. Stallman
Browse files

(Select Buffer): Doc next-buffer and prev-buffer.

(List Buffers): Clarify.
(Several Buffers): Doc T command.
(Buffer Convenience): Clarify menu.
parent 7f9c94b0
...@@ -67,6 +67,10 @@ megabytes. ...@@ -67,6 +67,10 @@ megabytes.
@table @kbd @table @kbd
@item C-x b @var{buffer} @key{RET} @item C-x b @var{buffer} @key{RET}
Select or create a buffer named @var{buffer} (@code{switch-to-buffer}). Select or create a buffer named @var{buffer} (@code{switch-to-buffer}).
@item C-x @key{LEFT}
Select the previous buffer in the list of existing buffers.
@item C-x @key{RIGHT}
Select the next buffer in the list of existing buffers.
@item C-x 4 b @var{buffer} @key{RET} @item C-x 4 b @var{buffer} @key{RET}
Similar, but select @var{buffer} in another window Similar, but select @var{buffer} in another window
(@code{switch-to-buffer-other-window}). (@code{switch-to-buffer-other-window}).
...@@ -84,6 +88,16 @@ name you want (@pxref{Completion}). An empty argument to @kbd{C-x b} ...@@ -84,6 +88,16 @@ name you want (@pxref{Completion}). An empty argument to @kbd{C-x b}
specifies the buffer that was current most recently among those not specifies the buffer that was current most recently among those not
now displayed in any window. now displayed in any window.
@kindex C-x @key{LEFT}
@kindex C-x @key{RIGHT}
@findex next-buffer
@findex prev-buffer
For conveniently switching between a few buffers, use the commands
@kbd{C-x @key{LEFT}} and @kbd{C-x @key{RIGHT}}. @kbd{C-x @key{RIGHT}}
(@code{prev-buffer}) selects the previous buffer (following the order
of most recent selection), while @kbd{C-x @key{LEFT}}
(@code{next-buffer}) moves through buffers in the reverse direction.
@kindex C-x 4 b @kindex C-x 4 b
@findex switch-to-buffer-other-window @findex switch-to-buffer-other-window
@vindex even-window-heights @vindex even-window-heights
...@@ -141,9 +155,9 @@ List the existing buffers (@code{list-buffers}). ...@@ -141,9 +155,9 @@ 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 all the buffers that exist, type @kbd{C-x C-b}. To display a list of existing buffers, type @kbd{C-x C-b}. Each
Each line in the list shows one buffer's name, major mode and visited line in the list shows one buffer's name, major mode and visited file.
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.
@samp{*} in the first field of a line indicates the buffer is ``modified.'' @samp{*} in the first field of a line indicates the buffer is ``modified.''
...@@ -171,7 +185,7 @@ directory @file{~/cvs/emacs/src/}. You can list only buffers that are ...@@ -171,7 +185,7 @@ directory @file{~/cvs/emacs/src/}. You can list only buffers that are
visiting files by giving the command a prefix; for instance, by typing visiting files by giving the command a prefix; for instance, by typing
@kbd{C-u C-x C-b}. @kbd{C-u C-x C-b}.
@code{list-buffers} omits buffers whose name begins with a blank, @code{list-buffers} omits buffers whose names begin with a space,
unless they visit files: such buffers are used internally by Emacs. unless they visit files: such buffers are used internally by Emacs.
@need 2000 @need 2000
...@@ -332,8 +346,9 @@ Similar, but do it in another window. ...@@ -332,8 +346,9 @@ Similar, but do it in another window.
buffers@footnote{Buffers which don't visit files and whose names begin buffers@footnote{Buffers which don't visit files and whose names begin
with a space are omitted: these are used internally by Emacs.} into the with a space are omitted: these are used internally by Emacs.} into the
buffer @samp{*Buffer List*}, and selects that buffer in Buffer Menu buffer @samp{*Buffer List*}, and selects that buffer in Buffer Menu
mode. The list in the @samp{*Buffer List*} buffer looks exactly as mode.
described in @ref{List Buffers}. The buffer is read-only, and can be
The buffer is read-only, and can be
changed only through the special commands described in this section. changed only through the special commands described in this section.
The usual Emacs cursor motion commands can be used in the @samp{*Buffer The usual Emacs cursor motion commands can be used in the @samp{*Buffer
List*} buffer. The following commands apply to the buffer described on List*} buffer. The following commands apply to the buffer described on
...@@ -411,21 +426,32 @@ any buffers previously marked with the @kbd{m} command. If you have not ...@@ -411,21 +426,32 @@ any buffers previously marked with the @kbd{m} command. If you have not
marked any buffers, this command is equivalent to @kbd{1}. marked any buffers, this command is equivalent to @kbd{1}.
@end table @end table
All that @code{buffer-menu} does directly is create and switch to a There is also a command that affects the entire buffer list:
suitable buffer, and turn on Buffer Menu mode. Everything else
@table @kbd
@item T
Delete, or reinsert, lines for non-file buffers. This command toggles
the inclusion of such buffers in the buffer list.
@end table
What @code{buffer-menu} actually does is create and switch to a
suitable buffer, and turn on Buffer Menu mode in it. Everything else
described above is implemented by the special commands provided in described above is implemented by the special commands provided in
Buffer Menu mode. One consequence of this is that you can switch from Buffer Menu mode. One consequence of this is that you can switch from
the @samp{*Buffer List*} buffer to another Emacs buffer, and edit there. the @samp{*Buffer List*} buffer to another Emacs buffer, and edit
You can reselect the @samp{*Buffer List*} buffer later, to perform the there. You can reselect the @samp{*Buffer List*} buffer later, to
operations already requested, or you can kill it, or pay no further perform the operations already requested, or you can kill it, or pay
attention to it. no further attention to it.
The only difference between @code{buffer-menu} and @code{list-buffers} The list in the @samp{*Buffer List*} buffer looks exactly like the
is that @code{buffer-menu} switches to the @samp{*Buffer List*} buffer buffer list described in @ref{List Buffers}, because they really are
in the selected window; @code{list-buffers} displays it in another the same. The only difference between @code{buffer-menu} and
window. If you run @code{list-buffers} (that is, type @kbd{C-x C-b}) @code{list-buffers} is that @code{buffer-menu} switches to the
and select the buffer list manually, you can use all of the commands @samp{*Buffer List*} buffer in the selected window;
described here. @code{list-buffers} displays the same buffer in another window. If
you run @code{list-buffers} (that is, type @kbd{C-x C-b}) and select
the buffer list manually, you can use all of the commands described
here.
Normally, the buffer @samp{*Buffer List*} is not updated automatically when Normally, the buffer @samp{*Buffer List*} is not updated automatically when
buffers are created and killed; its contents are just text. If you have buffers are created and killed; its contents are just text. If you have
...@@ -506,7 +532,7 @@ minibuffer. ...@@ -506,7 +532,7 @@ minibuffer.
convenient to switch between buffers. convenient to switch between buffers.
@menu @menu
* Uniquify:: Buffer names can contain directory parts. * Uniquify:: Making buffer names unique with directory parts.
* Iswitchb:: Switching between buffers with substrings. * Iswitchb:: Switching between buffers with substrings.
* Buffer Menus:: Configurable buffer menu. * Buffer Menus:: Configurable buffer menu.
@end menu @end menu
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment