Put autoloads in ibuffer.el rather than loaddefs.el.
[bpt/emacs.git] / lisp / ibuffer.el
CommitLineData
25d2f683
CW
1;;; ibuffer.el --- operate on buffers like dired
2
e6ce8c42
GM
3;; Copyright (C) 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008,
4;; 2009 Free Software Foundation, Inc.
25d2f683
CW
5
6;; Author: Colin Walters <walters@verbum.org>
4e4a724c 7;; Maintainer: John Paul Wallington <jpw@gnu.org>
25d2f683 8;; Created: 8 Sep 2000
25d2f683 9;; Keywords: buffer, convenience
25d2f683 10
b5cd37ea 11;; This file is part of GNU Emacs.
25d2f683 12
eb3fa2cf
GM
13;; GNU Emacs is free software: you can redistribute it and/or modify
14;; it under the terms of the GNU General Public License as published by
15;; the Free Software Foundation, either version 3 of the License, or
16;; (at your option) any later version.
25d2f683 17
eb3fa2cf
GM
18;; GNU Emacs is distributed in the hope that it will be useful,
19;; but WITHOUT ANY WARRANTY; without even the implied warranty of
20;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21;; GNU General Public License for more details.
25d2f683
CW
22
23;; You should have received a copy of the GNU General Public License
eb3fa2cf 24;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
25d2f683
CW
25
26;;; Commentary:
27
28;; ibuffer.el is an advanced replacement for the `buffer-menu' which
29;; is normally distributed with Emacs. Its interface is intended to
30;; be analogous to that of Dired.
31
32;;; Code:
33
34(eval-when-compile
35 (require 'cl)
36 (require 'ibuf-macs)
37 (require 'dired))
38
730da5b2 39(require 'font-core)
fd225d80 40
735d7026
JB
41;; These come from ibuf-ext.el, which can not be require'd at compile time
42;; because it has a recursive dependency on ibuffer.el
43(defvar ibuffer-auto-mode)
44(defvar ibuffer-cached-filter-formats)
45(defvar ibuffer-compiled-filter-formats)
46(defvar ibuffer-filter-format-alist)
47(defvar ibuffer-filter-group-kill-ring)
48(defvar ibuffer-filter-groups)
49(defvar ibuffer-filtering-qualifiers)
6d11a78b 50(defvar ibuffer-header-line-format)
735d7026
JB
51(defvar ibuffer-hidden-filter-groups)
52(defvar ibuffer-inline-columns)
53(defvar ibuffer-show-empty-filter-groups)
54(defvar ibuffer-tmp-hide-regexps)
55(defvar ibuffer-tmp-show-regexps)
63f0a166 56
2ead9289 57(declare-function ibuffer-mark-on-buffer "ibuf-ext"
004a00f4
DN
58 (func &optional ibuffer-mark-on-buffer-mark group))
59(declare-function ibuffer-format-qualifier "ibuf-ext" (qualifier))
2ead9289 60(declare-function ibuffer-generate-filter-groups "ibuf-ext"
004a00f4
DN
61 (bmarklist &optional noempty nodefault))
62(declare-function ibuffer-format-filter-group-data "ibuf-ext" (filter))
63
25d2f683
CW
64(defgroup ibuffer nil
65 "An advanced replacement for `buffer-menu'.
66
67Ibuffer allows you to operate on buffers in a manner much like Dired.
68Operations include sorting, marking by regular expression, and
69the ability to filter the displayed buffers by various criteria."
bf247b6e 70 :version "22.1"
25d2f683
CW
71 :group 'convenience)
72
ac3c7293
JPW
73(defcustom ibuffer-formats '((mark modified read-only " " (name 18 18 :left :elide)
74 " " (size 9 -1 :right)
b9debd54 75 " " (mode 16 16 :left :elide) " " filename-and-process)
25d2f683
CW
76 (mark " " (name 16 -1) " " filename))
77 "A list of ways to display buffer lines.
78
79With Ibuffer, you are not limited to displaying just certain
80attributes of a buffer such as size, name, and mode in a particular
cba63a2d 81order. Through this variable, you can completely customize and
25d2f683
CW
82control the appearance of an Ibuffer buffer. See also
83`define-ibuffer-column', which allows you to define your own columns
84for display.
85
86This variable has the form
2e4fae7d 87 ((COLUMN COLUMN ...) (COLUMN COLUMN ...) ...)
25d2f683
CW
88Each element in `ibuffer-formats' should be a list containing COLUMN
89specifiers. A COLUMN can be any of the following:
90
91 SYMBOL - A symbol naming the column. Predefined columns are:
92 mark modified read-only name size mode process filename
93 When you define your own columns using `define-ibuffer-column', just
94 use their name like the predefined columns here. This entry can
95 also be a function of two arguments, which should return a string.
96 The first argument is the buffer object, and the second is the mark
97 on that buffer.
98 or
99 \"STRING\" - A literal string to display.
100 or
101 (SYMBOL MIN-SIZE MAX-SIZE &optional ALIGN ELIDE) - SYMBOL is a
102 symbol naming the column, and MIN-SIZE and MAX-SIZE are integers (or
103 functions of no arguments returning an integer) which constrict the
104 size of a column. If MAX-SIZE is -1, there is no upper bound. The
105 default values are 0 and -1, respectively. If MIN-SIZE is negative,
106 use the end of the string. The optional element ALIGN describes the
107 alignment of the column; it can be :left, :center or :right. The
108 optional element ELIDE describes whether or not to elide the column
109 if it is too long; valid values are :elide and nil. The default is
110 nil (don't elide).
111
112Some example of valid entries in `ibuffer-formats', with
113description (also, feel free to try them out, and experiment with your
114own!):
115
116 (mark \" \" name)
117 This format just displays the current mark (if any) and the name of
118 the buffer, separated by a space.
119 (mark modified read-only \" \" (name 16 16 :left) \" \" (size 6 -1 :right))
120 This format displays the current mark (if any), its modification and
121 read-only status, as well as the name of the buffer and its size. In
122 this format, the name is restricted to 16 characters (longer names
523304ed 123 will be truncated, and shorter names will be padded with spaces), and
cba63a2d 124 the name is also aligned to the left. The size of the buffer will
25d2f683
CW
125 be padded with spaces up to a minimum of six characters, but there is
126 no upper limit on its size. The size will also be aligned to the
127 right.
128
129Thus, if you wanted to use these two formats, add
130
131 (setq ibuffer-formats '((mark \" \" name)
132 (mark modified read-only
133 (name 16 16 :left) (size 6 -1 :right))))
134
135to your ~/.emacs file.
136
137Using \\[ibuffer-switch-format], you can rotate the display between
138the specified formats in the list."
139 :type '(repeat sexp)
140 :group 'ibuffer)
141
142(defcustom ibuffer-always-compile-formats (featurep 'bytecomp)
143 "If non-nil, then use the byte-compiler to optimize `ibuffer-formats'.
144This will increase the redisplay speed, at the cost of loading the
145elisp byte-compiler."
146 :type 'boolean
147 :group 'ibuffer)
148
149(defcustom ibuffer-fontification-alist
40c10465 150 `((10 buffer-read-only font-lock-constant-face)
9fe14abe
JPW
151 (15 (and buffer-file-name
152 (string-match ibuffer-compressed-file-name-regexp
153 buffer-file-name))
154 font-lock-doc-face)
155 (20 (string-match "^*" (buffer-name)) font-lock-keyword-face)
156 (25 (and (string-match "^ " (buffer-name))
da337a28
JPW
157 (null buffer-file-name))
158 italic)
9fe14abe
JPW
159 (30 (memq major-mode ibuffer-help-buffer-modes) font-lock-comment-face)
160 (35 (eq major-mode 'dired-mode) font-lock-function-name-face))
25d2f683
CW
161 "An alist describing how to fontify buffers.
162Each element should be of the form (PRIORITY FORM FACE), where
163PRIORITY is an integer, FORM is an arbitrary form to evaluate in the
164buffer, and FACE is the face to use for fontification. If the FORM
165evaluates to non-nil, then FACE will be put on the buffer name. The
fd225d80
CW
166element with the highest PRIORITY takes precedence.
167
4e4a724c 168If you change this variable, you must kill the Ibuffer buffer and
fd225d80 169recreate it for the change to take effect."
25d2f683
CW
170 :type '(repeat
171 (list (integer :tag "Priority")
172 (sexp :tag "Test Form")
173 face))
174 :group 'ibuffer)
175
176(defcustom ibuffer-use-other-window nil
7ad5b902 177 "If non-nil, display Ibuffer in another window by default."
25d2f683
CW
178 :type 'boolean
179 :group 'ibuffer)
180
181(defcustom ibuffer-default-shrink-to-minimum-size nil
182 "If non-nil, minimize the size of the Ibuffer window by default."
183 :type 'boolean
184 :group 'ibuffer)
185(defvar ibuffer-shrink-to-minimum-size nil)
186
0740098c
JPW
187(defcustom ibuffer-display-summary t
188 "If non-nil, summarize Ibuffer columns."
189 :type 'boolean
190 :group 'ibuffer)
191
3eda3649
CW
192(defcustom ibuffer-truncate-lines t
193 "If non-nil, do not display continuation lines."
194 :type 'boolean
195 :group 'ibuffer)
196
25d2f683
CW
197(defcustom ibuffer-case-fold-search case-fold-search
198 "If non-nil, ignore case when searching."
199 :type 'boolean
200 :group 'ibuffer)
201
202(defcustom ibuffer-default-sorting-mode 'recency
203 "The criteria by which to sort the buffers.
204
4e4a724c
JPW
205Note that this variable is local to each Ibuffer buffer. Thus, you
206can have multiple Ibuffer buffers open, each with a different sorted
25d2f683
CW
207view of the buffers."
208 :type '(choice (const :tag "Last view time" :value recency)
209 (const :tag "Lexicographic" :value alphabetic)
210 (const :tag "Buffer size" :value size)
d5794180 211 (const :tag "File name" :value filename/process)
25d2f683
CW
212 (const :tag "Major mode" :value major-mode))
213 :group 'ibuffer)
214(defvar ibuffer-sorting-mode nil)
e7820654 215(defvar ibuffer-last-sorting-mode nil)
25d2f683
CW
216
217(defcustom ibuffer-default-sorting-reversep nil
218 "If non-nil, reverse the default sorting order."
219 :type 'boolean
220 :group 'ibuffer)
221(defvar ibuffer-sorting-reversep nil)
222
223(defcustom ibuffer-elide-long-columns nil
972b8f82 224 "If non-nil, then elide column entries which exceed their max length."
25d2f683
CW
225 :type 'boolean
226 :group 'ibuffer)
972b8f82
JB
227(make-obsolete-variable 'ibuffer-elide-long-columns
228 "use the :elide argument of `ibuffer-formats'."
229 "22.1")
25d2f683
CW
230
231(defcustom ibuffer-eliding-string "..."
232 "The string to use for eliding long columns."
233 :type 'string
234 :group 'ibuffer)
235
236(defcustom ibuffer-maybe-show-predicates `(,(lambda (buf)
237 (and (string-match "^ " (buffer-name buf))
238 (null buffer-file-name))))
4e4a724c
JPW
239 "A list of predicates for buffers to display conditionally.
240
241A predicate can be a regexp or a function.
25d2f683
CW
242If a regexp, then it will be matched against the buffer's name.
243If a function, it will be called with the buffer as an argument, and
244should return non-nil if this buffer should be shown.
245
957237cb 246Viewing of buffers hidden because of these predicates may be customized
bf247b6e 247via `ibuffer-default-display-maybe-show-predicates' and is toggled by
957237cb
JPW
248giving a non-nil prefix argument to `ibuffer-update'.
249Note that this specialized filtering occurs before real filtering."
25d2f683
CW
250 :type '(repeat (choice regexp function))
251 :group 'ibuffer)
252
957237cb
JPW
253(defcustom ibuffer-default-display-maybe-show-predicates nil
254 "Non-nil means show buffers that match `ibuffer-maybe-show-predicates'."
255 :type 'boolean
256 :group 'ibuffer)
257
258(defvar ibuffer-display-maybe-show-predicates nil)
259
25d2f683
CW
260(defvar ibuffer-current-format nil)
261
0ce780e1
CW
262(defcustom ibuffer-movement-cycle t
263 "If non-nil, then forward and backwards movement commands cycle."
264 :type 'boolean
265 :group 'ibuffer)
266
25d2f683
CW
267(defcustom ibuffer-modified-char ?*
268 "The character to display for modified buffers."
269 :type 'character
270 :group 'ibuffer)
271
272(defcustom ibuffer-read-only-char ?%
273 "The character to display for read-only buffers."
274 :type 'character
275 :group 'ibuffer)
276
277(defcustom ibuffer-marked-char ?>
278 "The character to display for marked buffers."
279 :type 'character
280 :group 'ibuffer)
281
282(defcustom ibuffer-deletion-char ?D
283 "The character to display for buffers marked for deletion."
284 :type 'character
285 :group 'ibuffer)
286
287(defcustom ibuffer-expert nil
288 "If non-nil, don't ask for confirmation of \"dangerous\" operations."
289 :type 'boolean
290 :group 'ibuffer)
291
292(defcustom ibuffer-view-ibuffer nil
293 "If non-nil, display the current Ibuffer buffer itself.
294Note that this has a drawback - the data about the current Ibuffer
295buffer will most likely be inaccurate. This includes modification
296state, size, etc."
297 :type 'boolean
298 :group 'ibuffer)
299
300(defcustom ibuffer-always-show-last-buffer nil
4e4a724c
JPW
301 "If non-nil, always display the previous buffer.
302This variable takes precedence over filtering, and even
25d2f683
CW
303`ibuffer-never-show-predicates'."
304 :type '(choice (const :tag "Always" :value t)
305 (const :tag "Never" :value nil)
306 (const :tag "Always except minibuffer" :value :nomini))
307 :group 'ibuffer)
308
0bdd7ae4
JPW
309(defcustom ibuffer-jump-offer-only-visible-buffers nil
310 "If non-nil, only offer buffers visible in the Ibuffer buffer
311in completion lists of the `ibuffer-jump-to-buffer' command."
312 :type 'boolean
313 :group 'ibuffer)
314
25d2f683 315(defcustom ibuffer-use-header-line (boundp 'header-line-format)
7ad5b902 316 "If non-nil, display a header line containing current filters."
25d2f683
CW
317 :type 'boolean
318 :group 'ibuffer)
319
320(defcustom ibuffer-default-directory nil
4e4a724c 321 "The default directory to use for a new Ibuffer buffer.
2e4fae7d 322If nil, inherit the directory of the buffer in which `ibuffer' was
25d2f683
CW
323called. Otherwise, this variable should be a string naming a
324directory, like `default-directory'."
325 :type '(choice (const :tag "Inherit" :value nil)
326 string)
327 :group 'ibuffer)
328
4e4a724c
JPW
329(defcustom ibuffer-help-buffer-modes
330 '(help-mode apropos-mode Info-mode Info-edit-mode)
60356fb5
CW
331 "List of \"Help\" major modes."
332 :type '(repeat function)
333 :group 'ibuffer)
334
9fe14abe 335(defcustom ibuffer-compressed-file-name-regexp
fe99056f 336 "\\.\\(arj\\|bgz\\|bz2\\|gz\\|lzh\\|taz\\|tgz\\|zip\\|z\\)$"
9fe14abe
JPW
337 "Regexp to match compressed file names."
338 :type 'regexp
c7f5c0a8 339 :group 'ibuffer)
9fe14abe 340
cd6ef82d
GM
341(define-obsolete-variable-alias 'ibuffer-hooks 'ibuffer-hook "22.1")
342
e9e96ba0 343(defcustom ibuffer-hook nil
4e4a724c 344 "Hook run when `ibuffer' is called."
25d2f683
CW
345 :type 'hook
346 :group 'ibuffer)
cd6ef82d
GM
347
348(define-obsolete-variable-alias 'ibuffer-mode-hooks 'ibuffer-mode-hook "22.1")
25d2f683 349
e9e96ba0 350(defcustom ibuffer-mode-hook nil
4e4a724c 351 "Hook run upon entry into `ibuffer-mode'."
25d2f683
CW
352 :type 'hook
353 :group 'ibuffer)
354
4e4a724c
JPW
355(defcustom ibuffer-load-hook nil
356 "Hook run when Ibuffer is loaded."
357 :type 'hook
358 :group 'ibuffer)
359
25d2f683
CW
360(defcustom ibuffer-marked-face 'font-lock-warning-face
361 "Face used for displaying marked buffers."
362 :type 'face
363 :group 'ibuffer)
364
365(defcustom ibuffer-deletion-face 'font-lock-type-face
366 "Face used for displaying buffers marked for deletion."
367 :type 'face
368 :group 'ibuffer)
369
370(defcustom ibuffer-title-face 'font-lock-type-face
371 "Face used for the title string."
372 :type 'face
373 :group 'ibuffer)
374
b5cd37ea
CW
375(defcustom ibuffer-filter-group-name-face 'bold
376 "Face used for displaying filtering group names."
377 :type 'face
378 :group 'ibuffer)
379
25d2f683
CW
380(defcustom ibuffer-directory-abbrev-alist nil
381 "An alist of file name abbreviations like `directory-abbrev-alist'."
382 :type '(repeat (cons :format "%v"
383 :value ("" . "")
384 (regexp :tag "From")
385 (regexp :tag "To")))
386 :group 'ibuffer)
387
4e4a724c 388
25d2f683
CW
389(defvar ibuffer-mode-map nil)
390(defvar ibuffer-mode-operate-map nil)
b5e80d1a 391(defvar ibuffer-mode-groups-popup nil)
25d2f683
CW
392(unless ibuffer-mode-map
393 (let ((map (make-sparse-keymap))
b5e80d1a
CW
394 (operate-map (make-sparse-keymap "Operate"))
395 (groups-map (make-sparse-keymap "Filter Groups")))
25d2f683
CW
396 (define-key map (kbd "0") 'digit-argument)
397 (define-key map (kbd "1") 'digit-argument)
398 (define-key map (kbd "2") 'digit-argument)
399 (define-key map (kbd "3") 'digit-argument)
400 (define-key map (kbd "4") 'digit-argument)
401 (define-key map (kbd "5") 'digit-argument)
402 (define-key map (kbd "6") 'digit-argument)
403 (define-key map (kbd "7") 'digit-argument)
404 (define-key map (kbd "8") 'digit-argument)
405 (define-key map (kbd "9") 'digit-argument)
406
407 (define-key map (kbd "m") 'ibuffer-mark-forward)
408 (define-key map (kbd "t") 'ibuffer-toggle-marks)
409 (define-key map (kbd "u") 'ibuffer-unmark-forward)
410 (define-key map (kbd "=") 'ibuffer-diff-with-file)
411 (define-key map (kbd "j") 'ibuffer-jump-to-buffer)
0bdd7ae4 412 (define-key map (kbd "M-g") 'ibuffer-jump-to-buffer)
78176075
JL
413 (define-key map (kbd "M-s a C-s") 'ibuffer-do-isearch)
414 (define-key map (kbd "M-s a M-C-s") 'ibuffer-do-isearch-regexp)
25d2f683
CW
415 (define-key map (kbd "DEL") 'ibuffer-unmark-backward)
416 (define-key map (kbd "M-DEL") 'ibuffer-unmark-all)
417 (define-key map (kbd "* *") 'ibuffer-unmark-all)
418 (define-key map (kbd "* M") 'ibuffer-mark-by-mode)
419 (define-key map (kbd "* m") 'ibuffer-mark-modified-buffers)
420 (define-key map (kbd "* u") 'ibuffer-mark-unsaved-buffers)
421 (define-key map (kbd "* s") 'ibuffer-mark-special-buffers)
422 (define-key map (kbd "* r") 'ibuffer-mark-read-only-buffers)
423 (define-key map (kbd "* /") 'ibuffer-mark-dired-buffers)
424 (define-key map (kbd "* e") 'ibuffer-mark-dissociated-buffers)
425 (define-key map (kbd "* h") 'ibuffer-mark-help-buffers)
9fe14abe 426 (define-key map (kbd "* z") 'ibuffer-mark-compressed-file-buffers)
25d2f683 427 (define-key map (kbd ".") 'ibuffer-mark-old-buffers)
71296446 428
25d2f683
CW
429 (define-key map (kbd "d") 'ibuffer-mark-for-delete)
430 (define-key map (kbd "C-d") 'ibuffer-mark-for-delete-backwards)
431 (define-key map (kbd "k") 'ibuffer-mark-for-delete)
432 (define-key map (kbd "x") 'ibuffer-do-kill-on-deletion-marks)
71296446 433
25d2f683
CW
434 ;; immediate operations
435 (define-key map (kbd "n") 'ibuffer-forward-line)
b5cd37ea 436 (define-key map (kbd "<down>") 'ibuffer-forward-line)
25d2f683
CW
437 (define-key map (kbd "SPC") 'forward-line)
438 (define-key map (kbd "p") 'ibuffer-backward-line)
cba63a2d 439 (define-key map (kbd "<up>") 'ibuffer-backward-line)
25d2f683
CW
440 (define-key map (kbd "M-}") 'ibuffer-forward-next-marked)
441 (define-key map (kbd "M-{") 'ibuffer-backwards-next-marked)
442 (define-key map (kbd "l") 'ibuffer-redisplay)
443 (define-key map (kbd "g") 'ibuffer-update)
444 (define-key map "`" 'ibuffer-switch-format)
445 (define-key map "-" 'ibuffer-add-to-tmp-hide)
446 (define-key map "+" 'ibuffer-add-to-tmp-show)
447 (define-key map "b" 'ibuffer-bury-buffer)
448 (define-key map (kbd ",") 'ibuffer-toggle-sorting-mode)
449 (define-key map (kbd "s i") 'ibuffer-invert-sorting)
450 (define-key map (kbd "s a") 'ibuffer-do-sort-by-alphabetic)
451 (define-key map (kbd "s v") 'ibuffer-do-sort-by-recency)
452 (define-key map (kbd "s s") 'ibuffer-do-sort-by-size)
d5794180 453 (define-key map (kbd "s f") 'ibuffer-do-sort-by-filename/process)
25d2f683
CW
454 (define-key map (kbd "s m") 'ibuffer-do-sort-by-major-mode)
455
456 (define-key map (kbd "/ m") 'ibuffer-filter-by-mode)
5bc06df9 457 (define-key map (kbd "/ M") 'ibuffer-filter-by-used-mode)
25d2f683
CW
458 (define-key map (kbd "/ n") 'ibuffer-filter-by-name)
459 (define-key map (kbd "/ c") 'ibuffer-filter-by-content)
460 (define-key map (kbd "/ e") 'ibuffer-filter-by-predicate)
461 (define-key map (kbd "/ f") 'ibuffer-filter-by-filename)
462 (define-key map (kbd "/ >") 'ibuffer-filter-by-size-gt)
463 (define-key map (kbd "/ <") 'ibuffer-filter-by-size-lt)
464 (define-key map (kbd "/ r") 'ibuffer-switch-to-saved-filters)
465 (define-key map (kbd "/ a") 'ibuffer-add-saved-filters)
466 (define-key map (kbd "/ x") 'ibuffer-delete-saved-filters)
467 (define-key map (kbd "/ d") 'ibuffer-decompose-filter)
468 (define-key map (kbd "/ s") 'ibuffer-save-filters)
469 (define-key map (kbd "/ p") 'ibuffer-pop-filter)
470 (define-key map (kbd "/ !") 'ibuffer-negate-filter)
471 (define-key map (kbd "/ t") 'ibuffer-exchange-filters)
472 (define-key map (kbd "/ TAB") 'ibuffer-exchange-filters)
473 (define-key map (kbd "/ o") 'ibuffer-or-filter)
b5cd37ea
CW
474 (define-key map (kbd "/ g") 'ibuffer-filters-to-filter-group)
475 (define-key map (kbd "/ P") 'ibuffer-pop-filter-group)
2bd26a6f 476 (define-key map (kbd "/ D") 'ibuffer-decompose-filter-group)
25d2f683 477 (define-key map (kbd "/ /") 'ibuffer-filter-disable)
b5cd37ea
CW
478
479 (define-key map (kbd "M-n") 'ibuffer-forward-filter-group)
480 (define-key map (kbd "<right>") 'ibuffer-forward-filter-group)
481 (define-key map (kbd "M-p") 'ibuffer-backward-filter-group)
482 (define-key map (kbd "<left>") 'ibuffer-backward-filter-group)
483 (define-key map (kbd "M-j") 'ibuffer-jump-to-filter-group)
cba63a2d
CW
484 (define-key map (kbd "C-k") 'ibuffer-kill-line)
485 (define-key map (kbd "C-y") 'ibuffer-yank)
486 (define-key map (kbd "/ S") 'ibuffer-save-filter-groups)
487 (define-key map (kbd "/ R") 'ibuffer-switch-to-saved-filter-groups)
488 (define-key map (kbd "/ X") 'ibuffer-delete-saved-filter-groups)
489 (define-key map (kbd "/ \\") 'ibuffer-clear-filter-groups)
71296446 490
25d2f683
CW
491 (define-key map (kbd "q") 'ibuffer-quit)
492 (define-key map (kbd "h") 'describe-mode)
493 (define-key map (kbd "?") 'describe-mode)
494
495 (define-key map (kbd "% n") 'ibuffer-mark-by-name-regexp)
496 (define-key map (kbd "% m") 'ibuffer-mark-by-mode-regexp)
497 (define-key map (kbd "% f") 'ibuffer-mark-by-file-name-regexp)
71296446 498
25d2f683
CW
499 (define-key map (kbd "C-t") 'ibuffer-visit-tags-table)
500
501 (define-key map (kbd "|") 'ibuffer-do-shell-command-pipe)
502 (define-key map (kbd "!") 'ibuffer-do-shell-command-file)
503 (define-key map (kbd "~") 'ibuffer-do-toggle-modified)
504 ;; marked operations
505 (define-key map (kbd "A") 'ibuffer-do-view)
506 (define-key map (kbd "D") 'ibuffer-do-delete)
507 (define-key map (kbd "E") 'ibuffer-do-eval)
508 (define-key map (kbd "F") 'ibuffer-do-shell-command-file)
509 (define-key map (kbd "I") 'ibuffer-do-query-replace-regexp)
510 (define-key map (kbd "H") 'ibuffer-do-view-other-frame)
511 (define-key map (kbd "N") 'ibuffer-do-shell-command-pipe-replace)
512 (define-key map (kbd "M") 'ibuffer-do-toggle-modified)
513 (define-key map (kbd "O") 'ibuffer-do-occur)
514 (define-key map (kbd "P") 'ibuffer-do-print)
515 (define-key map (kbd "Q") 'ibuffer-do-query-replace)
516 (define-key map (kbd "R") 'ibuffer-do-rename-uniquely)
517 (define-key map (kbd "S") 'ibuffer-do-save)
518 (define-key map (kbd "T") 'ibuffer-do-toggle-read-only)
519 (define-key map (kbd "U") 'ibuffer-do-replace-regexp)
520 (define-key map (kbd "V") 'ibuffer-do-revert)
521 (define-key map (kbd "W") 'ibuffer-do-view-and-eval)
522 (define-key map (kbd "X") 'ibuffer-do-shell-command-pipe)
71296446 523
25d2f683
CW
524 (define-key map (kbd "k") 'ibuffer-do-kill-lines)
525 (define-key map (kbd "w") 'ibuffer-copy-filename-as-kill)
526
527 (define-key map (kbd "RET") 'ibuffer-visit-buffer)
528 (define-key map (kbd "e") 'ibuffer-visit-buffer)
529 (define-key map (kbd "f") 'ibuffer-visit-buffer)
530 (define-key map (kbd "C-x C-f") 'ibuffer-find-file)
531 (define-key map (kbd "o") 'ibuffer-visit-buffer-other-window)
532 (define-key map (kbd "C-o") 'ibuffer-visit-buffer-other-window-noselect)
533 (define-key map (kbd "M-o") 'ibuffer-visit-buffer-1-window)
534 (define-key map (kbd "v") 'ibuffer-do-view)
535 (define-key map (kbd "C-x v") 'ibuffer-do-view-horizontally)
536 (define-key map (kbd "C-c C-a") 'ibuffer-auto-mode)
537 (define-key map (kbd "C-x 4 RET") 'ibuffer-visit-buffer-other-window)
538 (define-key map (kbd "C-x 5 RET") 'ibuffer-visit-buffer-other-frame)
539
540 (define-key map [menu-bar view]
541 (cons "View" (make-sparse-keymap "View")))
542
543 (define-key-after map [menu-bar view visit-buffer]
544 '(menu-item "View this buffer" ibuffer-visit-buffer))
545 (define-key-after map [menu-bar view visit-buffer-other-window]
546 '(menu-item "View (other window)" ibuffer-visit-buffer-other-window))
547 (define-key-after map [menu-bar view visit-buffer-other-frame]
548 '(menu-item "View (other frame)" ibuffer-visit-buffer-other-frame))
549 (define-key-after map [menu-bar view ibuffer-update]
550 '(menu-item "Update" ibuffer-update
551 :help "Regenerate the list of buffers"))
552 (define-key-after map [menu-bar view switch-format]
553 '(menu-item "Switch display format" ibuffer-switch-format
554 :help "Toggle between available values of `ibuffer-formats'"))
555
556 (define-key-after map [menu-bar view dashes]
557 '("--"))
558
559 (define-key-after map [menu-bar view sort]
560 (cons "Sort" (make-sparse-keymap "Sort")))
561
562 (define-key-after map [menu-bar view sort do-sort-by-major-mode]
cba63a2d 563 '(menu-item "Sort by major mode" ibuffer-do-sort-by-major-mode))
25d2f683 564 (define-key-after map [menu-bar view sort do-sort-by-size]
cba63a2d 565 '(menu-item "Sort by buffer size" ibuffer-do-sort-by-size))
25d2f683
CW
566 (define-key-after map [menu-bar view sort do-sort-by-alphabetic]
567 '(menu-item "Sort lexicographically" ibuffer-do-sort-by-alphabetic
568 :help "Sort by the alphabetic order of buffer name"))
569 (define-key-after map [menu-bar view sort do-sort-by-recency]
570 '(menu-item "Sort by view time" ibuffer-do-sort-by-recency
571 :help "Sort by the last time the buffer was displayed"))
4e4a724c
JPW
572 (define-key-after map [menu-bar view sort dashes]
573 '("--"))
25d2f683
CW
574 (define-key-after map [menu-bar view sort invert-sorting]
575 '(menu-item "Reverse sorting order" ibuffer-invert-sorting))
576 (define-key-after map [menu-bar view sort toggle-sorting-mode]
577 '(menu-item "Switch sorting mode" ibuffer-toggle-sorting-mode
578 :help "Switch between the various sorting criteria"))
579
580 (define-key-after map [menu-bar view filter]
581 (cons "Filter" (make-sparse-keymap "Filter")))
582
583 (define-key-after map [menu-bar view filter filter-disable]
05cc03af
CW
584 '(menu-item "Disable all filtering" ibuffer-filter-disable
585 :enable (and (featurep 'ibuf-ext) ibuffer-filtering-qualifiers)))
25d2f683 586 (define-key-after map [menu-bar view filter filter-by-mode]
cba63a2d 587 '(menu-item "Add filter by major mode..." ibuffer-filter-by-mode))
5bc06df9
CW
588 (define-key-after map [menu-bar view filter filter-by-mode]
589 '(menu-item "Add filter by major mode in use..." ibuffer-filter-by-used-mode))
25d2f683 590 (define-key-after map [menu-bar view filter filter-by-name]
cba63a2d 591 '(menu-item "Add filter by buffer name..." ibuffer-filter-by-name))
25d2f683 592 (define-key-after map [menu-bar view filter filter-by-filename]
cba63a2d 593 '(menu-item "Add filter by filename..." ibuffer-filter-by-filename))
25d2f683 594 (define-key-after map [menu-bar view filter filter-by-size-lt]
cba63a2d 595 '(menu-item "Add filter by size less than..." ibuffer-filter-by-size-lt))
25d2f683 596 (define-key-after map [menu-bar view filter filter-by-size-gt]
cba63a2d 597 '(menu-item "Add filter by size greater than..." ibuffer-filter-by-size-gt))
25d2f683 598 (define-key-after map [menu-bar view filter filter-by-content]
cba63a2d 599 '(menu-item "Add filter by content (regexp)..." ibuffer-filter-by-content))
25d2f683 600 (define-key-after map [menu-bar view filter filter-by-predicate]
cba63a2d 601 '(menu-item "Add filter by Lisp predicate..." ibuffer-filter-by-predicate))
25d2f683 602 (define-key-after map [menu-bar view filter pop-filter]
05cc03af
CW
603 '(menu-item "Remove top filter" ibuffer-pop-filter
604 :enable (and (featurep 'ibuf-ext) ibuffer-filtering-qualifiers)))
25d2f683
CW
605 (define-key-after map [menu-bar view filter or-filter]
606 '(menu-item "OR top two filters" ibuffer-or-filter
717339e5
CW
607 :enable (and (featurep 'ibuf-ext) ibuffer-filtering-qualifiers
608 (cdr ibuffer-filtering-qualifiers))
25d2f683
CW
609 :help "Create a new filter which is the logical OR of the top two filters"))
610 (define-key-after map [menu-bar view filter negate-filter]
05cc03af
CW
611 '(menu-item "Negate top filter" ibuffer-negate-filter
612 :enable (and (featurep 'ibuf-ext) ibuffer-filtering-qualifiers)))
25d2f683
CW
613 (define-key-after map [menu-bar view filter decompose-filter]
614 '(menu-item "Decompose top filter" ibuffer-decompose-filter
717339e5 615 :enable (and (featurep 'ibuf-ext) (memq (car ibuffer-filtering-qualifiers) '(or saved not)))
25d2f683
CW
616 :help "Break down a complex filter like OR or NOT"))
617 (define-key-after map [menu-bar view filter exchange-filters]
05cc03af 618 '(menu-item "Swap top two filters" ibuffer-exchange-filters
717339e5
CW
619 :enable (and (featurep 'ibuf-ext) ibuffer-filtering-qualifiers
620 (cdr ibuffer-filtering-qualifiers))))
25d2f683
CW
621 (define-key-after map [menu-bar view filter save-filters]
622 '(menu-item "Save current filters permanently..." ibuffer-save-filters
4e4a724c 623 :enable (and (featurep 'ibuf-ext) ibuffer-filtering-qualifiers)
25d2f683
CW
624 :help "Use a mnemnonic name to store current filter stack"))
625 (define-key-after map [menu-bar view filter switch-to-saved-filters]
626 '(menu-item "Restore permanently saved filters..." ibuffer-switch-to-saved-filters
05cc03af 627 :enable (and (featurep 'ibuf-ext) ibuffer-saved-filters)
25d2f683
CW
628 :help "Replace current filters with a saved stack"))
629 (define-key-after map [menu-bar view filter add-saved-filters]
630 '(menu-item "Add to permanently saved filters..." ibuffer-add-saved-filters
05cc03af 631 :enable (and (featurep 'ibuf-ext) ibuffer-filtering-qualifiers)
cba63a2d 632 :help "Include already saved stack with current filters"))
25d2f683 633 (define-key-after map [menu-bar view filter delete-saved-filters]
cba63a2d 634 '(menu-item "Delete permanently saved filters..."
05cc03af
CW
635 ibuffer-delete-saved-filters
636 :enable (and (featurep 'ibuf-ext) ibuffer-saved-filters)))
cba63a2d 637
b5e80d1a 638 ;; Filter groups
cba63a2d 639
b5e80d1a 640 (define-key-after groups-map [filters-to-filter-group]
cba63a2d 641 '(menu-item "Create filter group from current filters..."
2bd26a6f
CW
642 ibuffer-filters-to-filter-group
643 :enable (and (featurep 'ibuf-ext) ibuffer-filtering-qualifiers)))
b5e80d1a 644 (define-key-after groups-map [forward-filter-group]
cba63a2d 645 '(menu-item "Move point to the next filter group"
4e4a724c 646 ibuffer-forward-filter-group))
b5e80d1a 647 (define-key-after groups-map [backward-filter-group]
cba63a2d
CW
648 '(menu-item "Move point to the previous filter group"
649 ibuffer-backward-filter-group))
b5e80d1a 650 (define-key-after groups-map [jump-to-filter-group]
cba63a2d
CW
651 '(menu-item "Move point to a specific filter group..."
652 ibuffer-jump-to-filter-group))
b5e80d1a
CW
653 (define-key-after groups-map [kill-filter-group]
654 '(menu-item "Kill filter group named..."
655 ibuffer-kill-filter-group
656 :enable (and (featurep 'ibuf-ext) ibuffer-filter-groups)))
657 (define-key-after groups-map [yank-filter-group]
658 '(menu-item "Yank last killed filter group before..."
659 ibuffer-yank-filter-group
660 :enable (and (featurep 'ibuf-ext) ibuffer-filter-group-kill-ring)))
661 (define-key-after groups-map [pop-filter-group]
b5cd37ea 662 '(menu-item "Remove top filter group"
b5e80d1a 663 ibuffer-pop-filter-group
2bd26a6f 664 :enable (and (featurep 'ibuf-ext) ibuffer-filter-groups)))
b5e80d1a 665 (define-key-after groups-map [clear-filter-groups]
cba63a2d 666 '(menu-item "Remove all filter groups"
b5e80d1a 667 ibuffer-clear-filter-groups
2bd26a6f
CW
668 :enable (and (featurep 'ibuf-ext) ibuffer-filter-groups)))
669 (define-key-after groups-map [pop-filter-group]
670 '(menu-item "Decompose filter group..."
671 ibuffer-pop-filter-group
672 :help "\"Unmake\" a filter group"
673 :enable (and (featurep 'ibuf-ext) ibuffer-filter-groups)))
b5e80d1a 674 (define-key-after groups-map [save-filter-groups]
cba63a2d
CW
675 '(menu-item "Save current filter groups permanently..."
676 ibuffer-save-filter-groups
05cc03af 677 :enable (and (featurep 'ibuf-ext) ibuffer-filter-groups)
cba63a2d 678 :help "Use a mnemnonic name to store current filter groups"))
b5e80d1a 679 (define-key-after groups-map [switch-to-saved-filter-groups]
cba63a2d
CW
680 '(menu-item "Restore permanently saved filters..."
681 ibuffer-switch-to-saved-filter-groups
05cc03af 682 :enable (and (featurep 'ibuf-ext) ibuffer-saved-filter-groups)
4e4a724c 683 :help "Replace current filters with a saved stack"))
b5e80d1a 684 (define-key-after groups-map [delete-saved-filter-groups]
cba63a2d 685 '(menu-item "Delete permanently saved filter groups..."
05cc03af
CW
686 ibuffer-delete-saved-filter-groups
687 :enable (and (featurep 'ibuf-ext) ibuffer-saved-filter-groups)))
b5e80d1a 688 (define-key-after groups-map [set-filter-groups-by-mode]
cba63a2d
CW
689 '(menu-item "Set current filter groups to filter by mode"
690 ibuffer-set-filter-groups-by-mode))
691
b5e80d1a
CW
692 (define-key-after map [menu-bar view filter-groups]
693 (cons "Filter Groups" groups-map))
694
25d2f683
CW
695 (define-key-after map [menu-bar view dashes2]
696 '("--"))
697 (define-key-after map [menu-bar view diff-with-file]
698 '(menu-item "Diff with file" ibuffer-diff-with-file
699 :help "View the differences between this buffer and its file"))
700 (define-key-after map [menu-bar view auto-mode]
701 '(menu-item "Toggle Auto Mode" ibuffer-auto-mode
702 :help "Attempt to automatically update the Ibuffer buffer"))
703 (define-key-after map [menu-bar view customize]
4e4a724c 704 '(menu-item "Customize Ibuffer" ibuffer-customize
25d2f683
CW
705 :help "Use Custom to customize Ibuffer"))
706
707 (define-key-after map [menu-bar mark]
708 (cons "Mark" (make-sparse-keymap "Mark")))
709
710 (define-key-after map [menu-bar mark toggle-marks]
711 '(menu-item "Toggle marks" ibuffer-toggle-marks
712 :help "Unmark marked buffers, and mark unmarked buffers"))
713 (define-key-after map [menu-bar mark mark-forward]
714 '(menu-item "Mark" ibuffer-mark-forward
715 :help "Mark the buffer at point"))
716 (define-key-after map [menu-bar mark unmark-forward]
717 '(menu-item "Unmark" ibuffer-unmark-forward
718 :help "Unmark the buffer at point"))
719 (define-key-after map [menu-bar mark mark-by-mode]
720 '(menu-item "Mark by mode..." ibuffer-mark-by-mode
721 :help "Mark all buffers in a particular major mode"))
722 (define-key-after map [menu-bar mark mark-modified-buffers]
723 '(menu-item "Mark modified buffers" ibuffer-mark-modified-buffers
724 :help "Mark all buffers which have been modified"))
725 (define-key-after map [menu-bar mark mark-unsaved-buffers]
726 '(menu-item "Mark unsaved buffers" ibuffer-mark-unsaved-buffers
727 :help "Mark all buffers which have a file and are modified"))
728 (define-key-after map [menu-bar mark mark-read-only-buffers]
729 '(menu-item "Mark read-only buffers" ibuffer-mark-read-only-buffers
730 :help "Mark all buffers which are read-only"))
731 (define-key-after map [menu-bar mark mark-special-buffers]
732 '(menu-item "Mark special buffers" ibuffer-mark-special-buffers
733 :help "Mark all buffers whose name begins with a *"))
734 (define-key-after map [menu-bar mark mark-dired-buffers]
735 '(menu-item "Mark dired buffers" ibuffer-mark-dired-buffers
736 :help "Mark buffers in dired-mode"))
737 (define-key-after map [menu-bar mark mark-dissociated-buffers]
738 '(menu-item "Mark dissociated buffers" ibuffer-mark-dissociated-buffers
739 :help "Mark buffers with a non-existent associated file"))
740 (define-key-after map [menu-bar mark mark-help-buffers]
741 '(menu-item "Mark help buffers" ibuffer-mark-help-buffers
742 :help "Mark buffers in help-mode"))
9fe14abe
JPW
743 (define-key-after map [menu-bar mark mark-compressed-file-buffers]
744 '(menu-item "Mark compressed file buffers" ibuffer-mark-compressed-file-buffers
745 :help "Mark buffers which have a file that is compressed"))
25d2f683
CW
746 (define-key-after map [menu-bar mark mark-old-buffers]
747 '(menu-item "Mark old buffers" ibuffer-mark-old-buffers
748 :help "Mark buffers which have not been viewed recently"))
749 (define-key-after map [menu-bar mark unmark-all]
750 '(menu-item "Unmark All" ibuffer-unmark-all))
71296446 751
25d2f683
CW
752 (define-key-after map [menu-bar mark dashes]
753 '("--"))
71296446 754
25d2f683
CW
755 (define-key-after map [menu-bar mark mark-by-name-regexp]
756 '(menu-item "Mark by buffer name (regexp)..." ibuffer-mark-by-name-regexp
757 :help "Mark buffers whose name matches a regexp"))
758 (define-key-after map [menu-bar mark mark-by-mode-regexp]
759 '(menu-item "Mark by major mode (regexp)..." ibuffer-mark-by-mode-regexp
760 :help "Mark buffers whose major mode name matches a regexp"))
761 (define-key-after map [menu-bar mark mark-by-file-name-regexp]
762 '(menu-item "Mark by file name (regexp)..." ibuffer-mark-by-file-name-regexp
763 :help "Mark buffers whose file name matches a regexp"))
764
765 ;; Operate map is added later
766
767 (define-key-after operate-map [do-view]
768 '(menu-item "View" ibuffer-do-view))
769 (define-key-after operate-map [do-view-other-frame]
770 '(menu-item "View (separate frame)" ibuffer-do-view-other-frame))
771 (define-key-after operate-map [do-save]
772 '(menu-item "Save" ibuffer-do-save))
773 (define-key-after operate-map [do-replace-regexp]
774 '(menu-item "Replace (regexp)..." ibuffer-do-replace-regexp
775 :help "Replace text inside marked buffers"))
776 (define-key-after operate-map [do-query-replace]
777 '(menu-item "Query Replace..." ibuffer-do-query-replace
778 :help "Replace text in marked buffers, asking each time"))
779 (define-key-after operate-map [do-query-replace-regexp]
780 '(menu-item "Query Replace (regexp)..." ibuffer-do-query-replace-regexp
781 :help "Replace text in marked buffers by regexp, asking each time"))
782 (define-key-after operate-map [do-print]
783 '(menu-item "Print" ibuffer-do-print))
784 (define-key-after operate-map [do-toggle-modified]
785 '(menu-item "Toggle modification flag" ibuffer-do-toggle-modified))
786 (define-key-after operate-map [do-revert]
787 '(menu-item "Revert" ibuffer-do-revert
788 :help "Revert marked buffers to their associated file"))
789 (define-key-after operate-map [do-rename-uniquely]
790 '(menu-item "Rename Uniquely" ibuffer-do-rename-uniquely
791 :help "Rename marked buffers to a new, unique name"))
792 (define-key-after operate-map [do-delete]
793 '(menu-item "Kill" ibuffer-do-delete))
794 (define-key-after operate-map [do-occur]
795 '(menu-item "List lines matching..." ibuffer-do-occur
796 :help "View all lines in marked buffers matching a regexp"))
797 (define-key-after operate-map [do-shell-command-pipe]
798 '(menu-item "Pipe to shell command..." ibuffer-do-shell-command-pipe
799 :help "For each marked buffer, send its contents to a shell command"))
800 (define-key-after operate-map [do-shell-command-pipe-replace]
801 '(menu-item "Pipe to shell command (replace)..." ibuffer-do-shell-command-pipe-replace
802 :help "For each marked buffer, replace its contents with output of shell command"))
803 (define-key-after operate-map [do-shell-command-file]
804 '(menu-item "Shell command on buffer's file..." ibuffer-do-shell-command-file
805 :help "For each marked buffer, run a shell command with its file as argument"))
806 (define-key-after operate-map [do-eval]
807 '(menu-item "Eval..." ibuffer-do-eval
808 :help "Evaluate a Lisp form in each marked buffer"))
809 (define-key-after operate-map [do-view-and-eval]
810 '(menu-item "Eval (viewing buffer)..." ibuffer-do-view-and-eval
811 :help "Evaluate a Lisp form in each marked buffer while viewing it"))
71296446 812
25d2f683 813 (setq ibuffer-mode-map map
b5e80d1a 814 ibuffer-mode-operate-map operate-map
2bd26a6f
CW
815 ibuffer-mode-groups-popup (copy-keymap groups-map))))
816
817(define-key ibuffer-mode-groups-popup [kill-filter-group]
4e4a724c
JPW
818 '(menu-item "Kill filter group"
819 ibuffer-kill-line
34a4faa0
JPW
820 :enable (and (featurep 'ibuf-ext)
821 ibuffer-filter-groups)))
545aad2f 822(define-key ibuffer-mode-groups-popup [yank-filter-group]
4e4a724c
JPW
823 '(menu-item "Yank last killed filter group"
824 ibuffer-yank
34a4faa0
JPW
825 :enable (and (featurep 'ibuf-ext)
826 ibuffer-filter-group-kill-ring)))
4e4a724c 827
acf88897 828(defvar ibuffer-name-map
25d2f683 829 (let ((map (make-sparse-keymap)))
25d2f683
CW
830 (define-key map [(mouse-1)] 'ibuffer-mouse-toggle-mark)
831 (define-key map [(mouse-2)] 'ibuffer-mouse-visit-buffer)
832 (define-key map [down-mouse-3] 'ibuffer-mouse-popup-menu)
acf88897 833 map))
25d2f683 834
d5794180
DN
835(defvar ibuffer-filename/process-header-map
836 (let ((map (make-sparse-keymap)))
837 (define-key map [(mouse-1)] 'ibuffer-do-sort-by-filename/process)
838 map))
839
acf88897 840(defvar ibuffer-mode-name-map
25d2f683 841 (let ((map (make-sparse-keymap)))
25d2f683
CW
842 (define-key map [(mouse-2)] 'ibuffer-mouse-filter-by-mode)
843 (define-key map (kbd "RET") 'ibuffer-interactive-filter-by-mode)
acf88897 844 map))
25d2f683 845
f0b31589
DN
846(defvar ibuffer-name-header-map
847 (let ((map (make-sparse-keymap)))
848 (define-key map [(mouse-1)] 'ibuffer-do-sort-by-alphabetic)
849 map))
850
851(defvar ibuffer-size-header-map
852 (let ((map (make-sparse-keymap)))
853 (define-key map [(mouse-1)] 'ibuffer-do-sort-by-size)
854 map))
855
856(defvar ibuffer-mode-header-map
857 (let ((map (make-sparse-keymap)))
858 (define-key map [(mouse-1)] 'ibuffer-do-sort-by-major-mode)
859 map))
860
acf88897 861(defvar ibuffer-mode-filter-group-map
b5cd37ea 862 (let ((map (make-sparse-keymap)))
b5cd37ea
CW
863 (define-key map [(mouse-1)] 'ibuffer-mouse-toggle-mark)
864 (define-key map [(mouse-2)] 'ibuffer-mouse-toggle-filter-group)
865 (define-key map (kbd "RET") 'ibuffer-toggle-filter-group)
b5e80d1a 866 (define-key map [down-mouse-3] 'ibuffer-mouse-popup-menu)
acf88897 867 map))
b5cd37ea 868
4ed1f829
JPW
869(defvar ibuffer-restore-window-config-on-quit nil
870 "If non-nil, restore previous window configuration upon exiting `ibuffer'.")
871
872(defvar ibuffer-prev-window-config nil
873 "Window configuration before starting Ibuffer.")
25d2f683
CW
874
875(defvar ibuffer-did-modification nil)
876
63f0a166
JB
877(defvar ibuffer-compiled-formats nil)
878(defvar ibuffer-cached-formats nil)
879(defvar ibuffer-cached-eliding-string nil)
880(defvar ibuffer-cached-elide-long-columns 0)
881
25d2f683
CW
882(defvar ibuffer-sorting-functions-alist nil
883 "An alist of functions which describe how to sort buffers.
884
885Note: You most likely do not want to modify this variable directly;
886use `define-ibuffer-sorter' instead.
887
888The alist elements are constructed like (NAME DESCRIPTION FUNCTION)
889Where NAME is a symbol describing the sorting method, DESCRIPTION is a
890short string which will be displayed in the minibuffer and menu, and
891FUNCTION is a function of two arguments, which will be the buffers to
892compare.")
893
894;;; Utility functions
895(defun ibuffer-columnize-and-insert-list (list &optional pad-width)
896 "Insert LIST into the current buffer in as many columns as possible.
897The maximum number of columns is determined by the current window
898width and the longest string in LIST."
899 (unless pad-width
900 (setq pad-width 3))
901 (let ((width (window-width))
902 (max (+ (apply #'max (mapcar #'length list))
903 pad-width)))
904 (let ((columns (/ width max)))
905 (when (zerop columns)
906 (setq columns 1))
907 (while list
908 (dotimes (i (1- columns))
909 (insert (concat (car list) (make-string (- max (length (car list)))
972b8f82 910 ?\s)))
25d2f683
CW
911 (setq list (cdr list)))
912 (when (not (null list))
913 (insert (pop list)))
914 (insert "\n")))))
915
25d2f683
CW
916(defsubst ibuffer-current-mark ()
917 (cadr (get-text-property (line-beginning-position)
918 'ibuffer-properties)))
919
920(defun ibuffer-mouse-toggle-mark (event)
921 "Toggle the marked status of the buffer chosen with the mouse."
922 (interactive "e")
923 (unwind-protect
b5cd37ea
CW
924 (let ((pt (save-excursion
925 (mouse-set-point event)
926 (point))))
927 (ibuffer-aif (get-text-property (point) 'ibuffer-filter-group-name)
928 (ibuffer-toggle-marks it)
929 (goto-char pt)
930 (let ((mark (ibuffer-current-mark)))
931 (setq buffer-read-only nil)
932 (if (eq mark ibuffer-marked-char)
972b8f82 933 (ibuffer-set-mark ?\s)
b5cd37ea 934 (ibuffer-set-mark ibuffer-marked-char)))))
25d2f683
CW
935 (setq buffer-read-only t)))
936
937(defun ibuffer-find-file (file &optional wildcards)
938 "Like `find-file', but default to the directory of the buffer at point."
939 (interactive
940 (let ((default-directory (let ((buf (ibuffer-current-buffer)))
941 (if (buffer-live-p buf)
942 (with-current-buffer buf
943 default-directory)
944 default-directory))))
945 (list (read-file-name "Find file: " default-directory)
fe78af29
JPW
946 t)))
947 (find-file file wildcards))
25d2f683
CW
948
949(defun ibuffer-mouse-visit-buffer (event)
950 "Visit the buffer chosen with the mouse."
951 (interactive "e")
952 (switch-to-buffer
953 (save-excursion
954 (mouse-set-point event)
b5cd37ea 955 (ibuffer-current-buffer t))))
25d2f683
CW
956
957(defun ibuffer-mouse-popup-menu (event)
958 "Display a menu of operations."
959 (interactive "e")
a1793b2d
JPW
960 (let ((eventpt (posn-point (event-end event)))
961 (origpt (point)))
25d2f683 962 (unwind-protect
51922c04 963 (if (get-text-property eventpt 'ibuffer-filter-group-name)
a1793b2d
JPW
964 (progn
965 (goto-char eventpt)
966 (popup-menu ibuffer-mode-groups-popup))
51922c04 967 (let ((inhibit-read-only t))
b5e80d1a 968 (ibuffer-save-marks
4e4a724c
JPW
969 ;; hm. we could probably do this in a better fashion
970 (ibuffer-unmark-all ?\r)
971 (save-excursion
972 (goto-char eventpt)
973 (ibuffer-set-mark ibuffer-marked-char))
974 (save-excursion
975 (popup-menu ibuffer-mode-operate-map)))))
a1793b2d 976 (setq buffer-read-only t)
4ba16127 977 (if (= eventpt (point))
a1793b2d 978 (goto-char origpt)))))
51922c04 979
b5cd37ea
CW
980(defun ibuffer-skip-properties (props direction)
981 (while (and (not (eobp))
982 (let ((hit nil))
983 (dolist (prop props hit)
984 (when (get-text-property (point) prop)
985 (setq hit t)))))
986 (forward-line direction)
987 (beginning-of-line)))
25d2f683 988
4e4a724c
JPW
989(defun ibuffer-customize ()
990 "Begin customizing Ibuffer interactively."
991 (interactive)
992 (customize-group 'ibuffer))
993
b5cd37ea 994(defun ibuffer-backward-line (&optional arg skip-group-names)
25d2f683
CW
995 "Move backwards ARG lines, wrapping around the list if necessary."
996 (interactive "P")
34a4faa0 997 (or arg (setq arg 1))
25d2f683
CW
998 (beginning-of-line)
999 (while (> arg 0)
1000 (forward-line -1)
0ce780e1
CW
1001 (when (and ibuffer-movement-cycle
1002 (or (get-text-property (point) 'ibuffer-title)
1003 (and skip-group-names
34a4faa0
JPW
1004 (get-text-property (point)
1005 'ibuffer-filter-group-name))))
25d2f683 1006 (goto-char (point-max))
60356fb5 1007 (beginning-of-line))
b5cd37ea
CW
1008 (ibuffer-skip-properties (append '(ibuffer-summary)
1009 (when skip-group-names
1010 '(ibuffer-filter-group-name)))
1011 -1)
60356fb5
CW
1012 ;; Handle the special case of no buffers.
1013 (when (get-text-property (point) 'ibuffer-title)
1014 (forward-line 1)
1015 (setq arg 1))
1016 (decf arg)))
25d2f683 1017
b5cd37ea 1018(defun ibuffer-forward-line (&optional arg skip-group-names)
25d2f683
CW
1019 "Move forward ARG lines, wrapping around the list if necessary."
1020 (interactive "P")
34a4faa0 1021 (or arg (setq arg 1))
25d2f683 1022 (beginning-of-line)
0ce780e1
CW
1023 (when (and ibuffer-movement-cycle
1024 (or (eobp)
1025 (get-text-property (point) 'ibuffer-summary)))
214b39be 1026 (goto-char (point-min)))
b5cd37ea
CW
1027 (when (or (get-text-property (point) 'ibuffer-title)
1028 (and skip-group-names
1029 (get-text-property (point) 'ibuffer-filter-group-name)))
1030 (when (> arg 0)
1031 (decf arg))
1032 (ibuffer-skip-properties (append '(ibuffer-title)
1033 (when skip-group-names
1034 '(ibuffer-filter-group-name)))
1035 1))
25d2f683
CW
1036 (if (< arg 0)
1037 (ibuffer-backward-line (- arg))
60356fb5
CW
1038 (while (> arg 0)
1039 (forward-line 1)
0ce780e1
CW
1040 (when (and ibuffer-movement-cycle
1041 (or (eobp)
1042 (get-text-property (point) 'ibuffer-summary)))
60356fb5 1043 (goto-char (point-min)))
b5cd37ea
CW
1044 (decf arg)
1045 (ibuffer-skip-properties (append '(ibuffer-title)
1046 (when skip-group-names
1047 '(ibuffer-filter-group-name)))
1048 1))))
25d2f683 1049
d246cabf
CW
1050(defun ibuffer-visit-buffer (&optional single)
1051 "Visit the buffer on this line.
d246cabf
CW
1052If optional argument SINGLE is non-nil, then also ensure there is only
1053one window."
1054 (interactive "P")
b5cd37ea 1055 (let ((buf (ibuffer-current-buffer t)))
25d2f683 1056 (bury-buffer (current-buffer))
d246cabf
CW
1057 (switch-to-buffer buf)
1058 (when single
1059 (delete-other-windows))))
25d2f683
CW
1060
1061(defun ibuffer-visit-buffer-other-window (&optional noselect)
1062 "Visit the buffer on this line in another window."
1063 (interactive)
b5cd37ea 1064 (let ((buf (ibuffer-current-buffer t)))
25d2f683
CW
1065 (bury-buffer (current-buffer))
1066 (if noselect
1067 (let ((curwin (selected-window)))
1068 (pop-to-buffer buf)
1069 (select-window curwin))
1070 (switch-to-buffer-other-window buf))))
1071
1072(defun ibuffer-visit-buffer-other-window-noselect ()
1073 "Visit the buffer on this line in another window, but don't select it."
1074 (interactive)
1075 (ibuffer-visit-buffer-other-window t))
1076
1077(defun ibuffer-visit-buffer-other-frame ()
1078 "Visit the buffer on this line in another frame."
1079 (interactive)
b5cd37ea 1080 (let ((buf (ibuffer-current-buffer t)))
25d2f683
CW
1081 (bury-buffer (current-buffer))
1082 (switch-to-buffer-other-frame buf)))
1083
1084(defun ibuffer-visit-buffer-1-window ()
1085 "Visit the buffer on this line, and delete other windows."
1086 (interactive)
d246cabf 1087 (ibuffer-visit-buffer t))
25d2f683
CW
1088
1089(defun ibuffer-bury-buffer ()
1090 "Bury the buffer on this line."
1091 (interactive)
b5cd37ea 1092 (let ((buf (ibuffer-current-buffer t))
25d2f683 1093 (line (+ 1 (count-lines 1 (point)))))
25d2f683
CW
1094 (bury-buffer buf)
1095 (ibuffer-update nil t)
e6ce8c42
GM
1096 (goto-char (point-min))
1097 (forward-line (1- line))))
25d2f683
CW
1098
1099(defun ibuffer-visit-tags-table ()
1100 "Visit the tags table in the buffer on this line. See `visit-tags-table'."
1101 (interactive)
b5cd37ea 1102 (let ((file (buffer-file-name (ibuffer-current-buffer t))))
25d2f683
CW
1103 (if file
1104 (visit-tags-table file)
1105 (error "Specified buffer has no file"))))
1106
1107(defun ibuffer-do-view (&optional other-frame)
1108 "View marked buffers, or the buffer on the current line.
1109If optional argument OTHER-FRAME is non-nil, then display each
1110marked buffer in a new frame. Otherwise, display each buffer as
1111a new window in the current frame, splitting vertically."
1112 (interactive)
1113 (ibuffer-do-view-1 (if other-frame 'other-frame 'vertically)))
1114
1115(defun ibuffer-do-view-horizontally (&optional other-frame)
1116 "As `ibuffer-do-view', but split windows horizontally."
1117 (interactive)
1118 (ibuffer-do-view-1 (if other-frame 'other-frame 'horizontally)))
1119
1120(defun ibuffer-do-view-1 (type)
1121 (let ((marked-bufs (ibuffer-get-marked-buffers)))
1122 (when (null marked-bufs)
b5cd37ea 1123 (setq marked-bufs (list (ibuffer-current-buffer t))))
25d2f683
CW
1124 (unless (and (eq type 'other-frame)
1125 (not ibuffer-expert)
1126 (> (length marked-bufs) 3)
1127 (not (y-or-n-p (format "Really create a new frame for %s buffers? "
1128 (length marked-bufs)))))
4e4a724c 1129 (set-buffer-modified-p nil)
25d2f683
CW
1130 (delete-other-windows)
1131 (switch-to-buffer (pop marked-bufs))
1132 (let ((height (/ (1- (if (eq type 'horizontally) (frame-width)
4e4a724c 1133 (frame-height)))
25d2f683
CW
1134 (1+ (length marked-bufs)))))
1135 (mapcar (if (eq type 'other-frame)
1136 #'(lambda (buf)
1137 (let ((curframe (selected-frame)))
acf88897 1138 (select-frame (make-frame))
25d2f683
CW
1139 (switch-to-buffer buf)
1140 (select-frame curframe)))
1141 #'(lambda (buf)
1142 (split-window nil height (eq type 'horizontally))
1143 (other-window 1)
1144 (switch-to-buffer buf)))
1145 marked-bufs)))))
1146
1147(defun ibuffer-do-view-other-frame ()
1148 "View each of the marked buffers in a separate frame."
1149 (interactive)
1150 (ibuffer-do-view t))
1151
1152(defsubst ibuffer-map-marked-lines (func)
1153 (prog1 (ibuffer-map-on-mark ibuffer-marked-char func)
1154 (ibuffer-redisplay t)))
1155
1156(defun ibuffer-shrink-to-fit (&optional owin)
54124194
MO
1157 ;; Make sure that redisplay is performed, otherwise there can be a
1158 ;; bad interaction with code in the window-scroll-functions hook
1159 (redisplay t)
25d2f683
CW
1160 (fit-window-to-buffer nil (when owin (/ (frame-height)
1161 (length (window-list (selected-frame)))))))
1162
1163(defun ibuffer-confirm-operation-on (operation names)
1164 "Display a buffer asking whether to perform OPERATION on NAMES."
1165 (or ibuffer-expert
1166 (if (= (length names) 1)
1167 (y-or-n-p (format "Really %s buffer %s? " operation (car names)))
1168 (let ((buf (get-buffer-create "*Ibuffer confirmation*")))
1169 (with-current-buffer buf
1170 (setq buffer-read-only nil)
1171 (erase-buffer)
1172 (ibuffer-columnize-and-insert-list names)
1173 (goto-char (point-min))
1174 (setq buffer-read-only t))
4e4a724c 1175 (let ((lastwin (car (last (window-list nil 'nomini)))))
25d2f683
CW
1176 ;; Now attempt to display the buffer...
1177 (save-window-excursion
1178 (select-window lastwin)
1179 ;; The window might be too small to split; in that case,
7ad5b902 1180 ;; try a few times to increase its size before giving up.
25d2f683
CW
1181 (let ((attempts 0)
1182 (trying t))
1183 (while trying
1184 (condition-case err
1185 (progn
1186 (split-window)
1187 (setq trying nil))
1188 (error
1189 ;; Handle a failure
1190 (if (or (> (incf attempts) 4)
1191 (and (stringp (cadr err))
71296446 1192 ;; This definitely falls in the
4e4a724c 1193 ;; ghetto hack category...
25d2f683
CW
1194 (not (string-match "too small" (cadr err)))))
1195 (apply #'signal err)
1196 (enlarge-window 3))))))
25d2f683
CW
1197 (select-window (next-window))
1198 (switch-to-buffer buf)
1199 (unwind-protect
1200 (progn
1201 (fit-window-to-buffer)
1202 (y-or-n-p (format "Really %s %d buffers? "
1203 operation (length names))))
1204 (kill-buffer buf))))))))
1205
1206(defsubst ibuffer-map-lines-nomodify (function)
1207 "As `ibuffer-map-lines', but don't set the modification flag."
1208 (ibuffer-map-lines function t))
1209
1210(defun ibuffer-buffer-names-with-mark (mark)
1211 (let ((ibuffer-buffer-names-with-mark-result nil))
1212 (ibuffer-map-lines-nomodify
4e4a724c 1213 #'(lambda (buf mk)
25d2f683
CW
1214 (when (char-equal mark mk)
1215 (push (buffer-name buf)
1216 ibuffer-buffer-names-with-mark-result))))
1217 ibuffer-buffer-names-with-mark-result))
1218
1219(defsubst ibuffer-marked-buffer-names ()
1220 (ibuffer-buffer-names-with-mark ibuffer-marked-char))
1221
1222(defsubst ibuffer-deletion-marked-buffer-names ()
1223 (ibuffer-buffer-names-with-mark ibuffer-deletion-char))
1224
1225(defun ibuffer-count-marked-lines (&optional all)
1226 (if all
1227 (ibuffer-map-lines-nomodify
57c9cc3e 1228 #'(lambda (buf mark)
972b8f82 1229 (not (char-equal mark ?\s))))
25d2f683 1230 (ibuffer-map-lines-nomodify
57c9cc3e 1231 #'(lambda (buf mark)
25d2f683
CW
1232 (char-equal mark ibuffer-marked-char)))))
1233
1234(defsubst ibuffer-count-deletion-lines ()
1235 (ibuffer-map-lines-nomodify
57c9cc3e 1236 #'(lambda (buf mark)
25d2f683
CW
1237 (char-equal mark ibuffer-deletion-char))))
1238
1239(defsubst ibuffer-map-deletion-lines (func)
1240 (ibuffer-map-on-mark ibuffer-deletion-char func))
1241
87a6a53a 1242(defsubst ibuffer-assert-ibuffer-mode ()
2ead9289 1243 (assert (derived-mode-p 'ibuffer-mode)))
87a6a53a 1244
92cb2eaf
JPW
1245(defun ibuffer-buffer-file-name ()
1246 (or buffer-file-name
1247 (let ((dirname (or (and (boundp 'dired-directory)
1248 (if (stringp dired-directory)
1249 dired-directory
1250 (car dired-directory)))
414408cd 1251 (bound-and-true-p list-buffers-directory))))
9d458edc 1252 (and dirname (expand-file-name dirname)))))
92cb2eaf 1253
fd225d80 1254(define-ibuffer-op ibuffer-do-save ()
25d2f683
CW
1255 "Save marked buffers as with `save-buffer'."
1256 (:complex t
1257 :opstring "saved"
1258 :modifier-p :maybe)
1259 (when (buffer-modified-p buf)
1260 (if (not (with-current-buffer buf
1261 buffer-file-name))
1262 ;; handle the case where we're prompted
1263 ;; for a file name
1264 (save-window-excursion
1265 (switch-to-buffer buf)
1266 (save-buffer))
1267 (with-current-buffer buf
1268 (save-buffer))))
1269 t)
1270
fd225d80 1271(define-ibuffer-op ibuffer-do-toggle-modified ()
25d2f683
CW
1272 "Toggle modification flag of marked buffers."
1273 (:opstring "(un)marked as modified"
1274 :modifier-p t)
1275 (set-buffer-modified-p (not (buffer-modified-p))))
1276
92be491c
RW
1277(define-ibuffer-op ibuffer-do-toggle-read-only (&optional arg)
1278 "Toggle read only status in marked buffers.
320d3e68 1279With optional ARG, make read-only only if ARG is positive."
25d2f683 1280 (:opstring "toggled read only status in"
92be491c 1281 :interactive "P"
25d2f683 1282 :modifier-p t)
92be491c 1283 (toggle-read-only arg))
25d2f683 1284
fd225d80 1285(define-ibuffer-op ibuffer-do-delete ()
25d2f683
CW
1286 "Kill marked buffers as with `kill-this-buffer'."
1287 (:opstring "killed"
1288 :active-opstring "kill"
1289 :dangerous t
1290 :complex t
1291 :modifier-p t)
1292 (if (kill-buffer buf)
1293 'kill
1294 nil))
1295
fd225d80 1296(define-ibuffer-op ibuffer-do-kill-on-deletion-marks ()
25d2f683
CW
1297 "Kill buffers marked for deletion as with `kill-this-buffer'."
1298 (:opstring "killed"
1299 :active-opstring "kill"
1300 :dangerous t
1301 :complex t
1302 :mark :deletion
1303 :modifier-p t)
1304 (if (kill-buffer buf)
1305 'kill
1306 nil))
1307
1308(defun ibuffer-unmark-all (mark)
1309 "Unmark all buffers with mark MARK."
1310 (interactive "cRemove marks (RET means all):")
1311 (if (= (ibuffer-count-marked-lines t) 0)
1312 (message "No buffers marked; use 'm' to mark a buffer")
1313 (cond
1314 ((char-equal mark ibuffer-marked-char)
1315 (ibuffer-map-marked-lines
57c9cc3e 1316 #'(lambda (buf mark)
972b8f82 1317 (ibuffer-set-mark-1 ?\s)
25d2f683
CW
1318 t)))
1319 ((char-equal mark ibuffer-deletion-char)
1320 (ibuffer-map-deletion-lines
57c9cc3e 1321 #'(lambda (buf mark)
972b8f82 1322 (ibuffer-set-mark-1 ?\s)
25d2f683
CW
1323 t)))
1324 (t
1325 (ibuffer-map-lines
57c9cc3e 1326 #'(lambda (buf mark)
972b8f82
JB
1327 (when (not (char-equal mark ?\s))
1328 (ibuffer-set-mark-1 ?\s))
25d2f683
CW
1329 t)))))
1330 (ibuffer-redisplay t))
1331
b5cd37ea 1332(defun ibuffer-toggle-marks (&optional group)
25d2f683
CW
1333 "Toggle which buffers are marked.
1334In other words, unmarked buffers become marked, and marked buffers
cba63a2d
CW
1335become unmarked.
1336If point is on a group name, then this function operates on that
1337group."
25d2f683 1338 (interactive)
cba63a2d
CW
1339 (ibuffer-aif (get-text-property (point) 'ibuffer-filter-group-name)
1340 (setq group it))
25d2f683
CW
1341 (let ((count
1342 (ibuffer-map-lines
57c9cc3e 1343 #'(lambda (buf mark)
25d2f683 1344 (cond ((eq mark ibuffer-marked-char)
972b8f82 1345 (ibuffer-set-mark-1 ?\s)
25d2f683 1346 nil)
972b8f82 1347 ((eq mark ?\s)
25d2f683
CW
1348 (ibuffer-set-mark-1 ibuffer-marked-char)
1349 t)
1350 (t
b5cd37ea
CW
1351 nil)))
1352 nil group)))
25d2f683
CW
1353 (message "%s buffers marked" count))
1354 (ibuffer-redisplay t))
1355
1356(defun ibuffer-mark-forward (arg)
cba63a2d
CW
1357 "Mark the buffer on this line, and move forward ARG lines.
1358If point is on a group name, this function operates on that group."
25d2f683
CW
1359 (interactive "P")
1360 (ibuffer-mark-interactive arg ibuffer-marked-char 1))
1361
1362(defun ibuffer-unmark-forward (arg)
cba63a2d
CW
1363 "Unmark the buffer on this line, and move forward ARG lines.
1364If point is on a group name, this function operates on that group."
25d2f683 1365 (interactive "P")
972b8f82 1366 (ibuffer-mark-interactive arg ?\s 1))
25d2f683
CW
1367
1368(defun ibuffer-unmark-backward (arg)
cba63a2d
CW
1369 "Unmark the buffer on this line, and move backward ARG lines.
1370If point is on a group name, this function operates on that group."
25d2f683 1371 (interactive "P")
972b8f82 1372 (ibuffer-mark-interactive arg ?\s -1))
25d2f683
CW
1373
1374(defun ibuffer-mark-interactive (arg mark movement)
87a6a53a 1375 (ibuffer-assert-ibuffer-mode)
34a4faa0 1376 (or arg (setq arg 1))
cba63a2d
CW
1377 (ibuffer-forward-line 0)
1378 (ibuffer-aif (get-text-property (point) 'ibuffer-filter-group-name)
1379 (progn
1380 (require 'ibuf-ext)
1381 (ibuffer-mark-on-buffer #'identity mark it))
4e4a724c 1382 (ibuffer-forward-line 0 t)
cba63a2d
CW
1383 (let ((inhibit-read-only t))
1384 (while (> arg 0)
1385 (ibuffer-set-mark mark)
1386 (ibuffer-forward-line movement t)
1387 (setq arg (1- arg))))))
25d2f683
CW
1388
1389(defun ibuffer-set-mark (mark)
87a6a53a 1390 (ibuffer-assert-ibuffer-mode)
25d2f683
CW
1391 (let ((inhibit-read-only t))
1392 (ibuffer-set-mark-1 mark)
1393 (setq ibuffer-did-modification t)
559ac4c1
CW
1394 (ibuffer-redisplay-current)
1395 (beginning-of-line)))
25d2f683
CW
1396
1397(defun ibuffer-set-mark-1 (mark)
1398 (let ((beg (line-beginning-position))
1399 (end (line-end-position)))
1400 (put-text-property beg end 'ibuffer-properties
1401 (list (ibuffer-current-buffer)
1402 mark))))
1403
1404(defun ibuffer-mark-for-delete (arg)
cba63a2d
CW
1405 "Mark the buffers on ARG lines forward for deletion.
1406If point is on a group name, this function operates on that group."
25d2f683
CW
1407 (interactive "P")
1408 (ibuffer-mark-interactive arg ibuffer-deletion-char 1))
1409
1410(defun ibuffer-mark-for-delete-backwards (arg)
cba63a2d
CW
1411 "Mark the buffers on ARG lines backward for deletion.
1412If point is on a group name, this function operates on that group."
25d2f683
CW
1413 (interactive "P")
1414 (ibuffer-mark-interactive arg ibuffer-deletion-char -1))
1415
1416(defun ibuffer-current-buffer (&optional must-be-live)
1417 (let ((buf (car (get-text-property (line-beginning-position)
1418 'ibuffer-properties))))
b5cd37ea
CW
1419 (when must-be-live
1420 (if (bufferp buf)
1421 (unless (buffer-live-p buf)
1388485d 1422 (error "Buffer %s has been killed; %s" buf (substitute-command-keys "use `\\[ibuffer-update]' to update")))
b5cd37ea 1423 (error "No buffer on this line")))
25d2f683 1424 buf))
523304ed
CW
1425
1426(defun ibuffer-active-formats-name ()
1427 (if (boundp 'ibuffer-filter-format-alist)
1428 (let ((ret nil))
1429 (dolist (filter ibuffer-filtering-qualifiers ret)
1430 (let ((val (assq (car filter) ibuffer-filter-format-alist)))
1431 (when val
1432 (setq ret (car filter)))))
1433 (if ret
1434 ret
1435 :ibuffer-formats))
1436 :ibuffer-formats))
1437
1438(defun ibuffer-current-formats (uncompiledp)
1439 (let* ((name (ibuffer-active-formats-name)))
1440 (ibuffer-check-formats)
1441 (if (eq name :ibuffer-formats)
1442 (if uncompiledp
1443 ibuffer-formats
1444 ibuffer-compiled-formats)
1445 (cadr (assq name
1446 (if uncompiledp
1447 ibuffer-filter-format-alist
1448 ibuffer-compiled-filter-formats))))))
71296446 1449
523304ed 1450(defun ibuffer-current-format (&optional uncompiledp)
25d2f683
CW
1451 (or ibuffer-current-format
1452 (setq ibuffer-current-format 0))
4e4a724c 1453 (nth ibuffer-current-format (ibuffer-current-formats uncompiledp)))
25d2f683
CW
1454
1455(defun ibuffer-expand-format-entry (form)
1456 (if (or (consp form)
1457 (symbolp form))
4e4a724c
JPW
1458 (let ((sym (intern (concat "ibuffer-make-column-"
1459 (symbol-name (if (consp form)
1460 (car form)
1461 form))))))
1462 (unless (or (fboundp sym)
1463 (assq sym ibuffer-inline-columns))
1464 (error "Unknown column %s in ibuffer-formats" form))
1465 (let (min max align elide)
1466 (if (consp form)
1467 (setq min (or (nth 1 form) 0)
1468 max (or (nth 2 form) -1)
1469 align (or (nth 3 form) :left)
1470 elide (or (nth 4 form) nil))
1471 (setq min 0
1472 max -1
1473 align :left
1474 elide nil))
1475 (list sym min max align elide)))
25d2f683 1476 form))
71296446 1477
25d2f683 1478(defun ibuffer-compile-make-eliding-form (strvar elide from-end-p)
545aad2f 1479 (let ((ellipsis (propertize ibuffer-eliding-string 'font-lock-face 'bold)))
63f0a166 1480 (if (or elide (with-no-warnings ibuffer-elide-long-columns))
25d2f683
CW
1481 `(if (> strlen 5)
1482 ,(if from-end-p
1483 `(concat ,ellipsis
1484 (substring ,strvar
1485 (length ibuffer-eliding-string)))
1486 `(concat
1487 (substring ,strvar 0 (- strlen ,(length ellipsis)))
1488 ,ellipsis))
1489 ,strvar)
1490 strvar)))
1491
1492(defun ibuffer-compile-make-substring-form (strvar maxvar from-end-p)
1493 (if from-end-p
1494 `(substring str
1495 (- strlen ,maxvar))
1496 `(substring ,strvar 0 ,maxvar)))
1497
1498(defun ibuffer-compile-make-format-form (strvar widthform alignment)
972b8f82
JB
1499 (let* ((left `(make-string tmp2 ?\s))
1500 (right `(make-string (- tmp1 tmp2) ?\s)))
25d2f683
CW
1501 `(progn
1502 (setq tmp1 ,widthform
1503 tmp2 (/ tmp1 2))
1504 ,(case alignment
1505 (:right `(concat ,left ,right ,strvar))
1506 (:center `(concat ,left ,strvar ,right))
1507 (:left `(concat ,strvar ,left ,right))
1508 (t (error "Invalid alignment %s" alignment))))))
1509
1510(defun ibuffer-compile-format (format)
1511 (let ((result nil)
cb059426
CW
1512 ;; We use these variables to keep track of which variables
1513 ;; inside the generated function we need to bind, since
1514 ;; binding variables in Emacs takes time.
1515 str-used tmp1-used tmp2-used global-strlen-used)
25d2f683
CW
1516 (dolist (form format)
1517 (push
cb059426
CW
1518 ;; Generate a form based on a particular format entry, like
1519 ;; " ", mark, or (mode 16 16 :right).
25d2f683 1520 (if (stringp form)
cb059426 1521 ;; It's a string; all we need to do is insert it.
25d2f683
CW
1522 `(insert ,form)
1523 (let* ((form (ibuffer-expand-format-entry form))
1524 (sym (nth 0 form))
1525 (min (nth 1 form))
1526 (max (nth 2 form))
1527 (align (nth 3 form))
1528 (elide (nth 4 form)))
1529 (let* ((from-end-p (when (minusp min)
1530 (setq min (- min))
1531 t))
1532 (letbindings nil)
1533 (outforms nil)
1534 minform
1535 maxform
1536 min-used max-used strlen-used)
1537 (when (or (not (integerp min)) (>= min 0))
cb059426
CW
1538 ;; This is a complex case; they want it limited to a
1539 ;; minimum size.
25d2f683
CW
1540 (setq min-used t)
1541 (setq str-used t strlen-used t global-strlen-used t
1542 tmp1-used t tmp2-used t)
cb059426 1543 ;; Generate code to limit the string to a minimum size.
25d2f683
CW
1544 (setq minform `(progn
1545 (setq str
1546 ,(ibuffer-compile-make-format-form
1547 'str
1548 `(- ,(if (integerp min)
1549 min
1550 'min)
1551 strlen)
1552 align)))))
1553 (when (or (not (integerp max)) (> max 0))
1554 (setq str-used t max-used t)
cb059426 1555 ;; Generate code to limit the string to a maximum size.
25d2f683
CW
1556 (setq maxform `(progn
1557 (setq str
1558 ,(ibuffer-compile-make-substring-form
1559 'str
1560 (if (integerp max)
1561 max
1562 'max)
1563 from-end-p))
1564 (setq strlen (length str))
1565 (setq str
1566 ,(ibuffer-compile-make-eliding-form 'str
1567 elide
1568 from-end-p)))))
cb059426
CW
1569 ;; Now, put these forms together with the rest of the code.
1570 (let ((callform
1571 ;; Is this an "inline" column? This means we have
1572 ;; to get the code from the
1573 ;; `ibuffer-inline-columns' alist and insert it
1574 ;; into our generated code. Otherwise, we just
1575 ;; generate a call to the column function.
1576 (ibuffer-aif (assq sym ibuffer-inline-columns)
4e4a724c
JPW
1577 (nth 1 it)
1578 `(,sym buffer mark)))
cb059426
CW
1579 ;; You're not expected to understand this. Hell, I
1580 ;; don't even understand it, and I wrote it five
1581 ;; minutes ago.
1582 (insertgenfn (ibuffer-aif (get sym 'ibuffer-column-summarizer)
4e4a724c
JPW
1583 ;; I really, really wish Emacs Lisp had closures.
1584 (lambda (arg sym)
1585 `(insert
1586 (let ((ret ,arg))
1587 (put ',sym 'ibuffer-column-summary
1588 (cons ret (get ',sym 'ibuffer-column-summary)))
1589 ret)))
545aad2f
CW
1590 (lambda (arg sym)
1591 `(insert ,arg))))
25d2f683
CW
1592 (mincompform `(< strlen ,(if (integerp min)
1593 min
1594 'min)))
1595 (maxcompform `(> strlen ,(if (integerp max)
1596 max
1597 'max))))
4e4a724c
JPW
1598 (if (or min-used max-used)
1599 ;; The complex case, where we have to limit the
1600 ;; form to a maximum or minimum size.
1601 (progn
1602 (when (and min-used (not (integerp min)))
1603 (push `(min ,min) letbindings))
1604 (when (and max-used (not (integerp max)))
1605 (push `(max ,max) letbindings))
1606 (push
1607 (if (and min-used max-used)
1608 `(if ,mincompform
1609 ,minform
1610 (if ,maxcompform
1611 ,maxform))
1612 (if min-used
1613 `(when ,mincompform
1614 ,minform)
1615 `(when ,maxcompform
1616 ,maxform)))
1617 outforms)
1618 (push (append
1619 `(setq str ,callform)
1620 (when strlen-used
1621 `(strlen (length str))))
1622 outforms)
1623 (setq outforms
1624 (append outforms (list (funcall insertgenfn 'str sym)))))
1625 ;; The simple case; just insert the string.
1626 (push (funcall insertgenfn callform sym) outforms))
1627 ;; Finally, return a `let' form which binds the
1628 ;; variables in `letbindings', and contains all the
1629 ;; code in `outforms'.
1630 `(let ,letbindings
1631 ,@outforms)))))
25d2f683
CW
1632 result))
1633 (setq result
cb059426 1634 ;; We don't want to unconditionally load the byte-compiler.
25d2f683
CW
1635 (funcall (if (or ibuffer-always-compile-formats
1636 (featurep 'bytecomp))
1637 #'byte-compile
1638 #'identity)
cb059426
CW
1639 ;; Here, we actually create a lambda form which
1640 ;; inserts all the generated forms for each entry
1641 ;; in the format string.
25d2f683 1642 (nconc (list 'lambda '(buffer mark))
d99b259b 1643 `((let ,(append (when str-used
25d2f683
CW
1644 '(str))
1645 (when global-strlen-used
1646 '(strlen))
1647 (when tmp1-used
1648 '(tmp1))
1649 (when tmp2-used
1650 '(tmp2)))
1651 ,@(nreverse result))))))))
1652
25d2f683
CW
1653(defun ibuffer-recompile-formats ()
1654 "Recompile `ibuffer-formats'."
1655 (interactive)
1656 (setq ibuffer-compiled-formats
4e4a724c 1657 (mapcar #'ibuffer-compile-format ibuffer-formats))
523304ed
CW
1658 (when (boundp 'ibuffer-filter-format-alist)
1659 (setq ibuffer-compiled-filter-formats
1660 (mapcar #'(lambda (entry)
1661 (cons (car entry)
1662 (mapcar #'(lambda (formats)
1663 (mapcar #'ibuffer-compile-format formats))
1664 (cdr entry))))
1665 ibuffer-filter-format-alist))))
25d2f683 1666
cb059426
CW
1667(defun ibuffer-clear-summary-columns (format)
1668 (dolist (form format)
1669 (ibuffer-awhen (and (consp form)
1670 (get (car form) 'ibuffer-column-summarizer))
1671 (put (car form) 'ibuffer-column-summary nil))))
71296446 1672
25d2f683 1673(defun ibuffer-check-formats ()
523304ed
CW
1674 (when (null ibuffer-formats)
1675 (error "No formats!"))
b5cd37ea
CW
1676 (let ((ext-loaded (featurep 'ibuf-ext)))
1677 (when (or (null ibuffer-compiled-formats)
1678 (null ibuffer-cached-formats)
1679 (not (eq ibuffer-cached-formats ibuffer-formats))
1680 (null ibuffer-cached-eliding-string)
1681 (not (equal ibuffer-cached-eliding-string ibuffer-eliding-string))
1682 (eql 0 ibuffer-cached-elide-long-columns)
1683 (not (eql ibuffer-cached-elide-long-columns
63f0a166 1684 (with-no-warnings ibuffer-elide-long-columns)))
b5cd37ea
CW
1685 (and ext-loaded
1686 (not (eq ibuffer-cached-filter-formats
1687 ibuffer-filter-format-alist))
1688 (and ibuffer-filter-format-alist
1689 (null ibuffer-compiled-filter-formats))))
1690 (message "Formats have changed, recompiling...")
1691 (ibuffer-recompile-formats)
1692 (setq ibuffer-cached-formats ibuffer-formats
1693 ibuffer-cached-eliding-string ibuffer-eliding-string
63f0a166 1694 ibuffer-cached-elide-long-columns (with-no-warnings ibuffer-elide-long-columns))
b5cd37ea
CW
1695 (when ext-loaded
1696 (setq ibuffer-cached-filter-formats ibuffer-filter-format-alist))
1697 (message "Formats have changed, recompiling...done"))))
25d2f683
CW
1698
1699(defvar ibuffer-inline-columns nil)
1700
1701(define-ibuffer-column mark (:name " " :inline t)
1702 (string mark))
1703
1704(define-ibuffer-column read-only (:name "R" :inline t)
1705 (if buffer-read-only
34a4faa0 1706 (string ibuffer-read-only-char)
25d2f683
CW
1707 " "))
1708
1709(define-ibuffer-column modified (:name "M" :inline t)
1710 (if (buffer-modified-p)
1711 (string ibuffer-modified-char)
1712 " "))
1713
34a4faa0
JPW
1714(define-ibuffer-column name
1715 (:inline t
f0b31589 1716 :header-mouse-map ibuffer-name-header-map
34a4faa0
JPW
1717 :props
1718 ('mouse-face 'highlight 'keymap ibuffer-name-map
1719 'ibuffer-name-column t
1720 'help-echo '(if tooltip-mode
1721 "mouse-1: mark this buffer\nmouse-2: select this buffer\nmouse-3: operate on this buffer"
1722 "mouse-1: mark buffer mouse-2: select buffer mouse-3: operate"))
1723 :summarizer
1724 (lambda (strings)
1725 (let ((bufs (length strings)))
1726 (cond ((zerop bufs) "No buffers")
1727 ((= 1 bufs) "1 buffer")
1728 (t (format "%s buffers" bufs))))))
545aad2f 1729 (propertize (buffer-name) 'font-lock-face (ibuffer-buffer-name-face buffer mark)))
71296446 1730
34a4faa0
JPW
1731(define-ibuffer-column size
1732 (:inline t
f0b31589 1733 :header-mouse-map ibuffer-size-header-map
34a4faa0
JPW
1734 :summarizer
1735 (lambda (column-strings)
1736 (let ((total 0))
1737 (dolist (string column-strings)
1738 (setq total
1739 ;; like, ewww ...
7ad938e7 1740 (+ (float (string-to-number string))
34a4faa0
JPW
1741 total)))
1742 (format "%.0f" total))))
25d2f683
CW
1743 (format "%s" (buffer-size)))
1744
7ad938e7
JPW
1745(define-ibuffer-column mode
1746 (:inline t
f0b31589 1747 :header-mouse-map ibuffer-mode-header-map
7ad938e7
JPW
1748 :props
1749 ('mouse-face 'highlight
1750 'keymap ibuffer-mode-name-map
1751 'help-echo "mouse-2: filter by this mode"))
23eabff6 1752 (format-mode-line mode-name nil nil (current-buffer)))
25d2f683 1753
34a4faa0
JPW
1754(define-ibuffer-column process
1755 (:summarizer
1756 (lambda (strings)
1757 (let ((total (length (delete "" strings))))
1758 (cond ((zerop total) "No processes")
1759 ((= 1 total) "1 process")
1760 (t (format "%d processes" total))))))
96777edb
CW
1761 (ibuffer-aif (get-buffer-process buffer)
1762 (format "(%s %s)" it (process-status it))
34a4faa0
JPW
1763 ""))
1764
1765(define-ibuffer-column filename
1766 (:summarizer
1767 (lambda (strings)
1768 (let ((total (length (delete "" strings))))
1769 (cond ((zerop total) "No files")
1770 ((= 1 total) "1 file")
1771 (t (format "%d files" total))))))
25d2f683
CW
1772 (let ((directory-abbrev-alist ibuffer-directory-abbrev-alist))
1773 (abbreviate-file-name
9d458edc 1774 (or (ibuffer-buffer-file-name) ""))))
25d2f683 1775
34a4faa0
JPW
1776(define-ibuffer-column filename-and-process
1777 (:name "Filename/Process"
d5794180 1778 :header-mouse-map ibuffer-filename/process-header-map
34a4faa0
JPW
1779 :summarizer
1780 (lambda (strings)
1781 (setq strings (delete "" strings))
1782 (let ((procs 0)
1783 (files 0))
1784 (dolist (string strings)
1785 (if (string-match "\\(\?:\\`(\[\[:ascii:\]\]\+)\\)" string)
1786 (progn (setq procs (1+ procs))
1787 (if (< (match-end 0) (length string))
1788 (setq files (1+ files))))
1789 (setq files (1+ files))))
1790 (concat (cond ((zerop files) "No files")
1791 ((= 1 files) "1 file")
1792 (t (format "%d files" files)))
1793 ", "
1794 (cond ((zerop procs) "no processes")
1795 ((= 1 procs) "1 process")
1796 (t (format "%d processes" procs)))))))
fd225d80 1797 (let ((proc (get-buffer-process buffer))
63e0bf5e 1798 (filename (ibuffer-make-column-filename buffer mark)))
fd225d80 1799 (if proc
34a4faa0 1800 (concat (propertize (format "(%s %s)" proc (process-status proc))
545aad2f 1801 'font-lock-face 'italic)
34a4faa0
JPW
1802 (if (> (length filename) 0)
1803 (format " %s" filename)
1804 ""))
fd225d80
CW
1805 filename)))
1806
25d2f683 1807(defun ibuffer-format-column (str width alignment)
972b8f82
JB
1808 (let ((left (make-string (/ width 2) ?\s))
1809 (right (make-string (- width (/ width 2)) ?\s)))
25d2f683
CW
1810 (case alignment
1811 (:right (concat left right str))
1812 (:center (concat left str right))
1813 (t (concat str left right)))))
1814
545aad2f 1815(defun ibuffer-buffer-name-face (buf mark)
fd225d80 1816 (cond ((char-equal mark ibuffer-marked-char)
545aad2f 1817 ibuffer-marked-face)
fd225d80 1818 ((char-equal mark ibuffer-deletion-char)
545aad2f 1819 ibuffer-deletion-face)
fd225d80
CW
1820 (t
1821 (let ((level -1)
fd225d80
CW
1822 result)
1823 (dolist (e ibuffer-fontification-alist result)
1824 (when (and (> (car e) level)
1825 (with-current-buffer buf
545aad2f 1826 (eval (nth 1 e))))
fd225d80 1827 (setq level (car e)
545aad2f 1828 result (nth 2 e))))))))
25d2f683
CW
1829
1830(defun ibuffer-insert-buffer-line (buffer mark format)
1831 "Insert a line describing BUFFER and MARK using FORMAT."
87a6a53a 1832 (ibuffer-assert-ibuffer-mode)
25d2f683 1833 (let ((beg (point)))
25d2f683 1834 (funcall format buffer mark)
cb059426
CW
1835 (put-text-property beg (point) 'ibuffer-properties (list buffer mark)))
1836 (insert "\n"))
25d2f683 1837
cb059426 1838;; This function knows a bit too much of the internals. It would be
b5cd37ea 1839;; nice if it was all abstracted away.
25d2f683 1840(defun ibuffer-redisplay-current ()
87a6a53a 1841 (ibuffer-assert-ibuffer-mode)
25d2f683
CW
1842 (when (eobp)
1843 (forward-line -1))
1844 (beginning-of-line)
cb059426
CW
1845 (let ((curformat (mapcar #'ibuffer-expand-format-entry
1846 (ibuffer-current-format t))))
1847 (ibuffer-clear-summary-columns curformat)
1848 (let ((buf (ibuffer-current-buffer)))
1849 (when buf
1850 (let ((mark (ibuffer-current-mark)))
ed233dd8
CW
1851 (save-excursion
1852 (delete-region (point) (1+ (line-end-position)))
1853 (ibuffer-insert-buffer-line
1854 buf mark
1855 (ibuffer-current-format)))
cb059426
CW
1856 (when ibuffer-shrink-to-minimum-size
1857 (ibuffer-shrink-to-fit)))))))
71296446 1858
25d2f683
CW
1859(defun ibuffer-map-on-mark (mark func)
1860 (ibuffer-map-lines
57c9cc3e 1861 #'(lambda (buf mk)
25d2f683 1862 (if (char-equal mark mk)
57c9cc3e 1863 (funcall func buf mark)
25d2f683
CW
1864 nil))))
1865
b5cd37ea
CW
1866(defun ibuffer-map-lines (function &optional nomodify group)
1867 "Call FUNCTION for each buffer.
4837b516 1868Set the ibuffer modification flag unless NOMODIFY is non-nil.
25d2f683 1869
b5cd37ea
CW
1870If optional argument GROUP is non-nil, then only call FUNCTION on
1871buffers in filtering group GROUP.
1872
4e4a724c
JPW
1873FUNCTION is called with two arguments:
1874the buffer object itself and the current mark symbol."
87a6a53a 1875 (ibuffer-assert-ibuffer-mode)
b5cd37ea
CW
1876 (ibuffer-forward-line 0)
1877 (let* ((orig-target-line (1+ (count-lines (save-excursion
1878 (goto-char (point-min))
1879 (ibuffer-forward-line 0)
1880 (point))
1881 (point))))
1882 (target-line-offset orig-target-line)
1883 (ibuffer-map-lines-total 0)
1884 (ibuffer-map-lines-count 0))
25d2f683 1885 (unwind-protect
57c9cc3e
CW
1886 (progn
1887 (setq buffer-read-only nil)
1888 (goto-char (point-min))
4e4a724c 1889 (ibuffer-forward-line 0 t)
57c9cc3e 1890 (while (and (not (eobp))
b5cd37ea
CW
1891 (not (get-text-property (point) 'ibuffer-summary))
1892 (progn
1893 (ibuffer-forward-line 0 t)
1894 (and (not (eobp))
1895 (not (get-text-property (point) 'ibuffer-summary)))))
57c9cc3e
CW
1896 (let ((result
1897 (if (buffer-live-p (ibuffer-current-buffer))
b5cd37ea
CW
1898 (when (or (null group)
1899 (ibuffer-aif (get-text-property (point) 'ibuffer-filter-group)
1900 (equal group it)))
1901 (save-excursion
1902 (funcall function
1903 (ibuffer-current-buffer)
1904 (ibuffer-current-mark))))
57c9cc3e
CW
1905 ;; Kill the line if the buffer is dead
1906 'kill)))
1907 ;; A given mapping function should return:
1908 ;; `nil' if it chose not to affect the buffer
1909 ;; `kill' means the remove line from the buffer list
1910 ;; `t' otherwise
1911 (incf ibuffer-map-lines-total)
1912 (cond ((null result)
1913 (forward-line 1))
1914 ((eq result 'kill)
1915 (delete-region (line-beginning-position)
1916 (1+ (line-end-position)))
1917 (incf ibuffer-map-lines-count)
1918 (when (< ibuffer-map-lines-total
4e4a724c 1919 orig-target-line)
b5cd37ea 1920 (decf target-line-offset)))
57c9cc3e
CW
1921 (t
1922 (incf ibuffer-map-lines-count)
1923 (forward-line 1)))))
1924 ibuffer-map-lines-count)
25d2f683
CW
1925 (progn
1926 (setq buffer-read-only t)
1927 (unless nomodify
1928 (set-buffer-modified-p nil))
57c9cc3e
CW
1929 (goto-char (point-min))
1930 (ibuffer-forward-line 0)
b5cd37ea 1931 (ibuffer-forward-line (1- target-line-offset))))))
25d2f683
CW
1932
1933(defun ibuffer-get-marked-buffers ()
1934 "Return a list of buffer objects currently marked."
1935 (delq nil
1936 (mapcar #'(lambda (e)
1937 (when (eq (cdr e) ibuffer-marked-char)
1938 (car e)))
1939 (ibuffer-current-state-list))))
1940
d246cabf
CW
1941(defun ibuffer-current-state-list (&optional pos)
1942 "Return a list like (BUF . MARK) of all buffers in an ibuffer.
1943If POS is non-nil, return a list like (BUF MARK POINT), where POINT is
1944the value of point at the beginning of the line for that buffer."
25d2f683
CW
1945 (let ((ibuffer-current-state-list-tmp '()))
1946 ;; ah, if only we had closures. I bet this will mysteriously
1947 ;; break later. Don't blame me.
d246cabf
CW
1948 (if pos
1949 (ibuffer-map-lines-nomodify
1950 #'(lambda (buf mark)
1951 (when (buffer-live-p buf)
1952 (push (list buf mark (point)) ibuffer-current-state-list-tmp))))
1953 (ibuffer-map-lines-nomodify
1954 #'(lambda (buf mark)
1955 (when (buffer-live-p buf)
1956 (push (cons buf mark) ibuffer-current-state-list-tmp)))))
25d2f683
CW
1957 (nreverse ibuffer-current-state-list-tmp)))
1958
851476d4 1959(defun ibuffer-current-buffers-with-marks (curbufs)
25d2f683
CW
1960 "Return a list like (BUF . MARK) of all open buffers."
1961 (let ((bufs (ibuffer-current-state-list)))
1962 (mapcar #'(lambda (buf) (let ((e (assq buf bufs)))
1963 (if e
1964 e
972b8f82 1965 (cons buf ?\s))))
851476d4 1966 curbufs)))
25d2f683
CW
1967
1968(defun ibuffer-buf-matches-predicates (buf predicates)
1969 (let ((hit nil)
1970 (name (buffer-name buf)))
1971 (dolist (pred predicates)
1972 (when (if (stringp pred)
1973 (string-match pred name)
1974 (funcall pred buf))
1975 (setq hit t)))
1976 hit))
71296446 1977
25d2f683
CW
1978(defun ibuffer-filter-buffers (ibuffer-buf last bmarklist all)
1979 (let ((ext-loaded (featurep 'ibuf-ext)))
1980 (delq nil
b5cd37ea
CW
1981 (mapcar
1982 ;; element should be like (BUFFER . MARK)
1983 #'(lambda (e)
1984 (let* ((buf (car e)))
1985 (when
1986 ;; This takes precedence over anything else
1987 (or (and ibuffer-always-show-last-buffer
4e4a724c
JPW
1988 (eq last buf))
1989 (funcall (if ext-loaded
1990 #'ibuffer-ext-visible-p
1991 #'ibuffer-visible-p)
1992 buf all ibuffer-buf))
b5cd37ea
CW
1993 e)))
1994 bmarklist))))
25d2f683
CW
1995
1996(defun ibuffer-visible-p (buf all &optional ibuffer-buf)
1997 (and (or all
1998 (not
1999 (ibuffer-buf-matches-predicates buf ibuffer-maybe-show-predicates)))
2000 (or ibuffer-view-ibuffer
4e4a724c 2001 (and ibuffer-buf
25d2f683
CW
2002 (not (eq ibuffer-buf buf))))))
2003
2004;; This function is a special case; it's not defined by
6081889e 2005;; `define-ibuffer-sorter'.
25d2f683
CW
2006(defun ibuffer-do-sort-by-recency ()
2007 "Sort the buffers by last view time."
2008 (interactive)
2009 (setq ibuffer-sorting-mode 'recency)
e7820654
JPW
2010 (when (eq ibuffer-last-sorting-mode 'recency)
2011 (setq ibuffer-sorting-reversep (not ibuffer-sorting-reversep)))
2012 (ibuffer-update nil t)
2013 (setq ibuffer-last-sorting-mode 'recency))
25d2f683
CW
2014
2015(defun ibuffer-update-format ()
2016 (when (null ibuffer-current-format)
2017 (setq ibuffer-current-format 0))
2018 (when (null ibuffer-formats)
2019 (error "Ibuffer error: no formats!")))
2020
2021(defun ibuffer-switch-format ()
2022 "Switch the current display format."
2023 (interactive)
87a6a53a 2024 (ibuffer-assert-ibuffer-mode)
25d2f683
CW
2025 (unless (consp ibuffer-formats)
2026 (error "Ibuffer error: No formats!"))
2027 (setq ibuffer-current-format
80a06d64 2028 (if (>= ibuffer-current-format (1- (length (ibuffer-current-formats nil))))
25d2f683
CW
2029 0
2030 (1+ ibuffer-current-format)))
2031 (ibuffer-update-format)
2032 (ibuffer-redisplay t))
2033
cb059426 2034(defun ibuffer-update-title-and-summary (format)
87a6a53a 2035 (ibuffer-assert-ibuffer-mode)
25d2f683
CW
2036 ;; Don't do funky font-lock stuff here
2037 (let ((after-change-functions nil))
2038 (if (get-text-property (point-min) 'ibuffer-title)
2039 (delete-region (point-min)
2040 (next-single-property-change
2041 (point-min) 'ibuffer-title)))
2042 (goto-char (point-min))
fd225d80 2043 (add-text-properties
25d2f683
CW
2044 (point)
2045 (progn
2046 (let ((opos (point)))
2047 ;; Insert the title names.
cb059426 2048 (dolist (element format)
25d2f683
CW
2049 (insert
2050 (if (stringp element)
2051 element
2052 (let ((sym (car element))
2053 (min (cadr element))
2054 ;; (max (caddr element))
2055 (align (cadddr element)))
4e4a724c 2056 ;; Ignore a negative min when we're inserting the title
25d2f683
CW
2057 (when (minusp min)
2058 (setq min (- min)))
2059 (let* ((name (or (get sym 'ibuffer-column-name)
2060 (error "Unknown column %s in ibuffer-formats" sym)))
f0b31589
DN
2061 (len (length name))
2062 (hmap (get sym 'header-mouse-map))
2063 (strname (if (< len min)
2064 (ibuffer-format-column name
2065 (- min len)
2066 align)
2067 name)))
2068 (when hmap
2069 (setq
2ead9289 2070 strname
f0b31589
DN
2071 (propertize strname 'mouse-face 'highlight 'keymap hmap)))
2072 strname)))))
fd225d80 2073 (add-text-properties opos (point) `(ibuffer-title-header t))
25d2f683
CW
2074 (insert "\n")
2075 ;; Add the underlines
2076 (let ((str (save-excursion
2077 (forward-line -1)
2078 (beginning-of-line)
2079 (buffer-substring (point) (line-end-position)))))
2080 (apply #'insert (mapcar
2081 #'(lambda (c)
972b8f82 2082 (if (not (or (char-equal c ?\s)
25d2f683
CW
2083 (char-equal c ?\n)))
2084 ?-
972b8f82 2085 ?\s))
25d2f683
CW
2086 str)))
2087 (insert "\n"))
2088 (point))
545aad2f 2089 `(ibuffer-title t font-lock-face ,ibuffer-title-face))
cb059426
CW
2090 ;; Now, insert the summary columns.
2091 (goto-char (point-max))
2092 (if (get-text-property (1- (point-max)) 'ibuffer-summary)
2093 (delete-region (previous-single-property-change
2094 (point-max) 'ibuffer-summary)
2095 (point-max)))
0740098c
JPW
2096 (if ibuffer-display-summary
2097 (add-text-properties
2098 (point)
2099 (progn
2100 (insert "\n")
2101 (dolist (element format)
2102 (insert
2103 (if (stringp element)
972b8f82 2104 (make-string (length element) ?\s)
0740098c
JPW
2105 (let ((sym (car element)))
2106 (let ((min (cadr element))
2107 ;; (max (caddr element))
2108 (align (cadddr element)))
2109 ;; Ignore a negative min when we're inserting the title
2110 (when (minusp min)
2111 (setq min (- min)))
2112 (let* ((summary (if (get sym 'ibuffer-column-summarizer)
2113 (funcall (get sym 'ibuffer-column-summarizer)
2114 (get sym 'ibuffer-column-summary))
2115 (make-string (length (get sym 'ibuffer-column-name))
972b8f82 2116 ?\s)))
0740098c
JPW
2117 (len (length summary)))
2118 (if (< len min)
2119 (ibuffer-format-column summary
2120 (- min len)
2121 align)
2122 summary)))))))
2123 (point))
2124 `(ibuffer-summary t)))))
25d2f683 2125
25d2f683
CW
2126
2127(defun ibuffer-redisplay (&optional silent)
2128 "Redisplay the current list of buffers.
25d2f683
CW
2129This does not show new buffers; use `ibuffer-update' for that.
2130
7ad5b902 2131If optional arg SILENT is non-nil, do not display progress messages."
25d2f683 2132 (interactive)
57c9cc3e 2133 (ibuffer-forward-line 0)
25d2f683
CW
2134 (unless silent
2135 (message "Redisplaying current buffer list..."))
2136 (let ((blist (ibuffer-current-state-list)))
2137 (when (null blist)
2138 (if (and (featurep 'ibuf-ext)
cba63a2d 2139 (or ibuffer-filtering-qualifiers ibuffer-hidden-filter-groups))
25d2f683
CW
2140 (message "No buffers! (note: filtering in effect)")
2141 (error "No buffers!")))
b5cd37ea 2142 (ibuffer-redisplay-engine blist t)
25d2f683 2143 (unless silent
57c9cc3e
CW
2144 (message "Redisplaying current buffer list...done"))
2145 (ibuffer-forward-line 0)))
25d2f683
CW
2146
2147(defun ibuffer-update (arg &optional silent)
2148 "Regenerate the list of all buffers.
957237cb
JPW
2149
2150Prefix arg non-nil means to toggle whether buffers that match
2151`ibuffer-maybe-show-predicates' should be displayed.
25d2f683 2152
7ad5b902 2153If optional arg SILENT is non-nil, do not display progress messages."
25d2f683 2154 (interactive "P")
957237cb
JPW
2155 (if arg
2156 (setq ibuffer-display-maybe-show-predicates
2157 (not ibuffer-display-maybe-show-predicates)))
57c9cc3e 2158 (ibuffer-forward-line 0)
25d2f683
CW
2159 (let* ((bufs (buffer-list))
2160 (blist (ibuffer-filter-buffers
94394914
JPW
2161 (current-buffer)
2162 (if (and
2163 (cadr bufs)
2164 (eq ibuffer-always-show-last-buffer
2165 :nomini)
8e7dbfdb 2166 (minibufferp (cadr bufs)))
da337a28 2167 (caddr bufs)
94394914
JPW
2168 (cadr bufs))
2169 (ibuffer-current-buffers-with-marks bufs)
957237cb 2170 ibuffer-display-maybe-show-predicates)))
25d2f683
CW
2171 (when (null blist)
2172 (if (and (featurep 'ibuf-ext)
2173 ibuffer-filtering-qualifiers)
2174 (message "No buffers! (note: filtering in effect)")
2175 (error "No buffers!")))
2176 (unless silent
2177 (message "Updating buffer list..."))
b5cd37ea 2178 (ibuffer-redisplay-engine blist arg)
25d2f683
CW
2179 (unless silent
2180 (message "Updating buffer list...done")))
2181 (if (eq ibuffer-shrink-to-minimum-size 'onewindow)
2182 (ibuffer-shrink-to-fit t)
2183 (when ibuffer-shrink-to-minimum-size
2184 (ibuffer-shrink-to-fit)))
6d11a78b
SM
2185 (ibuffer-forward-line 0)
2186 ;; I tried to update this automatically from the mode-line-process format,
2187 ;; but changing nil-ness of header-line-format while computing
2188 ;; mode-line-format is asking a bit too much it seems. --Stef
2189 (setq header-line-format
2190 (and ibuffer-use-header-line
2191 ibuffer-filtering-qualifiers
2192 ibuffer-header-line-format)))
25d2f683 2193
b5cd37ea 2194(defun ibuffer-sort-bufferlist (bmarklist)
e19fff38
JB
2195 (unless ibuffer-sorting-functions-alist
2196 ;; make sure the sorting functions are loaded
2197 (require 'ibuf-ext))
b5cd37ea
CW
2198 (let* ((sortdat (assq ibuffer-sorting-mode
2199 ibuffer-sorting-functions-alist))
2200 (func (caddr sortdat)))
2201 (let ((result
2202 ;; actually sort the buffers
2203 (if (and sortdat func)
2204 (sort bmarklist func)
2205 bmarklist)))
2206 ;; perhaps reverse the sorted buffer list
2207 (if ibuffer-sorting-reversep
2208 (nreverse result)
2209 result))))
2210
7fbac645 2211(defun ibuffer-insert-filter-group (name display-name filter-string format bmarklist)
b5cd37ea
CW
2212 (add-text-properties
2213 (point)
2214 (progn
2215 (insert "[ " display-name " ]")
2216 (point))
fd225d80
CW
2217 `(ibuffer-filter-group-name
2218 ,name
545aad2f 2219 font-lock-face ,ibuffer-filter-group-name-face
fd225d80
CW
2220 keymap ,ibuffer-mode-filter-group-map
2221 mouse-face highlight
1cd7affa
JPW
2222 help-echo ,(let ((echo '(if tooltip-mode
2223 "mouse-1: toggle marks in this group\nmouse-2: hide/show this filtering group"
ce3a4c83 2224 "mouse-1: toggle marks mouse-2: hide/show")))
1cd7affa 2225 (if (> (length filter-string) 0)
ce3a4c83
JPW
2226 `(concat ,filter-string
2227 (if tooltip-mode "\n" " ")
2228 ,echo)
1cd7affa 2229 echo))))
b5cd37ea
CW
2230 (insert "\n")
2231 (when bmarklist
2232 (put-text-property
2233 (point)
2234 (progn
2235 (dolist (entry bmarklist)
2236 (ibuffer-insert-buffer-line (car entry) (cdr entry) format))
2237 (point))
2238 'ibuffer-filter-group
2239 name)))
2240
957237cb 2241(defun ibuffer-redisplay-engine (bmarklist &optional ignore)
87a6a53a 2242 (ibuffer-assert-ibuffer-mode)
b5cd37ea
CW
2243 (let* ((--ibuffer-insert-buffers-and-marks-format
2244 (ibuffer-current-format))
2245 (--ibuffer-expanded-format (mapcar #'ibuffer-expand-format-entry
2246 (ibuffer-current-format t)))
2247 (orig (count-lines (point-min) (point)))
2248 ;; Inhibit font-lock caching tricks, since we're modifying the
2249 ;; entire buffer at once
2250 (after-change-functions nil)
2251 (ext-loaded (featurep 'ibuf-ext))
2252 (bgroups (if ext-loaded
2253 (ibuffer-generate-filter-groups bmarklist)
2254 (list (cons "Default" bmarklist)))))
cb059426 2255 (ibuffer-clear-summary-columns --ibuffer-expanded-format)
25d2f683
CW
2256 (unwind-protect
2257 (progn
2258 (setq buffer-read-only nil)
2259 (erase-buffer)
2260 (ibuffer-update-format)
b5cd37ea
CW
2261 (dolist (group (nreverse bgroups))
2262 (let* ((name (car group))
2263 (disabled (and ext-loaded
cba63a2d 2264 (member name ibuffer-hidden-filter-groups)))
b5cd37ea 2265 (bmarklist (cdr group)))
cba63a2d 2266 (unless (and (null bmarklist)
b90a6a12 2267 (not disabled)
cba63a2d
CW
2268 ext-loaded
2269 (null ibuffer-show-empty-filter-groups))
2270 (ibuffer-insert-filter-group
2271 name
2272 (if disabled (concat name " ...") name)
7fbac645
CW
2273 (if ext-loaded
2274 (ibuffer-format-filter-group-data name)
2275 "")
cba63a2d
CW
2276 --ibuffer-insert-buffers-and-marks-format
2277 (if disabled
2278 nil
2279 (ibuffer-sort-bufferlist bmarklist))))))
cb059426 2280 (ibuffer-update-title-and-summary --ibuffer-expanded-format))
25d2f683
CW
2281 (setq buffer-read-only t)
2282 (set-buffer-modified-p ibuffer-did-modification)
2283 (setq ibuffer-did-modification nil)
e600eb79 2284 (goto-char (point-min))
2ead9289 2285 (forward-line orig))))
25d2f683
CW
2286
2287(defun ibuffer-quit ()
2288 "Quit this `ibuffer' session.
4837b516 2289Try to restore the previous window configuration if
4ed1f829 2290`ibuffer-restore-window-config-on-quit' is non-nil."
25d2f683 2291 (interactive)
4ed1f829 2292 (if ibuffer-restore-window-config-on-quit
7ad938e7 2293 (progn
25d2f683
CW
2294 (bury-buffer)
2295 (unless (= (count-windows) 1)
4ed1f829 2296 (set-window-configuration ibuffer-prev-window-config)))
25d2f683
CW
2297 (bury-buffer)))
2298
2299;;;###autoload
2300(defun ibuffer-list-buffers (&optional files-only)
2301 "Display a list of buffers, in another window.
2302If optional argument FILES-ONLY is non-nil, then add a filter for
2303buffers which are visiting a file."
2304 (interactive "P")
2305 (ibuffer t nil (when files-only
2306 '((filename . ".*"))) t))
2307
2308;;;###autoload
2309(defun ibuffer-other-window (&optional files-only)
2310 "Like `ibuffer', but displayed in another window by default.
2311If optional argument FILES-ONLY is non-nil, then add a filter for
2312buffers which are visiting a file."
2313 (interactive "P")
2314 (ibuffer t nil (when files-only
2315 '((filename . ".*")))))
2316
2317;;;###autoload
b5cd37ea 2318(defun ibuffer (&optional other-window-p name qualifiers noselect
fd225d80 2319 shrink filter-groups formats)
972b8f82 2320 "Begin using Ibuffer to edit a list of buffers.
25d2f683
CW
2321Type 'h' after entering ibuffer for more information.
2322
972b8f82
JB
2323All arguments are optional.
2324OTHER-WINDOW-P says to use another window.
2325NAME specifies the name of the buffer (defaults to \"*Ibuffer*\").
2326QUALIFIERS is an initial set of filtering qualifiers to use;
2327 see `ibuffer-filtering-qualifiers'.
2328NOSELECT means don't select the Ibuffer buffer.
2329SHRINK means shrink the buffer to minimal size. The special
2330 value `onewindow' means always use another window.
2331FILTER-GROUPS is an initial set of filtering groups to use;
2332 see `ibuffer-filter-groups'.
2333FORMATS is the value to use for `ibuffer-formats'.
2334 If specified, then the variable `ibuffer-formats' will have
2335 that value locally in this buffer."
25d2f683
CW
2336 (interactive "P")
2337 (when ibuffer-use-other-window
34b8f593 2338 (setq other-window-p t))
4ed1f829 2339 (setq ibuffer-prev-window-config (current-window-configuration))
34a4faa0 2340 (let ((buf (get-buffer-create (or name "*Ibuffer*"))))
25d2f683
CW
2341 (if other-window-p
2342 (funcall (if noselect #'(lambda (buf) (display-buffer buf t)) #'pop-to-buffer) buf)
2343 (funcall (if noselect #'display-buffer #'switch-to-buffer) buf))
2344 (with-current-buffer buf
b5cd37ea
CW
2345 (save-selected-window
2346 ;; We switch to the buffer's window in order to be able
2347 ;; to modify the value of point
fab0d308 2348 (select-window (get-buffer-window buf 0))
34a4faa0
JPW
2349 (or (eq major-mode 'ibuffer-mode)
2350 (ibuffer-mode))
4ed1f829 2351 (setq ibuffer-restore-window-config-on-quit other-window-p)
b5cd37ea
CW
2352 (when shrink
2353 (setq ibuffer-shrink-to-minimum-size shrink))
2354 (when qualifiers
2355 (require 'ibuf-ext)
2356 (setq ibuffer-filtering-qualifiers qualifiers))
2357 (when filter-groups
2358 (require 'ibuf-ext)
cba63a2d 2359 (setq ibuffer-filter-groups filter-groups))
fd225d80
CW
2360 (when formats
2361 (set (make-local-variable 'ibuffer-formats) formats))
b5cd37ea
CW
2362 (ibuffer-update nil)
2363 ;; Skip the group name by default.
2364 (ibuffer-forward-line 0 t)
25d2f683
CW
2365 (unwind-protect
2366 (progn
b5cd37ea 2367 (setq buffer-read-only nil)
7ad5b902 2368 (run-hooks 'ibuffer-hook))
b5cd37ea
CW
2369 (setq buffer-read-only t))
2370 (unless ibuffer-expert
2371 (message "Commands: m, u, t, RET, g, k, S, D, Q; q to quit; h for help"))))))
25d2f683 2372
b23af469 2373(put 'ibuffer-mode 'mode-class 'special)
25d2f683
CW
2374(defun ibuffer-mode ()
2375 "A major mode for viewing a list of buffers.
972b8f82 2376In Ibuffer, you can conveniently perform many operations on the
25d2f683
CW
2377currently open buffers, in addition to filtering your view to a
2378particular subset of them, and sorting by various criteria.
2379
2380Operations on marked buffers:
2381
2382 '\\[ibuffer-do-save]' - Save the marked buffers
2383 '\\[ibuffer-do-view]' - View the marked buffers in this frame.
2384 '\\[ibuffer-do-view-other-frame]' - View the marked buffers in another frame.
2385 '\\[ibuffer-do-revert]' - Revert the marked buffers.
2386 '\\[ibuffer-do-toggle-read-only]' - Toggle read-only state of marked buffers.
2387 '\\[ibuffer-do-delete]' - Kill the marked buffers.
78176075
JL
2388 '\\[ibuffer-do-isearch]' - Do incremental search in the marked buffers.
2389 '\\[ibuffer-do-isearch-regexp]' - Isearch for regexp in the marked buffers.
25d2f683
CW
2390 '\\[ibuffer-do-replace-regexp]' - Replace by regexp in each of the marked
2391 buffers.
2392 '\\[ibuffer-do-query-replace]' - Query replace in each of the marked buffers.
2393 '\\[ibuffer-do-query-replace-regexp]' - As above, with a regular expression.
2394 '\\[ibuffer-do-print]' - Print the marked buffers.
2395 '\\[ibuffer-do-occur]' - List lines in all marked buffers which match
2396 a given regexp (like the function `occur').
2397 '\\[ibuffer-do-shell-command-pipe]' - Pipe the contents of the marked
2398 buffers to a shell command.
2399 '\\[ibuffer-do-shell-command-pipe-replace]' - Replace the contents of the marked
2400 buffers with the output of a shell command.
2401 '\\[ibuffer-do-shell-command-file]' - Run a shell command with the
2402 buffer's file as an argument.
2403 '\\[ibuffer-do-eval]' - Evaluate a form in each of the marked buffers. This
2404 is a very flexible command. For example, if you want to make all
2405 of the marked buffers read only, try using (toggle-read-only 1) as
2406 the input form.
2407 '\\[ibuffer-do-view-and-eval]' - As above, but view each buffer while the form
2408 is evaluated.
2409 '\\[ibuffer-do-kill-lines]' - Remove the marked lines from the *Ibuffer* buffer,
2410 but don't kill the associated buffer.
2411 '\\[ibuffer-do-kill-on-deletion-marks]' - Kill all buffers marked for deletion.
2412
2413Marking commands:
2414
2415 '\\[ibuffer-mark-forward]' - Mark the buffer at point.
2416 '\\[ibuffer-toggle-marks]' - Unmark all currently marked buffers, and mark
2417 all unmarked buffers.
2418 '\\[ibuffer-unmark-forward]' - Unmark the buffer at point.
2419 '\\[ibuffer-unmark-backward]' - Unmark the buffer at point, and move to the
2420 previous line.
2421 '\\[ibuffer-unmark-all]' - Unmark all marked buffers.
2422 '\\[ibuffer-mark-by-mode]' - Mark buffers by major mode.
2423 '\\[ibuffer-mark-unsaved-buffers]' - Mark all \"unsaved\" buffers.
2424 This means that the buffer is modified, and has an associated file.
2425 '\\[ibuffer-mark-modified-buffers]' - Mark all modified buffers,
2426 regardless of whether or not they have an associated file.
2427 '\\[ibuffer-mark-special-buffers]' - Mark all buffers whose name begins and
2428 ends with '*'.
2429 '\\[ibuffer-mark-dissociated-buffers]' - Mark all buffers which have
2430 an associated file, but that file doesn't currently exist.
2431 '\\[ibuffer-mark-read-only-buffers]' - Mark all read-only buffers.
2432 '\\[ibuffer-mark-dired-buffers]' - Mark buffers in `dired' mode.
2433 '\\[ibuffer-mark-help-buffers]' - Mark buffers in `help-mode', `apropos-mode', etc.
2434 '\\[ibuffer-mark-old-buffers]' - Mark buffers older than `ibuffer-old-time'.
2435 '\\[ibuffer-mark-for-delete]' - Mark the buffer at point for deletion.
2436 '\\[ibuffer-mark-by-name-regexp]' - Mark buffers by their name, using a regexp.
2437 '\\[ibuffer-mark-by-mode-regexp]' - Mark buffers by their major mode, using a regexp.
2438 '\\[ibuffer-mark-by-file-name-regexp]' - Mark buffers by their filename, using a regexp.
2439
2440Filtering commands:
2441
2442 '\\[ibuffer-filter-by-mode]' - Add a filter by major mode.
5bc06df9 2443 '\\[ibuffer-filter-by-used-mode]' - Add a filter by major mode now in use.
25d2f683
CW
2444 '\\[ibuffer-filter-by-name]' - Add a filter by buffer name.
2445 '\\[ibuffer-filter-by-content]' - Add a filter by buffer content.
2446 '\\[ibuffer-filter-by-filename]' - Add a filter by filename.
2447 '\\[ibuffer-filter-by-size-gt]' - Add a filter by buffer size.
2448 '\\[ibuffer-filter-by-size-lt]' - Add a filter by buffer size.
2449 '\\[ibuffer-filter-by-predicate]' - Add a filter by an arbitrary Lisp predicate.
2450 '\\[ibuffer-save-filters]' - Save the current filters with a name.
2451 '\\[ibuffer-switch-to-saved-filters]' - Switch to previously saved filters.
2452 '\\[ibuffer-add-saved-filters]' - Add saved filters to current filters.
2453 '\\[ibuffer-or-filter]' - Replace the top two filters with their logical OR.
2454 '\\[ibuffer-pop-filter]' - Remove the top filter.
2455 '\\[ibuffer-negate-filter]' - Invert the logical sense of the top filter.
2456 '\\[ibuffer-decompose-filter]' - Break down the topmost filter.
2457 '\\[ibuffer-filter-disable]' - Remove all filtering currently in effect.
cba63a2d
CW
2458
2459Filter group commands:
2460
2461 '\\[ibuffer-filters-to-filter-group]' - Create filter group from filters.
2462 '\\[ibuffer-pop-filter-group]' - Remove top filter group.
b098e753
CW
2463 '\\[ibuffer-forward-filter-group]' - Move to the next filter group.
2464 '\\[ibuffer-backward-filter-group]' - Move to the previous filter group.
2465 '\\[ibuffer-clear-filter-groups]' - Remove all active filter groups.
2466 '\\[ibuffer-save-filter-groups]' - Save the current groups with a name.
2467 '\\[ibuffer-switch-to-saved-filter-groups]' - Restore previously saved groups.
2468 '\\[ibuffer-delete-saved-filter-groups]' - Delete previously saved groups.
71296446 2469
25d2f683
CW
2470Sorting commands:
2471
2472 '\\[ibuffer-toggle-sorting-mode]' - Rotate between the various sorting modes.
2473 '\\[ibuffer-invert-sorting]' - Reverse the current sorting order.
2474 '\\[ibuffer-do-sort-by-alphabetic]' - Sort the buffers lexicographically.
d5794180 2475 '\\[ibuffer-do-sort-by-filename/process]' - Sort the buffers by the file name.
25d2f683
CW
2476 '\\[ibuffer-do-sort-by-recency]' - Sort the buffers by last viewing time.
2477 '\\[ibuffer-do-sort-by-size]' - Sort the buffers by size.
2478 '\\[ibuffer-do-sort-by-major-mode]' - Sort the buffers by major mode.
2479
2480Other commands:
2481
4c38df30
JPW
2482 '\\[ibuffer-update]' - Regenerate the list of all buffers.
2483 Prefix arg means to toggle whether buffers that match
2484 `ibuffer-maybe-show-predicates' should be displayed.
2485
25d2f683
CW
2486 '\\[ibuffer-switch-format]' - Change the current display format.
2487 '\\[forward-line]' - Move point to the next line.
2488 '\\[previous-line]' - Move point to the previous line.
25d2f683
CW
2489 '\\[ibuffer-quit]' - Bury the Ibuffer buffer.
2490 '\\[describe-mode]' - This help.
2491 '\\[ibuffer-diff-with-file]' - View the differences between this buffer
2492 and its associated file.
2493 '\\[ibuffer-visit-buffer]' - View the buffer on this line.
2494 '\\[ibuffer-visit-buffer-other-window]' - As above, but in another window.
2495 '\\[ibuffer-visit-buffer-other-window-noselect]' - As both above, but don't select
2496 the new window.
2497 '\\[ibuffer-bury-buffer]' - Bury (not kill!) the buffer on this line.
2498
cba63a2d 2499** Information on Filtering:
25d2f683
CW
2500
2501 You can filter your ibuffer view via different critera. Each Ibuffer
2502buffer has its own stack of active filters. For example, suppose you
2503are working on an Emacs Lisp project. You can create an Ibuffer
2504buffer displays buffers in just `emacs-lisp' modes via
2505'\\[ibuffer-filter-by-mode] emacs-lisp-mode RET'. In this case, there
2506is just one entry on the filtering stack.
2507
2508You can also combine filters. The various filtering commands push a
2509new filter onto the stack, and the filters combine to show just
2510buffers which satisfy ALL criteria on the stack. For example, suppose
2511you only want to see buffers in `emacs-lisp' mode, whose names begin
2512with \"gnus\". You can accomplish this via:
2513'\\[ibuffer-filter-by-mode] emacs-lisp-mode RET
2514\\[ibuffer-filter-by-name] ^gnus RET'.
2515
2516Additionally, you can OR the top two filters together with
2517'\\[ibuffer-or-filters]'. To see all buffers in either
2518`emacs-lisp-mode' or `lisp-interaction-mode', type:
2519
2520'\\[ibuffer-filter-by-mode] emacs-lisp-mode RET \\[ibuffer-filter-by-mode] lisp-interaction-mode RET \\[ibuffer-or-filters]'.
2521
2522Filters can also be saved and restored using mnemonic names: see the
2523functions `ibuffer-save-filters' and `ibuffer-switch-to-saved-filters'.
2524
2525To remove the top filter on the stack, use '\\[ibuffer-pop-filter]', and
2526to disable all filtering currently in effect, use
cba63a2d
CW
2527'\\[ibuffer-filter-disable]'.
2528
2529** Filter Groups:
2530
2531Once one has mastered filters, the next logical step up is \"filter
2532groups\". A filter group is basically a named group of buffers which
2533match a filter, which are displayed together in an Ibuffer buffer. To
2534create a filter group, simply use the regular functions to create a
2535filter, and then type '\\[ibuffer-filters-to-filter-group]'.
2536
2537A quick example will make things clearer. Suppose that one wants to
2538group all of one's Emacs Lisp buffers together. To do this, type
2539
2540'\\[ibuffer-filter-by-mode] emacs-lisp-mode RET \\[ibuffer-filters-to-filter-group] RET emacs lisp buffers RET'
2541
2542You may, of course, name the group whatever you want; it doesn't have
2543to be \"emacs lisp buffers\". Filter groups may be composed of any
2544arbitrary combination of filters.
2545
2546Just like filters themselves, filter groups act as a stack. Buffers
2547will not be displayed multiple times if they would be included in
2548multiple filter groups; instead, the first filter group is used. The
2549filter groups are displayed in this order of precedence.
2550
2551You may rearrange filter groups by using the regular
2552'\\[ibuffer-kill-line]' and '\\[ibuffer-yank]' pair. Yanked groups
2553will be inserted before the group at point."
25d2f683
CW
2554 (kill-all-local-variables)
2555 (use-local-map ibuffer-mode-map)
2556 (setq major-mode 'ibuffer-mode)
2557 (setq mode-name "Ibuffer")
23eabff6 2558 ;; Include state info next to the mode name.
e47b4224 2559 (set (make-local-variable 'mode-line-process)
56618a0a
SM
2560 '(" by "
2561 (ibuffer-sorting-mode (:eval (symbol-name ibuffer-sorting-mode))
23eabff6
SM
2562 "view time")
2563 (ibuffer-sorting-reversep " [rev]")
2564 (ibuffer-auto-mode " (Auto)")
2565 ;; Only list the filters if they're not already in the header-line.
2566 (header-line-format
2567 ""
2568 (:eval (if (functionp 'ibuffer-format-qualifier)
2569 (mapconcat 'ibuffer-format-qualifier
2570 ibuffer-filtering-qualifiers ""))))))
6d11a78b
SM
2571 ;; `ibuffer-update' puts this on header-line-format when needed.
2572 (setq ibuffer-header-line-format
2573 ;; Display the part that won't be in the mode-line.
2574 (list* "" mode-name
2575 (mapcar (lambda (elem)
2576 (if (eq (car-safe elem) 'header-line-format)
2577 (nth 2 elem) elem))
2578 mode-line-process)))
23eabff6 2579
25d2f683
CW
2580 (setq buffer-read-only t)
2581 (buffer-disable-undo)
3eda3649 2582 (setq truncate-lines ibuffer-truncate-lines)
25d2f683
CW
2583 ;; This makes things less ugly for Emacs 21 users with a non-nil
2584 ;; `show-trailing-whitespace'.
2585 (setq show-trailing-whitespace nil)
4ba16127
JPW
2586 ;; disable `show-paren-mode' buffer-locally
2587 (if (bound-and-true-p show-paren-mode)
2588 (set (make-local-variable 'show-paren-mode) nil))
25d2f683
CW
2589 (set (make-local-variable 'revert-buffer-function)
2590 #'ibuffer-update)
2591 (set (make-local-variable 'ibuffer-sorting-mode)
2592 ibuffer-default-sorting-mode)
2593 (set (make-local-variable 'ibuffer-sorting-reversep)
2594 ibuffer-default-sorting-reversep)
2595 (set (make-local-variable 'ibuffer-shrink-to-minimum-size)
2596 ibuffer-default-shrink-to-minimum-size)
957237cb
JPW
2597 (set (make-local-variable 'ibuffer-display-maybe-show-predicates)
2598 ibuffer-default-display-maybe-show-predicates)
25d2f683 2599 (set (make-local-variable 'ibuffer-filtering-qualifiers) nil)
cba63a2d
CW
2600 (set (make-local-variable 'ibuffer-filter-groups) nil)
2601 (set (make-local-variable 'ibuffer-filter-group-kill-ring) nil)
2602 (set (make-local-variable 'ibuffer-hidden-filter-groups) nil)
25d2f683
CW
2603 (set (make-local-variable 'ibuffer-compiled-formats) nil)
2604 (set (make-local-variable 'ibuffer-cached-formats) nil)
2605 (set (make-local-variable 'ibuffer-cached-eliding-string) nil)
2606 (set (make-local-variable 'ibuffer-cached-elide-long-columns) nil)
2607 (set (make-local-variable 'ibuffer-current-format) nil)
4ed1f829 2608 (set (make-local-variable 'ibuffer-restore-window-config-on-quit) nil)
25d2f683 2609 (set (make-local-variable 'ibuffer-did-modification) nil)
b5cd37ea
CW
2610 (set (make-local-variable 'ibuffer-tmp-hide-regexps) nil)
2611 (set (make-local-variable 'ibuffer-tmp-show-regexps) nil)
25d2f683
CW
2612 (define-key ibuffer-mode-map [menu-bar edit] 'undefined)
2613 (define-key ibuffer-mode-map [menu-bar operate] (cons "Operate" ibuffer-mode-operate-map))
2614 (ibuffer-update-format)
2615 (when ibuffer-default-directory
2616 (setq default-directory ibuffer-default-directory))
214fee7a 2617 (add-hook 'change-major-mode-hook 'font-lock-defontify nil t)
23eabff6 2618 (run-mode-hooks 'ibuffer-mode-hook))
25d2f683
CW
2619
2620(provide 'ibuffer)
2621
4e4a724c
JPW
2622(run-hooks 'ibuffer-load-hook)
2623
25d2f683
CW
2624;; Local Variables:
2625;; coding: iso-8859-1
2626;; End:
2627
23eabff6 2628;; arch-tag: 72581688-0603-4954-b8cf-837c700f62e8
25d2f683 2629;;; ibuffer.el ends here