]> code.delx.au - gnu-emacs/blob - lisp/ibuf-ext.el
*** empty log message ***
[gnu-emacs] / lisp / ibuf-ext.el
1 ;;; ibuf-ext.el --- extensions for ibuffer
2
3 ;; Copyright (C) 2000, 2001, 2002, 2003, 2004,
4 ;; 2005, 2006, 2007, 2008 Free Software Foundation, Inc.
5
6 ;; Author: Colin Walters <walters@verbum.org>
7 ;; Maintainer: John Paul Wallington <jpw@gnu.org>
8 ;; Created: 2 Dec 2001
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 3, 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 ;; These functions should be automatically loaded when called, but you
31 ;; can explicity (require 'ibuf-ext) in your ~/.emacs to have them
32 ;; preloaded.
33
34 ;;; Code:
35
36 (require 'ibuffer)
37
38 (eval-when-compile
39 (require 'ibuf-macs)
40 (require 'cl))
41
42 ;;; Utility functions
43 (defun ibuffer-delete-alist (key alist)
44 "Delete all entries in ALIST that have a key equal to KEY."
45 (let (entry)
46 (while (setq entry (assoc key alist))
47 (setq alist (delete entry alist)))
48 alist))
49
50 ;; borrowed from Gnus
51 (defun ibuffer-remove-duplicates (list)
52 "Return a copy of LIST with duplicate elements removed."
53 (let ((new nil)
54 (tail list))
55 (while tail
56 (or (member (car tail) new)
57 (setq new (cons (car tail) new)))
58 (setq tail (cdr tail)))
59 (nreverse new)))
60
61 (defun ibuffer-split-list (ibuffer-split-list-fn ibuffer-split-list-elts)
62 (let ((hip-crowd nil)
63 (lamers nil))
64 (dolist (ibuffer-split-list-elt ibuffer-split-list-elts)
65 (if (funcall ibuffer-split-list-fn ibuffer-split-list-elt)
66 (push ibuffer-split-list-elt hip-crowd)
67 (push ibuffer-split-list-elt lamers)))
68 ;; Too bad Emacs Lisp doesn't have multiple values.
69 (list (nreverse hip-crowd) (nreverse lamers))))
70
71 (defcustom ibuffer-never-show-predicates nil
72 "A list of predicates (a regexp or function) for buffers not to display.
73 If a regexp, then it will be matched against the buffer's name.
74 If a function, it will be called with the buffer as an argument, and
75 should return non-nil if this buffer should not be shown."
76 :type '(repeat (choice regexp function))
77 :require 'ibuf-ext
78 :group 'ibuffer)
79
80 (defcustom ibuffer-always-show-predicates nil
81 "A list of predicates (a regexp or function) for buffers to always display.
82 If a regexp, then it will be matched against the buffer's name.
83 If a function, it will be called with the buffer as an argument, and
84 should return non-nil if this buffer should be shown.
85 Note that buffers matching one of these predicates will be shown
86 regardless of any active filters in this buffer."
87 :type '(repeat (choice regexp function))
88 :group 'ibuffer)
89
90 (defvar ibuffer-tmp-hide-regexps nil
91 "A list of regexps which should match buffer names to not show.")
92
93 (defvar ibuffer-tmp-show-regexps nil
94 "A list of regexps which should match buffer names to always show.")
95
96 (defvar ibuffer-auto-mode nil
97 "If non-nil, Ibuffer auto-mode should be enabled for this buffer.
98 Do not set this variable directly! Use the function
99 `ibuffer-auto-mode' instead.")
100
101 (defvar ibuffer-auto-buffers-changed nil)
102
103 (defcustom ibuffer-saved-filters '(("gnus"
104 ((or (mode . message-mode)
105 (mode . mail-mode)
106 (mode . gnus-group-mode)
107 (mode . gnus-summary-mode)
108 (mode . gnus-article-mode))))
109 ("programming"
110 ((or (mode . emacs-lisp-mode)
111 (mode . cperl-mode)
112 (mode . c-mode)
113 (mode . java-mode)
114 (mode . idl-mode)
115 (mode . lisp-mode)))))
116
117 "An alist of filter qualifiers to switch between.
118
119 This variable should look like ((\"STRING\" QUALIFIERS)
120 (\"STRING\" QUALIFIERS) ...), where
121 QUALIFIERS is a list of the same form as
122 `ibuffer-filtering-qualifiers'.
123 See also the variables `ibuffer-filtering-qualifiers',
124 `ibuffer-filtering-alist', and the functions
125 `ibuffer-switch-to-saved-filters', `ibuffer-save-filters'."
126 :type '(repeat sexp)
127 :group 'ibuffer)
128
129 (defvar ibuffer-filtering-qualifiers nil
130 "A list like (SYMBOL . QUALIFIER) which filters the current buffer list.
131 See also `ibuffer-filtering-alist'.")
132
133 ;; This is now frobbed by `define-ibuffer-filter'.
134 (defvar ibuffer-filtering-alist nil
135 "An alist of (SYMBOL DESCRIPTION FUNCTION) which describes a filter.
136
137 You most likely do not want to modify this variable directly; see
138 `define-ibuffer-filter'.
139
140 SYMBOL is the symbolic name of the filter. DESCRIPTION is used when
141 displaying information to the user. FUNCTION is given a buffer and
142 the value of the qualifier, and returns non-nil if and only if the
143 buffer should be displayed.")
144
145 (defcustom ibuffer-filter-format-alist nil
146 "An alist which has special formats used when a filter is active.
147 The contents of this variable should look like:
148 ((FILTER (FORMAT FORMAT ...)) (FILTER (FORMAT FORMAT ...)) ...)
149
150 For example, suppose that when you add a filter for buffers whose
151 major mode is `emacs-lisp-mode', you only want to see the mark and the
152 name of the buffer. You could accomplish that by adding:
153 (mode ((mark \" \" name)))
154 to this variable."
155 :type '(repeat (list :tag "Association" (symbol :tag "Filter")
156 (list :tag "Formats" (repeat (sexp :tag "Format")))))
157 :group 'ibuffer)
158
159 (defvar ibuffer-cached-filter-formats nil)
160 (defvar ibuffer-compiled-filter-formats nil)
161
162 (defvar ibuffer-filter-groups nil
163 "A list like ((\"NAME\" ((SYMBOL . QUALIFIER) ...) ...) which groups buffers.
164 The SYMBOL should be one from `ibuffer-filtering-alist'.
165 The QUALIFIER should be the same as QUALIFIER in
166 `ibuffer-filtering-qualifiers'.")
167
168 (defcustom ibuffer-show-empty-filter-groups t
169 "If non-nil, then show the names of filter groups which are empty."
170 :type 'boolean
171 :group 'ibuffer)
172
173 (defcustom ibuffer-saved-filter-groups nil
174 "An alist of filtering groups to switch between.
175
176 This variable should look like ((\"STRING\" QUALIFIERS)
177 (\"STRING\" QUALIFIERS) ...), where
178 QUALIFIERS is a list of the same form as
179 `ibuffer-filtering-qualifiers'.
180
181 See also the variables `ibuffer-filter-groups',
182 `ibuffer-filtering-qualifiers', `ibuffer-filtering-alist', and the
183 functions `ibuffer-switch-to-saved-filter-groups',
184 `ibuffer-save-filter-groups'."
185 :type '(repeat sexp)
186 :group 'ibuffer)
187
188 (defvar ibuffer-hidden-filter-groups nil
189 "A list of filtering groups which are currently hidden.")
190
191 (defvar ibuffer-filter-group-kill-ring nil)
192
193 (defcustom ibuffer-old-time 72
194 "The number of hours before a buffer is considered \"old\"."
195 :type '(choice (const :tag "72 hours (3 days)" 72)
196 (const :tag "48 hours (2 days)" 48)
197 (const :tag "24 hours (1 day)" 24)
198 (integer :tag "hours"))
199 :group 'ibuffer)
200
201 (defcustom ibuffer-save-with-custom t
202 "If non-nil, then use Custom to save interactively changed variables.
203 Currently, this only applies to `ibuffer-saved-filters' and
204 `ibuffer-saved-filter-groups'."
205 :type 'boolean
206 :group 'ibuffer)
207
208 (defun ibuffer-ext-visible-p (buf all &optional ibuffer-buf)
209 (or
210 (ibuffer-buf-matches-predicates buf ibuffer-tmp-show-regexps)
211 (and (not
212 (or
213 (ibuffer-buf-matches-predicates buf ibuffer-tmp-hide-regexps)
214 (ibuffer-buf-matches-predicates buf ibuffer-never-show-predicates)))
215 (or all
216 (not
217 (ibuffer-buf-matches-predicates buf ibuffer-maybe-show-predicates)))
218 (or ibuffer-view-ibuffer
219 (and ibuffer-buf
220 (not (eq ibuffer-buf buf))))
221 (or
222 (ibuffer-included-in-filters-p buf ibuffer-filtering-qualifiers)
223 (ibuffer-buf-matches-predicates buf ibuffer-always-show-predicates)))))
224
225 (defun ibuffer-auto-update-changed ()
226 (when (frame-or-buffer-changed-p 'ibuffer-auto-buffers-changed)
227 (mapcar #'(lambda (buf)
228 (ignore-errors
229 (with-current-buffer buf
230 (when (and ibuffer-auto-mode
231 (eq major-mode 'ibuffer-mode))
232 (ibuffer-update nil t)))))
233 (buffer-list))))
234
235 ;;;###autoload
236 (defun ibuffer-auto-mode (&optional arg)
237 "Toggle use of Ibuffer's auto-update facility.
238 With numeric ARG, enable auto-update if and only if ARG is positive."
239 (interactive)
240 (unless (eq major-mode 'ibuffer-mode)
241 (error "This buffer is not in Ibuffer mode"))
242 (set (make-local-variable 'ibuffer-auto-mode)
243 (if arg
244 (plusp arg)
245 (not ibuffer-auto-mode)))
246 (frame-or-buffer-changed-p 'ibuffer-auto-buffers-changed)
247 (add-hook 'post-command-hook 'ibuffer-auto-update-changed)
248 (ibuffer-update-mode-name))
249
250 ;;;###autoload
251 (defun ibuffer-mouse-filter-by-mode (event)
252 "Enable or disable filtering by the major mode chosen via mouse."
253 (interactive "e")
254 (ibuffer-interactive-filter-by-mode event))
255
256 ;;;###autoload
257 (defun ibuffer-interactive-filter-by-mode (event-or-point)
258 "Enable or disable filtering by the major mode at point."
259 (interactive "d")
260 (if (eventp event-or-point)
261 (posn-set-point (event-end event-or-point))
262 (goto-char event-or-point))
263 (let ((buf (ibuffer-current-buffer)))
264 (if (assq 'mode ibuffer-filtering-qualifiers)
265 (setq ibuffer-filtering-qualifiers
266 (ibuffer-delete-alist 'mode ibuffer-filtering-qualifiers))
267 (ibuffer-push-filter (cons 'mode
268 (with-current-buffer buf
269 major-mode)))))
270 (ibuffer-update nil t))
271
272 ;;;###autoload
273 (defun ibuffer-mouse-toggle-filter-group (event)
274 "Toggle the display status of the filter group chosen with the mouse."
275 (interactive "e")
276 (ibuffer-toggle-filter-group-1 (save-excursion
277 (mouse-set-point event)
278 (point))))
279
280 ;;;###autoload
281 (defun ibuffer-toggle-filter-group ()
282 "Toggle the display status of the filter group on this line."
283 (interactive)
284 (ibuffer-toggle-filter-group-1 (point)))
285
286 (defun ibuffer-toggle-filter-group-1 (posn)
287 (let ((name (get-text-property posn 'ibuffer-filter-group-name)))
288 (unless (stringp name)
289 (error "No filtering group name present"))
290 (if (member name ibuffer-hidden-filter-groups)
291 (setq ibuffer-hidden-filter-groups
292 (delete name ibuffer-hidden-filter-groups))
293 (push name ibuffer-hidden-filter-groups))
294 (ibuffer-update nil t)))
295
296 ;;;###autoload
297 (defun ibuffer-forward-filter-group (&optional count)
298 "Move point forwards by COUNT filtering groups."
299 (interactive "P")
300 (unless count
301 (setq count 1))
302 (when (> count 0)
303 (when (get-text-property (point) 'ibuffer-filter-group-name)
304 (goto-char (next-single-property-change
305 (point) 'ibuffer-filter-group-name
306 nil (point-max))))
307 (goto-char (next-single-property-change
308 (point) 'ibuffer-filter-group-name
309 nil (point-max)))
310 (ibuffer-forward-filter-group (1- count)))
311 (ibuffer-forward-line 0))
312
313 ;;;###autoload
314 (defun ibuffer-backward-filter-group (&optional count)
315 "Move point backwards by COUNT filtering groups."
316 (interactive "P")
317 (unless count
318 (setq count 1))
319 (when (> count 0)
320 (when (get-text-property (point) 'ibuffer-filter-group-name)
321 (goto-char (previous-single-property-change
322 (point) 'ibuffer-filter-group-name
323 nil (point-min))))
324 (goto-char (previous-single-property-change
325 (point) 'ibuffer-filter-group-name
326 nil (point-min)))
327 (ibuffer-backward-filter-group (1- count)))
328 (when (= (point) (point-min))
329 (goto-char (point-max))
330 (ibuffer-backward-filter-group 1))
331 (ibuffer-forward-line 0))
332
333 ;;;###autoload (autoload 'ibuffer-do-shell-command-pipe "ibuf-ext")
334 (define-ibuffer-op shell-command-pipe (command)
335 "Pipe the contents of each marked buffer to shell command COMMAND."
336 (:interactive "sPipe to shell command: "
337 :opstring "Shell command executed on"
338 :modifier-p nil)
339 (shell-command-on-region
340 (point-min) (point-max) command
341 (get-buffer-create "* ibuffer-shell-output*")))
342
343 ;;;###autoload (autoload 'ibuffer-do-shell-command-pipe-replace "ibuf-ext")
344 (define-ibuffer-op shell-command-pipe-replace (command)
345 "Replace the contents of marked buffers with output of pipe to COMMAND."
346 (:interactive "sPipe to shell command (replace): "
347 :opstring "Buffer contents replaced in"
348 :active-opstring "replace buffer contents in"
349 :dangerous t
350 :modifier-p t)
351 (with-current-buffer buf
352 (shell-command-on-region (point-min) (point-max)
353 command nil t)))
354
355 ;;;###autoload (autoload 'ibuffer-do-shell-command-file "ibuf-ext")
356 (define-ibuffer-op shell-command-file (command)
357 "Run shell command COMMAND separately on files of marked buffers."
358 (:interactive "sShell command on buffer's file: "
359 :opstring "Shell command executed on"
360 :modifier-p nil)
361 (shell-command (concat command " "
362 (shell-quote-argument
363 (if buffer-file-name
364 buffer-file-name
365 (make-temp-file
366 (substring (buffer-name) 0 (min 10 (length (buffer-name))))))))))
367
368 ;;;###autoload (autoload 'ibuffer-do-eval "ibuf-ext")
369 (define-ibuffer-op eval (form)
370 "Evaluate FORM in each of the buffers.
371 Does not display the buffer during evaluation. See
372 `ibuffer-do-view-and-eval' for that."
373 (:interactive
374 (list
375 (read-from-minibuffer
376 "Eval in buffers (form): "
377 nil read-expression-map t 'read-expression-history))
378 :opstring "evaluated in"
379 :modifier-p :maybe)
380 (eval form))
381
382 ;;;###autoload (autoload 'ibuffer-do-view-and-eval "ibuf-ext")
383 (define-ibuffer-op view-and-eval (form)
384 "Evaluate FORM while displaying each of the marked buffers.
385 To evaluate a form without viewing the buffer, see `ibuffer-do-eval'."
386 (:interactive
387 (list
388 (read-from-minibuffer
389 "Eval viewing in buffers (form): "
390 nil read-expression-map t 'read-expression-history))
391 :opstring "evaluated in"
392 :complex t
393 :modifier-p :maybe)
394 (let ((ibuffer-buf (current-buffer)))
395 (unwind-protect
396 (progn
397 (switch-to-buffer buf)
398 (eval form))
399 (switch-to-buffer ibuffer-buf))))
400
401 ;;;###autoload (autoload 'ibuffer-do-rename-uniquely "ibuf-ext")
402 (define-ibuffer-op rename-uniquely ()
403 "Rename marked buffers as with `rename-uniquely'."
404 (:opstring "renamed"
405 :modifier-p t)
406 (rename-uniquely))
407
408 ;;;###autoload (autoload 'ibuffer-do-revert "ibuf-ext")
409 (define-ibuffer-op revert ()
410 "Revert marked buffers as with `revert-buffer'."
411 (:dangerous t
412 :opstring "reverted"
413 :active-opstring "revert"
414 :modifier-p :maybe)
415 (revert-buffer t t))
416
417 ;;;###autoload (autoload 'ibuffer-do-replace-regexp "ibuf-ext")
418 (define-ibuffer-op replace-regexp (from-str to-str)
419 "Perform a `replace-regexp' in marked buffers."
420 (:interactive
421 (let* ((from-str (read-from-minibuffer "Replace regexp: "))
422 (to-str (read-from-minibuffer (concat "Replace " from-str
423 " with: "))))
424 (list from-str to-str))
425 :opstring "replaced in"
426 :complex t
427 :modifier-p :maybe)
428 (save-window-excursion
429 (switch-to-buffer buf)
430 (save-excursion
431 (goto-char (point-min))
432 (let ((case-fold-search ibuffer-case-fold-search))
433 (while (re-search-forward from-str nil t)
434 (replace-match to-str))))
435 t))
436
437 ;;;###autoload (autoload 'ibuffer-do-query-replace "ibuf-ext")
438 (define-ibuffer-op query-replace (&rest args)
439 "Perform a `query-replace' in marked buffers."
440 (:interactive
441 (query-replace-read-args "Query replace" t t)
442 :opstring "replaced in"
443 :complex t
444 :modifier-p :maybe)
445 (save-window-excursion
446 (switch-to-buffer buf)
447 (save-excursion
448 (let ((case-fold-search ibuffer-case-fold-search))
449 (goto-char (point-min))
450 (apply #'query-replace args)))
451 t))
452
453 ;;;###autoload (autoload 'ibuffer-do-query-replace-regexp "ibuf-ext")
454 (define-ibuffer-op query-replace-regexp (&rest args)
455 "Perform a `query-replace-regexp' in marked buffers."
456 (:interactive
457 (query-replace-read-args "Query replace regexp" t t)
458 :opstring "replaced in"
459 :complex t
460 :modifier-p :maybe)
461 (save-window-excursion
462 (switch-to-buffer buf)
463 (save-excursion
464 (let ((case-fold-search ibuffer-case-fold-search))
465 (goto-char (point-min))
466 (apply #'query-replace-regexp args)))
467 t))
468
469 ;;;###autoload (autoload 'ibuffer-do-print "ibuf-ext")
470 (define-ibuffer-op print ()
471 "Print marked buffers as with `print-buffer'."
472 (:opstring "printed"
473 :modifier-p nil)
474 (print-buffer))
475
476 ;;;###autoload
477 (defun ibuffer-included-in-filters-p (buf filters)
478 (not
479 (memq nil ;; a filter will return nil if it failed
480 (mapcar
481 ;; filter should be like (TYPE . QUALIFIER), or
482 ;; (or (TYPE . QUALIFIER) (TYPE . QUALIFIER) ...)
483 #'(lambda (qual)
484 (ibuffer-included-in-filter-p buf qual))
485 filters))))
486
487 (defun ibuffer-included-in-filter-p (buf filter)
488 (if (eq (car filter) 'not)
489 (not (ibuffer-included-in-filter-p-1 buf (cdr filter)))
490 (ibuffer-included-in-filter-p-1 buf filter)))
491
492 (defun ibuffer-included-in-filter-p-1 (buf filter)
493 (not
494 (not
495 (case (car filter)
496 (or
497 (memq t (mapcar #'(lambda (x)
498 (ibuffer-included-in-filter-p buf x))
499 (cdr filter))))
500 (saved
501 (let ((data
502 (assoc (cdr filter)
503 ibuffer-saved-filters)))
504 (unless data
505 (ibuffer-filter-disable)
506 (error "Unknown saved filter %s" (cdr filter)))
507 (ibuffer-included-in-filters-p buf (cadr data))))
508 (t
509 (let ((filterdat (assq (car filter)
510 ibuffer-filtering-alist)))
511 ;; filterdat should be like (TYPE DESCRIPTION FUNC)
512 ;; just a sanity check
513 (unless filterdat
514 (ibuffer-filter-disable)
515 (error "Undefined filter %s" (car filter)))
516 (not
517 (not
518 (funcall (caddr filterdat)
519 buf
520 (cdr filter))))))))))
521
522 (defun ibuffer-generate-filter-groups (bmarklist &optional noempty nodefault)
523 (let ((filter-group-alist (if nodefault
524 ibuffer-filter-groups
525 (append ibuffer-filter-groups
526 (list (cons "Default" nil))))))
527 ;; (dolist (hidden ibuffer-hidden-filter-groups)
528 ;; (setq filter-group-alist (ibuffer-delete-alist
529 ;; hidden filter-group-alist)))
530 (let ((vec (make-vector (length filter-group-alist) nil))
531 (i 0))
532 (dolist (filtergroup filter-group-alist)
533 (let ((filterset (cdr filtergroup)))
534 (multiple-value-bind (hip-crowd lamers)
535 (ibuffer-split-list (lambda (bufmark)
536 (ibuffer-included-in-filters-p (car bufmark)
537 filterset))
538 bmarklist)
539 (aset vec i hip-crowd)
540 (incf i)
541 (setq bmarklist lamers))))
542 (let (ret)
543 (dotimes (j i ret)
544 (let ((bufs (aref vec j)))
545 (unless (and noempty (null bufs))
546 (push (cons (car (nth j filter-group-alist))
547 bufs)
548 ret))))))))
549
550 ;;;###autoload
551 (defun ibuffer-filters-to-filter-group (name)
552 "Make the current filters into a filtering group."
553 (interactive "sName for filtering group: ")
554 (when (null ibuffer-filtering-qualifiers)
555 (error "No filters in effect"))
556 (push (cons name ibuffer-filtering-qualifiers) ibuffer-filter-groups)
557 (ibuffer-filter-disable))
558
559 ;;;###autoload
560 (defun ibuffer-set-filter-groups-by-mode ()
561 "Set the current filter groups to filter by mode."
562 (interactive)
563 (setq ibuffer-filter-groups
564 (mapcar (lambda (mode)
565 (cons (format "%s" mode) `((mode . ,mode))))
566 (let ((modes
567 (ibuffer-remove-duplicates
568 (mapcar (lambda (buf)
569 (with-current-buffer buf major-mode))
570 (buffer-list)))))
571 (if ibuffer-view-ibuffer
572 modes
573 (delq 'ibuffer-mode modes)))))
574 (ibuffer-update nil t))
575
576 ;;;###autoload
577 (defun ibuffer-pop-filter-group ()
578 "Remove the first filter group."
579 (interactive)
580 (when (null ibuffer-filter-groups)
581 (error "No filter groups active"))
582 (setq ibuffer-hidden-filter-groups
583 (delete (pop ibuffer-filter-groups)
584 ibuffer-hidden-filter-groups))
585 (ibuffer-update nil t))
586
587 (defun ibuffer-read-filter-group-name (msg &optional nodefault noerror)
588 (when (and (not noerror) (null ibuffer-filter-groups))
589 (error "No filter groups active"))
590 ;; `ibuffer-generate-filter-groups' returns all non-hidden filter
591 ;; groups, possibly excluding empty groups or Default.
592 ;; We add `ibuffer-hidden-filter-groups' to the list, excluding
593 ;; Default if necessary.
594 (completing-read msg (nconc
595 (ibuffer-generate-filter-groups
596 (ibuffer-current-state-list)
597 (not ibuffer-show-empty-filter-groups)
598 nodefault)
599 (if nodefault
600 (remove "Default" ibuffer-hidden-filter-groups)
601 ibuffer-hidden-filter-groups))
602 nil t))
603
604 ;;;###autoload
605 (defun ibuffer-decompose-filter-group (group)
606 "Decompose the filter group GROUP into active filters."
607 (interactive
608 (list (ibuffer-read-filter-group-name "Decompose filter group: " t)))
609 (let ((data (cdr (assoc group ibuffer-filter-groups))))
610 (setq ibuffer-filter-groups (ibuffer-delete-alist
611 group ibuffer-filter-groups)
612 ibuffer-filtering-qualifiers data))
613 (ibuffer-update nil t))
614
615 ;;;###autoload
616 (defun ibuffer-clear-filter-groups ()
617 "Remove all filter groups."
618 (interactive)
619 (setq ibuffer-filter-groups nil
620 ibuffer-hidden-filter-groups nil)
621 (ibuffer-update nil t))
622
623 (defun ibuffer-current-filter-groups-with-position ()
624 (save-excursion
625 (goto-char (point-min))
626 (let ((pos nil)
627 (result nil))
628 (while (and (not (eobp))
629 (setq pos (next-single-property-change
630 (point) 'ibuffer-filter-group-name)))
631 (goto-char pos)
632 (push (cons (get-text-property (point) 'ibuffer-filter-group-name)
633 pos)
634 result)
635 (goto-char (next-single-property-change
636 pos 'ibuffer-filter-group-name)))
637 (nreverse result))))
638
639 ;;;###autoload
640 (defun ibuffer-jump-to-filter-group (name)
641 "Move point to the filter group whose name is NAME."
642 (interactive
643 (list (ibuffer-read-filter-group-name "Jump to filter group: ")))
644 (ibuffer-aif (assoc name (ibuffer-current-filter-groups-with-position))
645 (goto-char (cdr it))
646 (error "No filter group with name %s" name)))
647
648 ;;;###autoload
649 (defun ibuffer-kill-filter-group (name)
650 "Kill the filter group named NAME.
651 The group will be added to `ibuffer-filter-group-kill-ring'."
652 (interactive (list (ibuffer-read-filter-group-name "Kill filter group: " t)))
653 (when (equal name "Default")
654 (error "Can't kill default filter group"))
655 (ibuffer-aif (assoc name ibuffer-filter-groups)
656 (progn
657 (push (copy-tree it) ibuffer-filter-group-kill-ring)
658 (setq ibuffer-filter-groups (ibuffer-delete-alist
659 name ibuffer-filter-groups))
660 (setq ibuffer-hidden-filter-groups
661 (delete name ibuffer-hidden-filter-groups)))
662 (error "No filter group with name \"%s\"" name))
663 (ibuffer-update nil t))
664
665 ;;;###autoload
666 (defun ibuffer-kill-line (&optional arg interactive-p)
667 "Kill the filter group at point.
668 See also `ibuffer-kill-filter-group'."
669 (interactive "P\np")
670 (ibuffer-aif (save-excursion
671 (ibuffer-forward-line 0)
672 (get-text-property (point) 'ibuffer-filter-group-name))
673 (progn
674 (ibuffer-kill-filter-group it))
675 (funcall (if interactive-p #'call-interactively #'funcall)
676 #'kill-line arg)))
677
678 (defun ibuffer-insert-filter-group-before (newgroup group)
679 (let* ((found nil)
680 (pos (let ((groups (mapcar #'car ibuffer-filter-groups))
681 (res 0))
682 (while groups
683 (if (equal (car groups) group)
684 (setq found t
685 groups nil)
686 (incf res)
687 (setq groups (cdr groups))))
688 res)))
689 (cond ((not found)
690 (setq ibuffer-filter-groups
691 (nconc ibuffer-filter-groups (list newgroup))))
692 ((zerop pos)
693 (push newgroup ibuffer-filter-groups))
694 (t
695 (let ((cell (nthcdr pos ibuffer-filter-groups)))
696 (setf (cdr cell) (cons (car cell) (cdr cell)))
697 (setf (car cell) newgroup))))))
698
699 ;;;###autoload
700 (defun ibuffer-yank ()
701 "Yank the last killed filter group before group at point."
702 (interactive)
703 (ibuffer-yank-filter-group
704 (or (get-text-property (point) 'ibuffer-filter-group-name)
705 (get-text-property (point) 'ibuffer-filter-group)
706 (error "No filter group at point"))))
707
708 ;;;###autoload
709 (defun ibuffer-yank-filter-group (name)
710 "Yank the last killed filter group before group named NAME."
711 (interactive (list (ibuffer-read-filter-group-name
712 "Yank filter group before group: ")))
713 (unless ibuffer-filter-group-kill-ring
714 (error "The Ibuffer filter group kill-ring is empty"))
715 (save-excursion
716 (ibuffer-forward-line 0)
717 (ibuffer-insert-filter-group-before (pop ibuffer-filter-group-kill-ring)
718 name))
719 (ibuffer-update nil t))
720
721 ;;;###autoload
722 (defun ibuffer-save-filter-groups (name groups)
723 "Save all active filter groups GROUPS as NAME.
724 They are added to `ibuffer-saved-filter-groups'. Interactively,
725 prompt for NAME, and use the current filters."
726 (interactive
727 (if (null ibuffer-filter-groups)
728 (error "No filter groups active")
729 (list
730 (read-from-minibuffer "Save current filter groups as: ")
731 ibuffer-filter-groups)))
732 (ibuffer-aif (assoc name ibuffer-saved-filter-groups)
733 (setcdr it groups)
734 (push (cons name groups) ibuffer-saved-filter-groups))
735 (ibuffer-maybe-save-stuff)
736 (ibuffer-update-mode-name))
737
738 ;;;###autoload
739 (defun ibuffer-delete-saved-filter-groups (name)
740 "Delete saved filter groups with NAME.
741 They are removed from `ibuffer-saved-filter-groups'."
742 (interactive
743 (list
744 (if (null ibuffer-saved-filter-groups)
745 (error "No saved filter groups")
746 (completing-read "Delete saved filter group: "
747 ibuffer-saved-filter-groups nil t))))
748 (setq ibuffer-saved-filter-groups
749 (ibuffer-delete-alist name ibuffer-saved-filter-groups))
750 (ibuffer-maybe-save-stuff)
751 (ibuffer-update nil t))
752
753 ;;;###autoload
754 (defun ibuffer-switch-to-saved-filter-groups (name)
755 "Set this buffer's filter groups to saved version with NAME.
756 The value from `ibuffer-saved-filter-groups' is used."
757 (interactive
758 (list
759 (if (null ibuffer-saved-filter-groups)
760 (error "No saved filters")
761 (completing-read "Switch to saved filter group: "
762 ibuffer-saved-filter-groups nil t))))
763 (setq ibuffer-filter-groups (cdr (assoc name ibuffer-saved-filter-groups))
764 ibuffer-hidden-filter-groups nil)
765 (ibuffer-update nil t))
766
767 ;;;###autoload
768 (defun ibuffer-filter-disable ()
769 "Disable all filters currently in effect in this buffer."
770 (interactive)
771 (setq ibuffer-filtering-qualifiers nil)
772 (let ((buf (ibuffer-current-buffer)))
773 (ibuffer-update nil t)
774 (when buf
775 (ibuffer-jump-to-buffer (buffer-name buf)))))
776
777 ;;;###autoload
778 (defun ibuffer-pop-filter ()
779 "Remove the top filter in this buffer."
780 (interactive)
781 (when (null ibuffer-filtering-qualifiers)
782 (error "No filters in effect"))
783 (pop ibuffer-filtering-qualifiers)
784 (let ((buf (ibuffer-current-buffer)))
785 (ibuffer-update nil t)
786 (when buf
787 (ibuffer-jump-to-buffer (buffer-name buf)))))
788
789 (defun ibuffer-push-filter (qualifier)
790 "Add QUALIFIER to `ibuffer-filtering-qualifiers'."
791 (push qualifier ibuffer-filtering-qualifiers))
792
793 ;;;###autoload
794 (defun ibuffer-decompose-filter ()
795 "Separate the top compound filter (OR, NOT, or SAVED) in this buffer.
796
797 This means that the topmost filter on the filtering stack, which must
798 be a complex filter like (OR [name: foo] [mode: bar-mode]), will be
799 turned into two separate filters [name: foo] and [mode: bar-mode]."
800 (interactive)
801 (when (null ibuffer-filtering-qualifiers)
802 (error "No filters in effect"))
803 (let ((lim (pop ibuffer-filtering-qualifiers)))
804 (case (car lim)
805 (or
806 (setq ibuffer-filtering-qualifiers (append
807 (cdr lim)
808 ibuffer-filtering-qualifiers)))
809 (saved
810 (let ((data
811 (assoc (cdr lim)
812 ibuffer-saved-filters)))
813 (unless data
814 (ibuffer-filter-disable)
815 (error "Unknown saved filter %s" (cdr lim)))
816 (setq ibuffer-filtering-qualifiers (append
817 (cadr data)
818 ibuffer-filtering-qualifiers))))
819 (not
820 (push (cdr lim)
821 ibuffer-filtering-qualifiers))
822 (t
823 (error "Filter type %s is not compound" (car lim)))))
824 (ibuffer-update nil t))
825
826 ;;;###autoload
827 (defun ibuffer-exchange-filters ()
828 "Exchange the top two filters on the stack in this buffer."
829 (interactive)
830 (when (< (length ibuffer-filtering-qualifiers)
831 2)
832 (error "Need two filters to exchange"))
833 (let ((first (pop ibuffer-filtering-qualifiers))
834 (second (pop ibuffer-filtering-qualifiers)))
835 (push first ibuffer-filtering-qualifiers)
836 (push second ibuffer-filtering-qualifiers))
837 (ibuffer-update nil t))
838
839 ;;;###autoload
840 (defun ibuffer-negate-filter ()
841 "Negate the sense of the top filter in the current buffer."
842 (interactive)
843 (when (null ibuffer-filtering-qualifiers)
844 (error "No filters in effect"))
845 (let ((lim (pop ibuffer-filtering-qualifiers)))
846 (push (if (eq (car lim) 'not)
847 (cdr lim)
848 (cons 'not lim))
849 ibuffer-filtering-qualifiers))
850 (ibuffer-update nil t))
851
852 ;;;###autoload
853 (defun ibuffer-or-filter (&optional reverse)
854 "Replace the top two filters in this buffer with their logical OR.
855 If optional argument REVERSE is non-nil, instead break the top OR
856 filter into parts."
857 (interactive "P")
858 (if reverse
859 (progn
860 (when (or (null ibuffer-filtering-qualifiers)
861 (not (eq 'or (caar ibuffer-filtering-qualifiers))))
862 (error "Top filter is not an OR"))
863 (let ((lim (pop ibuffer-filtering-qualifiers)))
864 (setq ibuffer-filtering-qualifiers
865 (nconc (cdr lim) ibuffer-filtering-qualifiers))))
866 (when (< (length ibuffer-filtering-qualifiers) 2)
867 (error "Need two filters to OR"))
868 ;; If the second filter is an OR, just add to it.
869 (let ((first (pop ibuffer-filtering-qualifiers))
870 (second (pop ibuffer-filtering-qualifiers)))
871 (if (eq 'or (car second))
872 (push (nconc (list 'or first) (cdr second))
873 ibuffer-filtering-qualifiers)
874 (push (list 'or first second)
875 ibuffer-filtering-qualifiers))))
876 (ibuffer-update nil t))
877
878 (defun ibuffer-maybe-save-stuff ()
879 (when ibuffer-save-with-custom
880 (if (fboundp 'customize-save-variable)
881 (progn
882 (customize-save-variable 'ibuffer-saved-filters
883 ibuffer-saved-filters)
884 (customize-save-variable 'ibuffer-saved-filter-groups
885 ibuffer-saved-filter-groups))
886 (message "Not saved permanently: Customize not available"))))
887
888 ;;;###autoload
889 (defun ibuffer-save-filters (name filters)
890 "Save FILTERS in this buffer with name NAME in `ibuffer-saved-filters'.
891 Interactively, prompt for NAME, and use the current filters."
892 (interactive
893 (if (null ibuffer-filtering-qualifiers)
894 (error "No filters currently in effect")
895 (list
896 (read-from-minibuffer "Save current filters as: ")
897 ibuffer-filtering-qualifiers)))
898 (ibuffer-aif (assoc name ibuffer-saved-filters)
899 (setcdr it filters)
900 (push (list name filters) ibuffer-saved-filters))
901 (ibuffer-maybe-save-stuff)
902 (ibuffer-update-mode-name))
903
904 ;;;###autoload
905 (defun ibuffer-delete-saved-filters (name)
906 "Delete saved filters with NAME from `ibuffer-saved-filters'."
907 (interactive
908 (list
909 (if (null ibuffer-saved-filters)
910 (error "No saved filters")
911 (completing-read "Delete saved filters: "
912 ibuffer-saved-filters nil t))))
913 (setq ibuffer-saved-filters
914 (ibuffer-delete-alist name ibuffer-saved-filters))
915 (ibuffer-maybe-save-stuff)
916 (ibuffer-update nil t))
917
918 ;;;###autoload
919 (defun ibuffer-add-saved-filters (name)
920 "Add saved filters from `ibuffer-saved-filters' to this buffer's filters."
921 (interactive
922 (list
923 (if (null ibuffer-saved-filters)
924 (error "No saved filters")
925 (completing-read "Add saved filters: "
926 ibuffer-saved-filters nil t))))
927 (push (cons 'saved name) ibuffer-filtering-qualifiers)
928 (ibuffer-update nil t))
929
930 ;;;###autoload
931 (defun ibuffer-switch-to-saved-filters (name)
932 "Set this buffer's filters to filters with NAME from `ibuffer-saved-filters'."
933 (interactive
934 (list
935 (if (null ibuffer-saved-filters)
936 (error "No saved filters")
937 (completing-read "Switch to saved filters: "
938 ibuffer-saved-filters nil t))))
939 (setq ibuffer-filtering-qualifiers (list (cons 'saved name)))
940 (ibuffer-update nil t))
941
942 (defun ibuffer-format-filter-group-data (filter)
943 (if (equal filter "Default")
944 ""
945 (concat "Filter:" (mapconcat #'ibuffer-format-qualifier
946 (cdr (assq filter ibuffer-filter-groups))
947 " "))))
948
949 (defun ibuffer-format-qualifier (qualifier)
950 (if (eq (car-safe qualifier) 'not)
951 (concat " [NOT" (ibuffer-format-qualifier-1 (cdr qualifier)) "]")
952 (ibuffer-format-qualifier-1 qualifier)))
953
954 (defun ibuffer-format-qualifier-1 (qualifier)
955 (case (car qualifier)
956 (saved
957 (concat " [filter: " (cdr qualifier) "]"))
958 (or
959 (concat " [OR" (mapconcat #'ibuffer-format-qualifier
960 (cdr qualifier) "") "]"))
961 (t
962 (let ((type (assq (car qualifier) ibuffer-filtering-alist)))
963 (unless qualifier
964 (error "Ibuffer: bad qualifier %s" qualifier))
965 (concat " [" (cadr type) ": " (format "%s]" (cdr qualifier)))))))
966
967
968 (defun ibuffer-list-buffer-modes ()
969 "Create an alist of buffer modes currently in use.
970 The list returned will be of the form (\"MODE-NAME\" . MODE-SYMBOL)."
971 (let ((bufs (buffer-list))
972 (modes)
973 (this-mode))
974 (while bufs
975 (setq this-mode
976 (with-current-buffer
977 (car bufs)
978 major-mode)
979 bufs (cdr bufs))
980 (add-to-list
981 'modes
982 `(,(symbol-name this-mode) .
983 ,this-mode)))
984 modes))
985
986
987 ;;; Extra operation definitions
988
989 ;;;###autoload (autoload 'ibuffer-filter-by-mode "ibuf-ext")
990 (define-ibuffer-filter mode
991 "Toggle current view to buffers with major mode QUALIFIER."
992 (:description "major mode"
993 :reader
994 (intern
995 (completing-read "Filter by major mode: " obarray
996 #'(lambda (e)
997 (string-match "-mode$"
998 (symbol-name e)))
999 t
1000 (let ((buf (ibuffer-current-buffer)))
1001 (if (and buf (buffer-live-p buf))
1002 (with-current-buffer buf
1003 (symbol-name major-mode))
1004 "")))))
1005 (eq qualifier (with-current-buffer buf major-mode)))
1006
1007 ;;;###autoload (autoload 'ibuffer-filter-by-used-mode "ibuf-ext")
1008 (define-ibuffer-filter used-mode
1009 "Toggle current view to buffers with major mode QUALIFIER.
1010 Called interactively, this function allows selection of modes
1011 currently used by buffers."
1012 (:description "major mode in use"
1013 :reader
1014 (intern
1015 (completing-read "Filter by major mode: "
1016 (ibuffer-list-buffer-modes)
1017 nil
1018 t
1019 (let ((buf (ibuffer-current-buffer)))
1020 (if (and buf (buffer-live-p buf))
1021 (with-current-buffer buf
1022 (symbol-name major-mode))
1023 "")))))
1024 (eq qualifier (with-current-buffer buf major-mode)))
1025
1026 ;;;###autoload (autoload 'ibuffer-filter-by-name "ibuf-ext")
1027 (define-ibuffer-filter name
1028 "Toggle current view to buffers with name matching QUALIFIER."
1029 (:description "buffer name"
1030 :reader (read-from-minibuffer "Filter by name (regexp): "))
1031 (string-match qualifier (buffer-name buf)))
1032
1033 ;;;###autoload (autoload 'ibuffer-filter-by-filename "ibuf-ext")
1034 (define-ibuffer-filter filename
1035 "Toggle current view to buffers with filename matching QUALIFIER."
1036 (:description "filename"
1037 :reader (read-from-minibuffer "Filter by filename (regexp): "))
1038 (ibuffer-awhen (with-current-buffer buf
1039 (or buffer-file-name
1040 (and (boundp 'dired-directory)
1041 (let ((dired-dir
1042 (if (stringp dired-directory)
1043 dired-directory
1044 (car dired-directory))))
1045 (and dired-dir
1046 (expand-file-name dired-dir))))))
1047 (string-match qualifier it)))
1048
1049 ;;;###autoload (autoload 'ibuffer-filter-by-size-gt "ibuf-ext")
1050 (define-ibuffer-filter size-gt
1051 "Toggle current view to buffers with size greater than QUALIFIER."
1052 (:description "size greater than"
1053 :reader
1054 (string-to-number (read-from-minibuffer "Filter by size greater than: ")))
1055 (> (with-current-buffer buf (buffer-size))
1056 qualifier))
1057
1058 ;;;###autoload (autoload 'ibuffer-filter-by-size-lt "ibuf-ext")
1059 (define-ibuffer-filter size-lt
1060 "Toggle current view to buffers with size less than QUALIFIER."
1061 (:description "size less than"
1062 :reader
1063 (string-to-number (read-from-minibuffer "Filter by size less than: ")))
1064 (< (with-current-buffer buf (buffer-size))
1065 qualifier))
1066
1067 ;;;###autoload (autoload 'ibuffer-filter-by-content "ibuf-ext")
1068 (define-ibuffer-filter content
1069 "Toggle current view to buffers whose contents match QUALIFIER."
1070 (:description "content"
1071 :reader (read-from-minibuffer "Filter by content (regexp): "))
1072 (with-current-buffer buf
1073 (save-excursion
1074 (goto-char (point-min))
1075 (re-search-forward qualifier nil t))))
1076
1077 ;;;###autoload (autoload 'ibuffer-filter-by-predicate "ibuf-ext")
1078 (define-ibuffer-filter predicate
1079 "Toggle current view to buffers for which QUALIFIER returns non-nil."
1080 (:description "predicate"
1081 :reader (read-minibuffer "Filter by predicate (form): "))
1082 (with-current-buffer buf
1083 (eval qualifier)))
1084
1085 ;;; Sorting
1086
1087 ;;;###autoload
1088 (defun ibuffer-toggle-sorting-mode ()
1089 "Toggle the current sorting mode.
1090 Default sorting modes are:
1091 Recency - the last time the buffer was viewed
1092 Name - the name of the buffer
1093 Major Mode - the name of the major mode of the buffer
1094 Size - the size of the buffer"
1095 (interactive)
1096 (let ((modes (mapcar 'car ibuffer-sorting-functions-alist)))
1097 (add-to-list 'modes 'recency)
1098 (setq modes (sort modes 'string-lessp))
1099 (let ((next (or (car-safe (cdr-safe (memq ibuffer-sorting-mode modes)))
1100 (car modes))))
1101 (setq ibuffer-sorting-mode next)
1102 (message "Sorting by %s" next)))
1103 (ibuffer-redisplay t))
1104
1105 ;;;###autoload
1106 (defun ibuffer-invert-sorting ()
1107 "Toggle whether or not sorting is in reverse order."
1108 (interactive)
1109 (setq ibuffer-sorting-reversep (not ibuffer-sorting-reversep))
1110 (message "Sorting order %s"
1111 (if ibuffer-sorting-reversep
1112 "reversed"
1113 "normal"))
1114 (ibuffer-redisplay t))
1115
1116 ;;;###autoload (autoload 'ibuffer-do-sort-by-major-mode "ibuf-ext")
1117 (define-ibuffer-sorter major-mode
1118 "Sort the buffers by major modes.
1119 Ordering is lexicographic."
1120 (:description "major mode")
1121 (string-lessp (downcase
1122 (symbol-name (with-current-buffer
1123 (car a)
1124 major-mode)))
1125 (downcase
1126 (symbol-name (with-current-buffer
1127 (car b)
1128 major-mode)))))
1129
1130 ;;;###autoload (autoload 'ibuffer-do-sort-by-mode-name "ibuf-ext")
1131 (define-ibuffer-sorter mode-name
1132 "Sort the buffers by their mode name.
1133 Ordering is lexicographic."
1134 (:description "major mode name")
1135 (string-lessp (downcase
1136 (with-current-buffer
1137 (car a)
1138 mode-name))
1139 (downcase
1140 (with-current-buffer
1141 (car b)
1142 mode-name))))
1143
1144 ;;;###autoload (autoload 'ibuffer-do-sort-by-alphabetic "ibuf-ext")
1145 (define-ibuffer-sorter alphabetic
1146 "Sort the buffers by their names.
1147 Ordering is lexicographic."
1148 (:description "buffer name")
1149 (string-lessp
1150 (buffer-name (car a))
1151 (buffer-name (car b))))
1152
1153 ;;;###autoload (autoload 'ibuffer-do-sort-by-size "ibuf-ext")
1154 (define-ibuffer-sorter size
1155 "Sort the buffers by their size."
1156 (:description "size")
1157 (< (with-current-buffer (car a)
1158 (buffer-size))
1159 (with-current-buffer (car b)
1160 (buffer-size))))
1161
1162 ;;; Functions to emulate bs.el
1163
1164 ;;;###autoload
1165 (defun ibuffer-bs-show ()
1166 "Emulate `bs-show' from the bs.el package."
1167 (interactive)
1168 (ibuffer t "*Ibuffer-bs*" '((filename . ".*")) nil t)
1169 (define-key (current-local-map) "a" 'ibuffer-bs-toggle-all))
1170
1171 (defun ibuffer-bs-toggle-all ()
1172 "Emulate `bs-toggle-show-all' from the bs.el package."
1173 (interactive)
1174 (if ibuffer-filtering-qualifiers
1175 (ibuffer-pop-filter)
1176 (progn (ibuffer-push-filter '(filename . ".*"))
1177 (ibuffer-update nil t))))
1178
1179 ;;; Handy functions
1180
1181 ;;;###autoload
1182 (defun ibuffer-add-to-tmp-hide (regexp)
1183 "Add REGEXP to `ibuffer-tmp-hide-regexps'.
1184 This means that buffers whose name matches REGEXP will not be shown
1185 for this Ibuffer session."
1186 (interactive
1187 (list
1188 (read-from-minibuffer "Never show buffers matching: "
1189 (regexp-quote (buffer-name (ibuffer-current-buffer t))))))
1190 (push regexp ibuffer-tmp-hide-regexps))
1191
1192 ;;;###autoload
1193 (defun ibuffer-add-to-tmp-show (regexp)
1194 "Add REGEXP to `ibuffer-tmp-show-regexps'.
1195 This means that buffers whose name matches REGEXP will always be shown
1196 for this Ibuffer session."
1197 (interactive
1198 (list
1199 (read-from-minibuffer "Always show buffers matching: "
1200 (regexp-quote (buffer-name (ibuffer-current-buffer t))))))
1201 (push regexp ibuffer-tmp-show-regexps))
1202
1203 ;;;###autoload
1204 (defun ibuffer-forward-next-marked (&optional count mark direction)
1205 "Move forward by COUNT marked buffers (default 1).
1206
1207 If MARK is non-nil, it should be a character denoting the type of mark
1208 to move by. The default is `ibuffer-marked-char'.
1209
1210 If DIRECTION is non-nil, it should be an integer; negative integers
1211 mean move backwards, non-negative integers mean move forwards."
1212 (interactive "P")
1213 (unless count
1214 (setq count 1))
1215 (unless mark
1216 (setq mark ibuffer-marked-char))
1217 (unless direction
1218 (setq direction 1))
1219 ;; Skip the title
1220 (ibuffer-forward-line 0)
1221 (let ((opos (point))
1222 curmark)
1223 (ibuffer-forward-line direction)
1224 (while (not (or (= (point) opos)
1225 (eq (setq curmark (ibuffer-current-mark))
1226 mark)))
1227 (ibuffer-forward-line direction))
1228 (when (and (= (point) opos)
1229 (not (eq (ibuffer-current-mark) mark)))
1230 (error "No buffers with mark %c" mark))))
1231
1232 ;;;###autoload
1233 (defun ibuffer-backwards-next-marked (&optional count mark)
1234 "Move backwards by COUNT marked buffers (default 1).
1235
1236 If MARK is non-nil, it should be a character denoting the type of mark
1237 to move by. The default is `ibuffer-marked-char'."
1238 (interactive "P")
1239 (ibuffer-forward-next-marked count mark -1))
1240
1241 ;;;###autoload
1242 (defun ibuffer-do-kill-lines ()
1243 "Hide all of the currently marked lines."
1244 (interactive)
1245 (if (= (ibuffer-count-marked-lines) 0)
1246 (message "No buffers marked; use 'm' to mark a buffer")
1247 (let ((count
1248 (ibuffer-map-marked-lines
1249 #'(lambda (buf mark)
1250 'kill))))
1251 (message "Killed %s lines" count))))
1252
1253 ;;;###autoload
1254 (defun ibuffer-jump-to-buffer (name)
1255 "Move point to the buffer whose name is NAME.
1256
1257 If called interactively, prompt for a buffer name and go to the
1258 corresponding line in the Ibuffer buffer. If said buffer is in a
1259 hidden group filter, open it.
1260
1261 If `ibuffer-jump-offer-only-visible-buffers' is non-nil, only offer
1262 visible buffers in the completion list. Calling the command with
1263 a prefix argument reverses the meaning of that variable."
1264 (interactive (list
1265 (let ((only-visible ibuffer-jump-offer-only-visible-buffers))
1266 (when current-prefix-arg
1267 (setq only-visible (not only-visible)))
1268 (if only-visible
1269 (let ((table (mapcar #'(lambda (x)
1270 (buffer-name (car x)))
1271 (ibuffer-current-state-list))))
1272 (when (null table)
1273 (error "No buffers!"))
1274 (completing-read "Jump to buffer: "
1275 table nil t))
1276 (read-buffer "Jump to buffer: " nil t)))))
1277 (when (not (string= "" name))
1278 (let (buf-point)
1279 ;; Blindly search for our buffer: it is very likely that it is
1280 ;; not in a hidden filter group.
1281 (ibuffer-map-lines #'(lambda (buf marks)
1282 (when (string= (buffer-name buf) name)
1283 (setq buf-point (point))
1284 nil))
1285 t nil)
1286 (when (and
1287 (null buf-point)
1288 (not (null ibuffer-hidden-filter-groups)))
1289 ;; We did not find our buffer. It must be in a hidden filter
1290 ;; group, so go through all hidden filter groups to find it.
1291 (catch 'found
1292 (dolist (group ibuffer-hidden-filter-groups)
1293 (ibuffer-jump-to-filter-group group)
1294 (ibuffer-toggle-filter-group)
1295 (ibuffer-map-lines #'(lambda (buf marks)
1296 (when (string= (buffer-name buf) name)
1297 (setq buf-point (point))
1298 nil))
1299 t group)
1300 (if buf-point
1301 (throw 'found nil)
1302 (ibuffer-toggle-filter-group)))))
1303 (if (null buf-point)
1304 ;; Still not found even though we expanded all hidden filter
1305 ;; groups: that must be because it's hidden by predicate:
1306 ;; we won't bother trying to display it.
1307 (error "No buffer with name %s" name)
1308 (goto-char buf-point)))))
1309
1310 ;;;###autoload
1311 (defun ibuffer-diff-with-file ()
1312 "View the differences between this buffer and its associated file.
1313 This requires the external program \"diff\" to be in your `exec-path'."
1314 (interactive)
1315 (let ((buf (ibuffer-current-buffer)))
1316 (unless (buffer-live-p buf)
1317 (error "Buffer %s has been killed" buf))
1318 (diff-buffer-with-file buf)))
1319
1320 ;;;###autoload
1321 (defun ibuffer-copy-filename-as-kill (&optional arg)
1322 "Copy filenames of marked buffers into the kill ring.
1323
1324 The names are separated by a space.
1325 If a buffer has no filename, it is ignored.
1326
1327 With no prefix arg, use the filename sans its directory of each marked file.
1328 With a zero prefix arg, use the complete filename of each marked file.
1329 With \\[universal-argument], use the filename of each marked file relative
1330 to `ibuffer-default-directory' if non-nil, otherwise `default-directory'.
1331
1332 You can then feed the file name(s) to other commands with \\[yank]."
1333 (interactive "p")
1334 (if (zerop (ibuffer-count-marked-lines))
1335 (message "No buffers marked; use 'm' to mark a buffer")
1336 (let ((ibuffer-copy-filename-as-kill-result "")
1337 (type (cond ((zerop arg)
1338 'full)
1339 ((= arg 4)
1340 'relative)
1341 (t
1342 'name))))
1343 (ibuffer-map-marked-lines
1344 #'(lambda (buf mark)
1345 (setq ibuffer-copy-filename-as-kill-result
1346 (concat ibuffer-copy-filename-as-kill-result
1347 (let ((name (buffer-file-name buf)))
1348 (if name
1349 (case type
1350 (full
1351 name)
1352 (relative
1353 (file-relative-name
1354 name (or ibuffer-default-directory
1355 default-directory)))
1356 (t
1357 (file-name-nondirectory name)))
1358 ""))
1359 " "))))
1360 (kill-new ibuffer-copy-filename-as-kill-result))))
1361
1362 (defun ibuffer-mark-on-buffer (func &optional ibuffer-mark-on-buffer-mark group)
1363 (let ((count
1364 (ibuffer-map-lines
1365 #'(lambda (buf mark)
1366 (when (funcall func buf)
1367 (ibuffer-set-mark-1 (or ibuffer-mark-on-buffer-mark
1368 ibuffer-marked-char))
1369 t))
1370 nil
1371 group)))
1372 (ibuffer-redisplay t)
1373 (message "Marked %s buffers" count)))
1374
1375 ;;;###autoload
1376 (defun ibuffer-mark-by-name-regexp (regexp)
1377 "Mark all buffers whose name matches REGEXP."
1378 (interactive "sMark by name (regexp): ")
1379 (ibuffer-mark-on-buffer
1380 #'(lambda (buf)
1381 (string-match regexp (buffer-name buf)))))
1382
1383 ;;;###autoload
1384 (defun ibuffer-mark-by-mode-regexp (regexp)
1385 "Mark all buffers whose major mode matches REGEXP."
1386 (interactive "sMark by major mode (regexp): ")
1387 (ibuffer-mark-on-buffer
1388 #'(lambda (buf)
1389 (with-current-buffer buf
1390 (string-match regexp mode-name)))))
1391
1392 ;;;###autoload
1393 (defun ibuffer-mark-by-file-name-regexp (regexp)
1394 "Mark all buffers whose file name matches REGEXP."
1395 (interactive "sMark by file name (regexp): ")
1396 (ibuffer-mark-on-buffer
1397 #'(lambda (buf)
1398 (let ((name (or (buffer-file-name buf)
1399 (with-current-buffer buf
1400 (and
1401 (boundp 'dired-directory)
1402 (stringp dired-directory)
1403 dired-directory)))))
1404 (when name
1405 (string-match regexp name))))))
1406
1407 ;;;###autoload
1408 (defun ibuffer-mark-by-mode (mode)
1409 "Mark all buffers whose major mode equals MODE."
1410 (interactive
1411 (list (intern (completing-read "Mark by major mode: " obarray
1412 #'(lambda (e)
1413 ;; kind of a hack...
1414 (and (fboundp e)
1415 (string-match "-mode$"
1416 (symbol-name e))))
1417 t
1418 (let ((buf (ibuffer-current-buffer)))
1419 (if (and buf (buffer-live-p buf))
1420 (with-current-buffer buf
1421 (cons (symbol-name major-mode)
1422 0))
1423 ""))))))
1424 (ibuffer-mark-on-buffer
1425 #'(lambda (buf)
1426 (with-current-buffer buf
1427 (eq major-mode mode)))))
1428
1429 ;;;###autoload
1430 (defun ibuffer-mark-modified-buffers ()
1431 "Mark all modified buffers."
1432 (interactive)
1433 (ibuffer-mark-on-buffer
1434 #'(lambda (buf) (buffer-modified-p buf))))
1435
1436 ;;;###autoload
1437 (defun ibuffer-mark-unsaved-buffers ()
1438 "Mark all modified buffers that have an associated file."
1439 (interactive)
1440 (ibuffer-mark-on-buffer
1441 #'(lambda (buf) (and (with-current-buffer buf buffer-file-name)
1442 (buffer-modified-p buf)))))
1443
1444 ;;;###autoload
1445 (defun ibuffer-mark-dissociated-buffers ()
1446 "Mark all buffers whose associated file does not exist."
1447 (interactive)
1448 (ibuffer-mark-on-buffer
1449 #'(lambda (buf)
1450 (with-current-buffer buf
1451 (or
1452 (and buffer-file-name
1453 (not (file-exists-p buffer-file-name)))
1454 (and (eq major-mode 'dired-mode)
1455 (boundp 'dired-directory)
1456 (stringp dired-directory)
1457 (not (file-exists-p (file-name-directory dired-directory)))))))))
1458
1459 ;;;###autoload
1460 (defun ibuffer-mark-help-buffers ()
1461 "Mark buffers like *Help*, *Apropos*, *Info*."
1462 (interactive)
1463 (ibuffer-mark-on-buffer
1464 #'(lambda (buf)
1465 (with-current-buffer buf
1466 (memq major-mode ibuffer-help-buffer-modes)))))
1467
1468 ;;;###autoload
1469 (defun ibuffer-mark-compressed-file-buffers ()
1470 "Mark buffers whose associated file is compressed."
1471 (interactive)
1472 (ibuffer-mark-on-buffer
1473 #'(lambda (buf)
1474 (with-current-buffer buf
1475 (and buffer-file-name
1476 (string-match ibuffer-compressed-file-name-regexp
1477 buffer-file-name))))))
1478
1479 ;;;###autoload
1480 (defun ibuffer-mark-old-buffers ()
1481 "Mark buffers which have not been viewed in `ibuffer-old-time' hours."
1482 (interactive)
1483 (ibuffer-mark-on-buffer
1484 #'(lambda (buf)
1485 (with-current-buffer buf
1486 ;; hacked from midnight.el
1487 (when buffer-display-time
1488 (let* ((tm (current-time))
1489 (now (+ (* (float (ash 1 16)) (car tm))
1490 (float (cadr tm)) (* 0.0000001 (caddr tm))))
1491 (then (+ (* (float (ash 1 16))
1492 (car buffer-display-time))
1493 (float (cadr buffer-display-time))
1494 (* 0.0000001 (caddr buffer-display-time)))))
1495 (> (- now then) (* 60 60 ibuffer-old-time))))))))
1496
1497 ;;;###autoload
1498 (defun ibuffer-mark-special-buffers ()
1499 "Mark all buffers whose name begins and ends with '*'."
1500 (interactive)
1501 (ibuffer-mark-on-buffer
1502 #'(lambda (buf) (string-match "^\\*.+\\*$"
1503 (buffer-name buf)))))
1504
1505 ;;;###autoload
1506 (defun ibuffer-mark-read-only-buffers ()
1507 "Mark all read-only buffers."
1508 (interactive)
1509 (ibuffer-mark-on-buffer
1510 #'(lambda (buf)
1511 (with-current-buffer buf
1512 buffer-read-only))))
1513
1514 ;;;###autoload
1515 (defun ibuffer-mark-dired-buffers ()
1516 "Mark all `dired' buffers."
1517 (interactive)
1518 (ibuffer-mark-on-buffer
1519 #'(lambda (buf)
1520 (with-current-buffer buf
1521 (eq major-mode 'dired-mode)))))
1522
1523 ;;;###autoload
1524 (defun ibuffer-do-occur (regexp &optional nlines)
1525 "View lines which match REGEXP in all marked buffers.
1526 Optional argument NLINES says how many lines of context to display: it
1527 defaults to one."
1528 (interactive (occur-read-primary-args))
1529 (if (or (not (integerp nlines))
1530 (< nlines 0))
1531 (setq nlines 0))
1532 (when (zerop (ibuffer-count-marked-lines))
1533 (ibuffer-set-mark ibuffer-marked-char))
1534 (let ((ibuffer-do-occur-bufs nil))
1535 ;; Accumulate a list of marked buffers
1536 (ibuffer-map-marked-lines
1537 #'(lambda (buf mark)
1538 (push buf ibuffer-do-occur-bufs)))
1539 (occur-1 regexp nlines ibuffer-do-occur-bufs)))
1540
1541 (provide 'ibuf-ext)
1542
1543 ;;; arch-tag: 9af21953-deda-4c30-b76d-f81d9128e76d
1544 ;;; ibuf-ext.el ends here