Switch to recommended form of GPLv3 permissions notice.
[bpt/emacs.git] / lisp / ibuffer.el
CommitLineData
25d2f683
CW
1;;; ibuffer.el --- operate on buffers like dired
2
0d30b337 3;; Copyright (C) 2000, 2001, 2002, 2003, 2004,
409cc4a3 4;; 2005, 2006, 2007, 2008 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
CW
12
13;; This program is free software; you can redistribute it and/or
14;; modify it under the terms of the GNU General Public License as
b4aa6026 15;; published by the Free Software Foundation; either version 3, or (at
25d2f683
CW
16;; your option) any later version.
17
18;; This program is distributed in the hope that it will be useful, but
19;; WITHOUT ANY WARRANTY; without even the implied warranty of
20;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
21;; General Public License for more details.
22
23;; You should have received a copy of the GNU General Public License
24;; along with this program ; see the file COPYING. If not, write to
086add15
LK
25;; the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
26;; Boston, MA 02110-1301, USA.
25d2f683
CW
27
28;;; Commentary:
29
30;; ibuffer.el is an advanced replacement for the `buffer-menu' which
31;; is normally distributed with Emacs. Its interface is intended to
32;; be analogous to that of Dired.
33
34;;; Code:
35
36(eval-when-compile
37 (require 'cl)
38 (require 'ibuf-macs)
39 (require 'dired))
40
730da5b2 41(require 'font-core)
fd225d80 42
735d7026
JB
43;; These come from ibuf-ext.el, which can not be require'd at compile time
44;; because it has a recursive dependency on ibuffer.el
45(defvar ibuffer-auto-mode)
46(defvar ibuffer-cached-filter-formats)
47(defvar ibuffer-compiled-filter-formats)
48(defvar ibuffer-filter-format-alist)
49(defvar ibuffer-filter-group-kill-ring)
50(defvar ibuffer-filter-groups)
51(defvar ibuffer-filtering-qualifiers)
6d11a78b 52(defvar ibuffer-header-line-format)
735d7026
JB
53(defvar ibuffer-hidden-filter-groups)
54(defvar ibuffer-inline-columns)
55(defvar ibuffer-show-empty-filter-groups)
56(defvar ibuffer-tmp-hide-regexps)
57(defvar ibuffer-tmp-show-regexps)
63f0a166 58
004a00f4
DN
59(declare-function ibuffer-mark-on-buffer "ibuf-ext"
60 (func &optional ibuffer-mark-on-buffer-mark group))
61(declare-function ibuffer-format-qualifier "ibuf-ext" (qualifier))
62(declare-function ibuffer-generate-filter-groups "ibuf-ext"
63 (bmarklist &optional noempty nodefault))
64(declare-function ibuffer-format-filter-group-data "ibuf-ext" (filter))
65
25d2f683
CW
66(defgroup ibuffer nil
67 "An advanced replacement for `buffer-menu'.
68
69Ibuffer allows you to operate on buffers in a manner much like Dired.
70Operations include sorting, marking by regular expression, and
71the ability to filter the displayed buffers by various criteria."
bf247b6e 72 :version "22.1"
25d2f683
CW
73 :group 'convenience)
74
ac3c7293
JPW
75(defcustom ibuffer-formats '((mark modified read-only " " (name 18 18 :left :elide)
76 " " (size 9 -1 :right)
b9debd54 77 " " (mode 16 16 :left :elide) " " filename-and-process)
25d2f683
CW
78 (mark " " (name 16 -1) " " filename))
79 "A list of ways to display buffer lines.
80
81With Ibuffer, you are not limited to displaying just certain
82attributes of a buffer such as size, name, and mode in a particular
cba63a2d 83order. Through this variable, you can completely customize and
25d2f683
CW
84control the appearance of an Ibuffer buffer. See also
85`define-ibuffer-column', which allows you to define your own columns
86for display.
87
88This variable has the form
2e4fae7d 89 ((COLUMN COLUMN ...) (COLUMN COLUMN ...) ...)
25d2f683
CW
90Each element in `ibuffer-formats' should be a list containing COLUMN
91specifiers. A COLUMN can be any of the following:
92
93 SYMBOL - A symbol naming the column. Predefined columns are:
94 mark modified read-only name size mode process filename
95 When you define your own columns using `define-ibuffer-column', just
96 use their name like the predefined columns here. This entry can
97 also be a function of two arguments, which should return a string.
98 The first argument is the buffer object, and the second is the mark
99 on that buffer.
100 or
101 \"STRING\" - A literal string to display.
102 or
103 (SYMBOL MIN-SIZE MAX-SIZE &optional ALIGN ELIDE) - SYMBOL is a
104 symbol naming the column, and MIN-SIZE and MAX-SIZE are integers (or
105 functions of no arguments returning an integer) which constrict the
106 size of a column. If MAX-SIZE is -1, there is no upper bound. The
107 default values are 0 and -1, respectively. If MIN-SIZE is negative,
108 use the end of the string. The optional element ALIGN describes the
109 alignment of the column; it can be :left, :center or :right. The
110 optional element ELIDE describes whether or not to elide the column
111 if it is too long; valid values are :elide and nil. The default is
112 nil (don't elide).
113
114Some example of valid entries in `ibuffer-formats', with
115description (also, feel free to try them out, and experiment with your
116own!):
117
118 (mark \" \" name)
119 This format just displays the current mark (if any) and the name of
120 the buffer, separated by a space.
121 (mark modified read-only \" \" (name 16 16 :left) \" \" (size 6 -1 :right))
122 This format displays the current mark (if any), its modification and
123 read-only status, as well as the name of the buffer and its size. In
124 this format, the name is restricted to 16 characters (longer names
523304ed 125 will be truncated, and shorter names will be padded with spaces), and
cba63a2d 126 the name is also aligned to the left. The size of the buffer will
25d2f683
CW
127 be padded with spaces up to a minimum of six characters, but there is
128 no upper limit on its size. The size will also be aligned to the
129 right.
130
131Thus, if you wanted to use these two formats, add
132
133 (setq ibuffer-formats '((mark \" \" name)
134 (mark modified read-only
135 (name 16 16 :left) (size 6 -1 :right))))
136
137to your ~/.emacs file.
138
139Using \\[ibuffer-switch-format], you can rotate the display between
140the specified formats in the list."
141 :type '(repeat sexp)
142 :group 'ibuffer)
143
144(defcustom ibuffer-always-compile-formats (featurep 'bytecomp)
145 "If non-nil, then use the byte-compiler to optimize `ibuffer-formats'.
146This will increase the redisplay speed, at the cost of loading the
147elisp byte-compiler."
148 :type 'boolean
149 :group 'ibuffer)
150
151(defcustom ibuffer-fontification-alist
40c10465 152 `((10 buffer-read-only font-lock-constant-face)
9fe14abe
JPW
153 (15 (and buffer-file-name
154 (string-match ibuffer-compressed-file-name-regexp
155 buffer-file-name))
156 font-lock-doc-face)
157 (20 (string-match "^*" (buffer-name)) font-lock-keyword-face)
158 (25 (and (string-match "^ " (buffer-name))
da337a28
JPW
159 (null buffer-file-name))
160 italic)
9fe14abe
JPW
161 (30 (memq major-mode ibuffer-help-buffer-modes) font-lock-comment-face)
162 (35 (eq major-mode 'dired-mode) font-lock-function-name-face))
25d2f683
CW
163 "An alist describing how to fontify buffers.
164Each element should be of the form (PRIORITY FORM FACE), where
165PRIORITY is an integer, FORM is an arbitrary form to evaluate in the
166buffer, and FACE is the face to use for fontification. If the FORM
167evaluates to non-nil, then FACE will be put on the buffer name. The
fd225d80
CW
168element with the highest PRIORITY takes precedence.
169
4e4a724c 170If you change this variable, you must kill the Ibuffer buffer and
fd225d80 171recreate it for the change to take effect."
25d2f683
CW
172 :type '(repeat
173 (list (integer :tag "Priority")
174 (sexp :tag "Test Form")
175 face))
176 :group 'ibuffer)
177
178(defcustom ibuffer-use-other-window nil
7ad5b902 179 "If non-nil, display Ibuffer in another window by default."
25d2f683
CW
180 :type 'boolean
181 :group 'ibuffer)
182
183(defcustom ibuffer-default-shrink-to-minimum-size nil
184 "If non-nil, minimize the size of the Ibuffer window by default."
185 :type 'boolean
186 :group 'ibuffer)
187(defvar ibuffer-shrink-to-minimum-size nil)
188
0740098c
JPW
189(defcustom ibuffer-display-summary t
190 "If non-nil, summarize Ibuffer columns."
191 :type 'boolean
192 :group 'ibuffer)
193
3eda3649
CW
194(defcustom ibuffer-truncate-lines t
195 "If non-nil, do not display continuation lines."
196 :type 'boolean
197 :group 'ibuffer)
198
25d2f683
CW
199(defcustom ibuffer-case-fold-search case-fold-search
200 "If non-nil, ignore case when searching."
201 :type 'boolean
202 :group 'ibuffer)
203
204(defcustom ibuffer-default-sorting-mode 'recency
205 "The criteria by which to sort the buffers.
206
4e4a724c
JPW
207Note that this variable is local to each Ibuffer buffer. Thus, you
208can have multiple Ibuffer buffers open, each with a different sorted
25d2f683
CW
209view of the buffers."
210 :type '(choice (const :tag "Last view time" :value recency)
211 (const :tag "Lexicographic" :value alphabetic)
212 (const :tag "Buffer size" :value size)
d5794180 213 (const :tag "File name" :value filename/process)
25d2f683
CW
214 (const :tag "Major mode" :value major-mode))
215 :group 'ibuffer)
216(defvar ibuffer-sorting-mode nil)
e7820654 217(defvar ibuffer-last-sorting-mode nil)
25d2f683
CW
218
219(defcustom ibuffer-default-sorting-reversep nil
220 "If non-nil, reverse the default sorting order."
221 :type 'boolean
222 :group 'ibuffer)
223(defvar ibuffer-sorting-reversep nil)
224
225(defcustom ibuffer-elide-long-columns nil
972b8f82 226 "If non-nil, then elide column entries which exceed their max length."
25d2f683
CW
227 :type 'boolean
228 :group 'ibuffer)
972b8f82
JB
229(make-obsolete-variable 'ibuffer-elide-long-columns
230 "use the :elide argument of `ibuffer-formats'."
231 "22.1")
25d2f683
CW
232
233(defcustom ibuffer-eliding-string "..."
234 "The string to use for eliding long columns."
235 :type 'string
236 :group 'ibuffer)
237
238(defcustom ibuffer-maybe-show-predicates `(,(lambda (buf)
239 (and (string-match "^ " (buffer-name buf))
240 (null buffer-file-name))))
4e4a724c
JPW
241 "A list of predicates for buffers to display conditionally.
242
243A predicate can be a regexp or a function.
25d2f683
CW
244If a regexp, then it will be matched against the buffer's name.
245If a function, it will be called with the buffer as an argument, and
246should return non-nil if this buffer should be shown.
247
957237cb 248Viewing of buffers hidden because of these predicates may be customized
bf247b6e 249via `ibuffer-default-display-maybe-show-predicates' and is toggled by
957237cb
JPW
250giving a non-nil prefix argument to `ibuffer-update'.
251Note that this specialized filtering occurs before real filtering."
25d2f683
CW
252 :type '(repeat (choice regexp function))
253 :group 'ibuffer)
254
957237cb
JPW
255(defcustom ibuffer-default-display-maybe-show-predicates nil
256 "Non-nil means show buffers that match `ibuffer-maybe-show-predicates'."
257 :type 'boolean
258 :group 'ibuffer)
259
260(defvar ibuffer-display-maybe-show-predicates nil)
261
25d2f683
CW
262(defvar ibuffer-current-format nil)
263
0ce780e1
CW
264(defcustom ibuffer-movement-cycle t
265 "If non-nil, then forward and backwards movement commands cycle."
266 :type 'boolean
267 :group 'ibuffer)
268
25d2f683
CW
269(defcustom ibuffer-modified-char ?*
270 "The character to display for modified buffers."
271 :type 'character
272 :group 'ibuffer)
273
274(defcustom ibuffer-read-only-char ?%
275 "The character to display for read-only buffers."
276 :type 'character
277 :group 'ibuffer)
278
279(defcustom ibuffer-marked-char ?>
280 "The character to display for marked buffers."
281 :type 'character
282 :group 'ibuffer)
283
284(defcustom ibuffer-deletion-char ?D
285 "The character to display for buffers marked for deletion."
286 :type 'character
287 :group 'ibuffer)
288
289(defcustom ibuffer-expert nil
290 "If non-nil, don't ask for confirmation of \"dangerous\" operations."
291 :type 'boolean
292 :group 'ibuffer)
293
294(defcustom ibuffer-view-ibuffer nil
295 "If non-nil, display the current Ibuffer buffer itself.
296Note that this has a drawback - the data about the current Ibuffer
297buffer will most likely be inaccurate. This includes modification
298state, size, etc."
299 :type 'boolean
300 :group 'ibuffer)
301
302(defcustom ibuffer-always-show-last-buffer nil
4e4a724c
JPW
303 "If non-nil, always display the previous buffer.
304This variable takes precedence over filtering, and even
25d2f683
CW
305`ibuffer-never-show-predicates'."
306 :type '(choice (const :tag "Always" :value t)
307 (const :tag "Never" :value nil)
308 (const :tag "Always except minibuffer" :value :nomini))
309 :group 'ibuffer)
310
0bdd7ae4
JPW
311(defcustom ibuffer-jump-offer-only-visible-buffers nil
312 "If non-nil, only offer buffers visible in the Ibuffer buffer
313in completion lists of the `ibuffer-jump-to-buffer' command."
314 :type 'boolean
315 :group 'ibuffer)
316
25d2f683 317(defcustom ibuffer-use-header-line (boundp 'header-line-format)
7ad5b902 318 "If non-nil, display a header line containing current filters."
25d2f683
CW
319 :type 'boolean
320 :group 'ibuffer)
321
322(defcustom ibuffer-default-directory nil
4e4a724c 323 "The default directory to use for a new Ibuffer buffer.
2e4fae7d 324If nil, inherit the directory of the buffer in which `ibuffer' was
25d2f683
CW
325called. Otherwise, this variable should be a string naming a
326directory, like `default-directory'."
327 :type '(choice (const :tag "Inherit" :value nil)
328 string)
329 :group 'ibuffer)
330
4e4a724c
JPW
331(defcustom ibuffer-help-buffer-modes
332 '(help-mode apropos-mode Info-mode Info-edit-mode)
60356fb5
CW
333 "List of \"Help\" major modes."
334 :type '(repeat function)
335 :group 'ibuffer)
336
9fe14abe 337(defcustom ibuffer-compressed-file-name-regexp
fe99056f 338 "\\.\\(arj\\|bgz\\|bz2\\|gz\\|lzh\\|taz\\|tgz\\|zip\\|z\\)$"
9fe14abe
JPW
339 "Regexp to match compressed file names."
340 :type 'regexp
c7f5c0a8 341 :group 'ibuffer)
9fe14abe 342
cd6ef82d
GM
343(define-obsolete-variable-alias 'ibuffer-hooks 'ibuffer-hook "22.1")
344
e9e96ba0 345(defcustom ibuffer-hook nil
4e4a724c 346 "Hook run when `ibuffer' is called."
25d2f683
CW
347 :type 'hook
348 :group 'ibuffer)
cd6ef82d
GM
349
350(define-obsolete-variable-alias 'ibuffer-mode-hooks 'ibuffer-mode-hook "22.1")
25d2f683 351
e9e96ba0 352(defcustom ibuffer-mode-hook nil
4e4a724c 353 "Hook run upon entry into `ibuffer-mode'."
25d2f683
CW
354 :type 'hook
355 :group 'ibuffer)
356
4e4a724c
JPW
357(defcustom ibuffer-load-hook nil
358 "Hook run when Ibuffer is loaded."
359 :type 'hook
360 :group 'ibuffer)
361
25d2f683
CW
362(defcustom ibuffer-marked-face 'font-lock-warning-face
363 "Face used for displaying marked buffers."
364 :type 'face
365 :group 'ibuffer)
366
367(defcustom ibuffer-deletion-face 'font-lock-type-face
368 "Face used for displaying buffers marked for deletion."
369 :type 'face
370 :group 'ibuffer)
371
372(defcustom ibuffer-title-face 'font-lock-type-face
373 "Face used for the title string."
374 :type 'face
375 :group 'ibuffer)
376
b5cd37ea
CW
377(defcustom ibuffer-filter-group-name-face 'bold
378 "Face used for displaying filtering group names."
379 :type 'face
380 :group 'ibuffer)
381
25d2f683
CW
382(defcustom ibuffer-directory-abbrev-alist nil
383 "An alist of file name abbreviations like `directory-abbrev-alist'."
384 :type '(repeat (cons :format "%v"
385 :value ("" . "")
386 (regexp :tag "From")
387 (regexp :tag "To")))
388 :group 'ibuffer)
389
4e4a724c 390
25d2f683
CW
391(defvar ibuffer-mode-map nil)
392(defvar ibuffer-mode-operate-map nil)
b5e80d1a 393(defvar ibuffer-mode-groups-popup nil)
25d2f683
CW
394(unless ibuffer-mode-map
395 (let ((map (make-sparse-keymap))
b5e80d1a
CW
396 (operate-map (make-sparse-keymap "Operate"))
397 (groups-map (make-sparse-keymap "Filter Groups")))
25d2f683
CW
398 (define-key map (kbd "0") 'digit-argument)
399 (define-key map (kbd "1") 'digit-argument)
400 (define-key map (kbd "2") 'digit-argument)
401 (define-key map (kbd "3") 'digit-argument)
402 (define-key map (kbd "4") 'digit-argument)
403 (define-key map (kbd "5") 'digit-argument)
404 (define-key map (kbd "6") 'digit-argument)
405 (define-key map (kbd "7") 'digit-argument)
406 (define-key map (kbd "8") 'digit-argument)
407 (define-key map (kbd "9") 'digit-argument)
408
409 (define-key map (kbd "m") 'ibuffer-mark-forward)
410 (define-key map (kbd "t") 'ibuffer-toggle-marks)
411 (define-key map (kbd "u") 'ibuffer-unmark-forward)
412 (define-key map (kbd "=") 'ibuffer-diff-with-file)
413 (define-key map (kbd "j") 'ibuffer-jump-to-buffer)
0bdd7ae4 414 (define-key map (kbd "M-g") 'ibuffer-jump-to-buffer)
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)
1096 (goto-line line)))
1097
1098(defun ibuffer-visit-tags-table ()
1099 "Visit the tags table in the buffer on this line. See `visit-tags-table'."
1100 (interactive)
b5cd37ea 1101 (let ((file (buffer-file-name (ibuffer-current-buffer t))))
25d2f683
CW
1102 (if file
1103 (visit-tags-table file)
1104 (error "Specified buffer has no file"))))
1105
1106(defun ibuffer-do-view (&optional other-frame)
1107 "View marked buffers, or the buffer on the current line.
1108If optional argument OTHER-FRAME is non-nil, then display each
1109marked buffer in a new frame. Otherwise, display each buffer as
1110a new window in the current frame, splitting vertically."
1111 (interactive)
1112 (ibuffer-do-view-1 (if other-frame 'other-frame 'vertically)))
1113
1114(defun ibuffer-do-view-horizontally (&optional other-frame)
1115 "As `ibuffer-do-view', but split windows horizontally."
1116 (interactive)
1117 (ibuffer-do-view-1 (if other-frame 'other-frame 'horizontally)))
1118
1119(defun ibuffer-do-view-1 (type)
1120 (let ((marked-bufs (ibuffer-get-marked-buffers)))
1121 (when (null marked-bufs)
b5cd37ea 1122 (setq marked-bufs (list (ibuffer-current-buffer t))))
25d2f683
CW
1123 (unless (and (eq type 'other-frame)
1124 (not ibuffer-expert)
1125 (> (length marked-bufs) 3)
1126 (not (y-or-n-p (format "Really create a new frame for %s buffers? "
1127 (length marked-bufs)))))
4e4a724c 1128 (set-buffer-modified-p nil)
25d2f683
CW
1129 (delete-other-windows)
1130 (switch-to-buffer (pop marked-bufs))
1131 (let ((height (/ (1- (if (eq type 'horizontally) (frame-width)
4e4a724c 1132 (frame-height)))
25d2f683
CW
1133 (1+ (length marked-bufs)))))
1134 (mapcar (if (eq type 'other-frame)
1135 #'(lambda (buf)
1136 (let ((curframe (selected-frame)))
acf88897 1137 (select-frame (make-frame))
25d2f683
CW
1138 (switch-to-buffer buf)
1139 (select-frame curframe)))
1140 #'(lambda (buf)
1141 (split-window nil height (eq type 'horizontally))
1142 (other-window 1)
1143 (switch-to-buffer buf)))
1144 marked-bufs)))))
1145
1146(defun ibuffer-do-view-other-frame ()
1147 "View each of the marked buffers in a separate frame."
1148 (interactive)
1149 (ibuffer-do-view t))
1150
1151(defsubst ibuffer-map-marked-lines (func)
1152 (prog1 (ibuffer-map-on-mark ibuffer-marked-char func)
1153 (ibuffer-redisplay t)))
1154
1155(defun ibuffer-shrink-to-fit (&optional owin)
1156 (fit-window-to-buffer nil (when owin (/ (frame-height)
1157 (length (window-list (selected-frame)))))))
1158
1159(defun ibuffer-confirm-operation-on (operation names)
1160 "Display a buffer asking whether to perform OPERATION on NAMES."
1161 (or ibuffer-expert
1162 (if (= (length names) 1)
1163 (y-or-n-p (format "Really %s buffer %s? " operation (car names)))
1164 (let ((buf (get-buffer-create "*Ibuffer confirmation*")))
1165 (with-current-buffer buf
1166 (setq buffer-read-only nil)
1167 (erase-buffer)
1168 (ibuffer-columnize-and-insert-list names)
1169 (goto-char (point-min))
1170 (setq buffer-read-only t))
4e4a724c 1171 (let ((lastwin (car (last (window-list nil 'nomini)))))
25d2f683
CW
1172 ;; Now attempt to display the buffer...
1173 (save-window-excursion
1174 (select-window lastwin)
1175 ;; The window might be too small to split; in that case,
7ad5b902 1176 ;; try a few times to increase its size before giving up.
25d2f683
CW
1177 (let ((attempts 0)
1178 (trying t))
1179 (while trying
1180 (condition-case err
1181 (progn
1182 (split-window)
1183 (setq trying nil))
1184 (error
1185 ;; Handle a failure
1186 (if (or (> (incf attempts) 4)
1187 (and (stringp (cadr err))
71296446 1188 ;; This definitely falls in the
4e4a724c 1189 ;; ghetto hack category...
25d2f683
CW
1190 (not (string-match "too small" (cadr err)))))
1191 (apply #'signal err)
1192 (enlarge-window 3))))))
25d2f683
CW
1193 (select-window (next-window))
1194 (switch-to-buffer buf)
1195 (unwind-protect
1196 (progn
1197 (fit-window-to-buffer)
1198 (y-or-n-p (format "Really %s %d buffers? "
1199 operation (length names))))
1200 (kill-buffer buf))))))))
1201
1202(defsubst ibuffer-map-lines-nomodify (function)
1203 "As `ibuffer-map-lines', but don't set the modification flag."
1204 (ibuffer-map-lines function t))
1205
1206(defun ibuffer-buffer-names-with-mark (mark)
1207 (let ((ibuffer-buffer-names-with-mark-result nil))
1208 (ibuffer-map-lines-nomodify
4e4a724c 1209 #'(lambda (buf mk)
25d2f683
CW
1210 (when (char-equal mark mk)
1211 (push (buffer-name buf)
1212 ibuffer-buffer-names-with-mark-result))))
1213 ibuffer-buffer-names-with-mark-result))
1214
1215(defsubst ibuffer-marked-buffer-names ()
1216 (ibuffer-buffer-names-with-mark ibuffer-marked-char))
1217
1218(defsubst ibuffer-deletion-marked-buffer-names ()
1219 (ibuffer-buffer-names-with-mark ibuffer-deletion-char))
1220
1221(defun ibuffer-count-marked-lines (&optional all)
1222 (if all
1223 (ibuffer-map-lines-nomodify
57c9cc3e 1224 #'(lambda (buf mark)
972b8f82 1225 (not (char-equal mark ?\s))))
25d2f683 1226 (ibuffer-map-lines-nomodify
57c9cc3e 1227 #'(lambda (buf mark)
25d2f683
CW
1228 (char-equal mark ibuffer-marked-char)))))
1229
1230(defsubst ibuffer-count-deletion-lines ()
1231 (ibuffer-map-lines-nomodify
57c9cc3e 1232 #'(lambda (buf mark)
25d2f683
CW
1233 (char-equal mark ibuffer-deletion-char))))
1234
1235(defsubst ibuffer-map-deletion-lines (func)
1236 (ibuffer-map-on-mark ibuffer-deletion-char func))
1237
fd225d80 1238(define-ibuffer-op ibuffer-do-save ()
25d2f683
CW
1239 "Save marked buffers as with `save-buffer'."
1240 (:complex t
1241 :opstring "saved"
1242 :modifier-p :maybe)
1243 (when (buffer-modified-p buf)
1244 (if (not (with-current-buffer buf
1245 buffer-file-name))
1246 ;; handle the case where we're prompted
1247 ;; for a file name
1248 (save-window-excursion
1249 (switch-to-buffer buf)
1250 (save-buffer))
1251 (with-current-buffer buf
1252 (save-buffer))))
1253 t)
1254
fd225d80 1255(define-ibuffer-op ibuffer-do-toggle-modified ()
25d2f683
CW
1256 "Toggle modification flag of marked buffers."
1257 (:opstring "(un)marked as modified"
1258 :modifier-p t)
1259 (set-buffer-modified-p (not (buffer-modified-p))))
1260
92be491c
RW
1261(define-ibuffer-op ibuffer-do-toggle-read-only (&optional arg)
1262 "Toggle read only status in marked buffers.
320d3e68 1263With optional ARG, make read-only only if ARG is positive."
25d2f683 1264 (:opstring "toggled read only status in"
92be491c 1265 :interactive "P"
25d2f683 1266 :modifier-p t)
92be491c 1267 (toggle-read-only arg))
25d2f683 1268
fd225d80 1269(define-ibuffer-op ibuffer-do-delete ()
25d2f683
CW
1270 "Kill marked buffers as with `kill-this-buffer'."
1271 (:opstring "killed"
1272 :active-opstring "kill"
1273 :dangerous t
1274 :complex t
1275 :modifier-p t)
1276 (if (kill-buffer buf)
1277 'kill
1278 nil))
1279
fd225d80 1280(define-ibuffer-op ibuffer-do-kill-on-deletion-marks ()
25d2f683
CW
1281 "Kill buffers marked for deletion as with `kill-this-buffer'."
1282 (:opstring "killed"
1283 :active-opstring "kill"
1284 :dangerous t
1285 :complex t
1286 :mark :deletion
1287 :modifier-p t)
1288 (if (kill-buffer buf)
1289 'kill
1290 nil))
1291
1292(defun ibuffer-unmark-all (mark)
1293 "Unmark all buffers with mark MARK."
1294 (interactive "cRemove marks (RET means all):")
1295 (if (= (ibuffer-count-marked-lines t) 0)
1296 (message "No buffers marked; use 'm' to mark a buffer")
1297 (cond
1298 ((char-equal mark ibuffer-marked-char)
1299 (ibuffer-map-marked-lines
57c9cc3e 1300 #'(lambda (buf mark)
972b8f82 1301 (ibuffer-set-mark-1 ?\s)
25d2f683
CW
1302 t)))
1303 ((char-equal mark ibuffer-deletion-char)
1304 (ibuffer-map-deletion-lines
57c9cc3e 1305 #'(lambda (buf mark)
972b8f82 1306 (ibuffer-set-mark-1 ?\s)
25d2f683
CW
1307 t)))
1308 (t
1309 (ibuffer-map-lines
57c9cc3e 1310 #'(lambda (buf mark)
972b8f82
JB
1311 (when (not (char-equal mark ?\s))
1312 (ibuffer-set-mark-1 ?\s))
25d2f683
CW
1313 t)))))
1314 (ibuffer-redisplay t))
1315
b5cd37ea 1316(defun ibuffer-toggle-marks (&optional group)
25d2f683
CW
1317 "Toggle which buffers are marked.
1318In other words, unmarked buffers become marked, and marked buffers
cba63a2d
CW
1319become unmarked.
1320If point is on a group name, then this function operates on that
1321group."
25d2f683 1322 (interactive)
cba63a2d
CW
1323 (ibuffer-aif (get-text-property (point) 'ibuffer-filter-group-name)
1324 (setq group it))
25d2f683
CW
1325 (let ((count
1326 (ibuffer-map-lines
57c9cc3e 1327 #'(lambda (buf mark)
25d2f683 1328 (cond ((eq mark ibuffer-marked-char)
972b8f82 1329 (ibuffer-set-mark-1 ?\s)
25d2f683 1330 nil)
972b8f82 1331 ((eq mark ?\s)
25d2f683
CW
1332 (ibuffer-set-mark-1 ibuffer-marked-char)
1333 t)
1334 (t
b5cd37ea
CW
1335 nil)))
1336 nil group)))
25d2f683
CW
1337 (message "%s buffers marked" count))
1338 (ibuffer-redisplay t))
1339
1340(defun ibuffer-mark-forward (arg)
cba63a2d
CW
1341 "Mark the buffer on this line, and move forward ARG lines.
1342If point is on a group name, this function operates on that group."
25d2f683
CW
1343 (interactive "P")
1344 (ibuffer-mark-interactive arg ibuffer-marked-char 1))
1345
1346(defun ibuffer-unmark-forward (arg)
cba63a2d
CW
1347 "Unmark the buffer on this line, and move forward ARG lines.
1348If point is on a group name, this function operates on that group."
25d2f683 1349 (interactive "P")
972b8f82 1350 (ibuffer-mark-interactive arg ?\s 1))
25d2f683
CW
1351
1352(defun ibuffer-unmark-backward (arg)
cba63a2d
CW
1353 "Unmark the buffer on this line, and move backward ARG lines.
1354If point is on a group name, this function operates on that group."
25d2f683 1355 (interactive "P")
972b8f82 1356 (ibuffer-mark-interactive arg ?\s -1))
25d2f683
CW
1357
1358(defun ibuffer-mark-interactive (arg mark movement)
1359 (assert (eq major-mode 'ibuffer-mode))
34a4faa0 1360 (or arg (setq arg 1))
cba63a2d
CW
1361 (ibuffer-forward-line 0)
1362 (ibuffer-aif (get-text-property (point) 'ibuffer-filter-group-name)
1363 (progn
1364 (require 'ibuf-ext)
1365 (ibuffer-mark-on-buffer #'identity mark it))
4e4a724c 1366 (ibuffer-forward-line 0 t)
cba63a2d
CW
1367 (let ((inhibit-read-only t))
1368 (while (> arg 0)
1369 (ibuffer-set-mark mark)
1370 (ibuffer-forward-line movement t)
1371 (setq arg (1- arg))))))
25d2f683
CW
1372
1373(defun ibuffer-set-mark (mark)
1374 (assert (eq major-mode 'ibuffer-mode))
1375 (let ((inhibit-read-only t))
1376 (ibuffer-set-mark-1 mark)
1377 (setq ibuffer-did-modification t)
559ac4c1
CW
1378 (ibuffer-redisplay-current)
1379 (beginning-of-line)))
25d2f683
CW
1380
1381(defun ibuffer-set-mark-1 (mark)
1382 (let ((beg (line-beginning-position))
1383 (end (line-end-position)))
1384 (put-text-property beg end 'ibuffer-properties
1385 (list (ibuffer-current-buffer)
1386 mark))))
1387
1388(defun ibuffer-mark-for-delete (arg)
cba63a2d
CW
1389 "Mark the buffers on ARG lines forward for deletion.
1390If point is on a group name, this function operates on that group."
25d2f683
CW
1391 (interactive "P")
1392 (ibuffer-mark-interactive arg ibuffer-deletion-char 1))
1393
1394(defun ibuffer-mark-for-delete-backwards (arg)
cba63a2d
CW
1395 "Mark the buffers on ARG lines backward for deletion.
1396If point is on a group name, this function operates on that group."
25d2f683
CW
1397 (interactive "P")
1398 (ibuffer-mark-interactive arg ibuffer-deletion-char -1))
1399
1400(defun ibuffer-current-buffer (&optional must-be-live)
1401 (let ((buf (car (get-text-property (line-beginning-position)
1402 'ibuffer-properties))))
b5cd37ea
CW
1403 (when must-be-live
1404 (if (bufferp buf)
1405 (unless (buffer-live-p buf)
1388485d 1406 (error "Buffer %s has been killed; %s" buf (substitute-command-keys "use `\\[ibuffer-update]' to update")))
b5cd37ea 1407 (error "No buffer on this line")))
25d2f683 1408 buf))
523304ed
CW
1409
1410(defun ibuffer-active-formats-name ()
1411 (if (boundp 'ibuffer-filter-format-alist)
1412 (let ((ret nil))
1413 (dolist (filter ibuffer-filtering-qualifiers ret)
1414 (let ((val (assq (car filter) ibuffer-filter-format-alist)))
1415 (when val
1416 (setq ret (car filter)))))
1417 (if ret
1418 ret
1419 :ibuffer-formats))
1420 :ibuffer-formats))
1421
1422(defun ibuffer-current-formats (uncompiledp)
1423 (let* ((name (ibuffer-active-formats-name)))
1424 (ibuffer-check-formats)
1425 (if (eq name :ibuffer-formats)
1426 (if uncompiledp
1427 ibuffer-formats
1428 ibuffer-compiled-formats)
1429 (cadr (assq name
1430 (if uncompiledp
1431 ibuffer-filter-format-alist
1432 ibuffer-compiled-filter-formats))))))
71296446 1433
523304ed 1434(defun ibuffer-current-format (&optional uncompiledp)
25d2f683
CW
1435 (or ibuffer-current-format
1436 (setq ibuffer-current-format 0))
4e4a724c 1437 (nth ibuffer-current-format (ibuffer-current-formats uncompiledp)))
25d2f683
CW
1438
1439(defun ibuffer-expand-format-entry (form)
1440 (if (or (consp form)
1441 (symbolp form))
4e4a724c
JPW
1442 (let ((sym (intern (concat "ibuffer-make-column-"
1443 (symbol-name (if (consp form)
1444 (car form)
1445 form))))))
1446 (unless (or (fboundp sym)
1447 (assq sym ibuffer-inline-columns))
1448 (error "Unknown column %s in ibuffer-formats" form))
1449 (let (min max align elide)
1450 (if (consp form)
1451 (setq min (or (nth 1 form) 0)
1452 max (or (nth 2 form) -1)
1453 align (or (nth 3 form) :left)
1454 elide (or (nth 4 form) nil))
1455 (setq min 0
1456 max -1
1457 align :left
1458 elide nil))
1459 (list sym min max align elide)))
25d2f683 1460 form))
71296446 1461
25d2f683 1462(defun ibuffer-compile-make-eliding-form (strvar elide from-end-p)
545aad2f 1463 (let ((ellipsis (propertize ibuffer-eliding-string 'font-lock-face 'bold)))
63f0a166 1464 (if (or elide (with-no-warnings ibuffer-elide-long-columns))
25d2f683
CW
1465 `(if (> strlen 5)
1466 ,(if from-end-p
1467 `(concat ,ellipsis
1468 (substring ,strvar
1469 (length ibuffer-eliding-string)))
1470 `(concat
1471 (substring ,strvar 0 (- strlen ,(length ellipsis)))
1472 ,ellipsis))
1473 ,strvar)
1474 strvar)))
1475
1476(defun ibuffer-compile-make-substring-form (strvar maxvar from-end-p)
1477 (if from-end-p
1478 `(substring str
1479 (- strlen ,maxvar))
1480 `(substring ,strvar 0 ,maxvar)))
1481
1482(defun ibuffer-compile-make-format-form (strvar widthform alignment)
972b8f82
JB
1483 (let* ((left `(make-string tmp2 ?\s))
1484 (right `(make-string (- tmp1 tmp2) ?\s)))
25d2f683
CW
1485 `(progn
1486 (setq tmp1 ,widthform
1487 tmp2 (/ tmp1 2))
1488 ,(case alignment
1489 (:right `(concat ,left ,right ,strvar))
1490 (:center `(concat ,left ,strvar ,right))
1491 (:left `(concat ,strvar ,left ,right))
1492 (t (error "Invalid alignment %s" alignment))))))
1493
1494(defun ibuffer-compile-format (format)
1495 (let ((result nil)
cb059426
CW
1496 ;; We use these variables to keep track of which variables
1497 ;; inside the generated function we need to bind, since
1498 ;; binding variables in Emacs takes time.
1499 str-used tmp1-used tmp2-used global-strlen-used)
25d2f683
CW
1500 (dolist (form format)
1501 (push
cb059426
CW
1502 ;; Generate a form based on a particular format entry, like
1503 ;; " ", mark, or (mode 16 16 :right).
25d2f683 1504 (if (stringp form)
cb059426 1505 ;; It's a string; all we need to do is insert it.
25d2f683
CW
1506 `(insert ,form)
1507 (let* ((form (ibuffer-expand-format-entry form))
1508 (sym (nth 0 form))
1509 (min (nth 1 form))
1510 (max (nth 2 form))
1511 (align (nth 3 form))
1512 (elide (nth 4 form)))
1513 (let* ((from-end-p (when (minusp min)
1514 (setq min (- min))
1515 t))
1516 (letbindings nil)
1517 (outforms nil)
1518 minform
1519 maxform
1520 min-used max-used strlen-used)
1521 (when (or (not (integerp min)) (>= min 0))
cb059426
CW
1522 ;; This is a complex case; they want it limited to a
1523 ;; minimum size.
25d2f683
CW
1524 (setq min-used t)
1525 (setq str-used t strlen-used t global-strlen-used t
1526 tmp1-used t tmp2-used t)
cb059426 1527 ;; Generate code to limit the string to a minimum size.
25d2f683
CW
1528 (setq minform `(progn
1529 (setq str
1530 ,(ibuffer-compile-make-format-form
1531 'str
1532 `(- ,(if (integerp min)
1533 min
1534 'min)
1535 strlen)
1536 align)))))
1537 (when (or (not (integerp max)) (> max 0))
1538 (setq str-used t max-used t)
cb059426 1539 ;; Generate code to limit the string to a maximum size.
25d2f683
CW
1540 (setq maxform `(progn
1541 (setq str
1542 ,(ibuffer-compile-make-substring-form
1543 'str
1544 (if (integerp max)
1545 max
1546 'max)
1547 from-end-p))
1548 (setq strlen (length str))
1549 (setq str
1550 ,(ibuffer-compile-make-eliding-form 'str
1551 elide
1552 from-end-p)))))
cb059426
CW
1553 ;; Now, put these forms together with the rest of the code.
1554 (let ((callform
1555 ;; Is this an "inline" column? This means we have
1556 ;; to get the code from the
1557 ;; `ibuffer-inline-columns' alist and insert it
1558 ;; into our generated code. Otherwise, we just
1559 ;; generate a call to the column function.
1560 (ibuffer-aif (assq sym ibuffer-inline-columns)
4e4a724c
JPW
1561 (nth 1 it)
1562 `(,sym buffer mark)))
cb059426
CW
1563 ;; You're not expected to understand this. Hell, I
1564 ;; don't even understand it, and I wrote it five
1565 ;; minutes ago.
1566 (insertgenfn (ibuffer-aif (get sym 'ibuffer-column-summarizer)
4e4a724c
JPW
1567 ;; I really, really wish Emacs Lisp had closures.
1568 (lambda (arg sym)
1569 `(insert
1570 (let ((ret ,arg))
1571 (put ',sym 'ibuffer-column-summary
1572 (cons ret (get ',sym 'ibuffer-column-summary)))
1573 ret)))
545aad2f
CW
1574 (lambda (arg sym)
1575 `(insert ,arg))))
25d2f683
CW
1576 (mincompform `(< strlen ,(if (integerp min)
1577 min
1578 'min)))
1579 (maxcompform `(> strlen ,(if (integerp max)
1580 max
1581 'max))))
4e4a724c
JPW
1582 (if (or min-used max-used)
1583 ;; The complex case, where we have to limit the
1584 ;; form to a maximum or minimum size.
1585 (progn
1586 (when (and min-used (not (integerp min)))
1587 (push `(min ,min) letbindings))
1588 (when (and max-used (not (integerp max)))
1589 (push `(max ,max) letbindings))
1590 (push
1591 (if (and min-used max-used)
1592 `(if ,mincompform
1593 ,minform
1594 (if ,maxcompform
1595 ,maxform))
1596 (if min-used
1597 `(when ,mincompform
1598 ,minform)
1599 `(when ,maxcompform
1600 ,maxform)))
1601 outforms)
1602 (push (append
1603 `(setq str ,callform)
1604 (when strlen-used
1605 `(strlen (length str))))
1606 outforms)
1607 (setq outforms
1608 (append outforms (list (funcall insertgenfn 'str sym)))))
1609 ;; The simple case; just insert the string.
1610 (push (funcall insertgenfn callform sym) outforms))
1611 ;; Finally, return a `let' form which binds the
1612 ;; variables in `letbindings', and contains all the
1613 ;; code in `outforms'.
1614 `(let ,letbindings
1615 ,@outforms)))))
25d2f683
CW
1616 result))
1617 (setq result
cb059426 1618 ;; We don't want to unconditionally load the byte-compiler.
25d2f683
CW
1619 (funcall (if (or ibuffer-always-compile-formats
1620 (featurep 'bytecomp))
1621 #'byte-compile
1622 #'identity)
cb059426
CW
1623 ;; Here, we actually create a lambda form which
1624 ;; inserts all the generated forms for each entry
1625 ;; in the format string.
25d2f683 1626 (nconc (list 'lambda '(buffer mark))
d99b259b 1627 `((let ,(append (when str-used
25d2f683
CW
1628 '(str))
1629 (when global-strlen-used
1630 '(strlen))
1631 (when tmp1-used
1632 '(tmp1))
1633 (when tmp2-used
1634 '(tmp2)))
1635 ,@(nreverse result))))))))
1636
25d2f683
CW
1637(defun ibuffer-recompile-formats ()
1638 "Recompile `ibuffer-formats'."
1639 (interactive)
1640 (setq ibuffer-compiled-formats
4e4a724c 1641 (mapcar #'ibuffer-compile-format ibuffer-formats))
523304ed
CW
1642 (when (boundp 'ibuffer-filter-format-alist)
1643 (setq ibuffer-compiled-filter-formats
1644 (mapcar #'(lambda (entry)
1645 (cons (car entry)
1646 (mapcar #'(lambda (formats)
1647 (mapcar #'ibuffer-compile-format formats))
1648 (cdr entry))))
1649 ibuffer-filter-format-alist))))
25d2f683 1650
cb059426
CW
1651(defun ibuffer-clear-summary-columns (format)
1652 (dolist (form format)
1653 (ibuffer-awhen (and (consp form)
1654 (get (car form) 'ibuffer-column-summarizer))
1655 (put (car form) 'ibuffer-column-summary nil))))
71296446 1656
25d2f683 1657(defun ibuffer-check-formats ()
523304ed
CW
1658 (when (null ibuffer-formats)
1659 (error "No formats!"))
b5cd37ea
CW
1660 (let ((ext-loaded (featurep 'ibuf-ext)))
1661 (when (or (null ibuffer-compiled-formats)
1662 (null ibuffer-cached-formats)
1663 (not (eq ibuffer-cached-formats ibuffer-formats))
1664 (null ibuffer-cached-eliding-string)
1665 (not (equal ibuffer-cached-eliding-string ibuffer-eliding-string))
1666 (eql 0 ibuffer-cached-elide-long-columns)
1667 (not (eql ibuffer-cached-elide-long-columns
63f0a166 1668 (with-no-warnings ibuffer-elide-long-columns)))
b5cd37ea
CW
1669 (and ext-loaded
1670 (not (eq ibuffer-cached-filter-formats
1671 ibuffer-filter-format-alist))
1672 (and ibuffer-filter-format-alist
1673 (null ibuffer-compiled-filter-formats))))
1674 (message "Formats have changed, recompiling...")
1675 (ibuffer-recompile-formats)
1676 (setq ibuffer-cached-formats ibuffer-formats
1677 ibuffer-cached-eliding-string ibuffer-eliding-string
63f0a166 1678 ibuffer-cached-elide-long-columns (with-no-warnings ibuffer-elide-long-columns))
b5cd37ea
CW
1679 (when ext-loaded
1680 (setq ibuffer-cached-filter-formats ibuffer-filter-format-alist))
1681 (message "Formats have changed, recompiling...done"))))
25d2f683
CW
1682
1683(defvar ibuffer-inline-columns nil)
1684
1685(define-ibuffer-column mark (:name " " :inline t)
1686 (string mark))
1687
1688(define-ibuffer-column read-only (:name "R" :inline t)
1689 (if buffer-read-only
34a4faa0 1690 (string ibuffer-read-only-char)
25d2f683
CW
1691 " "))
1692
1693(define-ibuffer-column modified (:name "M" :inline t)
1694 (if (buffer-modified-p)
1695 (string ibuffer-modified-char)
1696 " "))
1697
34a4faa0
JPW
1698(define-ibuffer-column name
1699 (:inline t
f0b31589 1700 :header-mouse-map ibuffer-name-header-map
34a4faa0
JPW
1701 :props
1702 ('mouse-face 'highlight 'keymap ibuffer-name-map
1703 'ibuffer-name-column t
1704 'help-echo '(if tooltip-mode
1705 "mouse-1: mark this buffer\nmouse-2: select this buffer\nmouse-3: operate on this buffer"
1706 "mouse-1: mark buffer mouse-2: select buffer mouse-3: operate"))
1707 :summarizer
1708 (lambda (strings)
1709 (let ((bufs (length strings)))
1710 (cond ((zerop bufs) "No buffers")
1711 ((= 1 bufs) "1 buffer")
1712 (t (format "%s buffers" bufs))))))
545aad2f 1713 (propertize (buffer-name) 'font-lock-face (ibuffer-buffer-name-face buffer mark)))
71296446 1714
34a4faa0
JPW
1715(define-ibuffer-column size
1716 (:inline t
f0b31589 1717 :header-mouse-map ibuffer-size-header-map
34a4faa0
JPW
1718 :summarizer
1719 (lambda (column-strings)
1720 (let ((total 0))
1721 (dolist (string column-strings)
1722 (setq total
1723 ;; like, ewww ...
7ad938e7 1724 (+ (float (string-to-number string))
34a4faa0
JPW
1725 total)))
1726 (format "%.0f" total))))
25d2f683
CW
1727 (format "%s" (buffer-size)))
1728
7ad938e7
JPW
1729(define-ibuffer-column mode
1730 (:inline t
f0b31589 1731 :header-mouse-map ibuffer-mode-header-map
7ad938e7
JPW
1732 :props
1733 ('mouse-face 'highlight
1734 'keymap ibuffer-mode-name-map
1735 'help-echo "mouse-2: filter by this mode"))
23eabff6 1736 (format-mode-line mode-name nil nil (current-buffer)))
25d2f683 1737
34a4faa0
JPW
1738(define-ibuffer-column process
1739 (:summarizer
1740 (lambda (strings)
1741 (let ((total (length (delete "" strings))))
1742 (cond ((zerop total) "No processes")
1743 ((= 1 total) "1 process")
1744 (t (format "%d processes" total))))))
96777edb
CW
1745 (ibuffer-aif (get-buffer-process buffer)
1746 (format "(%s %s)" it (process-status it))
34a4faa0
JPW
1747 ""))
1748
1749(define-ibuffer-column filename
1750 (:summarizer
1751 (lambda (strings)
1752 (let ((total (length (delete "" strings))))
1753 (cond ((zerop total) "No files")
1754 ((= 1 total) "1 file")
1755 (t (format "%d files" total))))))
25d2f683
CW
1756 (let ((directory-abbrev-alist ibuffer-directory-abbrev-alist))
1757 (abbreviate-file-name
1758 (or buffer-file-name
1759 (and (boundp 'dired-directory)
2baf64db
JPW
1760 (if (stringp dired-directory)
1761 dired-directory
972b8f82 1762 (car dired-directory)))
b4c5fc9f
JPW
1763 (and (eq major-mode 'vc-dir-mode)
1764 (bound-and-true-p default-directory))
25d2f683
CW
1765 ""))))
1766
34a4faa0
JPW
1767(define-ibuffer-column filename-and-process
1768 (:name "Filename/Process"
d5794180 1769 :header-mouse-map ibuffer-filename/process-header-map
34a4faa0
JPW
1770 :summarizer
1771 (lambda (strings)
1772 (setq strings (delete "" strings))
1773 (let ((procs 0)
1774 (files 0))
1775 (dolist (string strings)
1776 (if (string-match "\\(\?:\\`(\[\[:ascii:\]\]\+)\\)" string)
1777 (progn (setq procs (1+ procs))
1778 (if (< (match-end 0) (length string))
1779 (setq files (1+ files))))
1780 (setq files (1+ files))))
1781 (concat (cond ((zerop files) "No files")
1782 ((= 1 files) "1 file")
1783 (t (format "%d files" files)))
1784 ", "
1785 (cond ((zerop procs) "no processes")
1786 ((= 1 procs) "1 process")
1787 (t (format "%d processes" procs)))))))
fd225d80 1788 (let ((proc (get-buffer-process buffer))
63e0bf5e 1789 (filename (ibuffer-make-column-filename buffer mark)))
fd225d80 1790 (if proc
34a4faa0 1791 (concat (propertize (format "(%s %s)" proc (process-status proc))
545aad2f 1792 'font-lock-face 'italic)
34a4faa0
JPW
1793 (if (> (length filename) 0)
1794 (format " %s" filename)
1795 ""))
fd225d80
CW
1796 filename)))
1797
25d2f683 1798(defun ibuffer-format-column (str width alignment)
972b8f82
JB
1799 (let ((left (make-string (/ width 2) ?\s))
1800 (right (make-string (- width (/ width 2)) ?\s)))
25d2f683
CW
1801 (case alignment
1802 (:right (concat left right str))
1803 (:center (concat left str right))
1804 (t (concat str left right)))))
1805
545aad2f 1806(defun ibuffer-buffer-name-face (buf mark)
fd225d80 1807 (cond ((char-equal mark ibuffer-marked-char)
545aad2f 1808 ibuffer-marked-face)
fd225d80 1809 ((char-equal mark ibuffer-deletion-char)
545aad2f 1810 ibuffer-deletion-face)
fd225d80
CW
1811 (t
1812 (let ((level -1)
fd225d80
CW
1813 result)
1814 (dolist (e ibuffer-fontification-alist result)
1815 (when (and (> (car e) level)
1816 (with-current-buffer buf
545aad2f 1817 (eval (nth 1 e))))
fd225d80 1818 (setq level (car e)
545aad2f 1819 result (nth 2 e))))))))
25d2f683
CW
1820
1821(defun ibuffer-insert-buffer-line (buffer mark format)
1822 "Insert a line describing BUFFER and MARK using FORMAT."
1823 (assert (eq major-mode 'ibuffer-mode))
1824 (let ((beg (point)))
25d2f683 1825 (funcall format buffer mark)
cb059426
CW
1826 (put-text-property beg (point) 'ibuffer-properties (list buffer mark)))
1827 (insert "\n"))
25d2f683 1828
cb059426 1829;; This function knows a bit too much of the internals. It would be
b5cd37ea 1830;; nice if it was all abstracted away.
25d2f683
CW
1831(defun ibuffer-redisplay-current ()
1832 (assert (eq major-mode 'ibuffer-mode))
1833 (when (eobp)
1834 (forward-line -1))
1835 (beginning-of-line)
cb059426
CW
1836 (let ((curformat (mapcar #'ibuffer-expand-format-entry
1837 (ibuffer-current-format t))))
1838 (ibuffer-clear-summary-columns curformat)
1839 (let ((buf (ibuffer-current-buffer)))
1840 (when buf
1841 (let ((mark (ibuffer-current-mark)))
ed233dd8
CW
1842 (save-excursion
1843 (delete-region (point) (1+ (line-end-position)))
1844 (ibuffer-insert-buffer-line
1845 buf mark
1846 (ibuffer-current-format)))
cb059426
CW
1847 (when ibuffer-shrink-to-minimum-size
1848 (ibuffer-shrink-to-fit)))))))
71296446 1849
25d2f683
CW
1850(defun ibuffer-map-on-mark (mark func)
1851 (ibuffer-map-lines
57c9cc3e 1852 #'(lambda (buf mk)
25d2f683 1853 (if (char-equal mark mk)
57c9cc3e 1854 (funcall func buf mark)
25d2f683
CW
1855 nil))))
1856
b5cd37ea
CW
1857(defun ibuffer-map-lines (function &optional nomodify group)
1858 "Call FUNCTION for each buffer.
4837b516 1859Set the ibuffer modification flag unless NOMODIFY is non-nil.
25d2f683 1860
b5cd37ea
CW
1861If optional argument GROUP is non-nil, then only call FUNCTION on
1862buffers in filtering group GROUP.
1863
4e4a724c
JPW
1864FUNCTION is called with two arguments:
1865the buffer object itself and the current mark symbol."
25d2f683 1866 (assert (eq major-mode 'ibuffer-mode))
b5cd37ea
CW
1867 (ibuffer-forward-line 0)
1868 (let* ((orig-target-line (1+ (count-lines (save-excursion
1869 (goto-char (point-min))
1870 (ibuffer-forward-line 0)
1871 (point))
1872 (point))))
1873 (target-line-offset orig-target-line)
1874 (ibuffer-map-lines-total 0)
1875 (ibuffer-map-lines-count 0))
25d2f683 1876 (unwind-protect
57c9cc3e
CW
1877 (progn
1878 (setq buffer-read-only nil)
1879 (goto-char (point-min))
4e4a724c 1880 (ibuffer-forward-line 0 t)
57c9cc3e 1881 (while (and (not (eobp))
b5cd37ea
CW
1882 (not (get-text-property (point) 'ibuffer-summary))
1883 (progn
1884 (ibuffer-forward-line 0 t)
1885 (and (not (eobp))
1886 (not (get-text-property (point) 'ibuffer-summary)))))
57c9cc3e
CW
1887 (let ((result
1888 (if (buffer-live-p (ibuffer-current-buffer))
b5cd37ea
CW
1889 (when (or (null group)
1890 (ibuffer-aif (get-text-property (point) 'ibuffer-filter-group)
1891 (equal group it)))
1892 (save-excursion
1893 (funcall function
1894 (ibuffer-current-buffer)
1895 (ibuffer-current-mark))))
57c9cc3e
CW
1896 ;; Kill the line if the buffer is dead
1897 'kill)))
1898 ;; A given mapping function should return:
1899 ;; `nil' if it chose not to affect the buffer
1900 ;; `kill' means the remove line from the buffer list
1901 ;; `t' otherwise
1902 (incf ibuffer-map-lines-total)
1903 (cond ((null result)
1904 (forward-line 1))
1905 ((eq result 'kill)
1906 (delete-region (line-beginning-position)
1907 (1+ (line-end-position)))
1908 (incf ibuffer-map-lines-count)
1909 (when (< ibuffer-map-lines-total
4e4a724c 1910 orig-target-line)
b5cd37ea 1911 (decf target-line-offset)))
57c9cc3e
CW
1912 (t
1913 (incf ibuffer-map-lines-count)
1914 (forward-line 1)))))
1915 ibuffer-map-lines-count)
25d2f683
CW
1916 (progn
1917 (setq buffer-read-only t)
1918 (unless nomodify
1919 (set-buffer-modified-p nil))
57c9cc3e
CW
1920 (goto-char (point-min))
1921 (ibuffer-forward-line 0)
b5cd37ea 1922 (ibuffer-forward-line (1- target-line-offset))))))
25d2f683
CW
1923
1924(defun ibuffer-get-marked-buffers ()
1925 "Return a list of buffer objects currently marked."
1926 (delq nil
1927 (mapcar #'(lambda (e)
1928 (when (eq (cdr e) ibuffer-marked-char)
1929 (car e)))
1930 (ibuffer-current-state-list))))
1931
d246cabf
CW
1932(defun ibuffer-current-state-list (&optional pos)
1933 "Return a list like (BUF . MARK) of all buffers in an ibuffer.
1934If POS is non-nil, return a list like (BUF MARK POINT), where POINT is
1935the value of point at the beginning of the line for that buffer."
25d2f683
CW
1936 (let ((ibuffer-current-state-list-tmp '()))
1937 ;; ah, if only we had closures. I bet this will mysteriously
1938 ;; break later. Don't blame me.
d246cabf
CW
1939 (if pos
1940 (ibuffer-map-lines-nomodify
1941 #'(lambda (buf mark)
1942 (when (buffer-live-p buf)
1943 (push (list buf mark (point)) ibuffer-current-state-list-tmp))))
1944 (ibuffer-map-lines-nomodify
1945 #'(lambda (buf mark)
1946 (when (buffer-live-p buf)
1947 (push (cons buf mark) ibuffer-current-state-list-tmp)))))
25d2f683
CW
1948 (nreverse ibuffer-current-state-list-tmp)))
1949
851476d4 1950(defun ibuffer-current-buffers-with-marks (curbufs)
25d2f683
CW
1951 "Return a list like (BUF . MARK) of all open buffers."
1952 (let ((bufs (ibuffer-current-state-list)))
1953 (mapcar #'(lambda (buf) (let ((e (assq buf bufs)))
1954 (if e
1955 e
972b8f82 1956 (cons buf ?\s))))
851476d4 1957 curbufs)))
25d2f683
CW
1958
1959(defun ibuffer-buf-matches-predicates (buf predicates)
1960 (let ((hit nil)
1961 (name (buffer-name buf)))
1962 (dolist (pred predicates)
1963 (when (if (stringp pred)
1964 (string-match pred name)
1965 (funcall pred buf))
1966 (setq hit t)))
1967 hit))
71296446 1968
25d2f683
CW
1969(defun ibuffer-filter-buffers (ibuffer-buf last bmarklist all)
1970 (let ((ext-loaded (featurep 'ibuf-ext)))
1971 (delq nil
b5cd37ea
CW
1972 (mapcar
1973 ;; element should be like (BUFFER . MARK)
1974 #'(lambda (e)
1975 (let* ((buf (car e)))
1976 (when
1977 ;; This takes precedence over anything else
1978 (or (and ibuffer-always-show-last-buffer
4e4a724c
JPW
1979 (eq last buf))
1980 (funcall (if ext-loaded
1981 #'ibuffer-ext-visible-p
1982 #'ibuffer-visible-p)
1983 buf all ibuffer-buf))
b5cd37ea
CW
1984 e)))
1985 bmarklist))))
25d2f683
CW
1986
1987(defun ibuffer-visible-p (buf all &optional ibuffer-buf)
1988 (and (or all
1989 (not
1990 (ibuffer-buf-matches-predicates buf ibuffer-maybe-show-predicates)))
1991 (or ibuffer-view-ibuffer
4e4a724c 1992 (and ibuffer-buf
25d2f683
CW
1993 (not (eq ibuffer-buf buf))))))
1994
1995;; This function is a special case; it's not defined by
6081889e 1996;; `define-ibuffer-sorter'.
25d2f683
CW
1997(defun ibuffer-do-sort-by-recency ()
1998 "Sort the buffers by last view time."
1999 (interactive)
2000 (setq ibuffer-sorting-mode 'recency)
e7820654
JPW
2001 (when (eq ibuffer-last-sorting-mode 'recency)
2002 (setq ibuffer-sorting-reversep (not ibuffer-sorting-reversep)))
2003 (ibuffer-update nil t)
2004 (setq ibuffer-last-sorting-mode 'recency))
25d2f683
CW
2005
2006(defun ibuffer-update-format ()
2007 (when (null ibuffer-current-format)
2008 (setq ibuffer-current-format 0))
2009 (when (null ibuffer-formats)
2010 (error "Ibuffer error: no formats!")))
2011
2012(defun ibuffer-switch-format ()
2013 "Switch the current display format."
2014 (interactive)
2015 (assert (eq major-mode 'ibuffer-mode))
2016 (unless (consp ibuffer-formats)
2017 (error "Ibuffer error: No formats!"))
2018 (setq ibuffer-current-format
80a06d64 2019 (if (>= ibuffer-current-format (1- (length (ibuffer-current-formats nil))))
25d2f683
CW
2020 0
2021 (1+ ibuffer-current-format)))
2022 (ibuffer-update-format)
2023 (ibuffer-redisplay t))
2024
cb059426 2025(defun ibuffer-update-title-and-summary (format)
25d2f683
CW
2026 (assert (eq major-mode 'ibuffer-mode))
2027 ;; Don't do funky font-lock stuff here
2028 (let ((after-change-functions nil))
2029 (if (get-text-property (point-min) 'ibuffer-title)
2030 (delete-region (point-min)
2031 (next-single-property-change
2032 (point-min) 'ibuffer-title)))
2033 (goto-char (point-min))
fd225d80 2034 (add-text-properties
25d2f683
CW
2035 (point)
2036 (progn
2037 (let ((opos (point)))
2038 ;; Insert the title names.
cb059426 2039 (dolist (element format)
25d2f683
CW
2040 (insert
2041 (if (stringp element)
2042 element
2043 (let ((sym (car element))
2044 (min (cadr element))
2045 ;; (max (caddr element))
2046 (align (cadddr element)))
4e4a724c 2047 ;; Ignore a negative min when we're inserting the title
25d2f683
CW
2048 (when (minusp min)
2049 (setq min (- min)))
2050 (let* ((name (or (get sym 'ibuffer-column-name)
2051 (error "Unknown column %s in ibuffer-formats" sym)))
f0b31589
DN
2052 (len (length name))
2053 (hmap (get sym 'header-mouse-map))
2054 (strname (if (< len min)
2055 (ibuffer-format-column name
2056 (- min len)
2057 align)
2058 name)))
2059 (when hmap
2060 (setq
2061 strname
2062 (propertize strname 'mouse-face 'highlight 'keymap hmap)))
2063 strname)))))
fd225d80 2064 (add-text-properties opos (point) `(ibuffer-title-header t))
25d2f683
CW
2065 (insert "\n")
2066 ;; Add the underlines
2067 (let ((str (save-excursion
2068 (forward-line -1)
2069 (beginning-of-line)
2070 (buffer-substring (point) (line-end-position)))))
2071 (apply #'insert (mapcar
2072 #'(lambda (c)
972b8f82 2073 (if (not (or (char-equal c ?\s)
25d2f683
CW
2074 (char-equal c ?\n)))
2075 ?-
972b8f82 2076 ?\s))
25d2f683
CW
2077 str)))
2078 (insert "\n"))
2079 (point))
545aad2f 2080 `(ibuffer-title t font-lock-face ,ibuffer-title-face))
cb059426
CW
2081 ;; Now, insert the summary columns.
2082 (goto-char (point-max))
2083 (if (get-text-property (1- (point-max)) 'ibuffer-summary)
2084 (delete-region (previous-single-property-change
2085 (point-max) 'ibuffer-summary)
2086 (point-max)))
0740098c
JPW
2087 (if ibuffer-display-summary
2088 (add-text-properties
2089 (point)
2090 (progn
2091 (insert "\n")
2092 (dolist (element format)
2093 (insert
2094 (if (stringp element)
972b8f82 2095 (make-string (length element) ?\s)
0740098c
JPW
2096 (let ((sym (car element)))
2097 (let ((min (cadr element))
2098 ;; (max (caddr element))
2099 (align (cadddr element)))
2100 ;; Ignore a negative min when we're inserting the title
2101 (when (minusp min)
2102 (setq min (- min)))
2103 (let* ((summary (if (get sym 'ibuffer-column-summarizer)
2104 (funcall (get sym 'ibuffer-column-summarizer)
2105 (get sym 'ibuffer-column-summary))
2106 (make-string (length (get sym 'ibuffer-column-name))
972b8f82 2107 ?\s)))
0740098c
JPW
2108 (len (length summary)))
2109 (if (< len min)
2110 (ibuffer-format-column summary
2111 (- min len)
2112 align)
2113 summary)))))))
2114 (point))
2115 `(ibuffer-summary t)))))
25d2f683 2116
25d2f683
CW
2117
2118(defun ibuffer-redisplay (&optional silent)
2119 "Redisplay the current list of buffers.
25d2f683
CW
2120This does not show new buffers; use `ibuffer-update' for that.
2121
7ad5b902 2122If optional arg SILENT is non-nil, do not display progress messages."
25d2f683 2123 (interactive)
57c9cc3e 2124 (ibuffer-forward-line 0)
25d2f683
CW
2125 (unless silent
2126 (message "Redisplaying current buffer list..."))
2127 (let ((blist (ibuffer-current-state-list)))
2128 (when (null blist)
2129 (if (and (featurep 'ibuf-ext)
cba63a2d 2130 (or ibuffer-filtering-qualifiers ibuffer-hidden-filter-groups))
25d2f683
CW
2131 (message "No buffers! (note: filtering in effect)")
2132 (error "No buffers!")))
b5cd37ea 2133 (ibuffer-redisplay-engine blist t)
25d2f683 2134 (unless silent
57c9cc3e
CW
2135 (message "Redisplaying current buffer list...done"))
2136 (ibuffer-forward-line 0)))
25d2f683
CW
2137
2138(defun ibuffer-update (arg &optional silent)
2139 "Regenerate the list of all buffers.
957237cb
JPW
2140
2141Prefix arg non-nil means to toggle whether buffers that match
2142`ibuffer-maybe-show-predicates' should be displayed.
25d2f683 2143
7ad5b902 2144If optional arg SILENT is non-nil, do not display progress messages."
25d2f683 2145 (interactive "P")
957237cb
JPW
2146 (if arg
2147 (setq ibuffer-display-maybe-show-predicates
2148 (not ibuffer-display-maybe-show-predicates)))
57c9cc3e 2149 (ibuffer-forward-line 0)
25d2f683
CW
2150 (let* ((bufs (buffer-list))
2151 (blist (ibuffer-filter-buffers
94394914
JPW
2152 (current-buffer)
2153 (if (and
2154 (cadr bufs)
2155 (eq ibuffer-always-show-last-buffer
2156 :nomini)
8e7dbfdb 2157 (minibufferp (cadr bufs)))
da337a28 2158 (caddr bufs)
94394914
JPW
2159 (cadr bufs))
2160 (ibuffer-current-buffers-with-marks bufs)
957237cb 2161 ibuffer-display-maybe-show-predicates)))
25d2f683
CW
2162 (when (null blist)
2163 (if (and (featurep 'ibuf-ext)
2164 ibuffer-filtering-qualifiers)
2165 (message "No buffers! (note: filtering in effect)")
2166 (error "No buffers!")))
2167 (unless silent
2168 (message "Updating buffer list..."))
b5cd37ea 2169 (ibuffer-redisplay-engine blist arg)
25d2f683
CW
2170 (unless silent
2171 (message "Updating buffer list...done")))
2172 (if (eq ibuffer-shrink-to-minimum-size 'onewindow)
2173 (ibuffer-shrink-to-fit t)
2174 (when ibuffer-shrink-to-minimum-size
2175 (ibuffer-shrink-to-fit)))
6d11a78b
SM
2176 (ibuffer-forward-line 0)
2177 ;; I tried to update this automatically from the mode-line-process format,
2178 ;; but changing nil-ness of header-line-format while computing
2179 ;; mode-line-format is asking a bit too much it seems. --Stef
2180 (setq header-line-format
2181 (and ibuffer-use-header-line
2182 ibuffer-filtering-qualifiers
2183 ibuffer-header-line-format)))
25d2f683 2184
b5cd37ea
CW
2185(defun ibuffer-sort-bufferlist (bmarklist)
2186 (let* ((sortdat (assq ibuffer-sorting-mode
2187 ibuffer-sorting-functions-alist))
2188 (func (caddr sortdat)))
2189 (let ((result
2190 ;; actually sort the buffers
2191 (if (and sortdat func)
2192 (sort bmarklist func)
2193 bmarklist)))
2194 ;; perhaps reverse the sorted buffer list
2195 (if ibuffer-sorting-reversep
2196 (nreverse result)
2197 result))))
2198
7fbac645 2199(defun ibuffer-insert-filter-group (name display-name filter-string format bmarklist)
b5cd37ea
CW
2200 (add-text-properties
2201 (point)
2202 (progn
2203 (insert "[ " display-name " ]")
2204 (point))
fd225d80
CW
2205 `(ibuffer-filter-group-name
2206 ,name
545aad2f 2207 font-lock-face ,ibuffer-filter-group-name-face
fd225d80
CW
2208 keymap ,ibuffer-mode-filter-group-map
2209 mouse-face highlight
1cd7affa
JPW
2210 help-echo ,(let ((echo '(if tooltip-mode
2211 "mouse-1: toggle marks in this group\nmouse-2: hide/show this filtering group"
ce3a4c83 2212 "mouse-1: toggle marks mouse-2: hide/show")))
1cd7affa 2213 (if (> (length filter-string) 0)
ce3a4c83
JPW
2214 `(concat ,filter-string
2215 (if tooltip-mode "\n" " ")
2216 ,echo)
1cd7affa 2217 echo))))
b5cd37ea
CW
2218 (insert "\n")
2219 (when bmarklist
2220 (put-text-property
2221 (point)
2222 (progn
2223 (dolist (entry bmarklist)
2224 (ibuffer-insert-buffer-line (car entry) (cdr entry) format))
2225 (point))
2226 'ibuffer-filter-group
2227 name)))
2228
957237cb 2229(defun ibuffer-redisplay-engine (bmarklist &optional ignore)
25d2f683 2230 (assert (eq major-mode 'ibuffer-mode))
b5cd37ea
CW
2231 (let* ((--ibuffer-insert-buffers-and-marks-format
2232 (ibuffer-current-format))
2233 (--ibuffer-expanded-format (mapcar #'ibuffer-expand-format-entry
2234 (ibuffer-current-format t)))
2235 (orig (count-lines (point-min) (point)))
2236 ;; Inhibit font-lock caching tricks, since we're modifying the
2237 ;; entire buffer at once
2238 (after-change-functions nil)
2239 (ext-loaded (featurep 'ibuf-ext))
2240 (bgroups (if ext-loaded
2241 (ibuffer-generate-filter-groups bmarklist)
2242 (list (cons "Default" bmarklist)))))
cb059426 2243 (ibuffer-clear-summary-columns --ibuffer-expanded-format)
25d2f683
CW
2244 (unwind-protect
2245 (progn
2246 (setq buffer-read-only nil)
2247 (erase-buffer)
2248 (ibuffer-update-format)
b5cd37ea
CW
2249 (dolist (group (nreverse bgroups))
2250 (let* ((name (car group))
2251 (disabled (and ext-loaded
cba63a2d 2252 (member name ibuffer-hidden-filter-groups)))
b5cd37ea 2253 (bmarklist (cdr group)))
cba63a2d 2254 (unless (and (null bmarklist)
b90a6a12 2255 (not disabled)
cba63a2d
CW
2256 ext-loaded
2257 (null ibuffer-show-empty-filter-groups))
2258 (ibuffer-insert-filter-group
2259 name
2260 (if disabled (concat name " ...") name)
7fbac645
CW
2261 (if ext-loaded
2262 (ibuffer-format-filter-group-data name)
2263 "")
cba63a2d
CW
2264 --ibuffer-insert-buffers-and-marks-format
2265 (if disabled
2266 nil
2267 (ibuffer-sort-bufferlist bmarklist))))))
cb059426 2268 (ibuffer-update-title-and-summary --ibuffer-expanded-format))
25d2f683
CW
2269 (setq buffer-read-only t)
2270 (set-buffer-modified-p ibuffer-did-modification)
2271 (setq ibuffer-did-modification nil)
2272 (goto-line (1+ orig)))))
2273
2274(defun ibuffer-quit ()
2275 "Quit this `ibuffer' session.
4837b516 2276Try to restore the previous window configuration if
4ed1f829 2277`ibuffer-restore-window-config-on-quit' is non-nil."
25d2f683 2278 (interactive)
4ed1f829 2279 (if ibuffer-restore-window-config-on-quit
7ad938e7 2280 (progn
25d2f683
CW
2281 (bury-buffer)
2282 (unless (= (count-windows) 1)
4ed1f829 2283 (set-window-configuration ibuffer-prev-window-config)))
25d2f683
CW
2284 (bury-buffer)))
2285
2286;;;###autoload
2287(defun ibuffer-list-buffers (&optional files-only)
2288 "Display a list of buffers, in another window.
2289If optional argument FILES-ONLY is non-nil, then add a filter for
2290buffers which are visiting a file."
2291 (interactive "P")
2292 (ibuffer t nil (when files-only
2293 '((filename . ".*"))) t))
2294
2295;;;###autoload
2296(defun ibuffer-other-window (&optional files-only)
2297 "Like `ibuffer', but displayed in another window by default.
2298If optional argument FILES-ONLY is non-nil, then add a filter for
2299buffers which are visiting a file."
2300 (interactive "P")
2301 (ibuffer t nil (when files-only
2302 '((filename . ".*")))))
2303
2304;;;###autoload
b5cd37ea 2305(defun ibuffer (&optional other-window-p name qualifiers noselect
fd225d80 2306 shrink filter-groups formats)
972b8f82 2307 "Begin using Ibuffer to edit a list of buffers.
25d2f683
CW
2308Type 'h' after entering ibuffer for more information.
2309
972b8f82
JB
2310All arguments are optional.
2311OTHER-WINDOW-P says to use another window.
2312NAME specifies the name of the buffer (defaults to \"*Ibuffer*\").
2313QUALIFIERS is an initial set of filtering qualifiers to use;
2314 see `ibuffer-filtering-qualifiers'.
2315NOSELECT means don't select the Ibuffer buffer.
2316SHRINK means shrink the buffer to minimal size. The special
2317 value `onewindow' means always use another window.
2318FILTER-GROUPS is an initial set of filtering groups to use;
2319 see `ibuffer-filter-groups'.
2320FORMATS is the value to use for `ibuffer-formats'.
2321 If specified, then the variable `ibuffer-formats' will have
2322 that value locally in this buffer."
25d2f683
CW
2323 (interactive "P")
2324 (when ibuffer-use-other-window
34b8f593 2325 (setq other-window-p t))
4ed1f829 2326 (setq ibuffer-prev-window-config (current-window-configuration))
34a4faa0 2327 (let ((buf (get-buffer-create (or name "*Ibuffer*"))))
25d2f683
CW
2328 (if other-window-p
2329 (funcall (if noselect #'(lambda (buf) (display-buffer buf t)) #'pop-to-buffer) buf)
2330 (funcall (if noselect #'display-buffer #'switch-to-buffer) buf))
2331 (with-current-buffer buf
b5cd37ea
CW
2332 (save-selected-window
2333 ;; We switch to the buffer's window in order to be able
2334 ;; to modify the value of point
fab0d308 2335 (select-window (get-buffer-window buf 0))
34a4faa0
JPW
2336 (or (eq major-mode 'ibuffer-mode)
2337 (ibuffer-mode))
4ed1f829 2338 (setq ibuffer-restore-window-config-on-quit other-window-p)
b5cd37ea
CW
2339 (when shrink
2340 (setq ibuffer-shrink-to-minimum-size shrink))
2341 (when qualifiers
2342 (require 'ibuf-ext)
2343 (setq ibuffer-filtering-qualifiers qualifiers))
2344 (when filter-groups
2345 (require 'ibuf-ext)
cba63a2d 2346 (setq ibuffer-filter-groups filter-groups))
fd225d80
CW
2347 (when formats
2348 (set (make-local-variable 'ibuffer-formats) formats))
b5cd37ea
CW
2349 (ibuffer-update nil)
2350 ;; Skip the group name by default.
2351 (ibuffer-forward-line 0 t)
25d2f683
CW
2352 (unwind-protect
2353 (progn
b5cd37ea 2354 (setq buffer-read-only nil)
7ad5b902 2355 (run-hooks 'ibuffer-hook))
b5cd37ea
CW
2356 (setq buffer-read-only t))
2357 (unless ibuffer-expert
2358 (message "Commands: m, u, t, RET, g, k, S, D, Q; q to quit; h for help"))))))
25d2f683 2359
b23af469 2360(put 'ibuffer-mode 'mode-class 'special)
25d2f683
CW
2361(defun ibuffer-mode ()
2362 "A major mode for viewing a list of buffers.
972b8f82 2363In Ibuffer, you can conveniently perform many operations on the
25d2f683
CW
2364currently open buffers, in addition to filtering your view to a
2365particular subset of them, and sorting by various criteria.
2366
2367Operations on marked buffers:
2368
2369 '\\[ibuffer-do-save]' - Save the marked buffers
2370 '\\[ibuffer-do-view]' - View the marked buffers in this frame.
2371 '\\[ibuffer-do-view-other-frame]' - View the marked buffers in another frame.
2372 '\\[ibuffer-do-revert]' - Revert the marked buffers.
2373 '\\[ibuffer-do-toggle-read-only]' - Toggle read-only state of marked buffers.
2374 '\\[ibuffer-do-delete]' - Kill the marked buffers.
2375 '\\[ibuffer-do-replace-regexp]' - Replace by regexp in each of the marked
2376 buffers.
2377 '\\[ibuffer-do-query-replace]' - Query replace in each of the marked buffers.
2378 '\\[ibuffer-do-query-replace-regexp]' - As above, with a regular expression.
2379 '\\[ibuffer-do-print]' - Print the marked buffers.
2380 '\\[ibuffer-do-occur]' - List lines in all marked buffers which match
2381 a given regexp (like the function `occur').
2382 '\\[ibuffer-do-shell-command-pipe]' - Pipe the contents of the marked
2383 buffers to a shell command.
2384 '\\[ibuffer-do-shell-command-pipe-replace]' - Replace the contents of the marked
2385 buffers with the output of a shell command.
2386 '\\[ibuffer-do-shell-command-file]' - Run a shell command with the
2387 buffer's file as an argument.
2388 '\\[ibuffer-do-eval]' - Evaluate a form in each of the marked buffers. This
2389 is a very flexible command. For example, if you want to make all
2390 of the marked buffers read only, try using (toggle-read-only 1) as
2391 the input form.
2392 '\\[ibuffer-do-view-and-eval]' - As above, but view each buffer while the form
2393 is evaluated.
2394 '\\[ibuffer-do-kill-lines]' - Remove the marked lines from the *Ibuffer* buffer,
2395 but don't kill the associated buffer.
2396 '\\[ibuffer-do-kill-on-deletion-marks]' - Kill all buffers marked for deletion.
2397
2398Marking commands:
2399
2400 '\\[ibuffer-mark-forward]' - Mark the buffer at point.
2401 '\\[ibuffer-toggle-marks]' - Unmark all currently marked buffers, and mark
2402 all unmarked buffers.
2403 '\\[ibuffer-unmark-forward]' - Unmark the buffer at point.
2404 '\\[ibuffer-unmark-backward]' - Unmark the buffer at point, and move to the
2405 previous line.
2406 '\\[ibuffer-unmark-all]' - Unmark all marked buffers.
2407 '\\[ibuffer-mark-by-mode]' - Mark buffers by major mode.
2408 '\\[ibuffer-mark-unsaved-buffers]' - Mark all \"unsaved\" buffers.
2409 This means that the buffer is modified, and has an associated file.
2410 '\\[ibuffer-mark-modified-buffers]' - Mark all modified buffers,
2411 regardless of whether or not they have an associated file.
2412 '\\[ibuffer-mark-special-buffers]' - Mark all buffers whose name begins and
2413 ends with '*'.
2414 '\\[ibuffer-mark-dissociated-buffers]' - Mark all buffers which have
2415 an associated file, but that file doesn't currently exist.
2416 '\\[ibuffer-mark-read-only-buffers]' - Mark all read-only buffers.
2417 '\\[ibuffer-mark-dired-buffers]' - Mark buffers in `dired' mode.
2418 '\\[ibuffer-mark-help-buffers]' - Mark buffers in `help-mode', `apropos-mode', etc.
2419 '\\[ibuffer-mark-old-buffers]' - Mark buffers older than `ibuffer-old-time'.
2420 '\\[ibuffer-mark-for-delete]' - Mark the buffer at point for deletion.
2421 '\\[ibuffer-mark-by-name-regexp]' - Mark buffers by their name, using a regexp.
2422 '\\[ibuffer-mark-by-mode-regexp]' - Mark buffers by their major mode, using a regexp.
2423 '\\[ibuffer-mark-by-file-name-regexp]' - Mark buffers by their filename, using a regexp.
2424
2425Filtering commands:
2426
2427 '\\[ibuffer-filter-by-mode]' - Add a filter by major mode.
5bc06df9 2428 '\\[ibuffer-filter-by-used-mode]' - Add a filter by major mode now in use.
25d2f683
CW
2429 '\\[ibuffer-filter-by-name]' - Add a filter by buffer name.
2430 '\\[ibuffer-filter-by-content]' - Add a filter by buffer content.
2431 '\\[ibuffer-filter-by-filename]' - Add a filter by filename.
2432 '\\[ibuffer-filter-by-size-gt]' - Add a filter by buffer size.
2433 '\\[ibuffer-filter-by-size-lt]' - Add a filter by buffer size.
2434 '\\[ibuffer-filter-by-predicate]' - Add a filter by an arbitrary Lisp predicate.
2435 '\\[ibuffer-save-filters]' - Save the current filters with a name.
2436 '\\[ibuffer-switch-to-saved-filters]' - Switch to previously saved filters.
2437 '\\[ibuffer-add-saved-filters]' - Add saved filters to current filters.
2438 '\\[ibuffer-or-filter]' - Replace the top two filters with their logical OR.
2439 '\\[ibuffer-pop-filter]' - Remove the top filter.
2440 '\\[ibuffer-negate-filter]' - Invert the logical sense of the top filter.
2441 '\\[ibuffer-decompose-filter]' - Break down the topmost filter.
2442 '\\[ibuffer-filter-disable]' - Remove all filtering currently in effect.
cba63a2d
CW
2443
2444Filter group commands:
2445
2446 '\\[ibuffer-filters-to-filter-group]' - Create filter group from filters.
2447 '\\[ibuffer-pop-filter-group]' - Remove top filter group.
b098e753
CW
2448 '\\[ibuffer-forward-filter-group]' - Move to the next filter group.
2449 '\\[ibuffer-backward-filter-group]' - Move to the previous filter group.
2450 '\\[ibuffer-clear-filter-groups]' - Remove all active filter groups.
2451 '\\[ibuffer-save-filter-groups]' - Save the current groups with a name.
2452 '\\[ibuffer-switch-to-saved-filter-groups]' - Restore previously saved groups.
2453 '\\[ibuffer-delete-saved-filter-groups]' - Delete previously saved groups.
71296446 2454
25d2f683
CW
2455Sorting commands:
2456
2457 '\\[ibuffer-toggle-sorting-mode]' - Rotate between the various sorting modes.
2458 '\\[ibuffer-invert-sorting]' - Reverse the current sorting order.
2459 '\\[ibuffer-do-sort-by-alphabetic]' - Sort the buffers lexicographically.
d5794180 2460 '\\[ibuffer-do-sort-by-filename/process]' - Sort the buffers by the file name.
25d2f683
CW
2461 '\\[ibuffer-do-sort-by-recency]' - Sort the buffers by last viewing time.
2462 '\\[ibuffer-do-sort-by-size]' - Sort the buffers by size.
2463 '\\[ibuffer-do-sort-by-major-mode]' - Sort the buffers by major mode.
2464
2465Other commands:
2466
4c38df30
JPW
2467 '\\[ibuffer-update]' - Regenerate the list of all buffers.
2468 Prefix arg means to toggle whether buffers that match
2469 `ibuffer-maybe-show-predicates' should be displayed.
2470
25d2f683
CW
2471 '\\[ibuffer-switch-format]' - Change the current display format.
2472 '\\[forward-line]' - Move point to the next line.
2473 '\\[previous-line]' - Move point to the previous line.
25d2f683
CW
2474 '\\[ibuffer-quit]' - Bury the Ibuffer buffer.
2475 '\\[describe-mode]' - This help.
2476 '\\[ibuffer-diff-with-file]' - View the differences between this buffer
2477 and its associated file.
2478 '\\[ibuffer-visit-buffer]' - View the buffer on this line.
2479 '\\[ibuffer-visit-buffer-other-window]' - As above, but in another window.
2480 '\\[ibuffer-visit-buffer-other-window-noselect]' - As both above, but don't select
2481 the new window.
2482 '\\[ibuffer-bury-buffer]' - Bury (not kill!) the buffer on this line.
2483
cba63a2d 2484** Information on Filtering:
25d2f683
CW
2485
2486 You can filter your ibuffer view via different critera. Each Ibuffer
2487buffer has its own stack of active filters. For example, suppose you
2488are working on an Emacs Lisp project. You can create an Ibuffer
2489buffer displays buffers in just `emacs-lisp' modes via
2490'\\[ibuffer-filter-by-mode] emacs-lisp-mode RET'. In this case, there
2491is just one entry on the filtering stack.
2492
2493You can also combine filters. The various filtering commands push a
2494new filter onto the stack, and the filters combine to show just
2495buffers which satisfy ALL criteria on the stack. For example, suppose
2496you only want to see buffers in `emacs-lisp' mode, whose names begin
2497with \"gnus\". You can accomplish this via:
2498'\\[ibuffer-filter-by-mode] emacs-lisp-mode RET
2499\\[ibuffer-filter-by-name] ^gnus RET'.
2500
2501Additionally, you can OR the top two filters together with
2502'\\[ibuffer-or-filters]'. To see all buffers in either
2503`emacs-lisp-mode' or `lisp-interaction-mode', type:
2504
2505'\\[ibuffer-filter-by-mode] emacs-lisp-mode RET \\[ibuffer-filter-by-mode] lisp-interaction-mode RET \\[ibuffer-or-filters]'.
2506
2507Filters can also be saved and restored using mnemonic names: see the
2508functions `ibuffer-save-filters' and `ibuffer-switch-to-saved-filters'.
2509
2510To remove the top filter on the stack, use '\\[ibuffer-pop-filter]', and
2511to disable all filtering currently in effect, use
cba63a2d
CW
2512'\\[ibuffer-filter-disable]'.
2513
2514** Filter Groups:
2515
2516Once one has mastered filters, the next logical step up is \"filter
2517groups\". A filter group is basically a named group of buffers which
2518match a filter, which are displayed together in an Ibuffer buffer. To
2519create a filter group, simply use the regular functions to create a
2520filter, and then type '\\[ibuffer-filters-to-filter-group]'.
2521
2522A quick example will make things clearer. Suppose that one wants to
2523group all of one's Emacs Lisp buffers together. To do this, type
2524
2525'\\[ibuffer-filter-by-mode] emacs-lisp-mode RET \\[ibuffer-filters-to-filter-group] RET emacs lisp buffers RET'
2526
2527You may, of course, name the group whatever you want; it doesn't have
2528to be \"emacs lisp buffers\". Filter groups may be composed of any
2529arbitrary combination of filters.
2530
2531Just like filters themselves, filter groups act as a stack. Buffers
2532will not be displayed multiple times if they would be included in
2533multiple filter groups; instead, the first filter group is used. The
2534filter groups are displayed in this order of precedence.
2535
2536You may rearrange filter groups by using the regular
2537'\\[ibuffer-kill-line]' and '\\[ibuffer-yank]' pair. Yanked groups
2538will be inserted before the group at point."
25d2f683
CW
2539 (kill-all-local-variables)
2540 (use-local-map ibuffer-mode-map)
2541 (setq major-mode 'ibuffer-mode)
2542 (setq mode-name "Ibuffer")
23eabff6 2543 ;; Include state info next to the mode name.
e47b4224 2544 (set (make-local-variable 'mode-line-process)
56618a0a
SM
2545 '(" by "
2546 (ibuffer-sorting-mode (:eval (symbol-name ibuffer-sorting-mode))
23eabff6
SM
2547 "view time")
2548 (ibuffer-sorting-reversep " [rev]")
2549 (ibuffer-auto-mode " (Auto)")
2550 ;; Only list the filters if they're not already in the header-line.
2551 (header-line-format
2552 ""
2553 (:eval (if (functionp 'ibuffer-format-qualifier)
2554 (mapconcat 'ibuffer-format-qualifier
2555 ibuffer-filtering-qualifiers ""))))))
6d11a78b
SM
2556 ;; `ibuffer-update' puts this on header-line-format when needed.
2557 (setq ibuffer-header-line-format
2558 ;; Display the part that won't be in the mode-line.
2559 (list* "" mode-name
2560 (mapcar (lambda (elem)
2561 (if (eq (car-safe elem) 'header-line-format)
2562 (nth 2 elem) elem))
2563 mode-line-process)))
23eabff6 2564
25d2f683
CW
2565 (setq buffer-read-only t)
2566 (buffer-disable-undo)
3eda3649 2567 (setq truncate-lines ibuffer-truncate-lines)
25d2f683
CW
2568 ;; This makes things less ugly for Emacs 21 users with a non-nil
2569 ;; `show-trailing-whitespace'.
2570 (setq show-trailing-whitespace nil)
4ba16127
JPW
2571 ;; disable `show-paren-mode' buffer-locally
2572 (if (bound-and-true-p show-paren-mode)
2573 (set (make-local-variable 'show-paren-mode) nil))
25d2f683
CW
2574 (set (make-local-variable 'revert-buffer-function)
2575 #'ibuffer-update)
2576 (set (make-local-variable 'ibuffer-sorting-mode)
2577 ibuffer-default-sorting-mode)
2578 (set (make-local-variable 'ibuffer-sorting-reversep)
2579 ibuffer-default-sorting-reversep)
2580 (set (make-local-variable 'ibuffer-shrink-to-minimum-size)
2581 ibuffer-default-shrink-to-minimum-size)
957237cb
JPW
2582 (set (make-local-variable 'ibuffer-display-maybe-show-predicates)
2583 ibuffer-default-display-maybe-show-predicates)
25d2f683 2584 (set (make-local-variable 'ibuffer-filtering-qualifiers) nil)
cba63a2d
CW
2585 (set (make-local-variable 'ibuffer-filter-groups) nil)
2586 (set (make-local-variable 'ibuffer-filter-group-kill-ring) nil)
2587 (set (make-local-variable 'ibuffer-hidden-filter-groups) nil)
25d2f683
CW
2588 (set (make-local-variable 'ibuffer-compiled-formats) nil)
2589 (set (make-local-variable 'ibuffer-cached-formats) nil)
2590 (set (make-local-variable 'ibuffer-cached-eliding-string) nil)
2591 (set (make-local-variable 'ibuffer-cached-elide-long-columns) nil)
2592 (set (make-local-variable 'ibuffer-current-format) nil)
4ed1f829 2593 (set (make-local-variable 'ibuffer-restore-window-config-on-quit) nil)
25d2f683 2594 (set (make-local-variable 'ibuffer-did-modification) nil)
b5cd37ea
CW
2595 (set (make-local-variable 'ibuffer-tmp-hide-regexps) nil)
2596 (set (make-local-variable 'ibuffer-tmp-show-regexps) nil)
25d2f683
CW
2597 (define-key ibuffer-mode-map [menu-bar edit] 'undefined)
2598 (define-key ibuffer-mode-map [menu-bar operate] (cons "Operate" ibuffer-mode-operate-map))
2599 (ibuffer-update-format)
2600 (when ibuffer-default-directory
2601 (setq default-directory ibuffer-default-directory))
214fee7a 2602 (add-hook 'change-major-mode-hook 'font-lock-defontify nil t)
23eabff6 2603 (run-mode-hooks 'ibuffer-mode-hook))
25d2f683
CW
2604
2605(provide 'ibuffer)
2606
4e4a724c
JPW
2607(run-hooks 'ibuffer-load-hook)
2608
25d2f683
CW
2609;; Local Variables:
2610;; coding: iso-8859-1
2611;; End:
2612
23eabff6 2613;; arch-tag: 72581688-0603-4954-b8cf-837c700f62e8
25d2f683 2614;;; ibuffer.el ends here