662
|
1 ;;; chistory.el --- list command history
|
|
2
|
74439
|
3 ;; Copyright (C) 1985, 2001, 2002, 2003, 2004, 2005,
|
79721
|
4 ;; 2006, 2007, 2008 Free Software Foundation, Inc.
|
845
|
5
|
807
|
6 ;; Author: K. Shane Hartman
|
|
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
|
78236
|
14 ;; the Free Software Foundation; either version 3, 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
|
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>
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
|
34 ;;; Code:
|
|
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>
diff
changeset
|
49 (if (string-match "[^ \t]" pattern)
|
e928e72d3342
(repeat-matching-complex-command): Fix check for empty pattern. Simplify.
Karl Heuer <kwzh@gnu.org>
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>
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>
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>
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>
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>
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>
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>
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
|
127 (command-history-mode)))))
|
411
|
128
|
48915
|
129 (defvar command-history-map nil)
|
|
130 (unless command-history-map
|
|
131 (setq command-history-map (make-sparse-keymap))
|
|
132 (set-keymap-parent command-history-map lisp-mode-shared-map)
|
|
133 (suppress-keymap command-history-map)
|
|
134 (define-key command-history-map "x" 'command-history-repeat)
|
|
135 (define-key command-history-map "\n" 'next-line)
|
|
136 (define-key command-history-map "\r" 'next-line)
|
|
137 (define-key command-history-map "\177" 'previous-line))
|
|
138
|
27065
|
139 (defun command-history-mode ()
|
48778
d414c281a629
* ibuffer.el (ibuffer-mode): If `show-paren-mode' is enabled,
John Paul Wallington <jpw@pobox.com>
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>
diff
changeset
|
141
|
d414c281a629
* ibuffer.el (ibuffer-mode): If `show-paren-mode' is enabled,
John Paul Wallington <jpw@pobox.com>
diff
changeset
|
142 Keybindings:
|
d414c281a629
* ibuffer.el (ibuffer-mode): If `show-paren-mode' is enabled,
John Paul Wallington <jpw@pobox.com>
diff
changeset
|
143 \\{command-history-map}"
|
d414c281a629
* ibuffer.el (ibuffer-mode): If `show-paren-mode' is enabled,
John Paul Wallington <jpw@pobox.com>
diff
changeset
|
144 (interactive)
|
27065
|
145 (Command-history-setup)
|
|
146 (setq major-mode 'command-history-mode)
|
|
147 (setq mode-name "Command History")
|
|
148 (use-local-map command-history-map)
|
62721
|
149 (run-mode-hooks 'command-history-mode-hook))
|
27065
|
150
|
|
151 (defun Command-history-setup ()
|
|
152 (kill-all-local-variables)
|
33941
|
153 (use-local-map command-history-map)
|
411
|
154 (lisp-mode-variables nil)
|
|
155 (set-syntax-table emacs-lisp-mode-syntax-table)
|
27065
|
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
|
173 (car (cdr (buffer-list))))))))
|
411
|
174
|
|
175 ;;;###autoload
|
27065
|
176 (defun command-history ()
|
|
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
|
185
|
|
186 This command always recompiles the Command History listing
|
|
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
|
196 ;;; chistory.el ends here
|