1 ;;; ibuf-ext.el --- extensions for ibuffer
3 ;; Copyright (C) 2000, 2001, 2002 Free Software Foundation, Inc.
5 ;; Author: Colin Walters <walters@verbum.org>
7 ;; Keywords: buffer, convenience
9 ;; This file is part of GNU Emacs.
11 ;; This program is free software; you can redistribute it and/or
12 ;; modify it under the terms of the GNU General Public License as
13 ;; published by the Free Software Foundation; either version 2, or (at
14 ;; your option) any later version.
16 ;; This program is distributed in the hope that it will be useful, but
17 ;; WITHOUT ANY WARRANTY; without even the implied warranty of
18 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
19 ;; General Public License for more details.
21 ;; You should have received a copy of the GNU General Public License
22 ;; along with this program ; see the file COPYING. If not, write to
23 ;; the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
24 ;; Boston, MA 02111-1307, USA.
28 ;; These functions should be automatically loaded when called, but you
29 ;; can explicity (require 'ibuf-ext) in your ~/.emacs to have them
42 (defun ibuffer-delete-alist (key alist
)
43 "Delete all entries in ALIST that have a key equal to KEY."
45 (while (setq entry
(assoc key alist
))
46 (setq alist
(delete entry alist
)))
49 (defun ibuffer-split-list (ibuffer-split-list-fn ibuffer-split-list-elts
)
52 (dolist (ibuffer-split-list-elt ibuffer-split-list-elts
)
53 (if (funcall ibuffer-split-list-fn ibuffer-split-list-elt
)
54 (push ibuffer-split-list-elt hip-crowd
)
55 (push ibuffer-split-list-elt lamers
)))
56 ;; Too bad Emacs Lisp doesn't have multiple values.
57 (list (nreverse hip-crowd
) (nreverse lamers
))))
59 (defcustom ibuffer-never-show-predicates nil
60 "A list of predicates (a regexp or function) for buffers not to display.
61 If a regexp, then it will be matched against the buffer's name.
62 If a function, it will be called with the buffer as an argument, and
63 should return non-nil if this buffer should not be shown."
64 :type
'(repeat (choice regexp function
))
67 (defcustom ibuffer-always-show-predicates nil
68 "A list of predicates (a regexp or function) for buffers to always display.
69 If a regexp, then it will be matched against the buffer's name.
70 If a function, it will be called with the buffer as an argument, and
71 should return non-nil if this buffer should be shown.
72 Note that buffers matching one of these predicates will be shown
73 regardless of any active filters in this buffer."
74 :type
'(repeat (choice regexp function
))
77 (defvar ibuffer-tmp-hide-regexps nil
78 "A list of regexps which should match buffer names to not show.")
80 (defvar ibuffer-tmp-show-regexps nil
81 "A list of regexps which should match buffer names to always show.")
83 (defvar ibuffer-auto-mode nil
84 "If non-nil, Ibuffer auto-mode should be enabled for this buffer.
85 Do not set this variable directly! Use the function
86 `ibuffer-auto-mode' instead.")
88 (defvar ibuffer-auto-buffers-changed nil
)
90 (defcustom ibuffer-saved-filters
'(("gnus"
91 ((or (mode . message-mode
)
93 (mode . gnus-group-mode
)
94 (mode . gnus-summary-mode
)
95 (mode . gnus-article-mode
))))
97 ((or (mode . emacs-lisp-mode
)
102 (mode . lisp-mode
)))))
104 "An alist of filter qualifiers to switch between.
106 This variable should look like ((\"STRING\" QUALIFIERS)
107 (\"STRING\" QUALIFIERS) ...), where
108 QUALIFIERS is a list of the same form as
109 `ibuffer-filtering-qualifiers'.
110 See also the variables `ibuffer-filtering-qualifiers',
111 `ibuffer-filtering-alist', and the functions
112 `ibuffer-switch-to-saved-filters', `ibuffer-save-filters'."
116 (defvar ibuffer-filtering-qualifiers nil
117 "A list like (SYMBOL . QUALIFIER) which filters the current buffer list.
118 See also `ibuffer-filtering-alist'.")
120 ;; This is now frobbed by `define-ibuffer-filter'.
121 (defvar ibuffer-filtering-alist nil
122 "An alist of (SYMBOL DESCRIPTION FUNCTION) which describes a filter.
124 You most likely do not want to modify this variable directly; see
125 `define-ibuffer-filter'.
127 SYMBOL is the symbolic name of the filter. DESCRIPTION is used when
128 displaying information to the user. FUNCTION is given a buffer and
129 the value of the qualifier, and returns non-nil if and only if the
130 buffer should be displayed.")
132 (defcustom ibuffer-filter-format-alist nil
133 "An alist which has special formats used when a filter is active.
134 The contents of this variable should look like:
135 ((FILTER (FORMAT FORMAT ...)) (FILTER (FORMAT FORMAT ...)) ...)
137 For example, suppose that when you add a filter for buffers whose
138 major mode is `emacs-lisp-mode', you only want to see the mark and the
139 name of the buffer. You could accomplish that by adding:
140 (mode ((mark \" \" name)))
142 :type
'(repeat (list :tag
"Association" (symbol :tag
"Filter")
143 (list :tag
"Formats" (repeat (sexp :tag
"Format")))))
146 (defvar ibuffer-cached-filter-formats nil
)
147 (defvar ibuffer-compiled-filter-formats nil
)
149 (defvar ibuffer-filter-groups nil
150 "A list like ((\"NAME\" ((SYMBOL . QUALIFIER) ...) ...) which groups buffers.
151 The SYMBOL should be one from `ibuffer-filtering-alist'.
152 The QUALIFIER should be the same as QUALIFIER in
153 `ibuffer-filtering-qualifiers'.")
155 (defcustom ibuffer-show-empty-filter-groups t
156 "If non-nil, then show the names of filter groups which are empty."
160 (defcustom ibuffer-saved-filter-groups nil
162 "An alist of filtering groups to switch between.
164 This variable should look like ((\"STRING\" QUALIFIERS)
165 (\"STRING\" QUALIFIERS) ...), where
166 QUALIFIERS is a list of the same form as
167 `ibuffer-filtering-qualifiers'.
169 See also the variables `ibuffer-filter-groups',
170 `ibuffer-filtering-qualifiers', `ibuffer-filtering-alist', and the
171 functions `ibuffer-switch-to-saved-filter-group',
172 `ibuffer-save-filter-group'."
176 (defvar ibuffer-hidden-filter-groups nil
177 "A list of filtering groups which are currently hidden.")
179 (defvar ibuffer-filter-group-kill-ring nil
)
181 (defcustom ibuffer-old-time
72
182 "The number of hours before a buffer is considered \"old\"."
183 :type
'(choice (const :tag
"72 hours (3 days)" 72)
184 (const :tag
"48 hours (2 days)" 48)
185 (const :tag
"24 hours (1 day)" 24)
186 (integer :tag
"hours"))
189 (defcustom ibuffer-save-with-custom t
190 "If non-nil, then use Custom to save interactively changed variables.
191 Currently, this only applies to `ibuffer-saved-filters' and
192 `ibuffer-saved-filter-groups."
196 (defun ibuffer-ext-visible-p (buf all
&optional ibuffer-buf
)
198 (ibuffer-buf-matches-predicates buf ibuffer-tmp-show-regexps
)
201 (ibuffer-buf-matches-predicates buf ibuffer-tmp-hide-regexps
)
202 (ibuffer-buf-matches-predicates buf ibuffer-never-show-predicates
)))
205 (ibuffer-buf-matches-predicates buf ibuffer-maybe-show-predicates
)))
206 (or ibuffer-view-ibuffer
208 (not (eq ibuffer-buf buf
))))
210 (ibuffer-included-in-filters-p buf ibuffer-filtering-qualifiers
)
211 (ibuffer-buf-matches-predicates buf ibuffer-always-show-predicates
)))))
213 (defun ibuffer-auto-update-changed ()
214 (when ibuffer-auto-buffers-changed
215 (setq ibuffer-auto-buffers-changed nil
)
216 (mapcar #'(lambda (buf)
218 (with-current-buffer buf
219 (when (and ibuffer-auto-mode
220 (eq major-mode
'ibuffer-mode
))
221 (ibuffer-update nil t
)))))
225 (defun ibuffer-auto-mode (&optional arg
)
226 "Toggle use of Ibuffer's auto-update facility.
227 With numeric ARG, enable auto-update if and only if ARG is positive."
229 (unless (eq major-mode
'ibuffer-mode
)
230 (error "This buffer is not in Ibuffer mode"))
231 (set (make-local-variable 'ibuffer-auto-mode
)
234 (not ibuffer-auto-mode
)))
235 (defadvice get-buffer-create
(after ibuffer-notify-create activate
)
236 (setq ibuffer-auto-buffers-changed t
))
237 (defadvice kill-buffer
(after ibuffer-notify-kill activate
)
238 (setq ibuffer-auto-buffers-changed t
))
239 (add-hook 'post-command-hook
'ibuffer-auto-update-changed
)
240 (ibuffer-update-mode-name))
243 (defun ibuffer-mouse-filter-by-mode (event)
244 "Enable or disable filtering by the major mode chosen via mouse."
246 (ibuffer-interactive-filter-by-mode event
))
249 (defun ibuffer-interactive-filter-by-mode (event-or-point)
250 "Enable or disable filtering by the major mode at point."
252 (if (eventp event-or-point
)
253 (mouse-set-point event-or-point
)
254 (goto-char event-or-point
))
255 (let ((buf (ibuffer-current-buffer)))
256 (if (assq 'mode ibuffer-filtering-qualifiers
)
257 (setq ibuffer-filtering-qualifiers
258 (ibuffer-delete-alist 'mode ibuffer-filtering-qualifiers
))
259 (ibuffer-push-filter (cons 'mode
260 (with-current-buffer buf
262 (ibuffer-update nil t
))
265 (defun ibuffer-mouse-toggle-filter-group (event)
266 "Toggle the display status of the filter group chosen with the mouse."
268 (ibuffer-toggle-filter-group-1 (save-excursion
269 (mouse-set-point event
)
273 (defun ibuffer-toggle-filter-group ()
274 "Toggle the display status of the filter group on this line."
276 (ibuffer-toggle-filter-group-1 (point)))
278 (defun ibuffer-toggle-filter-group-1 (posn)
279 (let ((name (get-text-property posn
'ibuffer-filter-group-name
)))
280 (unless (stringp name
)
281 (error "No filtering group name present"))
282 (if (member name ibuffer-hidden-filter-groups
)
283 (setq ibuffer-hidden-filter-groups
284 (delete name ibuffer-hidden-filter-groups
))
285 (push name ibuffer-hidden-filter-groups
))
286 (ibuffer-update nil t
)))
289 (defun ibuffer-forward-filter-group (&optional count
)
290 "Move point forwards by COUNT filtering groups."
295 (when (get-text-property (point) 'ibuffer-filter-group-name
)
296 (goto-char (next-single-property-change
297 (point) 'ibuffer-filter-group-name
299 (goto-char (next-single-property-change
300 (point) 'ibuffer-filter-group-name
302 (ibuffer-forward-filter-group (1- count
)))
303 (ibuffer-forward-line 0))
306 (defun ibuffer-backward-filter-group (&optional count
)
307 "Move point backwards by COUNT filtering groups."
312 (when (get-text-property (point) 'ibuffer-filter-group-name
)
313 (goto-char (previous-single-property-change
314 (point) 'ibuffer-filter-group-name
316 (goto-char (previous-single-property-change
317 (point) 'ibuffer-filter-group-name
319 (ibuffer-backward-filter-group (1- count
)))
320 (when (= (point) (point-min))
321 (goto-char (point-max))
322 (ibuffer-backward-filter-group 1))
323 (ibuffer-forward-line 0))
325 ;;;###autoload (autoload 'ibuffer-do-shell-command-pipe "ibuf-ext.el")
326 (define-ibuffer-op shell-command-pipe
(command)
327 "Pipe the contents of each marked buffer to shell command COMMAND."
328 (:interactive
"sPipe to shell command: "
329 :opstring
"Shell command executed on"
331 (shell-command-on-region
332 (point-min) (point-max) command
333 (get-buffer-create "* ibuffer-shell-output*")))
335 ;;;###autoload (autoload 'ibuffer-do-shell-command-pipe-replace "ibuf-ext.el")
336 (define-ibuffer-op shell-command-pipe-replace
(command)
337 "Replace the contents of marked buffers with output of pipe to COMMAND."
338 (:interactive
"sPipe to shell command (replace): "
339 :opstring
"Buffer contents replaced in"
340 :active-opstring
"replace buffer contents in"
343 (with-current-buffer buf
344 (shell-command-on-region (point-min) (point-max)
347 ;;;###autoload (autoload 'ibuffer-do-shell-command-file "ibuf-ext.el")
348 (define-ibuffer-op shell-command-file
(command)
349 "Run shell command COMMAND separately on files of marked buffers."
350 (:interactive
"sShell command on buffer's file: "
351 :opstring
"Shell command executed on"
353 (shell-command (concat command
" "
354 (shell-quote-argument
358 (substring (buffer-name) 0 (min 10 (length (buffer-name))))))))))
360 ;;;###autoload (autoload 'ibuffer-do-eval "ibuf-ext.el")
361 (define-ibuffer-op eval
(form)
362 "Evaluate FORM in each of the buffers.
363 Does not display the buffer during evaluation. See
364 `ibuffer-do-view-and-eval' for that."
365 (:interactive
"xEval in buffers (form): "
366 :opstring
"evaluated in"
370 ;;;###autoload (autoload 'ibuffer-do-view-and-eval "ibuf-ext.el")
371 (define-ibuffer-op view-and-eval
(form)
372 "Evaluate FORM while displaying each of the marked buffers.
373 To evaluate a form without viewing the buffer, see `ibuffer-do-eval'."
374 (:interactive
"xEval viewing buffers (form): "
375 :opstring
"evaluated in"
378 (let ((ibuffer-buf (current-buffer)))
381 (switch-to-buffer buf
)
383 (switch-to-buffer ibuffer-buf
))))
385 ;;;###autoload (autoload 'ibuffer-do-rename-uniquely "ibuf-ext.el")
386 (define-ibuffer-op rename-uniquely
()
387 "Rename marked buffers as with `rename-uniquely'."
392 ;;;###autoload (autoload 'ibuffer-do-revert "ibuf-ext.el")
393 (define-ibuffer-op revert
()
394 "Revert marked buffers as with `revert-buffer'."
397 :active-opstring
"revert"
401 ;;;###autoload (autoload 'ibuffer-do-replace-regexp "ibuf-ext.el")
402 (define-ibuffer-op replace-regexp
(from-str to-str
)
403 "Perform a `replace-regexp' in marked buffers."
405 (let* ((from-str (read-from-minibuffer "Replace regexp: "))
406 (to-str (read-from-minibuffer (concat "Replace " from-str
408 (list from-str to-str
))
409 :opstring
"replaced in"
412 (save-window-excursion
413 (switch-to-buffer buf
)
415 (goto-char (point-min))
416 (let ((case-fold-search ibuffer-case-fold-search
))
417 (while (re-search-forward from-str nil t
)
418 (replace-match to-str
))))
421 ;;;###autoload (autoload 'ibuffer-do-query-replace "ibuf-ext.el")
422 (define-ibuffer-op query-replace
(&rest args
)
423 "Perform a `query-replace' in marked buffers."
425 (query-replace-read-args "Query replace" t t
)
426 :opstring
"replaced in"
429 (save-window-excursion
430 (switch-to-buffer buf
)
432 (let ((case-fold-search ibuffer-case-fold-search
))
433 (goto-char (point-min))
434 (apply #'query-replace args
)))
437 ;;;###autoload (autoload 'ibuffer-do-query-replace-regexp "ibuf-ext.el")
438 (define-ibuffer-op query-replace-regexp
(&rest args
)
439 "Perform a `query-replace-regexp' in marked buffers."
441 (query-replace-read-args "Query replace regexp" t t
)
442 :opstring
"replaced in"
445 (save-window-excursion
446 (switch-to-buffer buf
)
448 (let ((case-fold-search ibuffer-case-fold-search
))
449 (goto-char (point-min))
450 (apply #'query-replace-regexp args
)))
453 ;;;###autoload (autoload 'ibuffer-do-print "ibuf-ext.el")
454 (define-ibuffer-op print
()
455 "Print marked buffers as with `print-buffer'."
461 (defun ibuffer-included-in-filters-p (buf filters
)
463 (memq nil
;; a filter will return nil if it failed
465 ;; filter should be like (TYPE . QUALIFIER), or
466 ;; (or (TYPE . QUALIFIER) (TYPE . QUALIFIER) ...)
468 (ibuffer-included-in-filter-p buf qual
))
471 (defun ibuffer-included-in-filter-p (buf filter
)
472 (if (eq (car filter
) 'not
)
473 (not (ibuffer-included-in-filter-p-1 buf
(cdr filter
)))
474 (ibuffer-included-in-filter-p-1 buf filter
)))
476 (defun ibuffer-included-in-filter-p-1 (buf filter
)
481 (memq t
(mapcar #'(lambda (x)
482 (ibuffer-included-in-filter-p buf x
))
487 ibuffer-saved-filters
)))
489 (ibuffer-filter-disable)
490 (error "Unknown saved filter %s" (cdr filter
)))
491 (ibuffer-included-in-filters-p buf
(cadr data
))))
493 (let ((filterdat (assq (car filter
)
494 ibuffer-filtering-alist
)))
495 ;; filterdat should be like (TYPE DESCRIPTION FUNC)
496 ;; just a sanity check
498 (ibuffer-filter-disable)
499 (error "Undefined filter %s" (car filter
)))
502 (funcall (caddr filterdat
)
504 (cdr filter
))))))))))
506 (defun ibuffer-generate-filter-groups (bmarklist)
507 (let ((filter-group-alist (append ibuffer-filter-groups
508 (list (cons "Default" nil
)))))
509 ;; (dolist (hidden ibuffer-hidden-filter-groups)
510 ;; (setq filter-group-alist (ibuffer-delete-alist
511 ;; hidden filter-group-alist)))
512 (let ((vec (make-vector (length filter-group-alist
) nil
))
514 (dolist (filtergroup filter-group-alist
)
515 (let ((filterset (cdr filtergroup
)))
516 (multiple-value-bind (hip-crowd lamers
)
517 (ibuffer-split-list (lambda (bufmark)
518 (ibuffer-included-in-filters-p (car bufmark
)
521 (aset vec i hip-crowd
)
523 (setq bmarklist lamers
))))
526 (push (cons (car (nth j filter-group-alist
))
531 (defun ibuffer-filters-to-filter-group (name)
532 "Make the current filters into a filtering group."
533 (interactive "sName for filtering group: ")
534 (when (null ibuffer-filtering-qualifiers
)
535 (error "No filters in effect"))
536 (push (cons name ibuffer-filtering-qualifiers
) ibuffer-filter-groups
)
537 (ibuffer-filter-disable))
540 (defun ibuffer-set-filter-groups-by-mode ()
541 "Set the current filter groups to filter by mode."
543 (setq ibuffer-filter-groups
544 (mapcar (lambda (mode)
545 (cons (format "%s" mode
) `((mode .
,mode
))))
548 (mapcar (lambda (buf) (with-current-buffer buf major-mode
))
550 (if ibuffer-view-ibuffer
552 (delq 'ibuffer-mode modes
)))))
553 (ibuffer-update nil t
))
556 (defun ibuffer-pop-filter-group ()
557 "Remove the first filtering group."
559 (when (null ibuffer-filter-groups
)
560 (error "No filtering groups active"))
561 (setq ibuffer-hidden-filter-groups
562 (delete (pop ibuffer-filter-groups
)
563 ibuffer-hidden-filter-groups
))
564 (ibuffer-update nil t
))
567 (defun ibuffer-clear-filter-groups ()
568 "Remove all filtering groups."
570 (setq ibuffer-filter-groups nil
571 ibuffer-hidden-filter-groups nil
)
572 (ibuffer-update nil t
))
574 (defun ibuffer-current-filter-groups-with-position ()
576 (goto-char (point-min))
579 (while (and (not (eobp))
580 (setq pos
(next-single-property-change
581 (point) 'ibuffer-filter-group-name
)))
583 (push (cons (get-text-property (point) 'ibuffer-filter-group-name
)
586 (goto-char (next-single-property-change
587 pos
'ibuffer-filter-group-name
)))
591 (defun ibuffer-jump-to-filter-group (name)
592 "Move point to the filter group whose name is NAME."
593 (interactive (list nil
))
594 (let ((table (ibuffer-current-filter-groups-with-position)))
595 (when (interactive-p)
596 (setq name
(completing-read "Jump to filter group: " table nil t
)))
597 (ibuffer-aif (assoc name table
)
599 (error "No filter group with name %s" name
))))
602 (defun ibuffer-kill-filter-group (name)
603 "Delete the filtering group named NAME."
604 (interactive (list nil
))
605 (when (interactive-p)
606 (setq name
(completing-read "Kill filter group: "
607 ibuffer-filter-groups nil t
)))
608 (ibuffer-aif (assoc name ibuffer-filter-groups
)
610 (setq ibuffer-filter-groups
(ibuffer-delete-alist
611 name ibuffer-filter-groups
))
612 (setq ibuffer-hidden-filter-groups
613 delete name ibuffer-hidden-filter-groups
))
614 (error "No filter group with name \"%s\"" name
))
615 (ibuffer-update nil t
))
618 (defun ibuffer-kill-line (&optional arg
)
620 (ibuffer-aif (save-excursion
621 (ibuffer-forward-line 0)
622 (get-text-property (point) 'ibuffer-filter-group-name
))
624 (when (equal it
"Default")
625 (error "Can't kill default filtering group"))
626 (push (assoc it ibuffer-filter-groups
) ibuffer-filter-group-kill-ring
)
627 (ibuffer-kill-filter-group it
))
628 (funcall (if (interactive-p) #'call-interactively
#'funcall
)
632 (defun ibuffer-yank (&optional arg
)
634 (unless ibuffer-filter-group-kill-ring
635 (error "ibuffer-filter-group-kill-ring is empty"))
637 (ibuffer-forward-line 0)
638 (let* ((last-killed (pop ibuffer-filter-group-kill-ring
))
639 (all-groups ibuffer-filter-groups
)
640 (cur (or (get-text-property (point) 'ibuffer-filter-group-name
)
641 (get-text-property (point) 'ibuffer-filter-group
)
643 (pos (or (position cur
(mapcar #'car all-groups
) :test
#'equal
)
644 (1- (length all-groups
)))))
646 (push last-killed ibuffer-filter-groups
))
647 ((= pos
(1- (length all-groups
)))
648 (setq ibuffer-filter-groups
649 (nconc ibuffer-filter-groups
(list last-killed
))))
651 (let ((cell (nthcdr pos ibuffer-filter-groups
)))
652 (setf (cdr cell
) (cons (car cell
) (cdr cell
)))
653 (setf (car cell
) last-killed
))))))
654 (ibuffer-update nil t
))
657 (defun ibuffer-save-filter-groups (name groups
)
658 "Save all active filter groups GROUPS as NAME.
659 They are added to `ibuffer-saved-filter-groups'. Interactively,
660 prompt for NAME, and use the current filters."
662 (if (null ibuffer-filter-groups
)
663 (error "No filter groups active")
665 (read-from-minibuffer "Save current filter groups as: ")
666 ibuffer-filter-groups
)))
667 (ibuffer-aif (assoc name ibuffer-saved-filter-groups
)
669 (push (cons name groups
) ibuffer-saved-filter-groups
))
670 (ibuffer-maybe-save-stuff)
671 (ibuffer-update-mode-name))
674 (defun ibuffer-delete-saved-filter-groups (name)
675 "Delete saved filter groups with NAME.
676 They are removed from `ibuffer-saved-filter-groups'."
679 (if (null ibuffer-saved-filter-groups
)
680 (error "No saved filters")
681 (completing-read "Delete saved filters: "
682 ibuffer-saved-filter-groups nil t
))))
683 (setq ibuffer-saved-filter-groups
684 (ibuffer-delete-alist name ibuffer-saved-filter-groups
))
685 (ibuffer-maybe-save-stuff)
686 (ibuffer-update nil t
))
689 (defun ibuffer-switch-to-saved-filter-groups (name)
690 "Set this buffer's filter groups to saved version with NAME.
691 The value from `ibuffer-saved-filters' is used.
692 If prefix argument ADD is non-nil, then add the saved filters instead
693 of replacing the current filters."
696 (if (null ibuffer-saved-filter-groups
)
697 (error "No saved filters")
698 (completing-read "Switch to saved filter group: "
699 ibuffer-saved-filter-groups nil t
))))
700 (setq ibuffer-filter-groups
(cdr (assoc name ibuffer-saved-filter-groups
))
701 ibuffer-hidden-filter-groups nil
)
702 (ibuffer-update nil t
))
705 (defun ibuffer-filter-disable ()
706 "Disable all filters currently in effect in this buffer."
708 (setq ibuffer-filtering-qualifiers nil
)
709 (ibuffer-update nil t
))
712 (defun ibuffer-pop-filter ()
713 "Remove the top filter in this buffer."
715 (when (null ibuffer-filtering-qualifiers
)
716 (error "No filters in effect"))
717 (pop ibuffer-filtering-qualifiers
)
718 (ibuffer-update nil t
))
720 (defun ibuffer-push-filter (qualifier)
721 "Add QUALIFIER to `ibuffer-filtering-qualifiers'."
722 (push qualifier ibuffer-filtering-qualifiers
))
725 (defun ibuffer-decompose-filter ()
726 "Separate the top compound filter (OR, NOT, or SAVED) in this buffer.
728 This means that the topmost filter on the filtering stack, which must
729 be a complex filter like (OR [name: foo] [mode: bar-mode]), will be
730 turned into two separate filters [name: foo] and [mode: bar-mode]."
732 (when (null ibuffer-filtering-qualifiers
)
733 (error "No filters in effect"))
734 (let ((lim (pop ibuffer-filtering-qualifiers
)))
737 (setq ibuffer-filtering-qualifiers
(append
739 ibuffer-filtering-qualifiers
)))
743 ibuffer-saved-filters
)))
745 (ibuffer-filter-disable)
746 (error "Unknown saved filter %s" (cdr lim
)))
747 (setq ibuffer-filtering-qualifiers
(append
749 ibuffer-filtering-qualifiers
))))
752 ibuffer-filtering-qualifiers
))
754 (error "Filter type %s is not compound" (car lim
)))))
755 (ibuffer-update nil t
))
758 (defun ibuffer-exchange-filters ()
759 "Exchange the top two filters on the stack in this buffer."
761 (when (< (length ibuffer-filtering-qualifiers
)
763 (error "Need two filters to exchange"))
764 (let ((first (pop ibuffer-filtering-qualifiers
))
765 (second (pop ibuffer-filtering-qualifiers
)))
766 (push first ibuffer-filtering-qualifiers
)
767 (push second ibuffer-filtering-qualifiers
))
768 (ibuffer-update nil t
))
771 (defun ibuffer-negate-filter ()
772 "Negate the sense of the top filter in the current buffer."
774 (when (null ibuffer-filtering-qualifiers
)
775 (error "No filters in effect"))
776 (let ((lim (pop ibuffer-filtering-qualifiers
)))
777 (push (if (eq (car lim
) 'not
)
780 ibuffer-filtering-qualifiers
))
781 (ibuffer-update nil t
))
784 (defun ibuffer-or-filter (&optional reverse
)
785 "Replace the top two filters in this buffer with their logical OR.
786 If optional argument REVERSE is non-nil, instead break the top OR
791 (when (or (null ibuffer-filtering-qualifiers
)
792 (not (eq 'or
(caar ibuffer-filtering-qualifiers
))))
793 (error "Top filter is not an OR"))
794 (let ((lim (pop ibuffer-filtering-qualifiers
)))
795 (setq ibuffer-filtering-qualifiers
(nconc (cdr lim
) ibuffer-filtering-qualifiers
))))
796 (when (< (length ibuffer-filtering-qualifiers
) 2)
797 (error "Need two filters to OR"))
798 ;; If the second filter is an OR, just add to it.
799 (let ((first (pop ibuffer-filtering-qualifiers
))
800 (second (pop ibuffer-filtering-qualifiers
)))
801 (if (eq 'or
(car second
))
802 (push (nconc (list 'or first
) (cdr second
)) ibuffer-filtering-qualifiers
)
803 (push (list 'or first second
)
804 ibuffer-filtering-qualifiers
))))
805 (ibuffer-update nil t
))
807 (defun ibuffer-maybe-save-stuff ()
808 (when ibuffer-save-with-custom
809 (if (fboundp 'customize-save-variable
)
811 (customize-save-variable 'ibuffer-saved-filters
812 ibuffer-saved-filters
)
813 (customize-save-variable 'ibuffer-saved-filter-groups
814 ibuffer-saved-filter-groups
))
815 (message "Not saved permanently: Customize not available"))))
818 (defun ibuffer-save-filters (name filters
)
819 "Save FILTERS in this buffer with name NAME in `ibuffer-saved-filters'.
820 Interactively, prompt for NAME, and use the current filters."
822 (if (null ibuffer-filtering-qualifiers
)
823 (error "No filters currently in effect")
825 (read-from-minibuffer "Save current filters as: ")
826 ibuffer-filtering-qualifiers
)))
827 (ibuffer-aif (assoc name ibuffer-saved-filters
)
829 (push (list name filters
) ibuffer-saved-filters
))
830 (ibuffer-maybe-save-stuff)
831 (ibuffer-update-mode-name))
834 (defun ibuffer-delete-saved-filters (name)
835 "Delete saved filters with NAME from `ibuffer-saved-filters'."
838 (if (null ibuffer-saved-filters
)
839 (error "No saved filters")
840 (completing-read "Delete saved filters: "
841 ibuffer-saved-filters nil t
))))
842 (setq ibuffer-saved-filters
843 (ibuffer-delete-alist name ibuffer-saved-filters
))
844 (ibuffer-maybe-save-stuff)
845 (ibuffer-update nil t
))
848 (defun ibuffer-add-saved-filters (name)
849 "Add saved filters from `ibuffer-saved-filters' to this buffer's filters."
852 (if (null ibuffer-saved-filters
)
853 (error "No saved filters")
854 (completing-read "Add saved filters: "
855 ibuffer-saved-filters nil t
))))
856 (push (cons 'saved name
) ibuffer-filtering-qualifiers
)
857 (ibuffer-update nil t
))
860 (defun ibuffer-switch-to-saved-filters (name)
861 "Set this buffer's filters to filters with NAME from `ibuffer-saved-filters'.
862 If prefix argument ADD is non-nil, then add the saved filters instead
863 of replacing the current filters."
866 (if (null ibuffer-saved-filters
)
867 (error "No saved filters")
868 (completing-read "Switch to saved filters: "
869 ibuffer-saved-filters nil t
))))
870 (setq ibuffer-filtering-qualifiers
(list (cons 'saved name
)))
871 (ibuffer-update nil t
))
873 (defun ibuffer-format-qualifier (qualifier)
874 (if (eq (car-safe qualifier
) 'not
)
875 (concat " [NOT" (ibuffer-format-qualifier-1 (cdr qualifier
)) "]")
876 (ibuffer-format-qualifier-1 qualifier
)))
878 (defun ibuffer-format-qualifier-1 (qualifier)
879 (case (car qualifier
)
881 (concat " [filter: " (cdr qualifier
) "]"))
883 (concat " [OR" (mapconcat #'ibuffer-format-qualifier
884 (cdr qualifier
) "") "]"))
886 (let ((type (assq (car qualifier
) ibuffer-filtering-alist
)))
888 (error "Ibuffer: bad qualifier %s" qualifier
))
889 (concat " [" (cadr type
) ": " (format "%s]" (cdr qualifier
)))))))
891 ;;; Extra operation definitions
893 ;;;###autoload (autoload 'ibuffer-filter-by-mode "ibuf-ext.el")
894 (define-ibuffer-filter mode
895 "Toggle current view to buffers with major mode QUALIFIER."
896 (:description
"major mode"
899 (completing-read "Filter by major mode: " obarray
901 (string-match "-mode$"
904 (let ((buf (ibuffer-current-buffer)))
905 (if (and buf
(buffer-live-p buf
))
906 (with-current-buffer buf
907 (symbol-name major-mode
))
909 (eq qualifier
(with-current-buffer buf major-mode
)))
911 ;;;###autoload (autoload 'ibuffer-filter-by-name "ibuf-ext.el")
912 (define-ibuffer-filter name
913 "Toggle current view to buffers with name matching QUALIFIER."
914 (:description
"buffer name"
915 :reader
(read-from-minibuffer "Filter by name (regexp): "))
916 (string-match qualifier
(buffer-name buf
)))
918 ;;;###autoload (autoload 'ibuffer-filter-by-filename "ibuf-ext.el")
919 (define-ibuffer-filter filename
920 "Toggle current view to buffers with filename matching QUALIFIER."
921 (:description
"filename"
922 :reader
(read-from-minibuffer "Filter by filename (regexp): "))
923 (ibuffer-awhen (buffer-file-name buf
)
924 (string-match qualifier it
)))
926 ;;;###autoload (autoload 'ibuffer-filter-by-size-gt "ibuf-ext.el")
927 (define-ibuffer-filter size-gt
928 "Toggle current view to buffers with size greater than QUALIFIER."
929 (:description
"size greater than"
931 (string-to-number (read-from-minibuffer "Filter by size greater than: ")))
932 (> (with-current-buffer buf
(buffer-size))
935 ;;;###autoload (autoload 'ibuffer-filter-by-size-lt "ibuf-ext.el")
936 (define-ibuffer-filter size-lt
937 "Toggle current view to buffers with size less than QUALIFIER."
938 (:description
"size less than"
940 (string-to-number (read-from-minibuffer "Filter by size less than: ")))
941 (< (with-current-buffer buf
(buffer-size))
944 ;;;###autoload (autoload 'ibuffer-filter-by-content "ibuf-ext.el")
945 (define-ibuffer-filter content
946 "Toggle current view to buffers whose contents match QUALIFIER."
947 (:description
"content"
948 :reader
(read-from-minibuffer "Filter by content (regexp): "))
949 (with-current-buffer buf
951 (goto-char (point-min))
952 (re-search-forward qualifier nil t
))))
954 ;;;###autoload (autoload 'ibuffer-filter-by-predicate "ibuf-ext.el")
955 (define-ibuffer-filter predicate
956 "Toggle current view to buffers for which QUALIFIER returns non-nil."
957 (:description
"predicate"
958 :reader
(read-minibuffer "Filter by predicate (form): "))
959 (with-current-buffer buf
965 (defun ibuffer-toggle-sorting-mode ()
966 "Toggle the current sorting mode.
967 Default sorting modes are:
968 Recency - the last time the buffer was viewed
969 Name - the name of the buffer
970 Major Mode - the name of the major mode of the buffer
971 Size - the size of the buffer"
973 (let ((modes (mapcar 'car ibuffer-sorting-functions-alist
)))
974 (add-to-list 'modes
'recency
)
975 (setq modes
(sort modes
'string-lessp
))
976 (let ((next (or (car-safe (cdr-safe (memq ibuffer-sorting-mode modes
)))
978 (setq ibuffer-sorting-mode next
)
979 (message "Sorting by %s" next
)))
980 (ibuffer-redisplay t
))
983 (defun ibuffer-invert-sorting ()
984 "Toggle whether or not sorting is in reverse order."
986 (setq ibuffer-sorting-reversep
(not ibuffer-sorting-reversep
))
987 (message "Sorting order %s"
988 (if ibuffer-sorting-reversep
991 (ibuffer-redisplay t
))
993 ;;;###autoload (autoload 'ibuffer-do-sort-by-major-mode "ibuf-ext.el")
994 (define-ibuffer-sorter major-mode
995 "Sort the buffers by major modes.
996 Ordering is lexicographic."
997 (:description
"major mode")
998 (string-lessp (downcase
999 (symbol-name (with-current-buffer
1003 (symbol-name (with-current-buffer
1007 ;;;###autoload (autoload 'ibuffer-do-sort-by-mode-name "ibuf-ext.el")
1008 (define-ibuffer-sorter mode-name
1009 "Sort the buffers by their mode name.
1010 Ordering is lexicographic."
1011 (:description
"major mode name")
1012 (string-lessp (downcase
1013 (with-current-buffer
1017 (with-current-buffer
1021 ;;;###autoload (autoload 'ibuffer-do-sort-by-alphabetic "ibuf-ext.el")
1022 (define-ibuffer-sorter alphabetic
1023 "Sort the buffers by their names.
1024 Ordering is lexicographic."
1025 (:description
"buffer name")
1027 (buffer-name (car a
))
1028 (buffer-name (car b
))))
1030 ;;;###autoload (autoload 'ibuffer-do-sort-by-size "ibuf-ext.el")
1031 (define-ibuffer-sorter size
1032 "Sort the buffers by their size."
1033 (:description
"size")
1034 (< (with-current-buffer (car a
)
1036 (with-current-buffer (car b
)
1039 ;;; Functions to emulate bs.el
1042 (defun ibuffer-bs-show ()
1043 "Emulate `bs-show' from the bs.el package."
1045 (ibuffer t
"*Ibuffer-bs*" '((filename .
".*")) nil t
)
1046 (define-key (current-local-map) "a" 'ibuffer-bs-toggle-all
))
1048 (defun ibuffer-bs-toggle-all ()
1049 "Emulate `bs-toggle-show-all' from the bs.el package."
1051 (if ibuffer-filtering-qualifiers
1052 (ibuffer-pop-filter)
1053 (progn (ibuffer-push-filter '(filename .
".*"))
1054 (ibuffer-update nil t
))))
1059 (defun ibuffer-add-to-tmp-hide (regexp)
1060 "Add REGEXP to `ibuffer-tmp-hide-regexps'.
1061 This means that buffers whose name matches REGEXP will not be shown
1062 for this ibuffer session."
1065 (read-from-minibuffer "Never show buffers matching: "
1066 (regexp-quote (buffer-name (ibuffer-current-buffer t
))))))
1067 (push regexp ibuffer-tmp-hide-regexps
))
1070 (defun ibuffer-add-to-tmp-show (regexp)
1071 "Add REGEXP to `ibuffer-tmp-show-regexps'.
1072 This means that buffers whose name matches REGEXP will always be shown
1073 for this ibuffer session."
1076 (read-from-minibuffer "Always show buffers matching: "
1077 (regexp-quote (buffer-name (ibuffer-current-buffer t
))))))
1078 (push regexp ibuffer-tmp-show-regexps
))
1081 (defun ibuffer-forward-next-marked (&optional count mark direction
)
1082 "Move forward by COUNT marked buffers (default 1).
1084 If MARK is non-nil, it should be a character denoting the type of mark
1085 to move by. The default is `ibuffer-marked-char'.
1087 If DIRECTION is non-nil, it should be an integer; negative integers
1088 mean move backwards, non-negative integers mean move forwards."
1093 (setq mark ibuffer-marked-char
))
1097 (ibuffer-forward-line 0)
1098 (let ((opos (point))
1100 (ibuffer-forward-line direction
)
1101 (while (not (or (= (point) opos
)
1102 (eq (setq curmark
(ibuffer-current-mark))
1104 (ibuffer-forward-line direction
))
1105 (when (and (= (point) opos
)
1106 (not (eq (ibuffer-current-mark) mark
)))
1107 (error "No buffers with mark %c" mark
))))
1110 (defun ibuffer-backwards-next-marked (&optional count mark
)
1111 "Move backwards by COUNT marked buffers (default 1).
1113 If MARK is non-nil, it should be a character denoting the type of mark
1114 to move by. The default is `ibuffer-marked-char'."
1116 (ibuffer-forward-next-marked count mark -
1))
1119 (defun ibuffer-do-kill-lines ()
1120 "Hide all of the currently marked lines."
1122 (if (= (ibuffer-count-marked-lines) 0)
1123 (message "No buffers marked; use 'm' to mark a buffer")
1125 (ibuffer-map-marked-lines
1126 #'(lambda (buf mark
)
1128 (message "Killed %s lines" count
))))
1131 (defun ibuffer-jump-to-buffer (name)
1132 "Move point to the buffer whose name is NAME."
1133 (interactive (list nil
))
1134 (let ((table (mapcar #'(lambda (x)
1135 (cons (buffer-name (car x
))
1137 (ibuffer-current-state-list t
))))
1139 (error "No buffers!"))
1140 (when (interactive-p)
1141 (setq name
(completing-read "Jump to buffer: " table nil t
)))
1142 (ibuffer-aif (assoc name table
)
1143 (goto-char (cdr it
))
1144 (error "No buffer with name %s" name
))))
1147 (defun ibuffer-diff-with-file ()
1148 "View the differences between this buffer and its associated file.
1149 This requires the external program \"diff\" to be in your `exec-path'."
1151 (let* ((buf (ibuffer-current-buffer))
1152 (buf-filename (with-current-buffer buf
1154 (unless (buffer-live-p buf
)
1155 (error "Buffer %s has been killed" buf
))
1156 (unless buf-filename
1157 (error "Buffer %s has no associated file" buf
))
1158 (let ((diff-buf (get-buffer-create "*Ibuffer-diff*")))
1159 (with-current-buffer diff-buf
1160 (setq buffer-read-only nil
)
1162 (let ((tempfile (make-temp-file "ibuffer-diff-")))
1165 (with-current-buffer buf
1166 (write-region (point-min) (point-max) tempfile nil
'nomessage
))
1168 (apply #'call-process
"diff" nil diff-buf nil
1170 (when (and (boundp 'ediff-custom-diff-options
)
1171 (stringp ediff-custom-diff-options
))
1172 (list ediff-custom-diff-options
))
1173 (list buf-filename tempfile
))))
1174 (message "No differences found")
1176 (with-current-buffer diff-buf
1177 (goto-char (point-min))
1178 (if (fboundp 'diff-mode
)
1180 (fundamental-mode)))
1181 (display-buffer diff-buf
))))
1182 (when (file-exists-p tempfile
)
1183 (delete-file tempfile
)))))
1187 (defun ibuffer-copy-filename-as-kill (&optional arg
)
1188 "Copy filenames of marked buffers into the kill ring.
1189 The names are separated by a space.
1190 If a buffer has no filename, it is ignored.
1191 With a zero prefix arg, use the complete pathname of each marked file.
1193 You can then feed the file name(s) to other commands with C-y.
1195 [ This docstring shamelessly stolen from the
1196 `dired-copy-filename-as-kill' in \"dired-x\". ]"
1197 ;; Add to docstring later:
1198 ;; With C-u, use the relative pathname of each marked file.
1200 (if (= (ibuffer-count-marked-lines) 0)
1201 (message "No buffers marked; use 'm' to mark a buffer")
1202 (let ((ibuffer-copy-filename-as-kill-result "")
1203 (type (cond ((eql arg
0)
1209 (ibuffer-map-marked-lines
1210 #'(lambda (buf mark
)
1211 (setq ibuffer-copy-filename-as-kill-result
1212 (concat ibuffer-copy-filename-as-kill-result
1213 (let ((name (buffer-file-name buf
)))
1219 (file-name-nondirectory name
)))
1222 (push ibuffer-copy-filename-as-kill-result kill-ring
))))
1224 (defun ibuffer-mark-on-buffer (func &optional ibuffer-mark-on-buffer-mark group
)
1227 #'(lambda (buf mark
)
1228 (when (funcall func buf
)
1229 (ibuffer-set-mark-1 (or ibuffer-mark-on-buffer-mark
1230 ibuffer-marked-char
))
1234 (ibuffer-redisplay t
)
1235 (message "Marked %s buffers" count
)))
1238 (defun ibuffer-mark-by-name-regexp (regexp)
1239 "Mark all buffers whose name matches REGEXP."
1240 (interactive "sMark by name (regexp): ")
1241 (ibuffer-mark-on-buffer
1243 (string-match regexp
(buffer-name buf
)))))
1246 (defun ibuffer-mark-by-mode-regexp (regexp)
1247 "Mark all buffers whose major mode matches REGEXP."
1248 (interactive "sMark by major mode (regexp): ")
1249 (ibuffer-mark-on-buffer
1251 (with-current-buffer buf
1252 (string-match regexp mode-name
)))))
1255 (defun ibuffer-mark-by-file-name-regexp (regexp)
1256 "Mark all buffers whose file name matches REGEXP."
1257 (interactive "sMark by file name (regexp): ")
1258 (ibuffer-mark-on-buffer
1260 (let ((name (or (buffer-file-name buf
)
1261 (with-current-buffer buf
1263 (boundp 'dired-directory
)
1264 (stringp dired-directory
)
1265 dired-directory
)))))
1267 (string-match regexp name
))))))
1270 (defun ibuffer-mark-by-mode (mode)
1271 "Mark all buffers whose major mode equals MODE."
1273 (list (intern (completing-read "Mark by major mode: " obarray
1275 ;; kind of a hack...
1277 (string-match "-mode$"
1280 (let ((buf (ibuffer-current-buffer)))
1281 (if (and buf
(buffer-live-p buf
))
1282 (with-current-buffer buf
1283 (cons (symbol-name major-mode
)
1286 (ibuffer-mark-on-buffer
1288 (with-current-buffer buf
1289 (eq major-mode mode
)))))
1292 (defun ibuffer-mark-modified-buffers ()
1293 "Mark all modified buffers."
1295 (ibuffer-mark-on-buffer
1296 #'(lambda (buf) (buffer-modified-p buf
))))
1299 (defun ibuffer-mark-unsaved-buffers ()
1300 "Mark all modified buffers that have an associated file."
1302 (ibuffer-mark-on-buffer
1303 #'(lambda (buf) (and (with-current-buffer buf buffer-file-name
)
1304 (buffer-modified-p buf
)))))
1307 (defun ibuffer-mark-dissociated-buffers ()
1308 "Mark all buffers whose associated file does not exist."
1310 (ibuffer-mark-on-buffer
1312 (with-current-buffer buf
1314 (and buffer-file-name
1315 (not (file-exists-p buffer-file-name
)))
1316 (and (eq major-mode
'dired-mode
)
1317 (boundp 'dired-directory
)
1318 (stringp dired-directory
)
1319 (not (file-exists-p (file-name-directory dired-directory
)))))))))
1322 (defun ibuffer-mark-help-buffers ()
1323 "Mark buffers like *Help*, *Apropos*, *Info*."
1325 (ibuffer-mark-on-buffer
1327 (with-current-buffer buf
1328 (memq major-mode ibuffer-help-buffer-modes
)))))
1331 (defun ibuffer-mark-old-buffers ()
1332 "Mark buffers which have not been viewed in `ibuffer-old-time' days."
1334 (ibuffer-mark-on-buffer
1336 (with-current-buffer buf
1337 ;; hacked from midnight.el
1338 (when buffer-display-time
1339 (let* ((tm (current-time))
1340 (now (+ (* (float (ash 1 16)) (car tm
))
1341 (float (cadr tm
)) (* 0.0000001 (caddr tm
))))
1342 (then (+ (* (float (ash 1 16))
1343 (car buffer-display-time
))
1344 (float (cadr buffer-display-time
))
1345 (* 0.0000001 (caddr buffer-display-time
)))))
1346 (> (- now then
) (* 60 60 ibuffer-old-time
))))))))
1349 (defun ibuffer-mark-special-buffers ()
1350 "Mark all buffers whose name begins and ends with '*'."
1352 (ibuffer-mark-on-buffer
1353 #'(lambda (buf) (string-match "^\\*.+\\*$"
1354 (buffer-name buf
)))))
1357 (defun ibuffer-mark-read-only-buffers ()
1358 "Mark all read-only buffers."
1360 (ibuffer-mark-on-buffer
1362 (with-current-buffer buf
1363 buffer-read-only
))))
1366 (defun ibuffer-mark-dired-buffers ()
1367 "Mark all `dired' buffers."
1369 (ibuffer-mark-on-buffer
1371 (with-current-buffer buf
1372 (eq major-mode
'dired-mode
)))))
1375 (defun ibuffer-do-occur (regexp &optional nlines
)
1376 "View lines which match REGEXP in all marked buffers.
1377 Optional argument NLINES says how many lines of context to display: it
1379 (interactive (occur-read-primary-args))
1380 (if (or (not (integerp nlines
))
1383 (when (zerop (ibuffer-count-marked-lines))
1384 (ibuffer-set-mark ibuffer-marked-char
))
1385 (let ((ibuffer-do-occur-bufs nil
))
1386 ;; Accumulate a list of marked buffers
1387 (ibuffer-map-marked-lines
1388 #'(lambda (buf mark
)
1389 (push buf ibuffer-do-occur-bufs
)))
1390 (occur-1 regexp nlines ibuffer-do-occur-bufs
)))
1394 ;;; ibuf-ext.el ends here