Commit | Line | Data |
---|---|---|
c0274f38 ER |
1 | ;;; chistory.el --- list command history |
2 | ||
e91081eb | 3 | ;; Copyright (C) 1985, 2001, 2002, 2003, 2004, 2005, |
ae940284 | 4 | ;; 2006, 2007, 2008, 2009 Free Software Foundation, Inc. |
9750e079 | 5 | |
e5167999 ER |
6 | ;; Author: K. Shane Hartman |
7 | ;; Maintainer: FSF | |
30764597 | 8 | ;; Keywords: convenience |
e2fbf49d JB |
9 | |
10 | ;; This file is part of GNU Emacs. | |
11 | ||
eb3fa2cf | 12 | ;; GNU Emacs is free software: you can redistribute it and/or modify |
e2fbf49d | 13 | ;; it under the terms of the GNU General Public License as published by |
eb3fa2cf GM |
14 | ;; the Free Software Foundation, either version 3 of the License, or |
15 | ;; (at your option) any later version. | |
e2fbf49d JB |
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 | |
eb3fa2cf | 23 | ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. |
e2fbf49d | 24 | |
e5167999 | 25 | ;;; Commentary: |
e2fbf49d | 26 | |
e2fbf49d | 27 | ;; This really has nothing to do with list-command-history per se, but |
daaf0197 | 28 | ;; its a nice alternative to C-x ESC ESC (repeat-complex-command) and |
e2fbf49d JB |
29 | ;; functions as a lister if given no pattern. It's not important |
30 | ;; enough to warrant a file of its own. | |
31 | ||
e5167999 ER |
32 | ;;; Code: |
33 | ||
4bef9110 SE |
34 | (defgroup chistory nil |
35 | "List command history." | |
36 | :group 'keyboard) | |
37 | ||
e2fbf49d JB |
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 | |
daaf0197 KH |
47 | (if (string-match "[^ \t]" pattern) |
48 | (setq pattern (substring pattern (match-beginning 0))) | |
49 | (setq pattern nil))) | |
e2fbf49d JB |
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)))) | |
daaf0197 | 56 | (y-or-n-p (format "Redo %S? " temp))) |
e2fbf49d JB |
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 | ||
4bef9110 | 66 | (defcustom default-command-history-filter-garbage |
e2fbf49d JB |
67 | '(command-history-mode |
68 | list-command-history | |
69 | electric-command-history) | |
9201cc28 | 70 | "A list of symbols to be ignored by `default-command-history-filter'. |
4bef9110 | 71 | If that function is given a list whose car is an element of this list, |
daaf0197 KH |
72 | then it will return non-nil (indicating the list should be discarded from |
73 | the history). | |
4bef9110 SE |
74 | Initially, all commands related to the command history are discarded." |
75 | :type '(repeat symbol) | |
76 | :group 'chistory) | |
e2fbf49d JB |
77 | |
78 | (defvar list-command-history-filter 'default-command-history-filter | |
daaf0197 KH |
79 | "Predicate to test which commands should be excluded from the history listing. |
80 | If non-nil, should be the name of a function of one argument. | |
e2fbf49d JB |
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 | ||
4bef9110 | 92 | (defcustom list-command-history-max 32 |
9201cc28 | 93 | "If non-nil, maximum length of the listing produced by `list-command-history'." |
4bef9110 SE |
94 | :type '(choice integer (const nil)) |
95 | :group 'chistory) | |
e2fbf49d JB |
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) | |
610117a9 | 112 | (if (and (bound-and-true-p list-command-history-filter) |
e2fbf49d JB |
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") | |
40891308 | 124 | (command-history-mode))))) |
e2fbf49d | 125 | |
610117a9 JPW |
126 | (defvar command-history-map |
127 | (let ((map (make-sparse-keymap))) | |
128 | (set-keymap-parent map lisp-mode-shared-map) | |
129 | (suppress-keymap map) | |
130 | (define-key map "x" 'command-history-repeat) | |
131 | (define-key map "\n" 'next-line) | |
132 | (define-key map "\r" 'next-line) | |
133 | (define-key map "\177" 'previous-line) | |
134 | map) | |
135 | "Keymap for `command-history-mode'.") | |
ba3ca9bc | 136 | |
40891308 | 137 | (defun command-history-mode () |
4ba16127 JPW |
138 | "Major mode for listing and repeating recent commands. |
139 | ||
140 | Keybindings: | |
141 | \\{command-history-map}" | |
142 | (interactive) | |
40891308 RS |
143 | (Command-history-setup) |
144 | (setq major-mode 'command-history-mode) | |
145 | (setq mode-name "Command History") | |
146 | (use-local-map command-history-map) | |
95ea7b28 | 147 | (run-mode-hooks 'command-history-mode-hook)) |
40891308 RS |
148 | |
149 | (defun Command-history-setup () | |
150 | (kill-all-local-variables) | |
83d544cb | 151 | (use-local-map command-history-map) |
e2fbf49d JB |
152 | (lisp-mode-variables nil) |
153 | (set-syntax-table emacs-lisp-mode-syntax-table) | |
40891308 | 154 | (setq buffer-read-only t)) |
e2fbf49d | 155 | |
4bef9110 SE |
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) | |
e2fbf49d | 160 | |
e2fbf49d JB |
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 | |
dd4e1002 | 171 | (car (cdr (buffer-list)))))))) |
e2fbf49d JB |
172 | |
173 | ;;;###autoload | |
40891308 RS |
174 | (defun command-history () |
175 | "Examine commands from `command-history' in a buffer. | |
e2fbf49d JB |
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} | |
40891308 RS |
183 | |
184 | This command always recompiles the Command History listing | |
185 | and runs the normal hook `command-history-hook'." | |
e2fbf49d JB |
186 | (interactive) |
187 | (list-command-history) | |
188 | (pop-to-buffer "*Command History*") | |
189 | (run-hooks 'command-history-hook)) | |
49116ac0 JB |
190 | |
191 | (provide 'chistory) | |
192 | ||
cbee283d | 193 | ;; arch-tag: c201a0cd-89f2-4d39-a532-4cb309391dbd |
c0274f38 | 194 | ;;; chistory.el ends here |