Mercurial > emacs
annotate lisp/novice.el @ 2379:06abd963ec25
(enable-and-notify) Added. Inspired by Roland McGrath's LCD package
enable-me.
author | Eric S. Raymond <esr@snark.thyrsus.com> |
---|---|
date | Sat, 27 Mar 1993 01:58:24 +0000 |
parents | f287613dfc28 |
children | afb11b3822c2 |
rev | line source |
---|---|
659
505130d1ddf8
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
282
diff
changeset
|
1 ;;; novice.el --- handling of disabled commands ("novice mode") for Emacs. |
505130d1ddf8
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
282
diff
changeset
|
2 |
845 | 3 ;; Copyright (C) 1985, 1986, 1987 Free Software Foundation, Inc. |
4 | |
807
4f28bd14272c
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
659
diff
changeset
|
5 ;; Maintainer: FSF |
814
38b2499cb3e9
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
807
diff
changeset
|
6 ;; Keywords: internal, help |
807
4f28bd14272c
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
659
diff
changeset
|
7 |
36 | 8 ;; This file is part of GNU Emacs. |
9 | |
10 ;; GNU Emacs is free software; you can redistribute it and/or modify | |
11 ;; 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:
659
diff
changeset
|
12 ;; the Free Software Foundation; either version 2, or (at your option) |
36 | 13 ;; any later version. |
14 | |
15 ;; GNU Emacs is distributed in the hope that it will be useful, | |
16 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of | |
17 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
18 ;; GNU General Public License for more details. | |
19 | |
20 ;; You should have received a copy of the GNU General Public License | |
21 ;; along with GNU Emacs; see the file COPYING. If not, write to | |
22 ;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. | |
23 | |
2308
f287613dfc28
Added or corrected Commentary sections
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
2232
diff
changeset
|
24 ;;; Commentary: |
f287613dfc28
Added or corrected Commentary sections
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
2232
diff
changeset
|
25 |
f287613dfc28
Added or corrected Commentary sections
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
2232
diff
changeset
|
26 ;; This mode provides a hook which is, by default, attached to various |
f287613dfc28
Added or corrected Commentary sections
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
2232
diff
changeset
|
27 ;; putatively dangerous commands in a (probably futile) attempt to |
f287613dfc28
Added or corrected Commentary sections
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
2232
diff
changeset
|
28 ;; prevent lusers from shooting themselves in the feet. |
f287613dfc28
Added or corrected Commentary sections
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
2232
diff
changeset
|
29 |
2232
4f9d60f7de9d
Add standard library headers.
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
845
diff
changeset
|
30 ;;; Code: |
36 | 31 |
32 ;; This function is called (by autoloading) | |
33 ;; to handle any disabled command. | |
34 ;; The command is found in this-command | |
35 ;; and the keys are returned by (this-command-keys). | |
36 | |
256 | 37 ;;;###autoload |
268 | 38 (setq disabled-command-hook 'disabled-command-hook) |
39 | |
282 | 40 ;;;###autoload |
36 | 41 (defun disabled-command-hook (&rest ignore) |
42 (let (char) | |
43 (save-window-excursion | |
44 (with-output-to-temp-buffer "*Help*" | |
45 (if (= (aref (this-command-keys) 0) ?\M-x) | |
46 (princ "You have invoked the disabled command ") | |
47 (princ "You have typed ") | |
48 (princ (key-description (this-command-keys))) | |
49 (princ ", invoking disabled command ")) | |
50 (princ this-command) | |
51 (princ ":\n") | |
52 ;; Print any special message saying why the command is disabled. | |
53 (if (stringp (get this-command 'disabled)) | |
54 (princ (get this-command 'disabled))) | |
55 (princ (or (condition-case () | |
56 (documentation this-command) | |
57 (error nil)) | |
58 "<< not documented >>")) | |
59 ;; Keep only the first paragraph of the documentation. | |
60 (save-excursion | |
61 (set-buffer "*Help*") | |
62 (goto-char (point-min)) | |
63 (if (search-forward "\n\n" nil t) | |
64 (delete-region (1- (point)) (point-max)) | |
65 (goto-char (point-max)))) | |
66 (princ "\n\n") | |
67 (princ "You can now type | |
68 Space to try the command just this once, | |
69 but leave it disabled, | |
70 Y to try it and enable it (no questions if you use it again), | |
71 N to do nothing (command remains disabled).")) | |
72 (message "Type y, n or Space: ") | |
73 (let ((cursor-in-echo-area t)) | |
74 (while (not (memq (setq char (downcase (read-char))) | |
75 '(? ?y ?n))) | |
76 (ding) | |
77 (message "Please type y, n or Space: ")))) | |
78 (if (= char ?y) | |
79 (if (y-or-n-p "Enable command for future editing sessions also? ") | |
80 (enable-command this-command) | |
81 (put this-command 'disabled nil))) | |
82 (if (/= char ?n) | |
83 (call-interactively this-command)))) | |
84 | |
256 | 85 ;;;###autoload |
36 | 86 (defun enable-command (command) |
87 "Allow COMMAND to be executed without special confirmation from now on. | |
88 The user's .emacs file is altered so that this will apply | |
89 to future sessions." | |
90 (interactive "CEnable command: ") | |
91 (put command 'disabled nil) | |
92 (save-excursion | |
93 (set-buffer (find-file-noselect (substitute-in-file-name "~/.emacs"))) | |
94 (goto-char (point-min)) | |
95 (if (search-forward (concat "(put '" (symbol-name command) " ") nil t) | |
96 (delete-region | |
97 (progn (beginning-of-line) (point)) | |
98 (progn (forward-line 1) (point))) | |
99 ;; Must have been disabled by default. | |
100 (goto-char (point-max)) | |
101 (insert "\n(put '" (symbol-name command) " 'disabled nil)\n")) | |
102 (setq foo (buffer-modified-p)) | |
103 (save-buffer))) | |
104 | |
256 | 105 ;;;###autoload |
36 | 106 (defun disable-command (command) |
107 "Require special confirmation to execute COMMAND from now on. | |
108 The user's .emacs file is altered so that this will apply | |
109 to future sessions." | |
110 (interactive "CDisable command: ") | |
111 (put command 'disabled t) | |
112 (save-excursion | |
113 (set-buffer (find-file-noselect (substitute-in-file-name "~/.emacs"))) | |
114 (goto-char (point-min)) | |
115 (if (search-forward (concat "(put '" (symbol-name command) " ") nil t) | |
116 (delete-region | |
117 (progn (beginning-of-line) (point)) | |
118 (progn (forward-line 1) (point)))) | |
119 (goto-char (point-max)) | |
120 (insert "(put '" (symbol-name command) " 'disabled t)\n") | |
121 (save-buffer))) | |
122 | |
2379
06abd963ec25
(enable-and-notify) Added. Inspired by Roland McGrath's LCD package
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
2308
diff
changeset
|
123 ;;;###autoload |
06abd963ec25
(enable-and-notify) Added. Inspired by Roland McGrath's LCD package
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
2308
diff
changeset
|
124 (defun enable-and-notify (&rest args) |
06abd963ec25
(enable-and-notify) Added. Inspired by Roland McGrath's LCD package
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
2308
diff
changeset
|
125 "A novice hook for non-novices." |
06abd963ec25
(enable-and-notify) Added. Inspired by Roland McGrath's LCD package
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
2308
diff
changeset
|
126 (put this-command 'disabled nil) |
06abd963ec25
(enable-and-notify) Added. Inspired by Roland McGrath's LCD package
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
2308
diff
changeset
|
127 (message "You typed %s. %s was disabled. It's enabled now." |
06abd963ec25
(enable-and-notify) Added. Inspired by Roland McGrath's LCD package
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
2308
diff
changeset
|
128 (key-description (this-command-keys)) this-command) |
06abd963ec25
(enable-and-notify) Added. Inspired by Roland McGrath's LCD package
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
2308
diff
changeset
|
129 (sit-for 0) |
06abd963ec25
(enable-and-notify) Added. Inspired by Roland McGrath's LCD package
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
2308
diff
changeset
|
130 (call-interactively this-command)) |
06abd963ec25
(enable-and-notify) Added. Inspired by Roland McGrath's LCD package
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
2308
diff
changeset
|
131 |
659
505130d1ddf8
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
282
diff
changeset
|
132 ;;; novice.el ends here |