Mercurial > emacs
annotate lisp/chistory.el @ 97349:71b3b925a155
(Log Buffer): Describe C-c C-d.
(Diff Mode): Describe C-x 4 A.
author | Dan Nicolaescu <dann@ics.uci.edu> |
---|---|
date | Thu, 07 Aug 2008 05:21:28 +0000 |
parents | e495cfc33b5e |
children | d42aff5ca541 |
rev | line source |
---|---|
662
8a533acedb77
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
584
diff
changeset
|
1 ;;; chistory.el --- list command history |
8a533acedb77
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
584
diff
changeset
|
2 |
74439 | 3 ;; Copyright (C) 1985, 2001, 2002, 2003, 2004, 2005, |
79721 | 4 ;; 2006, 2007, 2008 Free Software Foundation, Inc. |
845 | 5 |
807
4f28bd14272c
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
662
diff
changeset
|
6 ;; Author: K. Shane Hartman |
4f28bd14272c
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
662
diff
changeset
|
7 ;; Maintainer: FSF |
45078 | 8 ;; Keywords: convenience |
411 | 9 |
10 ;; This file is part of GNU Emacs. | |
11 | |
94678
ee5932bf781d
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
93975
diff
changeset
|
12 ;; GNU Emacs is free software: you can redistribute it and/or modify |
411 | 13 ;; it under the terms of the GNU General Public License as published by |
94678
ee5932bf781d
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
93975
diff
changeset
|
14 ;; 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:
93975
diff
changeset
|
15 ;; (at your option) any later version. |
411 | 16 |
17 ;; GNU Emacs is distributed in the hope that it will be useful, | |
18 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of | |
19 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
20 ;; GNU General Public License for more details. | |
21 | |
22 ;; 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:
93975
diff
changeset
|
23 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. |
411 | 24 |
807
4f28bd14272c
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
662
diff
changeset
|
25 ;;; Commentary: |
411 | 26 |
27 ;; This really has nothing to do with list-command-history per se, but | |
9626
e928e72d3342
(repeat-matching-complex-command): Fix check for empty pattern. Simplify.
Karl Heuer <kwzh@gnu.org>
parents:
2452
diff
changeset
|
28 ;; its a nice alternative to C-x ESC ESC (repeat-complex-command) and |
411 | 29 ;; functions as a lister if given no pattern. It's not important |
30 ;; enough to warrant a file of its own. | |
31 | |
807
4f28bd14272c
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
662
diff
changeset
|
32 ;;; Code: |
4f28bd14272c
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
662
diff
changeset
|
33 |
21088 | 34 (defgroup chistory nil |
35 "List command history." | |
36 :group 'keyboard) | |
37 | |
411 | 38 ;;;###autoload |
39 (defun repeat-matching-complex-command (&optional pattern) | |
40 "Edit and re-evaluate complex command with name matching PATTERN. | |
41 Matching occurrences are displayed, most recent first, until you select | |
42 a form for evaluation. If PATTERN is empty (or nil), every form in the | |
43 command history is offered. The form is placed in the minibuffer for | |
44 editing and the result is evaluated." | |
45 (interactive "sRedo Command (regexp): ") | |
46 (if pattern | |
9626
e928e72d3342
(repeat-matching-complex-command): Fix check for empty pattern. Simplify.
Karl Heuer <kwzh@gnu.org>
parents:
2452
diff
changeset
|
47 (if (string-match "[^ \t]" pattern) |
e928e72d3342
(repeat-matching-complex-command): Fix check for empty pattern. Simplify.
Karl Heuer <kwzh@gnu.org>
parents:
2452
diff
changeset
|
48 (setq pattern (substring pattern (match-beginning 0))) |
e928e72d3342
(repeat-matching-complex-command): Fix check for empty pattern. Simplify.
Karl Heuer <kwzh@gnu.org>
parents:
2452
diff
changeset
|
49 (setq pattern nil))) |
411 | 50 (let ((history command-history) |
51 (temp) | |
52 (what)) | |
53 (while (and history (not what)) | |
54 (setq temp (car history)) | |
55 (if (and (or (not pattern) (string-match pattern (symbol-name (car temp)))) | |
9626
e928e72d3342
(repeat-matching-complex-command): Fix check for empty pattern. Simplify.
Karl Heuer <kwzh@gnu.org>
parents:
2452
diff
changeset
|
56 (y-or-n-p (format "Redo %S? " temp))) |
411 | 57 (setq what (car history)) |
58 (setq history (cdr history)))) | |
59 (if (not what) | |
60 (error "Command history exhausted") | |
61 ;; Try to remove any useless command history element for this command. | |
62 (if (eq (car (car command-history)) 'repeat-matching-complex-command) | |
63 (setq command-history (cdr command-history))) | |
64 (edit-and-eval-command "Redo: " what)))) | |
65 | |
21088 | 66 (defcustom default-command-history-filter-garbage |
411 | 67 '(command-history-mode |
68 list-command-history | |
69 electric-command-history) | |
9626
e928e72d3342
(repeat-matching-complex-command): Fix check for empty pattern. Simplify.
Karl Heuer <kwzh@gnu.org>
parents:
2452
diff
changeset
|
70 "*A list of symbols to be ignored by `default-command-history-filter'. |
21088 | 71 If that function is given a list whose car is an element of this list, |
9626
e928e72d3342
(repeat-matching-complex-command): Fix check for empty pattern. Simplify.
Karl Heuer <kwzh@gnu.org>
parents:
2452
diff
changeset
|
72 then it will return non-nil (indicating the list should be discarded from |
e928e72d3342
(repeat-matching-complex-command): Fix check for empty pattern. Simplify.
Karl Heuer <kwzh@gnu.org>
parents:
2452
diff
changeset
|
73 the history). |
21088 | 74 Initially, all commands related to the command history are discarded." |
75 :type '(repeat symbol) | |
76 :group 'chistory) | |
411 | 77 |
78 (defvar list-command-history-filter 'default-command-history-filter | |
9626
e928e72d3342
(repeat-matching-complex-command): Fix check for empty pattern. Simplify.
Karl Heuer <kwzh@gnu.org>
parents:
2452
diff
changeset
|
79 "Predicate to test which commands should be excluded from the history listing. |
e928e72d3342
(repeat-matching-complex-command): Fix check for empty pattern. Simplify.
Karl Heuer <kwzh@gnu.org>
parents:
2452
diff
changeset
|
80 If non-nil, should be the name of a function of one argument. |
411 | 81 It is passed each element of the command history when |
82 \\[list-command-history] is called. If the filter returns non-nil for | |
83 some element, that element is excluded from the history listing. The | |
84 default filter removes commands associated with the command-history.") | |
85 | |
86 (defun default-command-history-filter (frob) | |
87 "Filter commands matching `default-command-history-filter-garbage' list | |
88 from the command history." | |
89 (or (not (consp frob)) | |
90 (memq (car frob) default-command-history-filter-garbage))) | |
91 | |
21088 | 92 (defcustom list-command-history-max 32 |
93 "*If non-nil, maximum length of the listing produced by `list-command-history'." | |
94 :type '(choice integer (const nil)) | |
95 :group 'chistory) | |
411 | 96 |
97 ;;;###autoload | |
98 (defun list-command-history () | |
99 "List history of commands typed to minibuffer. | |
100 The number of commands listed is controlled by `list-command-history-max'. | |
101 Calls value of `list-command-history-filter' (if non-nil) on each history | |
102 element to judge if that element should be excluded from the list. | |
103 | |
104 The buffer is left in Command History mode." | |
105 (interactive) | |
106 (with-output-to-temp-buffer | |
107 "*Command History*" | |
108 (let ((history command-history) | |
109 (buffer-read-only nil) | |
110 (count (or list-command-history-max -1))) | |
111 (while (and (/= count 0) history) | |
96381
e495cfc33b5e
(list-command-history): Use `bound-and-true-p'.
John Paul Wallington <jpw@pobox.com>
parents:
94678
diff
changeset
|
112 (if (and (bound-and-true-p list-command-history-filter) |
411 | 113 (funcall list-command-history-filter (car history))) |
114 nil | |
115 (setq count (1- count)) | |
116 (prin1 (car history)) | |
117 (terpri)) | |
118 (setq history (cdr history)))) | |
119 (save-excursion | |
120 (set-buffer "*Command History*") | |
121 (goto-char (point-min)) | |
122 (if (eobp) | |
123 (error "No command history") | |
27065
bd4ad2d321a7
(command-history): Renamed from command-history-mode.
Richard M. Stallman <rms@gnu.org>
parents:
21088
diff
changeset
|
124 (command-history-mode))))) |
411 | 125 |
96381
e495cfc33b5e
(list-command-history): Use `bound-and-true-p'.
John Paul Wallington <jpw@pobox.com>
parents:
94678
diff
changeset
|
126 (defvar command-history-map |
e495cfc33b5e
(list-command-history): Use `bound-and-true-p'.
John Paul Wallington <jpw@pobox.com>
parents:
94678
diff
changeset
|
127 (let ((map (make-sparse-keymap))) |
e495cfc33b5e
(list-command-history): Use `bound-and-true-p'.
John Paul Wallington <jpw@pobox.com>
parents:
94678
diff
changeset
|
128 (set-keymap-parent map lisp-mode-shared-map) |
e495cfc33b5e
(list-command-history): Use `bound-and-true-p'.
John Paul Wallington <jpw@pobox.com>
parents:
94678
diff
changeset
|
129 (suppress-keymap map) |
e495cfc33b5e
(list-command-history): Use `bound-and-true-p'.
John Paul Wallington <jpw@pobox.com>
parents:
94678
diff
changeset
|
130 (define-key map "x" 'command-history-repeat) |
e495cfc33b5e
(list-command-history): Use `bound-and-true-p'.
John Paul Wallington <jpw@pobox.com>
parents:
94678
diff
changeset
|
131 (define-key map "\n" 'next-line) |
e495cfc33b5e
(list-command-history): Use `bound-and-true-p'.
John Paul Wallington <jpw@pobox.com>
parents:
94678
diff
changeset
|
132 (define-key map "\r" 'next-line) |
e495cfc33b5e
(list-command-history): Use `bound-and-true-p'.
John Paul Wallington <jpw@pobox.com>
parents:
94678
diff
changeset
|
133 (define-key map "\177" 'previous-line) |
e495cfc33b5e
(list-command-history): Use `bound-and-true-p'.
John Paul Wallington <jpw@pobox.com>
parents:
94678
diff
changeset
|
134 map) |
e495cfc33b5e
(list-command-history): Use `bound-and-true-p'.
John Paul Wallington <jpw@pobox.com>
parents:
94678
diff
changeset
|
135 "Keymap for `command-history-mode'.") |
48915
36f7a48a9735
(command-history-map): Move definition up.
Richard M. Stallman <rms@gnu.org>
parents:
48778
diff
changeset
|
136 |
27065
bd4ad2d321a7
(command-history): Renamed from command-history-mode.
Richard M. Stallman <rms@gnu.org>
parents:
21088
diff
changeset
|
137 (defun command-history-mode () |
48778
d414c281a629
* ibuffer.el (ibuffer-mode): If `show-paren-mode' is enabled,
John Paul Wallington <jpw@pobox.com>
parents:
45078
diff
changeset
|
138 "Major mode for listing and repeating recent commands. |
d414c281a629
* ibuffer.el (ibuffer-mode): If `show-paren-mode' is enabled,
John Paul Wallington <jpw@pobox.com>
parents:
45078
diff
changeset
|
139 |
d414c281a629
* ibuffer.el (ibuffer-mode): If `show-paren-mode' is enabled,
John Paul Wallington <jpw@pobox.com>
parents:
45078
diff
changeset
|
140 Keybindings: |
d414c281a629
* ibuffer.el (ibuffer-mode): If `show-paren-mode' is enabled,
John Paul Wallington <jpw@pobox.com>
parents:
45078
diff
changeset
|
141 \\{command-history-map}" |
d414c281a629
* ibuffer.el (ibuffer-mode): If `show-paren-mode' is enabled,
John Paul Wallington <jpw@pobox.com>
parents:
45078
diff
changeset
|
142 (interactive) |
27065
bd4ad2d321a7
(command-history): Renamed from command-history-mode.
Richard M. Stallman <rms@gnu.org>
parents:
21088
diff
changeset
|
143 (Command-history-setup) |
bd4ad2d321a7
(command-history): Renamed from command-history-mode.
Richard M. Stallman <rms@gnu.org>
parents:
21088
diff
changeset
|
144 (setq major-mode 'command-history-mode) |
bd4ad2d321a7
(command-history): Renamed from command-history-mode.
Richard M. Stallman <rms@gnu.org>
parents:
21088
diff
changeset
|
145 (setq mode-name "Command History") |
bd4ad2d321a7
(command-history): Renamed from command-history-mode.
Richard M. Stallman <rms@gnu.org>
parents:
21088
diff
changeset
|
146 (use-local-map command-history-map) |
62721
049538abf38f
(command-history-mode): Use run-mode-hooks.
Lute Kamstra <lute@gnu.org>
parents:
52401
diff
changeset
|
147 (run-mode-hooks 'command-history-mode-hook)) |
27065
bd4ad2d321a7
(command-history): Renamed from command-history-mode.
Richard M. Stallman <rms@gnu.org>
parents:
21088
diff
changeset
|
148 |
bd4ad2d321a7
(command-history): Renamed from command-history-mode.
Richard M. Stallman <rms@gnu.org>
parents:
21088
diff
changeset
|
149 (defun Command-history-setup () |
bd4ad2d321a7
(command-history): Renamed from command-history-mode.
Richard M. Stallman <rms@gnu.org>
parents:
21088
diff
changeset
|
150 (kill-all-local-variables) |
33941
10c41fa2dafe
(Command-history-setup): Remove extraneous `keymap'
Gerd Moellmann <gerd@gnu.org>
parents:
32367
diff
changeset
|
151 (use-local-map command-history-map) |
411 | 152 (lisp-mode-variables nil) |
153 (set-syntax-table emacs-lisp-mode-syntax-table) | |
27065
bd4ad2d321a7
(command-history): Renamed from command-history-mode.
Richard M. Stallman <rms@gnu.org>
parents:
21088
diff
changeset
|
154 (setq buffer-read-only t)) |
411 | 155 |
21088 | 156 (defcustom command-history-hook nil |
157 "If non-nil, its value is called on entry to `command-history-mode'." | |
158 :type 'hook | |
159 :group 'chistory) | |
411 | 160 |
161 (defun command-history-repeat () | |
162 "Repeat the command shown on the current line. | |
163 The buffer for that command is the previous current buffer." | |
164 (interactive) | |
165 (save-excursion | |
166 (eval (prog1 | |
167 (save-excursion | |
168 (beginning-of-line) | |
169 (read (current-buffer))) | |
170 (set-buffer | |
2452
5c9d9b33f249
(repeat-history-command): Bug fix. Someone forgot a car.
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
845
diff
changeset
|
171 (car (cdr (buffer-list)))))))) |
411 | 172 |
173 ;;;###autoload | |
27065
bd4ad2d321a7
(command-history): Renamed from command-history-mode.
Richard M. Stallman <rms@gnu.org>
parents:
21088
diff
changeset
|
174 (defun command-history () |
bd4ad2d321a7
(command-history): Renamed from command-history-mode.
Richard M. Stallman <rms@gnu.org>
parents:
21088
diff
changeset
|
175 "Examine commands from `command-history' in a buffer. |
411 | 176 The number of commands listed is controlled by `list-command-history-max'. |
177 The command history is filtered by `list-command-history-filter' if non-nil. | |
178 Use \\<command-history-map>\\[command-history-repeat] to repeat the command on the current line. | |
179 | |
180 Otherwise much like Emacs-Lisp Mode except that there is no self-insertion | |
181 and digits provide prefix arguments. Tab does not indent. | |
182 \\{command-history-map} | |
27065
bd4ad2d321a7
(command-history): Renamed from command-history-mode.
Richard M. Stallman <rms@gnu.org>
parents:
21088
diff
changeset
|
183 |
bd4ad2d321a7
(command-history): Renamed from command-history-mode.
Richard M. Stallman <rms@gnu.org>
parents:
21088
diff
changeset
|
184 This command always recompiles the Command History listing |
bd4ad2d321a7
(command-history): Renamed from command-history-mode.
Richard M. Stallman <rms@gnu.org>
parents:
21088
diff
changeset
|
185 and runs the normal hook `command-history-hook'." |
411 | 186 (interactive) |
187 (list-command-history) | |
188 (pop-to-buffer "*Command History*") | |
189 (run-hooks 'command-history-hook)) | |
584 | 190 |
191 (provide 'chistory) | |
192 | |
93975
1e3a407766b9
Fix up comment convention on the arch-tag lines.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
79721
diff
changeset
|
193 ;; arch-tag: c201a0cd-89f2-4d39-a532-4cb309391dbd |
662
8a533acedb77
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
584
diff
changeset
|
194 ;;; chistory.el ends here |