Mercurial > emacs
annotate lisp/chistory.el @ 73399:9cd63fc42776
(Format of Keymaps): Show all the keymap element
patterns that result from menu items.
(Key Lookup): Minor cleanups.
author | Richard M. Stallman <rms@gnu.org> |
---|---|
date | Mon, 16 Oct 2006 18:57:04 +0000 |
parents | 3bd95f4f2941 |
children | ddcbd2c1b70d c5406394f567 |
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 |
68651
3bd95f4f2941
Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
64762
diff
changeset
|
3 ;; Copyright (C) 1985, 2002, 2003, 2004, 2005, |
3bd95f4f2941
Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
64762
diff
changeset
|
4 ;; 2006 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 | |
12 ;; GNU Emacs is free software; you can redistribute it and/or modify | |
13 ;; it under the terms of the GNU General Public License as published by | |
807
4f28bd14272c
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
662
diff
changeset
|
14 ;; the Free Software Foundation; either version 2, or (at your option) |
411 | 15 ;; any later version. |
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 | |
14169 | 23 ;; along with GNU Emacs; see the file COPYING. If not, write to the |
64091 | 24 ;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, |
25 ;; Boston, MA 02110-1301, USA. | |
411 | 26 |
807
4f28bd14272c
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
662
diff
changeset
|
27 ;;; Commentary: |
411 | 28 |
29 ;; 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
|
30 ;; its a nice alternative to C-x ESC ESC (repeat-complex-command) and |
411 | 31 ;; functions as a lister if given no pattern. It's not important |
32 ;; enough to warrant a file of its own. | |
33 | |
807
4f28bd14272c
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
662
diff
changeset
|
34 ;;; Code: |
4f28bd14272c
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
662
diff
changeset
|
35 |
21088 | 36 (defgroup chistory nil |
37 "List command history." | |
38 :group 'keyboard) | |
39 | |
411 | 40 ;;;###autoload |
41 (defun repeat-matching-complex-command (&optional pattern) | |
42 "Edit and re-evaluate complex command with name matching PATTERN. | |
43 Matching occurrences are displayed, most recent first, until you select | |
44 a form for evaluation. If PATTERN is empty (or nil), every form in the | |
45 command history is offered. The form is placed in the minibuffer for | |
46 editing and the result is evaluated." | |
47 (interactive "sRedo Command (regexp): ") | |
48 (if pattern | |
9626
e928e72d3342
(repeat-matching-complex-command): Fix check for empty pattern. Simplify.
Karl Heuer <kwzh@gnu.org>
parents:
2452
diff
changeset
|
49 (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
|
50 (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
|
51 (setq pattern nil))) |
411 | 52 (let ((history command-history) |
53 (temp) | |
54 (what)) | |
55 (while (and history (not what)) | |
56 (setq temp (car history)) | |
57 (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
|
58 (y-or-n-p (format "Redo %S? " temp))) |
411 | 59 (setq what (car history)) |
60 (setq history (cdr history)))) | |
61 (if (not what) | |
62 (error "Command history exhausted") | |
63 ;; Try to remove any useless command history element for this command. | |
64 (if (eq (car (car command-history)) 'repeat-matching-complex-command) | |
65 (setq command-history (cdr command-history))) | |
66 (edit-and-eval-command "Redo: " what)))) | |
67 | |
21088 | 68 (defcustom default-command-history-filter-garbage |
411 | 69 '(command-history-mode |
70 list-command-history | |
71 electric-command-history) | |
9626
e928e72d3342
(repeat-matching-complex-command): Fix check for empty pattern. Simplify.
Karl Heuer <kwzh@gnu.org>
parents:
2452
diff
changeset
|
72 "*A list of symbols to be ignored by `default-command-history-filter'. |
21088 | 73 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
|
74 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
|
75 the history). |
21088 | 76 Initially, all commands related to the command history are discarded." |
77 :type '(repeat symbol) | |
78 :group 'chistory) | |
411 | 79 |
80 (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
|
81 "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
|
82 If non-nil, should be the name of a function of one argument. |
411 | 83 It is passed each element of the command history when |
84 \\[list-command-history] is called. If the filter returns non-nil for | |
85 some element, that element is excluded from the history listing. The | |
86 default filter removes commands associated with the command-history.") | |
87 | |
88 (defun default-command-history-filter (frob) | |
89 "Filter commands matching `default-command-history-filter-garbage' list | |
90 from the command history." | |
91 (or (not (consp frob)) | |
92 (memq (car frob) default-command-history-filter-garbage))) | |
93 | |
21088 | 94 (defcustom list-command-history-max 32 |
95 "*If non-nil, maximum length of the listing produced by `list-command-history'." | |
96 :type '(choice integer (const nil)) | |
97 :group 'chistory) | |
411 | 98 |
99 ;;;###autoload | |
100 (defun list-command-history () | |
101 "List history of commands typed to minibuffer. | |
102 The number of commands listed is controlled by `list-command-history-max'. | |
103 Calls value of `list-command-history-filter' (if non-nil) on each history | |
104 element to judge if that element should be excluded from the list. | |
105 | |
106 The buffer is left in Command History mode." | |
107 (interactive) | |
108 (with-output-to-temp-buffer | |
109 "*Command History*" | |
110 (let ((history command-history) | |
111 (buffer-read-only nil) | |
112 (count (or list-command-history-max -1))) | |
113 (while (and (/= count 0) history) | |
114 (if (and (boundp 'list-command-history-filter) | |
115 list-command-history-filter | |
116 (funcall list-command-history-filter (car history))) | |
117 nil | |
118 (setq count (1- count)) | |
119 (prin1 (car history)) | |
120 (terpri)) | |
121 (setq history (cdr history)))) | |
122 (save-excursion | |
123 (set-buffer "*Command History*") | |
124 (goto-char (point-min)) | |
125 (if (eobp) | |
126 (error "No command history") | |
27065
bd4ad2d321a7
(command-history): Renamed from command-history-mode.
Richard M. Stallman <rms@gnu.org>
parents:
21088
diff
changeset
|
127 (command-history-mode))))) |
411 | 128 |
48915
36f7a48a9735
(command-history-map): Move definition up.
Richard M. Stallman <rms@gnu.org>
parents:
48778
diff
changeset
|
129 (defvar command-history-map nil) |
36f7a48a9735
(command-history-map): Move definition up.
Richard M. Stallman <rms@gnu.org>
parents:
48778
diff
changeset
|
130 (unless command-history-map |
36f7a48a9735
(command-history-map): Move definition up.
Richard M. Stallman <rms@gnu.org>
parents:
48778
diff
changeset
|
131 (setq command-history-map (make-sparse-keymap)) |
36f7a48a9735
(command-history-map): Move definition up.
Richard M. Stallman <rms@gnu.org>
parents:
48778
diff
changeset
|
132 (set-keymap-parent command-history-map lisp-mode-shared-map) |
36f7a48a9735
(command-history-map): Move definition up.
Richard M. Stallman <rms@gnu.org>
parents:
48778
diff
changeset
|
133 (suppress-keymap command-history-map) |
36f7a48a9735
(command-history-map): Move definition up.
Richard M. Stallman <rms@gnu.org>
parents:
48778
diff
changeset
|
134 (define-key command-history-map "x" 'command-history-repeat) |
36f7a48a9735
(command-history-map): Move definition up.
Richard M. Stallman <rms@gnu.org>
parents:
48778
diff
changeset
|
135 (define-key command-history-map "\n" 'next-line) |
36f7a48a9735
(command-history-map): Move definition up.
Richard M. Stallman <rms@gnu.org>
parents:
48778
diff
changeset
|
136 (define-key command-history-map "\r" 'next-line) |
36f7a48a9735
(command-history-map): Move definition up.
Richard M. Stallman <rms@gnu.org>
parents:
48778
diff
changeset
|
137 (define-key command-history-map "\177" 'previous-line)) |
36f7a48a9735
(command-history-map): Move definition up.
Richard M. Stallman <rms@gnu.org>
parents:
48778
diff
changeset
|
138 |
27065
bd4ad2d321a7
(command-history): Renamed from command-history-mode.
Richard M. Stallman <rms@gnu.org>
parents:
21088
diff
changeset
|
139 (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
|
140 "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
|
141 |
d414c281a629
* ibuffer.el (ibuffer-mode): If `show-paren-mode' is enabled,
John Paul Wallington <jpw@pobox.com>
parents:
45078
diff
changeset
|
142 Keybindings: |
d414c281a629
* ibuffer.el (ibuffer-mode): If `show-paren-mode' is enabled,
John Paul Wallington <jpw@pobox.com>
parents:
45078
diff
changeset
|
143 \\{command-history-map}" |
d414c281a629
* ibuffer.el (ibuffer-mode): If `show-paren-mode' is enabled,
John Paul Wallington <jpw@pobox.com>
parents:
45078
diff
changeset
|
144 (interactive) |
27065
bd4ad2d321a7
(command-history): Renamed from command-history-mode.
Richard M. Stallman <rms@gnu.org>
parents:
21088
diff
changeset
|
145 (Command-history-setup) |
bd4ad2d321a7
(command-history): Renamed from command-history-mode.
Richard M. Stallman <rms@gnu.org>
parents:
21088
diff
changeset
|
146 (setq major-mode 'command-history-mode) |
bd4ad2d321a7
(command-history): Renamed from command-history-mode.
Richard M. Stallman <rms@gnu.org>
parents:
21088
diff
changeset
|
147 (setq mode-name "Command History") |
bd4ad2d321a7
(command-history): Renamed from command-history-mode.
Richard M. Stallman <rms@gnu.org>
parents:
21088
diff
changeset
|
148 (use-local-map command-history-map) |
62721
049538abf38f
(command-history-mode): Use run-mode-hooks.
Lute Kamstra <lute@gnu.org>
parents:
52401
diff
changeset
|
149 (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
|
150 |
bd4ad2d321a7
(command-history): Renamed from command-history-mode.
Richard M. Stallman <rms@gnu.org>
parents:
21088
diff
changeset
|
151 (defun Command-history-setup () |
bd4ad2d321a7
(command-history): Renamed from command-history-mode.
Richard M. Stallman <rms@gnu.org>
parents:
21088
diff
changeset
|
152 (kill-all-local-variables) |
33941
10c41fa2dafe
(Command-history-setup): Remove extraneous `keymap'
Gerd Moellmann <gerd@gnu.org>
parents:
32367
diff
changeset
|
153 (use-local-map command-history-map) |
411 | 154 (lisp-mode-variables nil) |
155 (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
|
156 (setq buffer-read-only t)) |
411 | 157 |
21088 | 158 (defcustom command-history-hook nil |
159 "If non-nil, its value is called on entry to `command-history-mode'." | |
160 :type 'hook | |
161 :group 'chistory) | |
411 | 162 |
163 (defun command-history-repeat () | |
164 "Repeat the command shown on the current line. | |
165 The buffer for that command is the previous current buffer." | |
166 (interactive) | |
167 (save-excursion | |
168 (eval (prog1 | |
169 (save-excursion | |
170 (beginning-of-line) | |
171 (read (current-buffer))) | |
172 (set-buffer | |
2452
5c9d9b33f249
(repeat-history-command): Bug fix. Someone forgot a car.
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
845
diff
changeset
|
173 (car (cdr (buffer-list)))))))) |
411 | 174 |
175 ;;;###autoload | |
27065
bd4ad2d321a7
(command-history): Renamed from command-history-mode.
Richard M. Stallman <rms@gnu.org>
parents:
21088
diff
changeset
|
176 (defun command-history () |
bd4ad2d321a7
(command-history): Renamed from command-history-mode.
Richard M. Stallman <rms@gnu.org>
parents:
21088
diff
changeset
|
177 "Examine commands from `command-history' in a buffer. |
411 | 178 The number of commands listed is controlled by `list-command-history-max'. |
179 The command history is filtered by `list-command-history-filter' if non-nil. | |
180 Use \\<command-history-map>\\[command-history-repeat] to repeat the command on the current line. | |
181 | |
182 Otherwise much like Emacs-Lisp Mode except that there is no self-insertion | |
183 and digits provide prefix arguments. Tab does not indent. | |
184 \\{command-history-map} | |
27065
bd4ad2d321a7
(command-history): Renamed from command-history-mode.
Richard M. Stallman <rms@gnu.org>
parents:
21088
diff
changeset
|
185 |
bd4ad2d321a7
(command-history): Renamed from command-history-mode.
Richard M. Stallman <rms@gnu.org>
parents:
21088
diff
changeset
|
186 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
|
187 and runs the normal hook `command-history-hook'." |
411 | 188 (interactive) |
189 (list-command-history) | |
190 (pop-to-buffer "*Command History*") | |
191 (run-hooks 'command-history-hook)) | |
584 | 192 |
193 (provide 'chistory) | |
194 | |
52401 | 195 ;;; arch-tag: c201a0cd-89f2-4d39-a532-4cb309391dbd |
662
8a533acedb77
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
584
diff
changeset
|
196 ;;; chistory.el ends here |