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