annotate man/buffers.texi @ 33093:46fe3d0d327b

*** empty log message ***
author Gerd Moellmann <gerd@gnu.org>
date Tue, 31 Oct 2000 11:57:12 +0000
parents e0b702f0bc3c
children 44a6f7ea121f
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1 @c This is part of the Emacs manual.
31311
a04fdd7a9207 bs-show
Dave Love <fx@gnu.org>
parents: 31185
diff changeset
2 @c Copyright (C) 1985, 86, 87, 93, 94, 95, 97, 2000
a04fdd7a9207 bs-show
Dave Love <fx@gnu.org>
parents: 31185
diff changeset
3 @c Free Software Foundation, Inc.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4 @c See file emacs.texi for copying conditions.
Dave Love <fx@gnu.org>
parents:
diff changeset
5 @node Buffers, Windows, Files, Top
Dave Love <fx@gnu.org>
parents:
diff changeset
6 @chapter Using Multiple Buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
7
Dave Love <fx@gnu.org>
parents:
diff changeset
8 @cindex buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
9 The text you are editing in Emacs resides in an object called a
Dave Love <fx@gnu.org>
parents:
diff changeset
10 @dfn{buffer}. Each time you visit a file, a buffer is created to hold the
Dave Love <fx@gnu.org>
parents:
diff changeset
11 file's text. Each time you invoke Dired, a buffer is created to hold the
Dave Love <fx@gnu.org>
parents:
diff changeset
12 directory listing. If you send a message with @kbd{C-x m}, a buffer named
Dave Love <fx@gnu.org>
parents:
diff changeset
13 @samp{*mail*} is used to hold the text of the message. When you ask for a
Dave Love <fx@gnu.org>
parents:
diff changeset
14 command's documentation, that appears in a buffer called @samp{*Help*}.
Dave Love <fx@gnu.org>
parents:
diff changeset
15
Dave Love <fx@gnu.org>
parents:
diff changeset
16 @cindex selected buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
17 @cindex current buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
18 At any time, one and only one buffer is @dfn{selected}. It is also
Dave Love <fx@gnu.org>
parents:
diff changeset
19 called the @dfn{current buffer}. Often we say that a command operates on
Dave Love <fx@gnu.org>
parents:
diff changeset
20 ``the buffer'' as if there were only one; but really this means that the
Dave Love <fx@gnu.org>
parents:
diff changeset
21 command operates on the selected buffer (most commands do).
Dave Love <fx@gnu.org>
parents:
diff changeset
22
Dave Love <fx@gnu.org>
parents:
diff changeset
23 When Emacs has multiple windows, each window has a chosen buffer which
Dave Love <fx@gnu.org>
parents:
diff changeset
24 is displayed there, but at any time only one of the windows is selected and
Dave Love <fx@gnu.org>
parents:
diff changeset
25 its chosen buffer is the selected buffer. Each window's mode line displays
Dave Love <fx@gnu.org>
parents:
diff changeset
26 the name of the buffer that the window is displaying (@pxref{Windows}).
Dave Love <fx@gnu.org>
parents:
diff changeset
27
Dave Love <fx@gnu.org>
parents:
diff changeset
28 Each buffer has a name, which can be of any length, and you can select
Dave Love <fx@gnu.org>
parents:
diff changeset
29 any buffer by giving its name. Most buffers are made by visiting files,
Dave Love <fx@gnu.org>
parents:
diff changeset
30 and their names are derived from the files' names. But you can also create
Dave Love <fx@gnu.org>
parents:
diff changeset
31 an empty buffer with any name you want. A newly started Emacs has a buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
32 named @samp{*scratch*} which can be used for evaluating Lisp expressions in
Dave Love <fx@gnu.org>
parents:
diff changeset
33 Emacs. The distinction between upper and lower case matters in buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
34 names.
Dave Love <fx@gnu.org>
parents:
diff changeset
35
Dave Love <fx@gnu.org>
parents:
diff changeset
36 Each buffer records individually what file it is visiting, whether it is
Dave Love <fx@gnu.org>
parents:
diff changeset
37 modified, and what major mode and minor modes are in effect in it
Dave Love <fx@gnu.org>
parents:
diff changeset
38 (@pxref{Major Modes}). Any Emacs variable can be made @dfn{local to} a
Dave Love <fx@gnu.org>
parents:
diff changeset
39 particular buffer, meaning its value in that buffer can be different from
Dave Love <fx@gnu.org>
parents:
diff changeset
40 the value in other buffers. @xref{Locals}.
Dave Love <fx@gnu.org>
parents:
diff changeset
41
Dave Love <fx@gnu.org>
parents:
diff changeset
42 @menu
Dave Love <fx@gnu.org>
parents:
diff changeset
43 * Select Buffer:: Creating a new buffer or reselecting an old one.
Dave Love <fx@gnu.org>
parents:
diff changeset
44 * List Buffers:: Getting a list of buffers that exist.
Dave Love <fx@gnu.org>
parents:
diff changeset
45 * Misc Buffer:: Renaming; changing read-onlyness; copying text.
Dave Love <fx@gnu.org>
parents:
diff changeset
46 * Kill Buffer:: Killing buffers you no longer need.
Dave Love <fx@gnu.org>
parents:
diff changeset
47 * Several Buffers:: How to go through the list of all buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
48 and operate variously on several of them.
Dave Love <fx@gnu.org>
parents:
diff changeset
49 * Indirect Buffers:: An indirect buffer shares the text of another buffer.
30869
1827bd720842 (Buffer Convenience): New.
Dave Love <fx@gnu.org>
parents: 30772
diff changeset
50 * Buffer Convenience:: Convenience and customization features for
1827bd720842 (Buffer Convenience): New.
Dave Love <fx@gnu.org>
parents: 30772
diff changeset
51 buffer handling.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
52 @end menu
Dave Love <fx@gnu.org>
parents:
diff changeset
53
Dave Love <fx@gnu.org>
parents:
diff changeset
54 @node Select Buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
55 @section Creating and Selecting Buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
56 @cindex change buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
57 @cindex switch buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
58
Dave Love <fx@gnu.org>
parents:
diff changeset
59 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
60 @item C-x b @var{buffer} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
61 Select or create a buffer named @var{buffer} (@code{switch-to-buffer}).
Dave Love <fx@gnu.org>
parents:
diff changeset
62 @item C-x 4 b @var{buffer} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
63 Similar, but select @var{buffer} in another window
Dave Love <fx@gnu.org>
parents:
diff changeset
64 (@code{switch-to-buffer-other-window}).
Dave Love <fx@gnu.org>
parents:
diff changeset
65 @item C-x 5 b @var{buffer} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
66 Similar, but select @var{buffer} in a separate frame
Dave Love <fx@gnu.org>
parents:
diff changeset
67 (@code{switch-to-buffer-other-frame}).
Dave Love <fx@gnu.org>
parents:
diff changeset
68 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
69
Dave Love <fx@gnu.org>
parents:
diff changeset
70 @kindex C-x 4 b
Dave Love <fx@gnu.org>
parents:
diff changeset
71 @findex switch-to-buffer-other-window
Dave Love <fx@gnu.org>
parents:
diff changeset
72 @kindex C-x 5 b
Dave Love <fx@gnu.org>
parents:
diff changeset
73 @findex switch-to-buffer-other-frame
Dave Love <fx@gnu.org>
parents:
diff changeset
74 @kindex C-x b
Dave Love <fx@gnu.org>
parents:
diff changeset
75 @findex switch-to-buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
76 To select the buffer named @var{bufname}, type @kbd{C-x b @var{bufname}
Dave Love <fx@gnu.org>
parents:
diff changeset
77 @key{RET}}. This runs the command @code{switch-to-buffer} with argument
Dave Love <fx@gnu.org>
parents:
diff changeset
78 @var{bufname}. You can use completion on an abbreviation for the buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
79 name you want (@pxref{Completion}). An empty argument to @kbd{C-x b}
Dave Love <fx@gnu.org>
parents:
diff changeset
80 specifies the most recently selected buffer that is not displayed in any
Dave Love <fx@gnu.org>
parents:
diff changeset
81 window.@refill
Dave Love <fx@gnu.org>
parents:
diff changeset
82
Dave Love <fx@gnu.org>
parents:
diff changeset
83 Most buffers are created by visiting files, or by Emacs commands that
Dave Love <fx@gnu.org>
parents:
diff changeset
84 want to display some text, but you can also create a buffer explicitly
Dave Love <fx@gnu.org>
parents:
diff changeset
85 by typing @kbd{C-x b @var{bufname} @key{RET}}. This makes a new, empty
Dave Love <fx@gnu.org>
parents:
diff changeset
86 buffer that is not visiting any file, and selects it for editing. Such
Dave Love <fx@gnu.org>
parents:
diff changeset
87 buffers are used for making notes to yourself. If you try to save one,
Dave Love <fx@gnu.org>
parents:
diff changeset
88 you are asked for the file name to use. The new buffer's major mode is
Dave Love <fx@gnu.org>
parents:
diff changeset
89 determined by the value of @code{default-major-mode} (@pxref{Major
Dave Love <fx@gnu.org>
parents:
diff changeset
90 Modes}).
Dave Love <fx@gnu.org>
parents:
diff changeset
91
Dave Love <fx@gnu.org>
parents:
diff changeset
92 Note that @kbd{C-x C-f}, and any other command for visiting a file,
Dave Love <fx@gnu.org>
parents:
diff changeset
93 can also be used to switch to an existing file-visiting buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
94 @xref{Visiting}.
Dave Love <fx@gnu.org>
parents:
diff changeset
95
Dave Love <fx@gnu.org>
parents:
diff changeset
96 Emacs uses buffer names that start with a space for internal purposes.
Dave Love <fx@gnu.org>
parents:
diff changeset
97 It treats these buffers specially in minor ways---for example, by
Dave Love <fx@gnu.org>
parents:
diff changeset
98 default they do not record undo information. It is best to avoid using
Dave Love <fx@gnu.org>
parents:
diff changeset
99 such buffer names yourself.
Dave Love <fx@gnu.org>
parents:
diff changeset
100
Dave Love <fx@gnu.org>
parents:
diff changeset
101 @node List Buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
102 @section Listing Existing Buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
103
Dave Love <fx@gnu.org>
parents:
diff changeset
104 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
105 @item C-x C-b
Dave Love <fx@gnu.org>
parents:
diff changeset
106 List the existing buffers (@code{list-buffers}).
Dave Love <fx@gnu.org>
parents:
diff changeset
107 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
108
Dave Love <fx@gnu.org>
parents:
diff changeset
109 @cindex listing current buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
110 @kindex C-x C-b
Dave Love <fx@gnu.org>
parents:
diff changeset
111 @findex list-buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
112 To display a list of all the buffers that exist, type @kbd{C-x C-b}.
Dave Love <fx@gnu.org>
parents:
diff changeset
113 Each line in the list shows one buffer's name, major mode and visited
Dave Love <fx@gnu.org>
parents:
diff changeset
114 file. The buffers are listed in the order that they were current; the
Dave Love <fx@gnu.org>
parents:
diff changeset
115 buffers that were current most recently come first.
Dave Love <fx@gnu.org>
parents:
diff changeset
116
Dave Love <fx@gnu.org>
parents:
diff changeset
117 @samp{*} at the beginning of a line indicates the buffer is ``modified.''
Dave Love <fx@gnu.org>
parents:
diff changeset
118 If several buffers are modified, it may be time to save some with @kbd{C-x s}
Dave Love <fx@gnu.org>
parents:
diff changeset
119 (@pxref{Saving}). @samp{%} indicates a read-only buffer. @samp{.} marks the
Dave Love <fx@gnu.org>
parents:
diff changeset
120 selected buffer. Here is an example of a buffer list:@refill
Dave Love <fx@gnu.org>
parents:
diff changeset
121
Dave Love <fx@gnu.org>
parents:
diff changeset
122 @smallexample
Dave Love <fx@gnu.org>
parents:
diff changeset
123 MR Buffer Size Mode File
Dave Love <fx@gnu.org>
parents:
diff changeset
124 -- ------ ---- ---- ----
Dave Love <fx@gnu.org>
parents:
diff changeset
125 .* emacs.tex 383402 Texinfo /u2/emacs/man/emacs.tex
Dave Love <fx@gnu.org>
parents:
diff changeset
126 *Help* 1287 Fundamental
Dave Love <fx@gnu.org>
parents:
diff changeset
127 files.el 23076 Emacs-Lisp /u2/emacs/lisp/files.el
Dave Love <fx@gnu.org>
parents:
diff changeset
128 % RMAIL 64042 RMAIL /u/rms/RMAIL
Dave Love <fx@gnu.org>
parents:
diff changeset
129 *% man 747 Dired /u2/emacs/man/
Dave Love <fx@gnu.org>
parents:
diff changeset
130 net.emacs 343885 Fundamental /u/rms/net.emacs
Dave Love <fx@gnu.org>
parents:
diff changeset
131 fileio.c 27691 C /u2/emacs/src/fileio.c
Dave Love <fx@gnu.org>
parents:
diff changeset
132 NEWS 67340 Text /u2/emacs/etc/NEWS
Dave Love <fx@gnu.org>
parents:
diff changeset
133 *scratch* 0 Lisp Interaction
Dave Love <fx@gnu.org>
parents:
diff changeset
134 @end smallexample
Dave Love <fx@gnu.org>
parents:
diff changeset
135
Dave Love <fx@gnu.org>
parents:
diff changeset
136 @noindent
Dave Love <fx@gnu.org>
parents:
diff changeset
137 Note that the buffer @samp{*Help*} was made by a help request; it is not
Dave Love <fx@gnu.org>
parents:
diff changeset
138 visiting any file. The buffer @code{man} was made by Dired on the
28384
11c8496abbfb *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents: 25829
diff changeset
139 directory @file{/u2/emacs/man/}. You can list buffers visiting files
11c8496abbfb *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents: 25829
diff changeset
140 only by giving the command a prefix, i.e. type @kbd{C-u C-x C-b}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
141
Dave Love <fx@gnu.org>
parents:
diff changeset
142 @need 2000
Dave Love <fx@gnu.org>
parents:
diff changeset
143 @node Misc Buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
144 @section Miscellaneous Buffer Operations
Dave Love <fx@gnu.org>
parents:
diff changeset
145
Dave Love <fx@gnu.org>
parents:
diff changeset
146 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
147 @item C-x C-q
Dave Love <fx@gnu.org>
parents:
diff changeset
148 Toggle read-only status of buffer (@code{vc-toggle-read-only}).
Dave Love <fx@gnu.org>
parents:
diff changeset
149 @item M-x rename-buffer @key{RET} @var{name} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
150 Change the name of the current buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
151 @item M-x rename-uniquely
Dave Love <fx@gnu.org>
parents:
diff changeset
152 Rename the current buffer by adding @samp{<@var{number}>} to the end.
Dave Love <fx@gnu.org>
parents:
diff changeset
153 @item M-x view-buffer @key{RET} @var{buffer} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
154 Scroll through buffer @var{buffer}.
Dave Love <fx@gnu.org>
parents:
diff changeset
155 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
156
Dave Love <fx@gnu.org>
parents:
diff changeset
157 @kindex C-x C-q
Dave Love <fx@gnu.org>
parents:
diff changeset
158 @findex vc-toggle-read-only
Dave Love <fx@gnu.org>
parents:
diff changeset
159 @vindex buffer-read-only
Dave Love <fx@gnu.org>
parents:
diff changeset
160 @cindex read-only buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
161 A buffer can be @dfn{read-only}, which means that commands to change
Dave Love <fx@gnu.org>
parents:
diff changeset
162 its contents are not allowed. The mode line indicates read-only buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
163 with @samp{%%} or @samp{%*} near the left margin. Read-only buffers are
Dave Love <fx@gnu.org>
parents:
diff changeset
164 usually made by subsystems such as Dired and Rmail that have special
Dave Love <fx@gnu.org>
parents:
diff changeset
165 commands to operate on the text; also by visiting a file whose access
30772
43cd847ecb62 (Misc Buffer): Document kill-read-only-ok.
Eli Zaretskii <eliz@gnu.org>
parents: 28384
diff changeset
166 control says you cannot write it. However, if the variable
43cd847ecb62 (Misc Buffer): Document kill-read-only-ok.
Eli Zaretskii <eliz@gnu.org>
parents: 28384
diff changeset
167 @code{kill-read-only-ok} is set to a non-@code{nil} value, you can kill
43cd847ecb62 (Misc Buffer): Document kill-read-only-ok.
Eli Zaretskii <eliz@gnu.org>
parents: 28384
diff changeset
168 (a.k.a.@: cut) read-only text, see @ref{Killing}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
169
Dave Love <fx@gnu.org>
parents:
diff changeset
170 If you wish to make changes in a read-only buffer, use the command
Dave Love <fx@gnu.org>
parents:
diff changeset
171 @kbd{C-x C-q} (@code{vc-toggle-read-only}). It makes a read-only buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
172 writable, and makes a writable buffer read-only. In most cases, this
Dave Love <fx@gnu.org>
parents:
diff changeset
173 works by setting the variable @code{buffer-read-only}, which has a local
Dave Love <fx@gnu.org>
parents:
diff changeset
174 value in each buffer and makes the buffer read-only if its value is
Dave Love <fx@gnu.org>
parents:
diff changeset
175 non-@code{nil}. If the file is maintained with version control,
Dave Love <fx@gnu.org>
parents:
diff changeset
176 @kbd{C-x C-q} works through the version control system to change the
Dave Love <fx@gnu.org>
parents:
diff changeset
177 read-only status of the file as well as the buffer. @xref{Version
Dave Love <fx@gnu.org>
parents:
diff changeset
178 Control}.
Dave Love <fx@gnu.org>
parents:
diff changeset
179
Dave Love <fx@gnu.org>
parents:
diff changeset
180 @findex rename-buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
181 @kbd{M-x rename-buffer} changes the name of the current buffer. Specify
Dave Love <fx@gnu.org>
parents:
diff changeset
182 the new name as a minibuffer argument. There is no default. If you
Dave Love <fx@gnu.org>
parents:
diff changeset
183 specify a name that is in use for some other buffer, an error happens and
Dave Love <fx@gnu.org>
parents:
diff changeset
184 no renaming is done.
Dave Love <fx@gnu.org>
parents:
diff changeset
185
Dave Love <fx@gnu.org>
parents:
diff changeset
186 @kbd{M-x rename-uniquely} renames the current buffer to a similar name
Dave Love <fx@gnu.org>
parents:
diff changeset
187 with a numeric suffix added to make it both different and unique. This
Dave Love <fx@gnu.org>
parents:
diff changeset
188 command does not need an argument. It is useful for creating multiple
Dave Love <fx@gnu.org>
parents:
diff changeset
189 shell buffers: if you rename the @samp{*Shell*} buffer, then do @kbd{M-x
Dave Love <fx@gnu.org>
parents:
diff changeset
190 shell} again, it makes a new shell buffer named @samp{*Shell*};
Dave Love <fx@gnu.org>
parents:
diff changeset
191 meanwhile, the old shell buffer continues to exist under its new name.
Dave Love <fx@gnu.org>
parents:
diff changeset
192 This method is also good for mail buffers, compilation buffers, and most
Dave Love <fx@gnu.org>
parents:
diff changeset
193 Emacs features that create special buffers with particular names.
Dave Love <fx@gnu.org>
parents:
diff changeset
194
Dave Love <fx@gnu.org>
parents:
diff changeset
195 @findex view-buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
196 @kbd{M-x view-buffer} is much like @kbd{M-x view-file} (@pxref{Misc
Dave Love <fx@gnu.org>
parents:
diff changeset
197 File Ops}) except that it examines an already existing Emacs buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
198 View mode provides commands for scrolling through the buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
199 conveniently but not for changing it. When you exit View mode with
Dave Love <fx@gnu.org>
parents:
diff changeset
200 @kbd{q}, that switches back to the buffer (and the position) which was
Dave Love <fx@gnu.org>
parents:
diff changeset
201 previously displayed in the window. Alternatively, if you exit View
Dave Love <fx@gnu.org>
parents:
diff changeset
202 mode with @kbd{e}, the buffer and the value of point that resulted from
Dave Love <fx@gnu.org>
parents:
diff changeset
203 your perusal remain in effect.
Dave Love <fx@gnu.org>
parents:
diff changeset
204
Dave Love <fx@gnu.org>
parents:
diff changeset
205 The commands @kbd{M-x append-to-buffer} and @kbd{M-x insert-buffer}
Dave Love <fx@gnu.org>
parents:
diff changeset
206 can be used to copy text from one buffer to another. @xref{Accumulating
Dave Love <fx@gnu.org>
parents:
diff changeset
207 Text}.@refill
Dave Love <fx@gnu.org>
parents:
diff changeset
208
Dave Love <fx@gnu.org>
parents:
diff changeset
209 @node Kill Buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
210 @section Killing Buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
211
Dave Love <fx@gnu.org>
parents:
diff changeset
212 @cindex killing buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
213 If you continue an Emacs session for a while, you may accumulate a
Dave Love <fx@gnu.org>
parents:
diff changeset
214 large number of buffers. You may then find it convenient to @dfn{kill}
Dave Love <fx@gnu.org>
parents:
diff changeset
215 the buffers you no longer need. On most operating systems, killing a
Dave Love <fx@gnu.org>
parents:
diff changeset
216 buffer releases its space back to the operating system so that other
Dave Love <fx@gnu.org>
parents:
diff changeset
217 programs can use it. Here are some commands for killing buffers:
Dave Love <fx@gnu.org>
parents:
diff changeset
218
Dave Love <fx@gnu.org>
parents:
diff changeset
219 @c WideCommands
Dave Love <fx@gnu.org>
parents:
diff changeset
220 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
221 @item C-x k @var{bufname} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
222 Kill buffer @var{bufname} (@code{kill-buffer}).
Dave Love <fx@gnu.org>
parents:
diff changeset
223 @item M-x kill-some-buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
224 Offer to kill each buffer, one by one.
Dave Love <fx@gnu.org>
parents:
diff changeset
225 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
226
Dave Love <fx@gnu.org>
parents:
diff changeset
227 @findex kill-buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
228 @findex kill-some-buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
229 @kindex C-x k
Dave Love <fx@gnu.org>
parents:
diff changeset
230
Dave Love <fx@gnu.org>
parents:
diff changeset
231 @kbd{C-x k} (@code{kill-buffer}) kills one buffer, whose name you
Dave Love <fx@gnu.org>
parents:
diff changeset
232 specify in the minibuffer. The default, used if you type just @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
233 in the minibuffer, is to kill the current buffer. If you kill the
Dave Love <fx@gnu.org>
parents:
diff changeset
234 current buffer, another buffer is selected; one that has been selected
Dave Love <fx@gnu.org>
parents:
diff changeset
235 recently but does not appear in any window now. If you ask to kill a
Dave Love <fx@gnu.org>
parents:
diff changeset
236 file-visiting buffer that is modified (has unsaved editing), then you
Dave Love <fx@gnu.org>
parents:
diff changeset
237 must confirm with @kbd{yes} before the buffer is killed.
Dave Love <fx@gnu.org>
parents:
diff changeset
238
Dave Love <fx@gnu.org>
parents:
diff changeset
239 The command @kbd{M-x kill-some-buffers} asks about each buffer, one by
Dave Love <fx@gnu.org>
parents:
diff changeset
240 one. An answer of @kbd{y} means to kill the buffer. Killing the current
Dave Love <fx@gnu.org>
parents:
diff changeset
241 buffer or a buffer containing unsaved changes selects a new buffer or asks
Dave Love <fx@gnu.org>
parents:
diff changeset
242 for confirmation just like @code{kill-buffer}.
Dave Love <fx@gnu.org>
parents:
diff changeset
243
Dave Love <fx@gnu.org>
parents:
diff changeset
244 The buffer menu feature (@pxref{Several Buffers}) is also convenient
Dave Love <fx@gnu.org>
parents:
diff changeset
245 for killing various buffers.
Dave Love <fx@gnu.org>
parents:
diff changeset
246
Dave Love <fx@gnu.org>
parents:
diff changeset
247 @vindex kill-buffer-hook
Dave Love <fx@gnu.org>
parents:
diff changeset
248 If you want to do something special every time a buffer is killed, you
Dave Love <fx@gnu.org>
parents:
diff changeset
249 can add hook functions to the hook @code{kill-buffer-hook} (@pxref{Hooks}).
Dave Love <fx@gnu.org>
parents:
diff changeset
250
Dave Love <fx@gnu.org>
parents:
diff changeset
251 @findex clean-buffer-list
Dave Love <fx@gnu.org>
parents:
diff changeset
252 If you run one Emacs session for a period of days, as many people do,
Dave Love <fx@gnu.org>
parents:
diff changeset
253 it can fill up with buffers that you used several days ago. The command
Dave Love <fx@gnu.org>
parents:
diff changeset
254 @kbd{M-x clean-buffer-list} is a convenient way to purge them; it kills
Dave Love <fx@gnu.org>
parents:
diff changeset
255 all the unmodified buffers that you have not used for a long time. An
Dave Love <fx@gnu.org>
parents:
diff changeset
256 ordinary buffer is killed if it has not been displayed for three days;
Dave Love <fx@gnu.org>
parents:
diff changeset
257 however, you can specify certain buffers that should never be killed
Dave Love <fx@gnu.org>
parents:
diff changeset
258 automatically, and others that should be killed if they have been unused
Dave Love <fx@gnu.org>
parents:
diff changeset
259 for a mere hour.
Dave Love <fx@gnu.org>
parents:
diff changeset
260
Dave Love <fx@gnu.org>
parents:
diff changeset
261 @cindex Midnight mode
Dave Love <fx@gnu.org>
parents:
diff changeset
262 @vindex midnight-mode
Dave Love <fx@gnu.org>
parents:
diff changeset
263 @vindex midnight-hook
Dave Love <fx@gnu.org>
parents:
diff changeset
264 You can also have this buffer purging done for you, every day at
Dave Love <fx@gnu.org>
parents:
diff changeset
265 midnight, by enabling Midnight mode. Midnight mode operates each day at
Dave Love <fx@gnu.org>
parents:
diff changeset
266 midnight; at that time, it runs @code{clean-buffer-list}, or whichever
Dave Love <fx@gnu.org>
parents:
diff changeset
267 functions you have placed in the normal hook @code{midnight-hook}
Dave Love <fx@gnu.org>
parents:
diff changeset
268 (@pxref{Hooks}).
Dave Love <fx@gnu.org>
parents:
diff changeset
269
Dave Love <fx@gnu.org>
parents:
diff changeset
270 To enable Midnight mode, use the Customization buffer to set the
Dave Love <fx@gnu.org>
parents:
diff changeset
271 variable @code{midnight-mode} to @code{t}. @xref{Easy Customization}.
Dave Love <fx@gnu.org>
parents:
diff changeset
272
Dave Love <fx@gnu.org>
parents:
diff changeset
273 @node Several Buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
274 @section Operating on Several Buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
275 @cindex buffer menu
Dave Love <fx@gnu.org>
parents:
diff changeset
276
Dave Love <fx@gnu.org>
parents:
diff changeset
277 The @dfn{buffer-menu} facility is like a ``Dired for buffers''; it allows
Dave Love <fx@gnu.org>
parents:
diff changeset
278 you to request operations on various Emacs buffers by editing an Emacs
Dave Love <fx@gnu.org>
parents:
diff changeset
279 buffer containing a list of them. You can save buffers, kill them
Dave Love <fx@gnu.org>
parents:
diff changeset
280 (here called @dfn{deleting} them, for consistency with Dired), or display
Dave Love <fx@gnu.org>
parents:
diff changeset
281 them.
Dave Love <fx@gnu.org>
parents:
diff changeset
282
Dave Love <fx@gnu.org>
parents:
diff changeset
283 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
284 @item M-x buffer-menu
Dave Love <fx@gnu.org>
parents:
diff changeset
285 Begin editing a buffer listing all Emacs buffers.
Dave Love <fx@gnu.org>
parents:
diff changeset
286 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
287
Dave Love <fx@gnu.org>
parents:
diff changeset
288 @findex buffer-menu
Dave Love <fx@gnu.org>
parents:
diff changeset
289 The command @code{buffer-menu} writes a list of all Emacs buffers into
Dave Love <fx@gnu.org>
parents:
diff changeset
290 the buffer @samp{*Buffer List*}, and selects that buffer in Buffer Menu
Dave Love <fx@gnu.org>
parents:
diff changeset
291 mode. The buffer is read-only, and can be changed only through the
Dave Love <fx@gnu.org>
parents:
diff changeset
292 special commands described in this section. The usual Emacs cursor
Dave Love <fx@gnu.org>
parents:
diff changeset
293 motion commands can be used in the @samp{*Buffer List*} buffer. The
Dave Love <fx@gnu.org>
parents:
diff changeset
294 following commands apply to the buffer described on the current line.
Dave Love <fx@gnu.org>
parents:
diff changeset
295
Dave Love <fx@gnu.org>
parents:
diff changeset
296 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
297 @item d
Dave Love <fx@gnu.org>
parents:
diff changeset
298 Request to delete (kill) the buffer, then move down. The request
Dave Love <fx@gnu.org>
parents:
diff changeset
299 shows as a @samp{D} on the line, before the buffer name. Requested
Dave Love <fx@gnu.org>
parents:
diff changeset
300 deletions take place when you type the @kbd{x} command.
Dave Love <fx@gnu.org>
parents:
diff changeset
301 @item C-d
Dave Love <fx@gnu.org>
parents:
diff changeset
302 Like @kbd{d} but move up afterwards instead of down.
Dave Love <fx@gnu.org>
parents:
diff changeset
303 @item s
Dave Love <fx@gnu.org>
parents:
diff changeset
304 Request to save the buffer. The request shows as an @samp{S} on the
Dave Love <fx@gnu.org>
parents:
diff changeset
305 line. Requested saves take place when you type the @kbd{x} command.
Dave Love <fx@gnu.org>
parents:
diff changeset
306 You may request both saving and deletion for the same buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
307 @item x
Dave Love <fx@gnu.org>
parents:
diff changeset
308 Perform previously requested deletions and saves.
Dave Love <fx@gnu.org>
parents:
diff changeset
309 @item u
Dave Love <fx@gnu.org>
parents:
diff changeset
310 Remove any request made for the current line, and move down.
Dave Love <fx@gnu.org>
parents:
diff changeset
311 @item @key{DEL}
Dave Love <fx@gnu.org>
parents:
diff changeset
312 Move to previous line and remove any request made for that line.
Dave Love <fx@gnu.org>
parents:
diff changeset
313 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
314
Dave Love <fx@gnu.org>
parents:
diff changeset
315 The @kbd{d}, @kbd{C-d}, @kbd{s} and @kbd{u} commands to add or remove
Dave Love <fx@gnu.org>
parents:
diff changeset
316 flags also move down (or up) one line. They accept a numeric argument
Dave Love <fx@gnu.org>
parents:
diff changeset
317 as a repeat count.
Dave Love <fx@gnu.org>
parents:
diff changeset
318
Dave Love <fx@gnu.org>
parents:
diff changeset
319 These commands operate immediately on the buffer listed on the current
Dave Love <fx@gnu.org>
parents:
diff changeset
320 line:
Dave Love <fx@gnu.org>
parents:
diff changeset
321
Dave Love <fx@gnu.org>
parents:
diff changeset
322 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
323 @item ~
Dave Love <fx@gnu.org>
parents:
diff changeset
324 Mark the buffer ``unmodified.'' The command @kbd{~} does this
Dave Love <fx@gnu.org>
parents:
diff changeset
325 immediately when you type it.
Dave Love <fx@gnu.org>
parents:
diff changeset
326 @item %
Dave Love <fx@gnu.org>
parents:
diff changeset
327 Toggle the buffer's read-only flag. The command @kbd{%} does
Dave Love <fx@gnu.org>
parents:
diff changeset
328 this immediately when you type it.
Dave Love <fx@gnu.org>
parents:
diff changeset
329 @item t
Dave Love <fx@gnu.org>
parents:
diff changeset
330 Visit the buffer as a tags table. @xref{Select Tags Table}.
Dave Love <fx@gnu.org>
parents:
diff changeset
331 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
332
Dave Love <fx@gnu.org>
parents:
diff changeset
333 There are also commands to select another buffer or buffers:
Dave Love <fx@gnu.org>
parents:
diff changeset
334
Dave Love <fx@gnu.org>
parents:
diff changeset
335 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
336 @item q
Dave Love <fx@gnu.org>
parents:
diff changeset
337 Quit the buffer menu---immediately display the most recent formerly
Dave Love <fx@gnu.org>
parents:
diff changeset
338 visible buffer in its place.
Dave Love <fx@gnu.org>
parents:
diff changeset
339 @item @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
340 @itemx f
Dave Love <fx@gnu.org>
parents:
diff changeset
341 Immediately select this line's buffer in place of the @samp{*Buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
342 List*} buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
343 @item o
Dave Love <fx@gnu.org>
parents:
diff changeset
344 Immediately select this line's buffer in another window as if by
Dave Love <fx@gnu.org>
parents:
diff changeset
345 @kbd{C-x 4 b}, leaving @samp{*Buffer List*} visible.
Dave Love <fx@gnu.org>
parents:
diff changeset
346 @item C-o
Dave Love <fx@gnu.org>
parents:
diff changeset
347 Immediately display this line's buffer in another window, but don't
Dave Love <fx@gnu.org>
parents:
diff changeset
348 select the window.
Dave Love <fx@gnu.org>
parents:
diff changeset
349 @item 1
Dave Love <fx@gnu.org>
parents:
diff changeset
350 Immediately select this line's buffer in a full-screen window.
Dave Love <fx@gnu.org>
parents:
diff changeset
351 @item 2
Dave Love <fx@gnu.org>
parents:
diff changeset
352 Immediately set up two windows, with this line's buffer in one, and the
Dave Love <fx@gnu.org>
parents:
diff changeset
353 previously selected buffer (aside from the buffer @samp{*Buffer List*})
Dave Love <fx@gnu.org>
parents:
diff changeset
354 in the other.
Dave Love <fx@gnu.org>
parents:
diff changeset
355 @item b
Dave Love <fx@gnu.org>
parents:
diff changeset
356 Bury the buffer listed on this line.
Dave Love <fx@gnu.org>
parents:
diff changeset
357 @item m
Dave Love <fx@gnu.org>
parents:
diff changeset
358 Mark this line's buffer to be displayed in another window if you exit
Dave Love <fx@gnu.org>
parents:
diff changeset
359 with the @kbd{v} command. The request shows as a @samp{>} at the
Dave Love <fx@gnu.org>
parents:
diff changeset
360 beginning of the line. (A single buffer may not have both a delete
Dave Love <fx@gnu.org>
parents:
diff changeset
361 request and a display request.)
Dave Love <fx@gnu.org>
parents:
diff changeset
362 @item v
Dave Love <fx@gnu.org>
parents:
diff changeset
363 Immediately select this line's buffer, and also display in other windows
Dave Love <fx@gnu.org>
parents:
diff changeset
364 any buffers previously marked with the @kbd{m} command. If you have not
Dave Love <fx@gnu.org>
parents:
diff changeset
365 marked any buffers, this command is equivalent to @kbd{1}.
Dave Love <fx@gnu.org>
parents:
diff changeset
366 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
367
Dave Love <fx@gnu.org>
parents:
diff changeset
368 All that @code{buffer-menu} does directly is create and switch to a
Dave Love <fx@gnu.org>
parents:
diff changeset
369 suitable buffer, and turn on Buffer Menu mode. Everything else
Dave Love <fx@gnu.org>
parents:
diff changeset
370 described above is implemented by the special commands provided in
Dave Love <fx@gnu.org>
parents:
diff changeset
371 Buffer Menu mode. One consequence of this is that you can switch from
Dave Love <fx@gnu.org>
parents:
diff changeset
372 the @samp{*Buffer List*} buffer to another Emacs buffer, and edit there.
Dave Love <fx@gnu.org>
parents:
diff changeset
373 You can reselect the @samp{*Buffer List*} buffer later, to perform the
Dave Love <fx@gnu.org>
parents:
diff changeset
374 operations already requested, or you can kill it, or pay no further
Dave Love <fx@gnu.org>
parents:
diff changeset
375 attention to it.
Dave Love <fx@gnu.org>
parents:
diff changeset
376
Dave Love <fx@gnu.org>
parents:
diff changeset
377 The only difference between @code{buffer-menu} and @code{list-buffers}
Dave Love <fx@gnu.org>
parents:
diff changeset
378 is that @code{buffer-menu} switches to the @samp{*Buffer List*} buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
379 in the selected window; @code{list-buffers} displays it in another
Dave Love <fx@gnu.org>
parents:
diff changeset
380 window. If you run @code{list-buffers} (that is, type @kbd{C-x C-b})
Dave Love <fx@gnu.org>
parents:
diff changeset
381 and select the buffer list manually, you can use all of the commands
Dave Love <fx@gnu.org>
parents:
diff changeset
382 described here.
Dave Love <fx@gnu.org>
parents:
diff changeset
383
Dave Love <fx@gnu.org>
parents:
diff changeset
384 The buffer @samp{*Buffer List*} is not updated automatically when
Dave Love <fx@gnu.org>
parents:
diff changeset
385 buffers are created and killed; its contents are just text. If you have
Dave Love <fx@gnu.org>
parents:
diff changeset
386 created, deleted or renamed buffers, the way to update @samp{*Buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
387 List*} to show what you have done is to type @kbd{g}
Dave Love <fx@gnu.org>
parents:
diff changeset
388 (@code{revert-buffer}) or repeat the @code{buffer-menu} command.
Dave Love <fx@gnu.org>
parents:
diff changeset
389
Dave Love <fx@gnu.org>
parents:
diff changeset
390 @node Indirect Buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
391 @section Indirect Buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
392 @cindex indirect buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
393 @cindex base buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
394
Dave Love <fx@gnu.org>
parents:
diff changeset
395 An @dfn{indirect buffer} shares the text of some other buffer, which
Dave Love <fx@gnu.org>
parents:
diff changeset
396 is called the @dfn{base buffer} of the indirect buffer. In some ways it
Dave Love <fx@gnu.org>
parents:
diff changeset
397 is the analogue, for buffers, of a symbolic link between files.
Dave Love <fx@gnu.org>
parents:
diff changeset
398
Dave Love <fx@gnu.org>
parents:
diff changeset
399 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
400 @findex make-indirect-buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
401 @item M-x make-indirect-buffer @var{base-buffer} @key{RET} @var{indirect-name} @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
402 Create an indirect buffer named @var{indirect-name} whose base buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
403 is @var{base-buffer}.
31056
3d90d6c1f3b9 Document clone-indirect-buffer.
Eli Zaretskii <eliz@gnu.org>
parents: 30869
diff changeset
404 @findex clone-indirect-buffer
3d90d6c1f3b9 Document clone-indirect-buffer.
Eli Zaretskii <eliz@gnu.org>
parents: 30869
diff changeset
405 @item M-x clone-indirect-buffer @key{RET}
3d90d6c1f3b9 Document clone-indirect-buffer.
Eli Zaretskii <eliz@gnu.org>
parents: 30869
diff changeset
406 Create an indirect buffer that is a twin copy of the current buffer.
3d90d6c1f3b9 Document clone-indirect-buffer.
Eli Zaretskii <eliz@gnu.org>
parents: 30869
diff changeset
407 @kindex C-x 4 c
3d90d6c1f3b9 Document clone-indirect-buffer.
Eli Zaretskii <eliz@gnu.org>
parents: 30869
diff changeset
408 @findex clone-indirect-buffer-other-window
3d90d6c1f3b9 Document clone-indirect-buffer.
Eli Zaretskii <eliz@gnu.org>
parents: 30869
diff changeset
409 Create an indirect buffer that is a twin copy of the current buffer, and
3d90d6c1f3b9 Document clone-indirect-buffer.
Eli Zaretskii <eliz@gnu.org>
parents: 30869
diff changeset
410 select it in another window (@code{clone-indirect-buffer-other-window}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
411 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
412
Dave Love <fx@gnu.org>
parents:
diff changeset
413 The text of the indirect buffer is always identical to the text of its
Dave Love <fx@gnu.org>
parents:
diff changeset
414 base buffer; changes made by editing either one are visible immediately
Dave Love <fx@gnu.org>
parents:
diff changeset
415 in the other. But in all other respects, the indirect buffer and its
Dave Love <fx@gnu.org>
parents:
diff changeset
416 base buffer are completely separate. They have different names,
Dave Love <fx@gnu.org>
parents:
diff changeset
417 different values of point, different narrowing, different markers,
Dave Love <fx@gnu.org>
parents:
diff changeset
418 different major modes, and different local variables.
Dave Love <fx@gnu.org>
parents:
diff changeset
419
Dave Love <fx@gnu.org>
parents:
diff changeset
420 An indirect buffer cannot visit a file, but its base buffer can. If
Dave Love <fx@gnu.org>
parents:
diff changeset
421 you try to save the indirect buffer, that actually works by saving the
Dave Love <fx@gnu.org>
parents:
diff changeset
422 base buffer. Killing the base buffer effectively kills the indirect
Dave Love <fx@gnu.org>
parents:
diff changeset
423 buffer, but killing an indirect buffer has no effect on its base buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
424
Dave Love <fx@gnu.org>
parents:
diff changeset
425 One way to use indirect buffers is to display multiple views of an
Dave Love <fx@gnu.org>
parents:
diff changeset
426 outline. @xref{Outline Views}.
30869
1827bd720842 (Buffer Convenience): New.
Dave Love <fx@gnu.org>
parents: 30772
diff changeset
427
31056
3d90d6c1f3b9 Document clone-indirect-buffer.
Eli Zaretskii <eliz@gnu.org>
parents: 30869
diff changeset
428 The command @kbd{M-x make-indirect-buffer} creates an indirect buffer
3d90d6c1f3b9 Document clone-indirect-buffer.
Eli Zaretskii <eliz@gnu.org>
parents: 30869
diff changeset
429 whose name is @var{indirect-name} and whose text is identical to that of
3d90d6c1f3b9 Document clone-indirect-buffer.
Eli Zaretskii <eliz@gnu.org>
parents: 30869
diff changeset
430 the buffer @var{base-buffer}. It prompts for both @var{base-buffer} and
3d90d6c1f3b9 Document clone-indirect-buffer.
Eli Zaretskii <eliz@gnu.org>
parents: 30869
diff changeset
431 @var{indirect-name}.
3d90d6c1f3b9 Document clone-indirect-buffer.
Eli Zaretskii <eliz@gnu.org>
parents: 30869
diff changeset
432
31185
4140a40525e8 Mention that M-x clone-buffer can be used to create multiple *info* and
Eli Zaretskii <eliz@gnu.org>
parents: 31056
diff changeset
433 @cindex multiple @samp{*info*} and @samp{*Help*} buffers
31056
3d90d6c1f3b9 Document clone-indirect-buffer.
Eli Zaretskii <eliz@gnu.org>
parents: 30869
diff changeset
434 The command @kbd{M-x clone-indirect-buffer} creates an indirect buffer
3d90d6c1f3b9 Document clone-indirect-buffer.
Eli Zaretskii <eliz@gnu.org>
parents: 30869
diff changeset
435 whose base buffer is the current buffer, and also selects the
3d90d6c1f3b9 Document clone-indirect-buffer.
Eli Zaretskii <eliz@gnu.org>
parents: 30869
diff changeset
436 newly-created indirect buffer. With a numeric argument, it prompts for
3d90d6c1f3b9 Document clone-indirect-buffer.
Eli Zaretskii <eliz@gnu.org>
parents: 30869
diff changeset
437 the name of the indirect buffer; otherwise it defaults to the name of
3d90d6c1f3b9 Document clone-indirect-buffer.
Eli Zaretskii <eliz@gnu.org>
parents: 30869
diff changeset
438 the current buffer, modifying it by adding a @samp{<@var{n}>} prefix if
3d90d6c1f3b9 Document clone-indirect-buffer.
Eli Zaretskii <eliz@gnu.org>
parents: 30869
diff changeset
439 required. @kbd{C-x 4 c} (@code{clone-indirect-buffer-other-window})
3d90d6c1f3b9 Document clone-indirect-buffer.
Eli Zaretskii <eliz@gnu.org>
parents: 30869
diff changeset
440 works like @kbd{M-x clone-indirect-buffer}, but it selects the cloned
31185
4140a40525e8 Mention that M-x clone-buffer can be used to create multiple *info* and
Eli Zaretskii <eliz@gnu.org>
parents: 31056
diff changeset
441 buffer in another window. These commands come in handy if you want to
4140a40525e8 Mention that M-x clone-buffer can be used to create multiple *info* and
Eli Zaretskii <eliz@gnu.org>
parents: 31056
diff changeset
442 create new @samp{*info*} or @samp{*Help*} buffers, for example.
31056
3d90d6c1f3b9 Document clone-indirect-buffer.
Eli Zaretskii <eliz@gnu.org>
parents: 30869
diff changeset
443
30869
1827bd720842 (Buffer Convenience): New.
Dave Love <fx@gnu.org>
parents: 30772
diff changeset
444 @node Buffer Convenience
1827bd720842 (Buffer Convenience): New.
Dave Love <fx@gnu.org>
parents: 30772
diff changeset
445 @section Convenience Features and Customization of Buffer Handling
1827bd720842 (Buffer Convenience): New.
Dave Love <fx@gnu.org>
parents: 30772
diff changeset
446
1827bd720842 (Buffer Convenience): New.
Dave Love <fx@gnu.org>
parents: 30772
diff changeset
447 @menu
31311
a04fdd7a9207 bs-show
Dave Love <fx@gnu.org>
parents: 31185
diff changeset
448 * Uniquify:: Buffer names can contain directory parts.
31815
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
449 * Iswitchb:: Switching between buffers with substrings.
31311
a04fdd7a9207 bs-show
Dave Love <fx@gnu.org>
parents: 31185
diff changeset
450 * BS:: Configurable buffer menu.
31815
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
451 * MSB:: Customizing the Mouse Buffer Selection Menus.
30869
1827bd720842 (Buffer Convenience): New.
Dave Love <fx@gnu.org>
parents: 30772
diff changeset
452 @end menu
1827bd720842 (Buffer Convenience): New.
Dave Love <fx@gnu.org>
parents: 30772
diff changeset
453
1827bd720842 (Buffer Convenience): New.
Dave Love <fx@gnu.org>
parents: 30772
diff changeset
454 @node Uniquify
1827bd720842 (Buffer Convenience): New.
Dave Love <fx@gnu.org>
parents: 30772
diff changeset
455 @subsection Directory Names in Buffer Names
1827bd720842 (Buffer Convenience): New.
Dave Love <fx@gnu.org>
parents: 30772
diff changeset
456
1827bd720842 (Buffer Convenience): New.
Dave Love <fx@gnu.org>
parents: 30772
diff changeset
457 @findex toggle-uniquify-buffer-names
1827bd720842 (Buffer Convenience): New.
Dave Love <fx@gnu.org>
parents: 30772
diff changeset
458 @vindex uniquify-buffer-name-style
1827bd720842 (Buffer Convenience): New.
Dave Love <fx@gnu.org>
parents: 30772
diff changeset
459 @cindex unique buffer names
1827bd720842 (Buffer Convenience): New.
Dave Love <fx@gnu.org>
parents: 30772
diff changeset
460 @cindex directories in buffer names
1827bd720842 (Buffer Convenience): New.
Dave Love <fx@gnu.org>
parents: 30772
diff changeset
461 Emacs's standard method for making buffer names unique adds @samp{<2>},
1827bd720842 (Buffer Convenience): New.
Dave Love <fx@gnu.org>
parents: 30772
diff changeset
462 @samp{<3>}, etc. to the end of (all but one of) the buffers. The
1827bd720842 (Buffer Convenience): New.
Dave Love <fx@gnu.org>
parents: 30772
diff changeset
463 Uniquify package replaces that behavior, for buffers visiting files and
1827bd720842 (Buffer Convenience): New.
Dave Love <fx@gnu.org>
parents: 30772
diff changeset
464 dired buffers. It implements a uniquification that adds parts of the
1827bd720842 (Buffer Convenience): New.
Dave Love <fx@gnu.org>
parents: 30772
diff changeset
465 file name until the buffer names are unique. For instance, buffers
1827bd720842 (Buffer Convenience): New.
Dave Love <fx@gnu.org>
parents: 30772
diff changeset
466 visiting @file{/u/mernst/tmp/Makefile} and
1827bd720842 (Buffer Convenience): New.
Dave Love <fx@gnu.org>
parents: 30772
diff changeset
467 @file{/usr/projects/zaphod/Makefile} would be named @samp{tmp/Makefile}
1827bd720842 (Buffer Convenience): New.
Dave Love <fx@gnu.org>
parents: 30772
diff changeset
468 and @samp{zaphod/Makefile}, respectively (instead of @samp{Makefile}
1827bd720842 (Buffer Convenience): New.
Dave Love <fx@gnu.org>
parents: 30772
diff changeset
469 and @samp{Makefile<2>}). You can turn on this mode and select other
1827bd720842 (Buffer Convenience): New.
Dave Love <fx@gnu.org>
parents: 30772
diff changeset
470 buffer name styles by customizing the user option
1827bd720842 (Buffer Convenience): New.
Dave Love <fx@gnu.org>
parents: 30772
diff changeset
471 @code{uniquify-buffer-name-style}. The command @kbd{M-x
1827bd720842 (Buffer Convenience): New.
Dave Love <fx@gnu.org>
parents: 30772
diff changeset
472 toggle-uniquify-buffer-names} can also be used to toggle the mode.
1827bd720842 (Buffer Convenience): New.
Dave Love <fx@gnu.org>
parents: 30772
diff changeset
473
31815
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
474 @node Iswitchb
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
475 @subsection Switching Between Buffers using Substrings
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
476
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
477 @findex iswitchb-mode
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
478 @cindex Iswitchb mode
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
479 @cindex mode, Iswitchb
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
480 @kindex C-x b @r{(Iswitchb mode)}
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
481 @kindex C-x 4 b @r{(Iswitchb mode)}
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
482 @kindex C-x 5 b @r{(Iswitchb mode)}
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
483 @kindex C-x 4 C-o @r{(Iswitchb mode)}
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
484
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
485 Iswitchb global minor mode provides convenient switching between buffers
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
486 using substrings of their names by replacing the normal keybindings
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
487 @kbd{C-x b}, @kbd{C-x 4 b}, @kbd{C-x 5 b} and @kbd{C-x 4 C-o}.
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
488
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
489 When you are prompted for a buffer name, as you type in a substring the
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
490 list of buffers currently matching it is displayed as you type, with the
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
491 most recent buffers visited towards the start of the list. The buffer
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
492 at the start will be the one visited when you press @key{RET}. By
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
493 typing more of the substring, the list is narrowed down so that
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
494 gradually the buffer you want will be at the top of the list.
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
495 Alternatively, you can use @kbd{C-s} and @kbd{C-r} to rotate buffer
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
496 names in the list until the one you want is at the top of the list.
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
497 Completion is available so that you can see what is common to all of the
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
498 matching buffers as you type.
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
499
30869
1827bd720842 (Buffer Convenience): New.
Dave Love <fx@gnu.org>
parents: 30772
diff changeset
500 @node BS
31311
a04fdd7a9207 bs-show
Dave Love <fx@gnu.org>
parents: 31185
diff changeset
501 @subsection Configurable Buffer Menus
30869
1827bd720842 (Buffer Convenience): New.
Dave Love <fx@gnu.org>
parents: 30772
diff changeset
502
31311
a04fdd7a9207 bs-show
Dave Love <fx@gnu.org>
parents: 31185
diff changeset
503 @findex bs-show
a04fdd7a9207 bs-show
Dave Love <fx@gnu.org>
parents: 31185
diff changeset
504 @findex bs-cycle-next
a04fdd7a9207 bs-show
Dave Love <fx@gnu.org>
parents: 31185
diff changeset
505 @findex bs-cycle-previous
a04fdd7a9207 bs-show
Dave Love <fx@gnu.org>
parents: 31185
diff changeset
506 @cindex buffer list, customizable
a04fdd7a9207 bs-show
Dave Love <fx@gnu.org>
parents: 31185
diff changeset
507 @table @kbd
a04fdd7a9207 bs-show
Dave Love <fx@gnu.org>
parents: 31185
diff changeset
508 @item M-x bs-show
a04fdd7a9207 bs-show
Dave Love <fx@gnu.org>
parents: 31185
diff changeset
509 Make a list of buffers similarly to @kbd{M-x list-buffers} but
a04fdd7a9207 bs-show
Dave Love <fx@gnu.org>
parents: 31185
diff changeset
510 customizable.
a04fdd7a9207 bs-show
Dave Love <fx@gnu.org>
parents: 31185
diff changeset
511 @item M-x bs-cycle-next
a04fdd7a9207 bs-show
Dave Love <fx@gnu.org>
parents: 31185
diff changeset
512 Cycle to the next buffer in the configuration.
a04fdd7a9207 bs-show
Dave Love <fx@gnu.org>
parents: 31185
diff changeset
513 @item M-x bs-cycle-previous
a04fdd7a9207 bs-show
Dave Love <fx@gnu.org>
parents: 31185
diff changeset
514 Cycle to the previous buffer in the configuration.
a04fdd7a9207 bs-show
Dave Love <fx@gnu.org>
parents: 31185
diff changeset
515 @end table
a04fdd7a9207 bs-show
Dave Love <fx@gnu.org>
parents: 31185
diff changeset
516
a04fdd7a9207 bs-show
Dave Love <fx@gnu.org>
parents: 31185
diff changeset
517 @kbd{M-x bs-show} pops up a buffer list similar to the one normally
a04fdd7a9207 bs-show
Dave Love <fx@gnu.org>
parents: 31185
diff changeset
518 displayed by @kbd{C-x C-b} but which can be customized. You might like
a04fdd7a9207 bs-show
Dave Love <fx@gnu.org>
parents: 31185
diff changeset
519 to bind it to @kbd{C-x C-b}. You can customize the display, for
a04fdd7a9207 bs-show
Dave Love <fx@gnu.org>
parents: 31185
diff changeset
520 instance to display a subset of buffers, in the @code{bs} Custom group.
a04fdd7a9207 bs-show
Dave Love <fx@gnu.org>
parents: 31185
diff changeset
521 A special subset of all buffers is available---for instance avoiding
a04fdd7a9207 bs-show
Dave Love <fx@gnu.org>
parents: 31185
diff changeset
522 ones like @samp{*Messages*}---through which you can cycle with @kbd{M-x
a04fdd7a9207 bs-show
Dave Love <fx@gnu.org>
parents: 31185
diff changeset
523 bs-cycle-next} and @kbd{M-x bs-cycle-previous}. Those commands could be
a04fdd7a9207 bs-show
Dave Love <fx@gnu.org>
parents: 31185
diff changeset
524 bound to convenient keys.
a04fdd7a9207 bs-show
Dave Love <fx@gnu.org>
parents: 31185
diff changeset
525
31815
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
526 @node MSB
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
527 @subsection Customizing the Mouse Buffer Selection Menus
30869
1827bd720842 (Buffer Convenience): New.
Dave Love <fx@gnu.org>
parents: 30772
diff changeset
528
31815
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
529 @findex msb-mode
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
530 @cindex mode, MSB
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
531 @cindex MSB mode
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
532 @cindex buffer menu
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
533 @findex mouse-buffer-menu
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
534 @kindex C-down-mouse-1
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
535
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
536 MSB global minor mode provides a different and customizable mouse buffer
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
537 menu which you may prefer. It replaces the bindings of
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
538 @code{mouse-buffer-menu}, normally on @kbd{C-down-mouse-1}, and the menu
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
539 bar buffer menu. You can customize the menu in the @code{msb} Custom
e0b702f0bc3c iswitchb, msb
Dave Love <fx@gnu.org>
parents: 31311
diff changeset
540 group.