annotate lisp/ibuf-macs.el @ 109428:5ba21f4a3d62

Merge from mainline.
author Katsumi Yamaoka <yamaoka@jpl.org>
date Thu, 08 Jul 2010 22:47:34 +0000
parents 1d1d5d9bd884
children a3e1f7134e6e 376148b31b5e
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
42702
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
1 ;;; ibuf-macs.el --- macros for ibuffer
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
2
64762
41bb365f41c4 Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 64091
diff changeset
3 ;; Copyright (C) 2000, 2001, 2002, 2003, 2004,
106815
1d1d5d9bd884 Add 2010 to copyright years.
Glenn Morris <rgm@gnu.org>
parents: 100908
diff changeset
4 ;; 2005, 2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc.
42702
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
5
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
6 ;; Author: Colin Walters <walters@verbum.org>
49410
798119a6859c * ibuffer.el (ibuffer-window-list): Remove.
John Paul Wallington <jpw@pobox.com>
parents: 47740
diff changeset
7 ;; Maintainer: John Paul Wallington <jpw@gnu.org>
42702
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
8 ;; Created: 6 Dec 2001
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
9 ;; Keywords: buffer, convenience
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
10
44831
56a3e3132102 (ibuffer-save-marks): Call `ibuffer-redisplay-engine'.
Colin Walters <walters@gnu.org>
parents: 44573
diff changeset
11 ;; This file is part of GNU Emacs.
42702
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
12
94678
ee5932bf781d Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 94508
diff changeset
13 ;; GNU Emacs is free software: you can redistribute it and/or modify
ee5932bf781d Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 94508
diff changeset
14 ;; it under the terms of the GNU General Public License as published by
ee5932bf781d Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 94508
diff changeset
15 ;; the Free Software Foundation, either version 3 of the License, or
ee5932bf781d Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 94508
diff changeset
16 ;; (at your option) any later version.
42702
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
17
94678
ee5932bf781d Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 94508
diff changeset
18 ;; GNU Emacs is distributed in the hope that it will be useful,
ee5932bf781d Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 94508
diff changeset
19 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
ee5932bf781d Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 94508
diff changeset
20 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
ee5932bf781d Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 94508
diff changeset
21 ;; GNU General Public License for more details.
42702
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
22
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
23 ;; You should have received a copy of the GNU General Public License
94678
ee5932bf781d Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 94508
diff changeset
24 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
42702
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
25
45078
829beb9a6a4b Follow coding conventions.
Pavel Janík <Pavel@Janik.cz>
parents: 44831
diff changeset
26 ;;; Commentary:
829beb9a6a4b Follow coding conventions.
Pavel Janík <Pavel@Janik.cz>
parents: 44831
diff changeset
27
42702
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
28 ;;; Code:
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
29
42770
a7530850a26c (toplevel): Require `cl' when compiling.
Colin Walters <walters@gnu.org>
parents: 42702
diff changeset
30 (eval-when-compile
a7530850a26c (toplevel): Require `cl' when compiling.
Colin Walters <walters@gnu.org>
parents: 42702
diff changeset
31 (require 'cl))
a7530850a26c (toplevel): Require `cl' when compiling.
Colin Walters <walters@gnu.org>
parents: 42702
diff changeset
32
42702
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
33 ;; From Paul Graham's "ANSI Common Lisp", adapted for Emacs Lisp here.
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
34 (defmacro ibuffer-aif (test true-body &rest false-body)
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
35 "Evaluate TRUE-BODY or FALSE-BODY depending on value of TEST.
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
36 If TEST returns non-nil, bind `it' to the value, and evaluate
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
37 TRUE-BODY. Otherwise, evaluate forms in FALSE-BODY as if in `progn'.
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
38 Compare with `if'."
94978
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
39 (declare (indent 2))
50010
d19b54decc23 (ibuffer-aif): Use `make-symbol' instead of
John Paul Wallington <jpw@pobox.com>
parents: 49588
diff changeset
40 (let ((sym (make-symbol "ibuffer-aif-sym")))
42702
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
41 `(let ((,sym ,test))
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
42 (if ,sym
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
43 (let ((it ,sym))
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
44 ,true-body)
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
45 (progn
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
46 ,@false-body)))))
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
47
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
48 (defmacro ibuffer-awhen (test &rest body)
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
49 "Evaluate BODY if TEST returns non-nil.
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
50 During evaluation of body, bind `it' to the value returned by TEST."
94978
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
51 (declare (indent 1))
42702
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
52 `(ibuffer-aif ,test
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
53 (progn ,@body)
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
54 nil))
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
55
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
56 (defmacro ibuffer-save-marks (&rest body)
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
57 "Save the marked status of the buffers and execute BODY; restore marks."
94978
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
58 (declare (indent 0))
50010
d19b54decc23 (ibuffer-aif): Use `make-symbol' instead of
John Paul Wallington <jpw@pobox.com>
parents: 49588
diff changeset
59 (let ((bufsym (make-symbol "bufsym")))
42702
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
60 `(let ((,bufsym (current-buffer))
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
61 (ibuffer-save-marks-tmp-mark-list (ibuffer-current-state-list)))
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
62 (unwind-protect
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
63 (progn
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
64 (save-excursion
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
65 ,@body))
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
66 (with-current-buffer ,bufsym
44831
56a3e3132102 (ibuffer-save-marks): Call `ibuffer-redisplay-engine'.
Colin Walters <walters@gnu.org>
parents: 44573
diff changeset
67 (ibuffer-redisplay-engine
42702
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
68 ;; Get rid of dead buffers
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
69 (delq nil
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
70 (mapcar #'(lambda (e) (when (buffer-live-p (car e))
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
71 e))
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
72 ibuffer-save-marks-tmp-mark-list)))
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
73 (ibuffer-redisplay t))))))
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
74
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
75 ;;;###autoload
94978
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
76 (defmacro* define-ibuffer-column (symbol (&key name inline props summarizer
69764
986a4b641e9e * ibuf-macs.el (define-ibuffer-column): Add a new key:
Dan Nicolaescu <dann@ics.uci.edu>
parents: 68651
diff changeset
77 header-mouse-map) &rest body)
42702
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
78 "Define a column SYMBOL for use with `ibuffer-formats'.
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
79
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
80 BODY will be called with `buffer' bound to the buffer object, and
45442
5bc8bee6a228 (define-ibuffer-column): Add third argument `ibuffer-buf'.
Colin Walters <walters@gnu.org>
parents: 45078
diff changeset
81 `mark' bound to the current mark on the buffer. The original ibuffer
5bc8bee6a228 (define-ibuffer-column): Add third argument `ibuffer-buf'.
Colin Walters <walters@gnu.org>
parents: 45078
diff changeset
82 buffer will be bound to `ibuffer-buf'.
42702
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
83
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
84 If NAME is given, it will be used as a title for the column.
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
85 Otherwise, the title will default to a capitalized version of the
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
86 SYMBOL's name. PROPS is a plist of additional properties to add to
43103
7f95aeaa47b3 (define-ibuffer-column): Add beginnings of support for a summary
Colin Walters <walters@gnu.org>
parents: 42770
diff changeset
87 the text, such as `mouse-face'. And SUMMARIZER, if given, is a
7f95aeaa47b3 (define-ibuffer-column): Add beginnings of support for a summary
Colin Walters <walters@gnu.org>
parents: 42770
diff changeset
88 function which will be passed a list of all the strings in its column;
7f95aeaa47b3 (define-ibuffer-column): Add beginnings of support for a summary
Colin Walters <walters@gnu.org>
parents: 42770
diff changeset
89 it should return a string to display at the bottom.
42702
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
90
69768
cbdede292c6e (define-ibuffer-column): Document the new parameter.
Dan Nicolaescu <dann@ics.uci.edu>
parents: 69764
diff changeset
91 If HEADER-MOUSE-MAP is given, it will be used as a keymap for the
cbdede292c6e (define-ibuffer-column): Document the new parameter.
Dan Nicolaescu <dann@ics.uci.edu>
parents: 69764
diff changeset
92 title of the column.
cbdede292c6e (define-ibuffer-column): Document the new parameter.
Dan Nicolaescu <dann@ics.uci.edu>
parents: 69764
diff changeset
93
42702
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
94 Note that this macro expands into a `defun' for a function named
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
95 ibuffer-make-column-NAME. If INLINE is non-nil, then the form will be
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
96 inlined into the compiled format versions. This means that if you
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
97 change its definition, you should explicitly call
55509
dbf692d994dc (define-ibuffer-column, define-ibuffer-sorter, define-ibuffer-filter): Add usage
Juanma Barranquero <lekktu@gmail.com>
parents: 52401
diff changeset
98 `ibuffer-recompile-formats'.
dbf692d994dc (define-ibuffer-column, define-ibuffer-sorter, define-ibuffer-filter): Add usage
Juanma Barranquero <lekktu@gmail.com>
parents: 52401
diff changeset
99
dbf692d994dc (define-ibuffer-column, define-ibuffer-sorter, define-ibuffer-filter): Add usage
Juanma Barranquero <lekktu@gmail.com>
parents: 52401
diff changeset
100 \(fn SYMBOL (&key NAME INLINE PROPS SUMMARIZER) &rest BODY)"
94978
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
101 (declare (indent defun))
42702
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
102 (let* ((sym (intern (concat "ibuffer-make-column-"
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
103 (symbol-name symbol))))
43767
6bc5cbc8912d (define-ibuffer-column): Add :summarizer property.
Colin Walters <walters@gnu.org>
parents: 43103
diff changeset
104 (bod-1 `(with-current-buffer buffer
42702
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
105 ,@body))
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
106 (bod (if props
94978
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
107 `(propertize
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
108 ,bod-1
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
109 ,@props)
42702
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
110 bod-1)))
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
111 `(progn
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
112 ,(if inline
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
113 `(push '(,sym ,bod) ibuffer-inline-columns)
45709
77b4e2d5f8dd (define-ibuffer-column): Don't create a third argument for the
Colin Walters <walters@gnu.org>
parents: 45442
diff changeset
114 `(defun ,sym (buffer mark)
42702
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
115 ,bod))
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
116 (put (quote ,sym) 'ibuffer-column-name
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
117 ,(if (stringp name)
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
118 name
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
119 (capitalize (symbol-name symbol))))
69764
986a4b641e9e * ibuf-macs.el (define-ibuffer-column): Add a new key:
Dan Nicolaescu <dann@ics.uci.edu>
parents: 68651
diff changeset
120 ,(if header-mouse-map `(put (quote ,sym) 'header-mouse-map ,header-mouse-map))
43103
7f95aeaa47b3 (define-ibuffer-column): Add beginnings of support for a summary
Colin Walters <walters@gnu.org>
parents: 42770
diff changeset
121 ,(if summarizer
43767
6bc5cbc8912d (define-ibuffer-column): Add :summarizer property.
Colin Walters <walters@gnu.org>
parents: 43103
diff changeset
122 ;; Store the name of the summarizing function.
43103
7f95aeaa47b3 (define-ibuffer-column): Add beginnings of support for a summary
Colin Walters <walters@gnu.org>
parents: 42770
diff changeset
123 `(put (quote ,sym) 'ibuffer-column-summarizer
7f95aeaa47b3 (define-ibuffer-column): Add beginnings of support for a summary
Colin Walters <walters@gnu.org>
parents: 42770
diff changeset
124 (quote ,summarizer)))
7f95aeaa47b3 (define-ibuffer-column): Add beginnings of support for a summary
Colin Walters <walters@gnu.org>
parents: 42770
diff changeset
125 ,(if summarizer
43767
6bc5cbc8912d (define-ibuffer-column): Add :summarizer property.
Colin Walters <walters@gnu.org>
parents: 43103
diff changeset
126 ;; This will store the actual values of the column
6bc5cbc8912d (define-ibuffer-column): Add :summarizer property.
Colin Walters <walters@gnu.org>
parents: 43103
diff changeset
127 ;; summary.
6bc5cbc8912d (define-ibuffer-column): Add :summarizer property.
Colin Walters <walters@gnu.org>
parents: 43103
diff changeset
128 `(put (quote ,sym) 'ibuffer-column-summary nil))
42702
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
129 :autoload-end)))
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
130
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
131 ;;;###autoload
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
132 (defmacro* define-ibuffer-sorter (name documentation
49588
37645a051842 Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents: 49410
diff changeset
133 (&key
42702
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
134 description)
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
135 &rest body)
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
136 "Define a method of sorting named NAME.
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
137 DOCUMENTATION is the documentation of the function, which will be called
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
138 `ibuffer-do-sort-by-NAME'.
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
139 DESCRIPTION is a short string describing the sorting method.
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
140
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
141 For sorting, the forms in BODY will be evaluated with `a' bound to one
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
142 buffer object, and `b' bound to another. BODY should return a non-nil
55509
dbf692d994dc (define-ibuffer-column, define-ibuffer-sorter, define-ibuffer-filter): Add usage
Juanma Barranquero <lekktu@gmail.com>
parents: 52401
diff changeset
143 value if and only if `a' is \"less than\" `b'.
dbf692d994dc (define-ibuffer-column, define-ibuffer-sorter, define-ibuffer-filter): Add usage
Juanma Barranquero <lekktu@gmail.com>
parents: 52401
diff changeset
144
dbf692d994dc (define-ibuffer-column, define-ibuffer-sorter, define-ibuffer-filter): Add usage
Juanma Barranquero <lekktu@gmail.com>
parents: 52401
diff changeset
145 \(fn NAME DOCUMENTATION (&key DESCRIPTION) &rest BODY)"
94978
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
146 (declare (indent 1))
42702
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
147 `(progn
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
148 (defun ,(intern (concat "ibuffer-do-sort-by-" (symbol-name name))) ()
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
149 ,(or documentation "No :documentation specified for this sorting method.")
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
150 (interactive)
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
151 (setq ibuffer-sorting-mode ',name)
94508
4d31120b081e (define-ibuffer-sorter): Define the sorter to reverse sorting order if
John Paul Wallington <jpw@pobox.com>
parents: 93975
diff changeset
152 (when (eq ibuffer-sorting-mode ibuffer-last-sorting-mode)
4d31120b081e (define-ibuffer-sorter): Define the sorter to reverse sorting order if
John Paul Wallington <jpw@pobox.com>
parents: 93975
diff changeset
153 (setq ibuffer-sorting-reversep (not ibuffer-sorting-reversep)))
4d31120b081e (define-ibuffer-sorter): Define the sorter to reverse sorting order if
John Paul Wallington <jpw@pobox.com>
parents: 93975
diff changeset
154 (ibuffer-redisplay t)
4d31120b081e (define-ibuffer-sorter): Define the sorter to reverse sorting order if
John Paul Wallington <jpw@pobox.com>
parents: 93975
diff changeset
155 (setq ibuffer-last-sorting-mode ',name))
42702
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
156 (push (list ',name ,description
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
157 #'(lambda (a b)
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
158 ,@body))
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
159 ibuffer-sorting-functions-alist)
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
160 :autoload-end))
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
161
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
162 ;;;###autoload
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
163 (defmacro* define-ibuffer-op (op args
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
164 documentation
49588
37645a051842 Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents: 49410
diff changeset
165 (&key
42702
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
166 interactive
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
167 mark
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
168 modifier-p
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
169 dangerous
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
170 (opstring "operated on")
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
171 (active-opstring "Operate on")
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
172 complex)
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
173 &rest body)
45442
5bc8bee6a228 (define-ibuffer-column): Add third argument `ibuffer-buf'.
Colin Walters <walters@gnu.org>
parents: 45078
diff changeset
174 "Generate a function which operates on a buffer.
5bc8bee6a228 (define-ibuffer-column): Add third argument `ibuffer-buf'.
Colin Walters <walters@gnu.org>
parents: 45078
diff changeset
175 OP becomes the name of the function; if it doesn't begin with
5bc8bee6a228 (define-ibuffer-column): Add third argument `ibuffer-buf'.
Colin Walters <walters@gnu.org>
parents: 45078
diff changeset
176 `ibuffer-do-', then that is prepended to it.
42702
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
177 When an operation is performed, this function will be called once for
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
178 each marked buffer, with that buffer current.
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
179
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
180 ARGS becomes the formal parameters of the function.
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
181 DOCUMENTATION becomes the docstring of the function.
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
182 INTERACTIVE becomes the interactive specification of the function.
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
183 MARK describes which type of mark (:deletion, or nil) this operation
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
184 uses. :deletion means the function operates on buffers marked for
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
185 deletion, otherwise it acts on normally marked buffers.
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
186 MODIFIER-P describes how the function modifies buffers. This is used
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
187 to set the modification flag of the Ibuffer buffer itself. Valid
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
188 values are:
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
189 nil - the function never modifiers buffers
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
190 t - the function it always modifies buffers
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
191 :maybe - attempt to discover this information by comparing the
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
192 buffer's modification flag.
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
193 DANGEROUS is a boolean which should be set if the user should be
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
194 prompted before performing this operation.
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
195 OPSTRING is a string which will be displayed to the user after the
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
196 operation is complete, in the form:
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
197 \"Operation complete; OPSTRING x buffers\"
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
198 ACTIVE-OPSTRING is a string which will be displayed to the user in a
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
199 confirmation message, in the form:
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
200 \"Really ACTIVE-OPSTRING x buffers?\"
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
201 COMPLEX means this function is special; see the source code of this
55509
dbf692d994dc (define-ibuffer-column, define-ibuffer-sorter, define-ibuffer-filter): Add usage
Juanma Barranquero <lekktu@gmail.com>
parents: 52401
diff changeset
202 macro for exactly what it does.
dbf692d994dc (define-ibuffer-column, define-ibuffer-sorter, define-ibuffer-filter): Add usage
Juanma Barranquero <lekktu@gmail.com>
parents: 52401
diff changeset
203
dbf692d994dc (define-ibuffer-column, define-ibuffer-sorter, define-ibuffer-filter): Add usage
Juanma Barranquero <lekktu@gmail.com>
parents: 52401
diff changeset
204 \(fn OP ARGS DOCUMENTATION (&key INTERACTIVE MARK MODIFIER-P DANGEROUS OPSTRING ACTIVE-OPSTRING COMPLEX) &rest BODY)"
94978
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
205 (declare (indent 2))
42702
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
206 `(progn
94978
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
207 (defun ,(intern (concat (if (string-match "^ibuffer-do" (symbol-name op))
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
208 "" "ibuffer-do-") (symbol-name op)))
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
209 ,args
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
210 ,(if (stringp documentation)
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
211 documentation
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
212 (format "%s marked buffers." active-opstring))
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
213 ,(if (not (null interactive))
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
214 `(interactive ,interactive)
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
215 '(interactive))
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
216 (assert (derived-mode-p 'ibuffer-mode))
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
217 (setq ibuffer-did-modification nil)
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
218 (let ((marked-names (,(case mark
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
219 (:deletion
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
220 'ibuffer-deletion-marked-buffer-names)
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
221 (t
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
222 'ibuffer-marked-buffer-names)))))
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
223 (when (null marked-names)
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
224 (setq marked-names (list (buffer-name (ibuffer-current-buffer))))
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
225 (ibuffer-set-mark ,(case mark
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
226 (:deletion
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
227 'ibuffer-deletion-char)
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
228 (t
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
229 'ibuffer-marked-char))))
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
230 ,(let* ((finish (append
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
231 '(progn)
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
232 (if (eq modifier-p t)
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
233 '((setq ibuffer-did-modification t))
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
234 ())
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
235 `((ibuffer-redisplay t)
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
236 (message ,(concat "Operation finished; " opstring " %s buffers") count))))
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
237 (inner-body (if complex
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
238 `(progn ,@body)
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
239 `(progn
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
240 (with-current-buffer buf
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
241 (save-excursion
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
242 ,@body))
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
243 t)))
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
244 (body `(let ((count
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
245 (,(case mark
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
246 (:deletion
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
247 'ibuffer-map-deletion-lines)
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
248 (t
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
249 'ibuffer-map-marked-lines))
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
250 #'(lambda (buf mark)
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
251 ,(if (eq modifier-p :maybe)
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
252 `(let ((ibuffer-tmp-previous-buffer-modification
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
253 (buffer-modified-p buf)))
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
254 (prog1 ,inner-body
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
255 (when (not (eq ibuffer-tmp-previous-buffer-modification
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
256 (buffer-modified-p buf)))
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
257 (setq ibuffer-did-modification t))))
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
258 inner-body)))))
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
259 ,finish)))
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
260 (if dangerous
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
261 `(when (ibuffer-confirm-operation-on ,active-opstring marked-names)
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
262 ,body)
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
263 body))))
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
264 :autoload-end))
42702
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
265
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
266 ;;;###autoload
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
267 (defmacro* define-ibuffer-filter (name documentation
49588
37645a051842 Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents: 49410
diff changeset
268 (&key
42702
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
269 reader
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
270 description)
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
271 &rest body)
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
272 "Define a filter named NAME.
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
273 DOCUMENTATION is the documentation of the function.
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
274 READER is a form which should read a qualifier from the user.
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
275 DESCRIPTION is a short string describing the filter.
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
276
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
277 BODY should contain forms which will be evaluated to test whether or
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
278 not a particular buffer should be displayed or not. The forms in BODY
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
279 will be evaluated with BUF bound to the buffer object, and QUALIFIER
55509
dbf692d994dc (define-ibuffer-column, define-ibuffer-sorter, define-ibuffer-filter): Add usage
Juanma Barranquero <lekktu@gmail.com>
parents: 52401
diff changeset
280 bound to the current value of the filter.
dbf692d994dc (define-ibuffer-column, define-ibuffer-sorter, define-ibuffer-filter): Add usage
Juanma Barranquero <lekktu@gmail.com>
parents: 52401
diff changeset
281
dbf692d994dc (define-ibuffer-column, define-ibuffer-sorter, define-ibuffer-filter): Add usage
Juanma Barranquero <lekktu@gmail.com>
parents: 52401
diff changeset
282 \(fn NAME DOCUMENTATION (&key READER DESCRIPTION) &rest BODY)"
94978
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
283 (declare (indent 2))
42702
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
284 (let ((fn-name (intern (concat "ibuffer-filter-by-" (symbol-name name)))))
49588
37645a051842 Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents: 49410
diff changeset
285 `(progn
42702
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
286 (defun ,fn-name (qualifier)
94978
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
287 ,(or documentation "This filter is not documented.")
42702
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
288 (interactive (list ,reader))
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
289 (ibuffer-push-filter (cons ',name qualifier))
65582
4d1085b02d64 Message format spec fixes (1)
Deepak Goel <deego@gnufans.org>
parents: 64762
diff changeset
290 (message "%s"
94978
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
291 (format ,(concat (format "Filter by %s added: " description)
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
292 " %s")
af4982c7c0f6 (ibuffer-aif, ibuffer-awhen, ibuffer-save-marks)
John Paul Wallington <jpw@pobox.com>
parents: 94678
diff changeset
293 qualifier))
42702
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
294 (ibuffer-update nil t))
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
295 (push (list ',name ,description
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
296 #'(lambda (buf qualifier)
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
297 ,@body))
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
298 ibuffer-filtering-alist)
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
299 :autoload-end)))
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
300
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
301 (provide 'ibuf-macs)
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
302
93975
1e3a407766b9 Fix up comment convention on the arch-tag lines.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 79721
diff changeset
303 ;; arch-tag: 2748edce-82c9-4cd9-9d9d-bd73e43c20c5
42702
fb0b4579a45d Initial revision.
Colin Walters <walters@gnu.org>
parents:
diff changeset
304 ;;; ibuf-macs.el ends here