Mercurial > emacs
annotate lisp/help.el @ 16632:5dd86f31843a
(compose-mail): Handle several more args:
other-headers continue switch-function yank-action send-action.
(sendmail-user-agent): Rewrite to handle new args.
(assoc-ignore-case): New function.
(define-mail-user-agent): Doc fix.
author | Richard M. Stallman <rms@gnu.org> |
---|---|
date | Sat, 07 Dec 1996 21:30:17 +0000 |
parents | 4ff6a0f0f5c7 |
children | c19089a334b2 |
rev | line source |
---|---|
660
08eb386dd0f3
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
444
diff
changeset
|
1 ;;; help.el --- help commands for Emacs |
08eb386dd0f3
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
444
diff
changeset
|
2 |
7298 | 3 ;; Copyright (C) 1985, 1986, 1993, 1994 Free Software Foundation, Inc. |
846
20674ae6bf52
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
811
diff
changeset
|
4 |
807
4f28bd14272c
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
755
diff
changeset
|
5 ;; Maintainer: FSF |
811
e694e0879463
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
807
diff
changeset
|
6 ;; Keywords: help, internal |
807
4f28bd14272c
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
755
diff
changeset
|
7 |
409 | 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:
755
diff
changeset
|
12 ;; the Free Software Foundation; either version 2, or (at your option) |
409 | 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 | |
14169 | 21 ;; along with GNU Emacs; see the file COPYING. If not, write to the |
22 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330, | |
23 ;; Boston, MA 02111-1307, USA. | |
409 | 24 |
2315
9e7ec92a4fdf
Added or corrected Commentary headers
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
2312
diff
changeset
|
25 ;;; Commentary: |
9e7ec92a4fdf
Added or corrected Commentary headers
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
2312
diff
changeset
|
26 |
16391
5d64d742ccbb
(print-help-return-message): Use new functions `special-display-p' and
Erik Naggum <erik@naggum.no>
parents:
16273
diff
changeset
|
27 ;; This code implements GNU Emacs' on-line help system, the one invoked by |
2315
9e7ec92a4fdf
Added or corrected Commentary headers
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
2312
diff
changeset
|
28 ;;`M-x help-for-help'. |
9e7ec92a4fdf
Added or corrected Commentary headers
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
2312
diff
changeset
|
29 |
807
4f28bd14272c
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
755
diff
changeset
|
30 ;;; Code: |
4f28bd14272c
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
755
diff
changeset
|
31 |
2312
ad7b89a430df
Don't load help-screen at run time if compiled.
Richard M. Stallman <rms@gnu.org>
parents:
2237
diff
changeset
|
32 ;; Get the macro make-help-screen when this is compiled, |
ad7b89a430df
Don't load help-screen at run time if compiled.
Richard M. Stallman <rms@gnu.org>
parents:
2237
diff
changeset
|
33 ;; or run interpreted, but not when the compiled code is loaded. |
2697
05ff97695d32
Require help-macro, not help-screen.
Richard M. Stallman <rms@gnu.org>
parents:
2638
diff
changeset
|
34 (eval-when-compile (require 'help-macro)) |
2237
2670a8f6a42e
Teach this to use help-screen.el.
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
2134
diff
changeset
|
35 |
409 | 36 (defvar help-map (make-sparse-keymap) |
37 "Keymap for characters following the Help key.") | |
38 | |
9833 | 39 (defvar help-mode-map (make-sparse-keymap) |
40 "Keymap for help mode.") | |
41 | |
919 | 42 (define-key global-map (char-to-string help-char) 'help-command) |
12424
aa25c9b2e043
Bind f1 and help like C-h.
Richard M. Stallman <rms@gnu.org>
parents:
11890
diff
changeset
|
43 (define-key global-map [help] 'help-command) |
aa25c9b2e043
Bind f1 and help like C-h.
Richard M. Stallman <rms@gnu.org>
parents:
11890
diff
changeset
|
44 (define-key global-map [f1] 'help-command) |
409 | 45 (fset 'help-command help-map) |
46 | |
919 | 47 (define-key help-map (char-to-string help-char) 'help-for-help) |
12424
aa25c9b2e043
Bind f1 and help like C-h.
Richard M. Stallman <rms@gnu.org>
parents:
11890
diff
changeset
|
48 (define-key help-map [help] 'help-for-help) |
aa25c9b2e043
Bind f1 and help like C-h.
Richard M. Stallman <rms@gnu.org>
parents:
11890
diff
changeset
|
49 (define-key help-map [f1] 'help-for-help) |
409 | 50 (define-key help-map "?" 'help-for-help) |
51 | |
52 (define-key help-map "\C-c" 'describe-copying) | |
53 (define-key help-map "\C-d" 'describe-distribution) | |
54 (define-key help-map "\C-w" 'describe-no-warranty) | |
5025
0556b068e9ee
(describe-project): New function, on C-h C-p.
Richard M. Stallman <rms@gnu.org>
parents:
4467
diff
changeset
|
55 (define-key help-map "\C-p" 'describe-project) |
409 | 56 (define-key help-map "a" 'command-apropos) |
57 | |
58 (define-key help-map "b" 'describe-bindings) | |
59 | |
60 (define-key help-map "c" 'describe-key-briefly) | |
61 (define-key help-map "k" 'describe-key) | |
62 | |
63 (define-key help-map "d" 'describe-function) | |
64 (define-key help-map "f" 'describe-function) | |
65 | |
10923
fe008aef4cf1
(view-emacs-FAQ): New function. Bind to C-h F.
Richard M. Stallman <rms@gnu.org>
parents:
10622
diff
changeset
|
66 (define-key help-map "F" 'view-emacs-FAQ) |
fe008aef4cf1
(view-emacs-FAQ): New function. Bind to C-h F.
Richard M. Stallman <rms@gnu.org>
parents:
10622
diff
changeset
|
67 |
409 | 68 (define-key help-map "i" 'info) |
732 | 69 (define-key help-map "\C-f" 'Info-goto-emacs-command-node) |
70 (define-key help-map "\C-k" 'Info-goto-emacs-key-command-node) | |
409 | 71 |
72 (define-key help-map "l" 'view-lossage) | |
73 | |
74 (define-key help-map "m" 'describe-mode) | |
75 | |
76 (define-key help-map "\C-n" 'view-emacs-news) | |
77 (define-key help-map "n" 'view-emacs-news) | |
78 | |
2134
b275e1b50542
Added autoload, binding and menu line for new finder feature (P).
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
2079
diff
changeset
|
79 (define-key help-map "p" 'finder-by-keyword) |
7978
8356e992ddb6
(finder-by-keyword): Add doc string and t for interactive.
Richard M. Stallman <rms@gnu.org>
parents:
7298
diff
changeset
|
80 (autoload 'finder-by-keyword "finder" |
8356e992ddb6
(finder-by-keyword): Add doc string and t for interactive.
Richard M. Stallman <rms@gnu.org>
parents:
7298
diff
changeset
|
81 "Find packages matching a given keyword." t) |
2134
b275e1b50542
Added autoload, binding and menu line for new finder feature (P).
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
2079
diff
changeset
|
82 |
409 | 83 (define-key help-map "s" 'describe-syntax) |
84 | |
85 (define-key help-map "t" 'help-with-tutorial) | |
86 | |
87 (define-key help-map "w" 'where-is) | |
88 | |
89 (define-key help-map "v" 'describe-variable) | |
90 | |
6580 | 91 (define-key help-map "q" 'help-quit) |
92 | |
12816
7a19739bd181
Added Font Lock mode support.
Simon Marshall <simon@gnu.org>
parents:
12499
diff
changeset
|
93 (defvar help-font-lock-keywords |
15788
e8e74fb6da7d
(help-font-lock-keywords): Use font-lock-function-name-face
Richard M. Stallman <rms@gnu.org>
parents:
15783
diff
changeset
|
94 (eval-when-compile |
e8e74fb6da7d
(help-font-lock-keywords): Use font-lock-function-name-face
Richard M. Stallman <rms@gnu.org>
parents:
15783
diff
changeset
|
95 (let ((name-char "[-+a-zA-Z0-9_*]") (sym-char "[-+a-zA-Z0-9_:*]")) |
e8e74fb6da7d
(help-font-lock-keywords): Use font-lock-function-name-face
Richard M. Stallman <rms@gnu.org>
parents:
15783
diff
changeset
|
96 (list |
e8e74fb6da7d
(help-font-lock-keywords): Use font-lock-function-name-face
Richard M. Stallman <rms@gnu.org>
parents:
15783
diff
changeset
|
97 ;; |
e8e74fb6da7d
(help-font-lock-keywords): Use font-lock-function-name-face
Richard M. Stallman <rms@gnu.org>
parents:
15783
diff
changeset
|
98 ;; The symbol itself. |
e8e74fb6da7d
(help-font-lock-keywords): Use font-lock-function-name-face
Richard M. Stallman <rms@gnu.org>
parents:
15783
diff
changeset
|
99 (list (concat "\\`\\(" name-char "+\\)\\(\\(:\\)\\|\\('\\)\\)") |
15810
add6684a3e67
(help-font-lock-keywords): Undo July 26 change.
Richard M. Stallman <rms@gnu.org>
parents:
15799
diff
changeset
|
100 '(1 (if (match-beginning 3) |
add6684a3e67
(help-font-lock-keywords): Undo July 26 change.
Richard M. Stallman <rms@gnu.org>
parents:
15799
diff
changeset
|
101 font-lock-function-name-face |
15826
4a675a6a15c8
Fully reinstall July 26 change.
Simon Marshall <simon@gnu.org>
parents:
15810
diff
changeset
|
102 font-lock-variable-name-face))) |
15788
e8e74fb6da7d
(help-font-lock-keywords): Use font-lock-function-name-face
Richard M. Stallman <rms@gnu.org>
parents:
15783
diff
changeset
|
103 ;; |
e8e74fb6da7d
(help-font-lock-keywords): Use font-lock-function-name-face
Richard M. Stallman <rms@gnu.org>
parents:
15783
diff
changeset
|
104 ;; Words inside `' which tend to be symbol names. |
e8e74fb6da7d
(help-font-lock-keywords): Use font-lock-function-name-face
Richard M. Stallman <rms@gnu.org>
parents:
15783
diff
changeset
|
105 (list (concat "`\\(" sym-char sym-char "+\\)'") |
e8e74fb6da7d
(help-font-lock-keywords): Use font-lock-function-name-face
Richard M. Stallman <rms@gnu.org>
parents:
15783
diff
changeset
|
106 1 'font-lock-reference-face t) |
e8e74fb6da7d
(help-font-lock-keywords): Use font-lock-function-name-face
Richard M. Stallman <rms@gnu.org>
parents:
15783
diff
changeset
|
107 ;; |
e8e74fb6da7d
(help-font-lock-keywords): Use font-lock-function-name-face
Richard M. Stallman <rms@gnu.org>
parents:
15783
diff
changeset
|
108 ;; CLisp `:' keywords as references. |
e8e74fb6da7d
(help-font-lock-keywords): Use font-lock-function-name-face
Richard M. Stallman <rms@gnu.org>
parents:
15783
diff
changeset
|
109 (list (concat "\\<:" sym-char "+\\>") 0 'font-lock-reference-face t)))) |
12816
7a19739bd181
Added Font Lock mode support.
Simon Marshall <simon@gnu.org>
parents:
12499
diff
changeset
|
110 "Default expressions to highlight in Help mode.") |
7a19739bd181
Added Font Lock mode support.
Simon Marshall <simon@gnu.org>
parents:
12499
diff
changeset
|
111 |
9833 | 112 (defun help-mode () |
113 "Major mode for viewing help text. | |
114 Entry to this mode runs the normal hook `help-mode-hook'. | |
115 Commands: | |
116 \\{help-mode-map}" | |
117 (interactive) | |
118 (kill-all-local-variables) | |
119 (use-local-map help-mode-map) | |
120 (setq mode-name "Help") | |
121 (setq major-mode 'help-mode) | |
12816
7a19739bd181
Added Font Lock mode support.
Simon Marshall <simon@gnu.org>
parents:
12499
diff
changeset
|
122 (make-local-variable 'font-lock-defaults) |
15799
2a1123f30c73
(help-fontify-buffer-function): Function deleted.
Richard M. Stallman <rms@gnu.org>
parents:
15788
diff
changeset
|
123 (setq font-lock-defaults '(help-font-lock-keywords)) |
13079
6a91723f2a8c
(help-mode): Call view-mode.
Richard M. Stallman <rms@gnu.org>
parents:
12941
diff
changeset
|
124 (view-mode) |
9833 | 125 (run-hooks 'help-mode-hook)) |
126 | |
6580 | 127 (defun help-quit () |
128 (interactive) | |
129 nil) | |
130 | |
409 | 131 (defun help-with-tutorial () |
132 "Select the Emacs learn-by-doing tutorial." | |
133 (interactive) | |
134 (let ((file (expand-file-name "~/TUTORIAL"))) | |
135 (delete-other-windows) | |
136 (if (get-file-buffer file) | |
137 (switch-to-buffer (get-file-buffer file)) | |
138 (switch-to-buffer (create-file-buffer file)) | |
139 (setq buffer-file-name file) | |
140 (setq default-directory (expand-file-name "~/")) | |
755 | 141 (setq buffer-auto-save-file-name nil) |
444 | 142 (insert-file-contents (expand-file-name "TUTORIAL" data-directory)) |
409 | 143 (goto-char (point-min)) |
144 (search-forward "\n<<") | |
145 (beginning-of-line) | |
146 (delete-region (point) (progn (end-of-line) (point))) | |
6419
e5ce725b661d
(help-with-tutorial): Avoid unexplained large blank area.
Karl Heuer <kwzh@gnu.org>
parents:
6079
diff
changeset
|
147 (let ((n (- (window-height (selected-window)) |
409 | 148 (count-lines (point-min) (point)) |
6419
e5ce725b661d
(help-with-tutorial): Avoid unexplained large blank area.
Karl Heuer <kwzh@gnu.org>
parents:
6079
diff
changeset
|
149 6))) |
6433
e50519261181
(help-with-tutorial): Change previous change;
Richard M. Stallman <rms@gnu.org>
parents:
6419
diff
changeset
|
150 (if (< n 12) |
6419
e5ce725b661d
(help-with-tutorial): Avoid unexplained large blank area.
Karl Heuer <kwzh@gnu.org>
parents:
6079
diff
changeset
|
151 (newline n) |
e5ce725b661d
(help-with-tutorial): Avoid unexplained large blank area.
Karl Heuer <kwzh@gnu.org>
parents:
6079
diff
changeset
|
152 ;; Some people get confused by the large gap. |
e5ce725b661d
(help-with-tutorial): Avoid unexplained large blank area.
Karl Heuer <kwzh@gnu.org>
parents:
6079
diff
changeset
|
153 (newline (/ n 2)) |
e5ce725b661d
(help-with-tutorial): Avoid unexplained large blank area.
Karl Heuer <kwzh@gnu.org>
parents:
6079
diff
changeset
|
154 (insert "[Middle of page left blank for didactic purposes. " |
e5ce725b661d
(help-with-tutorial): Avoid unexplained large blank area.
Karl Heuer <kwzh@gnu.org>
parents:
6079
diff
changeset
|
155 "Text continues below]") |
e5ce725b661d
(help-with-tutorial): Avoid unexplained large blank area.
Karl Heuer <kwzh@gnu.org>
parents:
6079
diff
changeset
|
156 (newline (- n (/ n 2))))) |
409 | 157 (goto-char (point-min)) |
158 (set-buffer-modified-p nil)))) | |
159 | |
160 (defun describe-key-briefly (key) | |
161 "Print the name of the function KEY invokes. KEY is a string." | |
162 (interactive "kDescribe key briefly: ") | |
2955
f34f9e634b81
(describe-key, describe-key-briefly):
Richard M. Stallman <rms@gnu.org>
parents:
2697
diff
changeset
|
163 ;; If this key seq ends with a down event, discard the |
f34f9e634b81
(describe-key, describe-key-briefly):
Richard M. Stallman <rms@gnu.org>
parents:
2697
diff
changeset
|
164 ;; following click or drag event. Otherwise that would |
f34f9e634b81
(describe-key, describe-key-briefly):
Richard M. Stallman <rms@gnu.org>
parents:
2697
diff
changeset
|
165 ;; erase the message. |
f34f9e634b81
(describe-key, describe-key-briefly):
Richard M. Stallman <rms@gnu.org>
parents:
2697
diff
changeset
|
166 (let ((type (aref key (1- (length key))))) |
f34f9e634b81
(describe-key, describe-key-briefly):
Richard M. Stallman <rms@gnu.org>
parents:
2697
diff
changeset
|
167 (if (listp type) (setq type (car type))) |
f34f9e634b81
(describe-key, describe-key-briefly):
Richard M. Stallman <rms@gnu.org>
parents:
2697
diff
changeset
|
168 (and (symbolp type) |
f34f9e634b81
(describe-key, describe-key-briefly):
Richard M. Stallman <rms@gnu.org>
parents:
2697
diff
changeset
|
169 (memq 'down (event-modifiers type)) |
3986
0e5fa7a1ac36
(describe-key-briefly): Don't set `foo'.
Richard M. Stallman <rms@gnu.org>
parents:
3982
diff
changeset
|
170 (read-event))) |
13293
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
171 (save-excursion |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
172 (let ((modifiers (event-modifiers (aref key 0))) |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
173 window position) |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
174 ;; For a mouse button event, go to the button it applies to |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
175 ;; to get the right key bindings. And go to the right place |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
176 ;; in case the keymap depends on where you clicked. |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
177 (if (or (memq 'click modifiers) (memq 'down modifiers) |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
178 (memq 'drag modifiers)) |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
179 (setq window (posn-window (event-start (aref key 0))) |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
180 position (posn-point (event-start (aref key 0))))) |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
181 (if (windowp window) |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
182 (progn |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
183 (set-buffer (window-buffer window)) |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
184 (goto-char position))) |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
185 ;; Ok, now look up the key and name the command. |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
186 (let ((defn (key-binding key))) |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
187 (if (or (null defn) (integerp defn)) |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
188 (message "%s is undefined" (key-description key)) |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
189 (message (if (windowp window) |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
190 "%s at that spot runs the command %s" |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
191 "%s runs the command %s") |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
192 (key-description key) |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
193 (if (symbolp defn) defn (prin1-to-string defn)))))))) |
409 | 194 |
195 (defun print-help-return-message (&optional function) | |
196 "Display or return message saying how to restore windows after help command. | |
197 Computes a message and applies the optional argument FUNCTION to it. | |
198 If FUNCTION is nil, applies `message' to it, thus printing it." | |
199 (and (not (get-buffer-window standard-output)) | |
8259
604d89082229
(print-help-return-message): If help buffer is a
Richard M. Stallman <rms@gnu.org>
parents:
7978
diff
changeset
|
200 (let ((first-message |
16391
5d64d742ccbb
(print-help-return-message): Use new functions `special-display-p' and
Erik Naggum <erik@naggum.no>
parents:
16273
diff
changeset
|
201 (cond ((special-display-p (buffer-name standard-output)) |
8259
604d89082229
(print-help-return-message): If help buffer is a
Richard M. Stallman <rms@gnu.org>
parents:
7978
diff
changeset
|
202 ;; If the help output buffer is a special display buffer, |
604d89082229
(print-help-return-message): If help buffer is a
Richard M. Stallman <rms@gnu.org>
parents:
7978
diff
changeset
|
203 ;; don't say anything about how to get rid of it. |
604d89082229
(print-help-return-message): If help buffer is a
Richard M. Stallman <rms@gnu.org>
parents:
7978
diff
changeset
|
204 ;; First of all, the user will do that with the window |
604d89082229
(print-help-return-message): If help buffer is a
Richard M. Stallman <rms@gnu.org>
parents:
7978
diff
changeset
|
205 ;; manager, not with Emacs. |
604d89082229
(print-help-return-message): If help buffer is a
Richard M. Stallman <rms@gnu.org>
parents:
7978
diff
changeset
|
206 ;; Secondly, the buffer has not been displayed yet, |
604d89082229
(print-help-return-message): If help buffer is a
Richard M. Stallman <rms@gnu.org>
parents:
7978
diff
changeset
|
207 ;; so we don't know whether its frame will be selected. |
604d89082229
(print-help-return-message): If help buffer is a
Richard M. Stallman <rms@gnu.org>
parents:
7978
diff
changeset
|
208 nil) |
604d89082229
(print-help-return-message): If help buffer is a
Richard M. Stallman <rms@gnu.org>
parents:
7978
diff
changeset
|
209 ((not (one-window-p t)) |
604d89082229
(print-help-return-message): If help buffer is a
Richard M. Stallman <rms@gnu.org>
parents:
7978
diff
changeset
|
210 "Type \\[switch-to-buffer-other-window] RET to restore the other window.") |
604d89082229
(print-help-return-message): If help buffer is a
Richard M. Stallman <rms@gnu.org>
parents:
7978
diff
changeset
|
211 (pop-up-windows |
604d89082229
(print-help-return-message): If help buffer is a
Richard M. Stallman <rms@gnu.org>
parents:
7978
diff
changeset
|
212 "Type \\[delete-other-windows] to remove help window.") |
604d89082229
(print-help-return-message): If help buffer is a
Richard M. Stallman <rms@gnu.org>
parents:
7978
diff
changeset
|
213 (t |
604d89082229
(print-help-return-message): If help buffer is a
Richard M. Stallman <rms@gnu.org>
parents:
7978
diff
changeset
|
214 "Type \\[switch-to-buffer] RET to remove help window.")))) |
604d89082229
(print-help-return-message): If help buffer is a
Richard M. Stallman <rms@gnu.org>
parents:
7978
diff
changeset
|
215 (funcall (or function 'message) |
604d89082229
(print-help-return-message): If help buffer is a
Richard M. Stallman <rms@gnu.org>
parents:
7978
diff
changeset
|
216 (concat |
604d89082229
(print-help-return-message): If help buffer is a
Richard M. Stallman <rms@gnu.org>
parents:
7978
diff
changeset
|
217 (if first-message |
604d89082229
(print-help-return-message): If help buffer is a
Richard M. Stallman <rms@gnu.org>
parents:
7978
diff
changeset
|
218 (substitute-command-keys first-message) |
604d89082229
(print-help-return-message): If help buffer is a
Richard M. Stallman <rms@gnu.org>
parents:
7978
diff
changeset
|
219 "") |
604d89082229
(print-help-return-message): If help buffer is a
Richard M. Stallman <rms@gnu.org>
parents:
7978
diff
changeset
|
220 (if first-message " " "") |
11524
cafa503e806c
(print-help-return-message): Check same-window-buffer-names
Richard M. Stallman <rms@gnu.org>
parents:
11428
diff
changeset
|
221 ;; If the help buffer will go in a separate frame, |
cafa503e806c
(print-help-return-message): Check same-window-buffer-names
Richard M. Stallman <rms@gnu.org>
parents:
11428
diff
changeset
|
222 ;; it's no use mentioning a command to scroll, so don't. |
16391
5d64d742ccbb
(print-help-return-message): Use new functions `special-display-p' and
Erik Naggum <erik@naggum.no>
parents:
16273
diff
changeset
|
223 (if (special-display-p (buffer-name standard-output)) |
11524
cafa503e806c
(print-help-return-message): Check same-window-buffer-names
Richard M. Stallman <rms@gnu.org>
parents:
11428
diff
changeset
|
224 nil |
16391
5d64d742ccbb
(print-help-return-message): Use new functions `special-display-p' and
Erik Naggum <erik@naggum.no>
parents:
16273
diff
changeset
|
225 (if (same-window-p (buffer-name standard-output)) |
11524
cafa503e806c
(print-help-return-message): Check same-window-buffer-names
Richard M. Stallman <rms@gnu.org>
parents:
11428
diff
changeset
|
226 ;; Say how to scroll this window. |
cafa503e806c
(print-help-return-message): Check same-window-buffer-names
Richard M. Stallman <rms@gnu.org>
parents:
11428
diff
changeset
|
227 (substitute-command-keys |
cafa503e806c
(print-help-return-message): Check same-window-buffer-names
Richard M. Stallman <rms@gnu.org>
parents:
11428
diff
changeset
|
228 "\\[scroll-up] to scroll the help.") |
cafa503e806c
(print-help-return-message): Check same-window-buffer-names
Richard M. Stallman <rms@gnu.org>
parents:
11428
diff
changeset
|
229 ;; Say how to scroll some other window. |
11428
d39d8e8b6d20
(print-help-return-message): Check same-window-buffer-names
Richard M. Stallman <rms@gnu.org>
parents:
10923
diff
changeset
|
230 (substitute-command-keys |
11524
cafa503e806c
(print-help-return-message): Check same-window-buffer-names
Richard M. Stallman <rms@gnu.org>
parents:
11428
diff
changeset
|
231 "\\[scroll-other-window] to scroll the help.")))))))) |
409 | 232 |
233 (defun describe-key (key) | |
234 "Display documentation of the function invoked by KEY. KEY is a string." | |
235 (interactive "kDescribe key: ") | |
2955
f34f9e634b81
(describe-key, describe-key-briefly):
Richard M. Stallman <rms@gnu.org>
parents:
2697
diff
changeset
|
236 ;; If this key seq ends with a down event, discard the |
f34f9e634b81
(describe-key, describe-key-briefly):
Richard M. Stallman <rms@gnu.org>
parents:
2697
diff
changeset
|
237 ;; following click or drag event. Otherwise that would |
f34f9e634b81
(describe-key, describe-key-briefly):
Richard M. Stallman <rms@gnu.org>
parents:
2697
diff
changeset
|
238 ;; erase the message. |
f34f9e634b81
(describe-key, describe-key-briefly):
Richard M. Stallman <rms@gnu.org>
parents:
2697
diff
changeset
|
239 (let ((type (aref key (1- (length key))))) |
f34f9e634b81
(describe-key, describe-key-briefly):
Richard M. Stallman <rms@gnu.org>
parents:
2697
diff
changeset
|
240 (if (listp type) (setq type (car type))) |
f34f9e634b81
(describe-key, describe-key-briefly):
Richard M. Stallman <rms@gnu.org>
parents:
2697
diff
changeset
|
241 (and (symbolp type) |
f34f9e634b81
(describe-key, describe-key-briefly):
Richard M. Stallman <rms@gnu.org>
parents:
2697
diff
changeset
|
242 (memq 'down (event-modifiers type)) |
f34f9e634b81
(describe-key, describe-key-briefly):
Richard M. Stallman <rms@gnu.org>
parents:
2697
diff
changeset
|
243 (read-event))) |
13293
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
244 (save-excursion |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
245 (let ((modifiers (event-modifiers (aref key 0))) |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
246 window position) |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
247 ;; For a mouse button event, go to the button it applies to |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
248 ;; to get the right key bindings. And go to the right place |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
249 ;; in case the keymap depends on where you clicked. |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
250 (if (or (memq 'click modifiers) (memq 'down modifiers) |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
251 (memq 'drag modifiers)) |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
252 (setq window (posn-window (event-start (aref key 0))) |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
253 position (posn-point (event-start (aref key 0))))) |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
254 (if (windowp window) |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
255 (progn |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
256 (set-buffer (window-buffer window)) |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
257 (goto-char position))) |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
258 (let ((defn (key-binding key))) |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
259 (if (or (null defn) (integerp defn)) |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
260 (message "%s is undefined" (key-description key)) |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
261 (with-output-to-temp-buffer "*Help*" |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
262 (princ (key-description key)) |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
263 (if (windowp window) |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
264 (princ " at that spot")) |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
265 (princ " runs the command ") |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
266 (prin1 defn) |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
267 (princ ":\n") |
13358
febf5ce4532c
(describe-function): Call documentation just once.
Richard M. Stallman <rms@gnu.org>
parents:
13348
diff
changeset
|
268 (let ((doc (documentation defn))) |
febf5ce4532c
(describe-function): Call documentation just once.
Richard M. Stallman <rms@gnu.org>
parents:
13348
diff
changeset
|
269 (if doc |
febf5ce4532c
(describe-function): Call documentation just once.
Richard M. Stallman <rms@gnu.org>
parents:
13348
diff
changeset
|
270 (progn (terpri) |
febf5ce4532c
(describe-function): Call documentation just once.
Richard M. Stallman <rms@gnu.org>
parents:
13348
diff
changeset
|
271 (princ doc)) |
febf5ce4532c
(describe-function): Call documentation just once.
Richard M. Stallman <rms@gnu.org>
parents:
13348
diff
changeset
|
272 (princ "not documented"))) |
13293
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
273 (save-excursion |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
274 (set-buffer standard-output) |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
275 (help-mode)) |
5270a0a465a7
(describe-key, describe-key-briefly): For a mouse click,
Richard M. Stallman <rms@gnu.org>
parents:
13209
diff
changeset
|
276 (print-help-return-message))))))) |
409 | 277 |
6902
962a6ffb7b97
(describe-mode): Always show minor modes, at front.
Richard M. Stallman <rms@gnu.org>
parents:
6580
diff
changeset
|
278 (defun describe-mode () |
962a6ffb7b97
(describe-mode): Always show minor modes, at front.
Richard M. Stallman <rms@gnu.org>
parents:
6580
diff
changeset
|
279 "Display documentation of current major mode and minor modes. |
409 | 280 For this to work correctly for a minor mode, the mode's indicator variable |
3980
bf2d4294a1dd
(describe-prefix-bindings): New command.
Richard M. Stallman <rms@gnu.org>
parents:
3145
diff
changeset
|
281 \(listed in `minor-mode-alist') must also be a function whose documentation |
409 | 282 describes the minor mode." |
6903
61d9d9b5ccba
(describe-mode): Fix previous change.
Richard M. Stallman <rms@gnu.org>
parents:
6902
diff
changeset
|
283 (interactive) |
409 | 284 (with-output-to-temp-buffer "*Help*" |
6903
61d9d9b5ccba
(describe-mode): Fix previous change.
Richard M. Stallman <rms@gnu.org>
parents:
6902
diff
changeset
|
285 (let ((minor-modes minor-mode-alist) |
15783
e0524a01fc91
(describe-mode): Put a formfeed between each two modes.
Richard M. Stallman <rms@gnu.org>
parents:
14832
diff
changeset
|
286 (first t) |
6903
61d9d9b5ccba
(describe-mode): Fix previous change.
Richard M. Stallman <rms@gnu.org>
parents:
6902
diff
changeset
|
287 (locals (buffer-local-variables))) |
61d9d9b5ccba
(describe-mode): Fix previous change.
Richard M. Stallman <rms@gnu.org>
parents:
6902
diff
changeset
|
288 (while minor-modes |
61d9d9b5ccba
(describe-mode): Fix previous change.
Richard M. Stallman <rms@gnu.org>
parents:
6902
diff
changeset
|
289 (let* ((minor-mode (car (car minor-modes))) |
61d9d9b5ccba
(describe-mode): Fix previous change.
Richard M. Stallman <rms@gnu.org>
parents:
6902
diff
changeset
|
290 (indicator (car (cdr (car minor-modes)))) |
61d9d9b5ccba
(describe-mode): Fix previous change.
Richard M. Stallman <rms@gnu.org>
parents:
6902
diff
changeset
|
291 (local-binding (assq minor-mode locals))) |
61d9d9b5ccba
(describe-mode): Fix previous change.
Richard M. Stallman <rms@gnu.org>
parents:
6902
diff
changeset
|
292 ;; Document a minor mode if it is listed in minor-mode-alist, |
61d9d9b5ccba
(describe-mode): Fix previous change.
Richard M. Stallman <rms@gnu.org>
parents:
6902
diff
changeset
|
293 ;; bound locally in this buffer, non-nil, and has a function |
61d9d9b5ccba
(describe-mode): Fix previous change.
Richard M. Stallman <rms@gnu.org>
parents:
6902
diff
changeset
|
294 ;; definition. |
61d9d9b5ccba
(describe-mode): Fix previous change.
Richard M. Stallman <rms@gnu.org>
parents:
6902
diff
changeset
|
295 (if (and local-binding |
61d9d9b5ccba
(describe-mode): Fix previous change.
Richard M. Stallman <rms@gnu.org>
parents:
6902
diff
changeset
|
296 (cdr local-binding) |
61d9d9b5ccba
(describe-mode): Fix previous change.
Richard M. Stallman <rms@gnu.org>
parents:
6902
diff
changeset
|
297 (fboundp minor-mode)) |
61d9d9b5ccba
(describe-mode): Fix previous change.
Richard M. Stallman <rms@gnu.org>
parents:
6902
diff
changeset
|
298 (let ((pretty-minor-mode minor-mode)) |
61d9d9b5ccba
(describe-mode): Fix previous change.
Richard M. Stallman <rms@gnu.org>
parents:
6902
diff
changeset
|
299 (if (string-match "-mode$" (symbol-name minor-mode)) |
61d9d9b5ccba
(describe-mode): Fix previous change.
Richard M. Stallman <rms@gnu.org>
parents:
6902
diff
changeset
|
300 (setq pretty-minor-mode |
61d9d9b5ccba
(describe-mode): Fix previous change.
Richard M. Stallman <rms@gnu.org>
parents:
6902
diff
changeset
|
301 (capitalize |
61d9d9b5ccba
(describe-mode): Fix previous change.
Richard M. Stallman <rms@gnu.org>
parents:
6902
diff
changeset
|
302 (substring (symbol-name minor-mode) |
61d9d9b5ccba
(describe-mode): Fix previous change.
Richard M. Stallman <rms@gnu.org>
parents:
6902
diff
changeset
|
303 0 (match-beginning 0))))) |
61d9d9b5ccba
(describe-mode): Fix previous change.
Richard M. Stallman <rms@gnu.org>
parents:
6902
diff
changeset
|
304 (while (and indicator (symbolp indicator)) |
61d9d9b5ccba
(describe-mode): Fix previous change.
Richard M. Stallman <rms@gnu.org>
parents:
6902
diff
changeset
|
305 (setq indicator (symbol-value indicator))) |
15783
e0524a01fc91
(describe-mode): Put a formfeed between each two modes.
Richard M. Stallman <rms@gnu.org>
parents:
14832
diff
changeset
|
306 (if first |
e0524a01fc91
(describe-mode): Put a formfeed between each two modes.
Richard M. Stallman <rms@gnu.org>
parents:
14832
diff
changeset
|
307 (princ "The minor modes are described first, |
e0524a01fc91
(describe-mode): Put a formfeed between each two modes.
Richard M. Stallman <rms@gnu.org>
parents:
14832
diff
changeset
|
308 followed by the major mode, which is described on the last page.\n\f\n")) |
e0524a01fc91
(describe-mode): Put a formfeed between each two modes.
Richard M. Stallman <rms@gnu.org>
parents:
14832
diff
changeset
|
309 (setq first nil) |
14832
4d511dd9bfce
(describe-mode): Handle minor mode w/o mode line indicator.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
310 (princ (format "%s minor mode (%s):\n" |
4d511dd9bfce
(describe-mode): Handle minor mode w/o mode line indicator.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
311 pretty-minor-mode |
4d511dd9bfce
(describe-mode): Handle minor mode w/o mode line indicator.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
312 (if indicator |
4d511dd9bfce
(describe-mode): Handle minor mode w/o mode line indicator.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
313 (format "indicator%s" indicator) |
4d511dd9bfce
(describe-mode): Handle minor mode w/o mode line indicator.
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
314 "no indicator"))) |
6903
61d9d9b5ccba
(describe-mode): Fix previous change.
Richard M. Stallman <rms@gnu.org>
parents:
6902
diff
changeset
|
315 (princ (documentation minor-mode)) |
15783
e0524a01fc91
(describe-mode): Put a formfeed between each two modes.
Richard M. Stallman <rms@gnu.org>
parents:
14832
diff
changeset
|
316 (princ "\n\f\n")))) |
6903
61d9d9b5ccba
(describe-mode): Fix previous change.
Richard M. Stallman <rms@gnu.org>
parents:
6902
diff
changeset
|
317 (setq minor-modes (cdr minor-modes)))) |
409 | 318 (princ mode-name) |
6902
962a6ffb7b97
(describe-mode): Always show minor modes, at front.
Richard M. Stallman <rms@gnu.org>
parents:
6580
diff
changeset
|
319 (princ " mode:\n") |
409 | 320 (princ (documentation major-mode)) |
9854
f810a558acf6
(describe-key, describe-mode, view-lossage, describe-function, describe-variable): Set help-mode in *Help* buffer.
Karl Heuer <kwzh@gnu.org>
parents:
9833
diff
changeset
|
321 (save-excursion |
f810a558acf6
(describe-key, describe-mode, view-lossage, describe-function, describe-variable): Set help-mode in *Help* buffer.
Karl Heuer <kwzh@gnu.org>
parents:
9833
diff
changeset
|
322 (set-buffer standard-output) |
f810a558acf6
(describe-key, describe-mode, view-lossage, describe-function, describe-variable): Set help-mode in *Help* buffer.
Karl Heuer <kwzh@gnu.org>
parents:
9833
diff
changeset
|
323 (help-mode)) |
409 | 324 (print-help-return-message))) |
325 | |
326 ;; So keyboard macro definitions are documented correctly | |
327 (fset 'defining-kbd-macro (symbol-function 'start-kbd-macro)) | |
328 | |
329 (defun describe-distribution () | |
330 "Display info on how to obtain the latest version of GNU Emacs." | |
331 (interactive) | |
332 (find-file-read-only | |
444 | 333 (expand-file-name "DISTRIB" data-directory))) |
409 | 334 |
335 (defun describe-copying () | |
336 "Display info on how you may redistribute copies of GNU Emacs." | |
337 (interactive) | |
338 (find-file-read-only | |
444 | 339 (expand-file-name "COPYING" data-directory)) |
409 | 340 (goto-char (point-min))) |
341 | |
5025
0556b068e9ee
(describe-project): New function, on C-h C-p.
Richard M. Stallman <rms@gnu.org>
parents:
4467
diff
changeset
|
342 (defun describe-project () |
0556b068e9ee
(describe-project): New function, on C-h C-p.
Richard M. Stallman <rms@gnu.org>
parents:
4467
diff
changeset
|
343 "Display info on the GNU project." |
0556b068e9ee
(describe-project): New function, on C-h C-p.
Richard M. Stallman <rms@gnu.org>
parents:
4467
diff
changeset
|
344 (interactive) |
0556b068e9ee
(describe-project): New function, on C-h C-p.
Richard M. Stallman <rms@gnu.org>
parents:
4467
diff
changeset
|
345 (find-file-read-only |
0556b068e9ee
(describe-project): New function, on C-h C-p.
Richard M. Stallman <rms@gnu.org>
parents:
4467
diff
changeset
|
346 (expand-file-name "GNU" data-directory)) |
0556b068e9ee
(describe-project): New function, on C-h C-p.
Richard M. Stallman <rms@gnu.org>
parents:
4467
diff
changeset
|
347 (goto-char (point-min))) |
0556b068e9ee
(describe-project): New function, on C-h C-p.
Richard M. Stallman <rms@gnu.org>
parents:
4467
diff
changeset
|
348 |
409 | 349 (defun describe-no-warranty () |
350 "Display info on all the kinds of warranty Emacs does NOT have." | |
351 (interactive) | |
352 (describe-copying) | |
353 (let (case-fold-search) | |
354 (search-forward "NO WARRANTY") | |
355 (recenter 0))) | |
356 | |
3980
bf2d4294a1dd
(describe-prefix-bindings): New command.
Richard M. Stallman <rms@gnu.org>
parents:
3145
diff
changeset
|
357 (defun describe-prefix-bindings () |
3982
e50f7b531c7f
(describe-prefix-bindings): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents:
3980
diff
changeset
|
358 "Describe the bindings of the prefix used to reach this command. |
e50f7b531c7f
(describe-prefix-bindings): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents:
3980
diff
changeset
|
359 The prefix described consists of all but the last event |
e50f7b531c7f
(describe-prefix-bindings): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents:
3980
diff
changeset
|
360 of the key sequence that ran this command." |
3980
bf2d4294a1dd
(describe-prefix-bindings): New command.
Richard M. Stallman <rms@gnu.org>
parents:
3145
diff
changeset
|
361 (interactive) |
11890
543a76aa50b9
(describe-prefix-bindings): If key is a string,
Karl Heuer <kwzh@gnu.org>
parents:
11524
diff
changeset
|
362 (let* ((key (this-command-keys))) |
543a76aa50b9
(describe-prefix-bindings): If key is a string,
Karl Heuer <kwzh@gnu.org>
parents:
11524
diff
changeset
|
363 (describe-bindings |
543a76aa50b9
(describe-prefix-bindings): If key is a string,
Karl Heuer <kwzh@gnu.org>
parents:
11524
diff
changeset
|
364 (if (stringp key) |
543a76aa50b9
(describe-prefix-bindings): If key is a string,
Karl Heuer <kwzh@gnu.org>
parents:
11524
diff
changeset
|
365 (substring key 0 (1- (length key))) |
543a76aa50b9
(describe-prefix-bindings): If key is a string,
Karl Heuer <kwzh@gnu.org>
parents:
11524
diff
changeset
|
366 (let ((prefix (make-vector (1- (length key)) nil)) |
543a76aa50b9
(describe-prefix-bindings): If key is a string,
Karl Heuer <kwzh@gnu.org>
parents:
11524
diff
changeset
|
367 (i 0)) |
543a76aa50b9
(describe-prefix-bindings): If key is a string,
Karl Heuer <kwzh@gnu.org>
parents:
11524
diff
changeset
|
368 (while (< i (length prefix)) |
543a76aa50b9
(describe-prefix-bindings): If key is a string,
Karl Heuer <kwzh@gnu.org>
parents:
11524
diff
changeset
|
369 (aset prefix i (aref key i)) |
543a76aa50b9
(describe-prefix-bindings): If key is a string,
Karl Heuer <kwzh@gnu.org>
parents:
11524
diff
changeset
|
370 (setq i (1+ i))) |
543a76aa50b9
(describe-prefix-bindings): If key is a string,
Karl Heuer <kwzh@gnu.org>
parents:
11524
diff
changeset
|
371 prefix))))) |
3982
e50f7b531c7f
(describe-prefix-bindings): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents:
3980
diff
changeset
|
372 ;; Make C-h after a prefix, when not specifically bound, |
e50f7b531c7f
(describe-prefix-bindings): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents:
3980
diff
changeset
|
373 ;; run describe-prefix-bindings. |
3980
bf2d4294a1dd
(describe-prefix-bindings): New command.
Richard M. Stallman <rms@gnu.org>
parents:
3145
diff
changeset
|
374 (setq prefix-help-command 'describe-prefix-bindings) |
bf2d4294a1dd
(describe-prefix-bindings): New command.
Richard M. Stallman <rms@gnu.org>
parents:
3145
diff
changeset
|
375 |
409 | 376 (defun view-emacs-news () |
377 "Display info on recent changes to Emacs." | |
378 (interactive) | |
444 | 379 (find-file-read-only (expand-file-name "NEWS" data-directory))) |
409 | 380 |
10923
fe008aef4cf1
(view-emacs-FAQ): New function. Bind to C-h F.
Richard M. Stallman <rms@gnu.org>
parents:
10622
diff
changeset
|
381 (defun view-emacs-FAQ () |
fe008aef4cf1
(view-emacs-FAQ): New function. Bind to C-h F.
Richard M. Stallman <rms@gnu.org>
parents:
10622
diff
changeset
|
382 "Display the Emacs Frequently Asked Questions (FAQ) file." |
fe008aef4cf1
(view-emacs-FAQ): New function. Bind to C-h F.
Richard M. Stallman <rms@gnu.org>
parents:
10622
diff
changeset
|
383 (interactive) |
fe008aef4cf1
(view-emacs-FAQ): New function. Bind to C-h F.
Richard M. Stallman <rms@gnu.org>
parents:
10622
diff
changeset
|
384 (find-file-read-only (expand-file-name "FAQ" data-directory))) |
fe008aef4cf1
(view-emacs-FAQ): New function. Bind to C-h F.
Richard M. Stallman <rms@gnu.org>
parents:
10622
diff
changeset
|
385 |
409 | 386 (defun view-lossage () |
387 "Display last 100 input keystrokes." | |
388 (interactive) | |
389 (with-output-to-temp-buffer "*Help*" | |
8504
8c492f23ee28
(view-lossage): Handle buffers and frames in recent-keys.
Richard M. Stallman <rms@gnu.org>
parents:
8259
diff
changeset
|
390 (princ (mapconcat (function (lambda (key) |
8c492f23ee28
(view-lossage): Handle buffers and frames in recent-keys.
Richard M. Stallman <rms@gnu.org>
parents:
8259
diff
changeset
|
391 (if (or (integerp key) |
8c492f23ee28
(view-lossage): Handle buffers and frames in recent-keys.
Richard M. Stallman <rms@gnu.org>
parents:
8259
diff
changeset
|
392 (symbolp key) |
8c492f23ee28
(view-lossage): Handle buffers and frames in recent-keys.
Richard M. Stallman <rms@gnu.org>
parents:
8259
diff
changeset
|
393 (listp key)) |
8c492f23ee28
(view-lossage): Handle buffers and frames in recent-keys.
Richard M. Stallman <rms@gnu.org>
parents:
8259
diff
changeset
|
394 (single-key-description key) |
8c492f23ee28
(view-lossage): Handle buffers and frames in recent-keys.
Richard M. Stallman <rms@gnu.org>
parents:
8259
diff
changeset
|
395 (prin1-to-string key nil)))) |
8c492f23ee28
(view-lossage): Handle buffers and frames in recent-keys.
Richard M. Stallman <rms@gnu.org>
parents:
8259
diff
changeset
|
396 (recent-keys) |
8c492f23ee28
(view-lossage): Handle buffers and frames in recent-keys.
Richard M. Stallman <rms@gnu.org>
parents:
8259
diff
changeset
|
397 " ")) |
409 | 398 (save-excursion |
399 (set-buffer standard-output) | |
400 (goto-char (point-min)) | |
401 (while (progn (move-to-column 50) (not (eobp))) | |
402 (search-forward " " nil t) | |
9854
f810a558acf6
(describe-key, describe-mode, view-lossage, describe-function, describe-variable): Set help-mode in *Help* buffer.
Karl Heuer <kwzh@gnu.org>
parents:
9833
diff
changeset
|
403 (insert "\n")) |
f810a558acf6
(describe-key, describe-mode, view-lossage, describe-function, describe-variable): Set help-mode in *Help* buffer.
Karl Heuer <kwzh@gnu.org>
parents:
9833
diff
changeset
|
404 (help-mode)) |
409 | 405 (print-help-return-message))) |
406 | |
6580 | 407 (defalias 'help 'help-for-help) |
2237
2670a8f6a42e
Teach this to use help-screen.el.
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
2134
diff
changeset
|
408 (make-help-screen help-for-help |
5680
4428fd0336f3
(help-for-help): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents:
5380
diff
changeset
|
409 "a b c f C-f i k C-k l m n p s t v w C-c C-d C-n C-w, or ? for more help:" |
5025
0556b068e9ee
(describe-project): New function, on C-h C-p.
Richard M. Stallman <rms@gnu.org>
parents:
4467
diff
changeset
|
410 "You have typed \\[help-command], the help character. Type a Help option: |
10479
f2f290b13413
(help-for-help): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents:
10196
diff
changeset
|
411 \(Use SPC or DEL to scroll through this text. Type \\<help-map>\\[help-quit] to exit the Help command.) |
409 | 412 |
4467
1e8785572dd4
(help-for-help): Mention C-k and C-f.
Roland McGrath <roland@gnu.org>
parents:
3986
diff
changeset
|
413 a command-apropos. Give a substring, and see a list of commands |
1e8785572dd4
(help-for-help): Mention C-k and C-f.
Roland McGrath <roland@gnu.org>
parents:
3986
diff
changeset
|
414 (functions interactively callable) that contain |
1e8785572dd4
(help-for-help): Mention C-k and C-f.
Roland McGrath <roland@gnu.org>
parents:
3986
diff
changeset
|
415 that substring. See also the apropos command. |
2638
5ff504c4ae11
(help-for-help): Use lower case letters for help options.
Richard M. Stallman <rms@gnu.org>
parents:
2440
diff
changeset
|
416 b describe-bindings. Display table of all key bindings. |
5ff504c4ae11
(help-for-help): Use lower case letters for help options.
Richard M. Stallman <rms@gnu.org>
parents:
2440
diff
changeset
|
417 c describe-key-briefly. Type a command key sequence; |
4467
1e8785572dd4
(help-for-help): Mention C-k and C-f.
Roland McGrath <roland@gnu.org>
parents:
3986
diff
changeset
|
418 it prints the function name that sequence runs. |
2638
5ff504c4ae11
(help-for-help): Use lower case letters for help options.
Richard M. Stallman <rms@gnu.org>
parents:
2440
diff
changeset
|
419 f describe-function. Type a function name and get documentation of it. |
4467
1e8785572dd4
(help-for-help): Mention C-k and C-f.
Roland McGrath <roland@gnu.org>
parents:
3986
diff
changeset
|
420 C-f Info-goto-emacs-command-node. Type a function name; |
1e8785572dd4
(help-for-help): Mention C-k and C-f.
Roland McGrath <roland@gnu.org>
parents:
3986
diff
changeset
|
421 it takes you to the Info node for that command. |
10923
fe008aef4cf1
(view-emacs-FAQ): New function. Bind to C-h F.
Richard M. Stallman <rms@gnu.org>
parents:
10622
diff
changeset
|
422 F view-emacs-FAQ. Shows emacs frequently asked questions file. |
2638
5ff504c4ae11
(help-for-help): Use lower case letters for help options.
Richard M. Stallman <rms@gnu.org>
parents:
2440
diff
changeset
|
423 i info. The info documentation reader. |
5ff504c4ae11
(help-for-help): Use lower case letters for help options.
Richard M. Stallman <rms@gnu.org>
parents:
2440
diff
changeset
|
424 k describe-key. Type a command key sequence; |
4467
1e8785572dd4
(help-for-help): Mention C-k and C-f.
Roland McGrath <roland@gnu.org>
parents:
3986
diff
changeset
|
425 it displays the full documentation. |
1e8785572dd4
(help-for-help): Mention C-k and C-f.
Roland McGrath <roland@gnu.org>
parents:
3986
diff
changeset
|
426 C-k Info-goto-emacs-key-command-node. Type a command key sequence; |
1e8785572dd4
(help-for-help): Mention C-k and C-f.
Roland McGrath <roland@gnu.org>
parents:
3986
diff
changeset
|
427 it takes you to the Info node for the command bound to that key. |
2638
5ff504c4ae11
(help-for-help): Use lower case letters for help options.
Richard M. Stallman <rms@gnu.org>
parents:
2440
diff
changeset
|
428 l view-lossage. Shows last 100 characters you typed. |
5ff504c4ae11
(help-for-help): Use lower case letters for help options.
Richard M. Stallman <rms@gnu.org>
parents:
2440
diff
changeset
|
429 m describe-mode. Print documentation of current major mode, |
4467
1e8785572dd4
(help-for-help): Mention C-k and C-f.
Roland McGrath <roland@gnu.org>
parents:
3986
diff
changeset
|
430 which describes the commands peculiar to it. |
2638
5ff504c4ae11
(help-for-help): Use lower case letters for help options.
Richard M. Stallman <rms@gnu.org>
parents:
2440
diff
changeset
|
431 n view-emacs-news. Shows emacs news file. |
5ff504c4ae11
(help-for-help): Use lower case letters for help options.
Richard M. Stallman <rms@gnu.org>
parents:
2440
diff
changeset
|
432 p finder-by-keyword. Find packages matching a given topic keyword. |
5ff504c4ae11
(help-for-help): Use lower case letters for help options.
Richard M. Stallman <rms@gnu.org>
parents:
2440
diff
changeset
|
433 s describe-syntax. Display contents of syntax table, plus explanations |
5ff504c4ae11
(help-for-help): Use lower case letters for help options.
Richard M. Stallman <rms@gnu.org>
parents:
2440
diff
changeset
|
434 t help-with-tutorial. Select the Emacs learn-by-doing tutorial. |
5ff504c4ae11
(help-for-help): Use lower case letters for help options.
Richard M. Stallman <rms@gnu.org>
parents:
2440
diff
changeset
|
435 v describe-variable. Type name of a variable; |
4467
1e8785572dd4
(help-for-help): Mention C-k and C-f.
Roland McGrath <roland@gnu.org>
parents:
3986
diff
changeset
|
436 it displays the variable's documentation and value. |
2638
5ff504c4ae11
(help-for-help): Use lower case letters for help options.
Richard M. Stallman <rms@gnu.org>
parents:
2440
diff
changeset
|
437 w where-is. Type command name; it prints which keystrokes |
4467
1e8785572dd4
(help-for-help): Mention C-k and C-f.
Roland McGrath <roland@gnu.org>
parents:
3986
diff
changeset
|
438 invoke that command. |
409 | 439 C-c print Emacs copying permission (General Public License). |
440 C-d print Emacs ordering information. | |
441 C-n print news of recent Emacs changes. | |
5025
0556b068e9ee
(describe-project): New function, on C-h C-p.
Richard M. Stallman <rms@gnu.org>
parents:
4467
diff
changeset
|
442 C-p print information about the GNU project. |
409 | 443 C-w print information on absence of warranty for GNU Emacs." |
2237
2670a8f6a42e
Teach this to use help-screen.el.
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
2134
diff
changeset
|
444 help-map) |
409 | 445 |
446 ;; Return a function which is called by the list containing point. | |
447 ;; If that gives no function, return a function whose name is around point. | |
448 ;; If that doesn't give a function, return nil. | |
449 (defun function-called-at-point () | |
450 (or (condition-case () | |
451 (save-excursion | |
452 (save-restriction | |
453 (narrow-to-region (max (point-min) (- (point) 1000)) (point-max)) | |
454 (backward-up-list 1) | |
455 (forward-char 1) | |
456 (let (obj) | |
457 (setq obj (read (current-buffer))) | |
458 (and (symbolp obj) (fboundp obj) obj)))) | |
459 (error nil)) | |
460 (condition-case () | |
13209
c2f172263810
(variable-at-point, function-called-at-point):
Richard M. Stallman <rms@gnu.org>
parents:
13197
diff
changeset
|
461 (let ((stab (syntax-table))) |
c2f172263810
(variable-at-point, function-called-at-point):
Richard M. Stallman <rms@gnu.org>
parents:
13197
diff
changeset
|
462 (unwind-protect |
c2f172263810
(variable-at-point, function-called-at-point):
Richard M. Stallman <rms@gnu.org>
parents:
13197
diff
changeset
|
463 (save-excursion |
c2f172263810
(variable-at-point, function-called-at-point):
Richard M. Stallman <rms@gnu.org>
parents:
13197
diff
changeset
|
464 (set-syntax-table emacs-lisp-mode-syntax-table) |
c2f172263810
(variable-at-point, function-called-at-point):
Richard M. Stallman <rms@gnu.org>
parents:
13197
diff
changeset
|
465 (or (not (zerop (skip-syntax-backward "_w"))) |
c2f172263810
(variable-at-point, function-called-at-point):
Richard M. Stallman <rms@gnu.org>
parents:
13197
diff
changeset
|
466 (eq (char-syntax (following-char)) ?w) |
c2f172263810
(variable-at-point, function-called-at-point):
Richard M. Stallman <rms@gnu.org>
parents:
13197
diff
changeset
|
467 (eq (char-syntax (following-char)) ?_) |
c2f172263810
(variable-at-point, function-called-at-point):
Richard M. Stallman <rms@gnu.org>
parents:
13197
diff
changeset
|
468 (forward-sexp -1)) |
c2f172263810
(variable-at-point, function-called-at-point):
Richard M. Stallman <rms@gnu.org>
parents:
13197
diff
changeset
|
469 (skip-chars-forward "'") |
c2f172263810
(variable-at-point, function-called-at-point):
Richard M. Stallman <rms@gnu.org>
parents:
13197
diff
changeset
|
470 (let ((obj (read (current-buffer)))) |
c2f172263810
(variable-at-point, function-called-at-point):
Richard M. Stallman <rms@gnu.org>
parents:
13197
diff
changeset
|
471 (and (symbolp obj) (fboundp obj) obj))) |
c2f172263810
(variable-at-point, function-called-at-point):
Richard M. Stallman <rms@gnu.org>
parents:
13197
diff
changeset
|
472 (set-syntax-table stab))) |
409 | 473 (error nil)))) |
474 | |
9639
7cad0025f303
(describe-function-find-file): New function.
Richard M. Stallman <rms@gnu.org>
parents:
9638
diff
changeset
|
475 (defun describe-function-find-file (function) |
7cad0025f303
(describe-function-find-file): New function.
Richard M. Stallman <rms@gnu.org>
parents:
9638
diff
changeset
|
476 (let ((files load-history) |
7cad0025f303
(describe-function-find-file): New function.
Richard M. Stallman <rms@gnu.org>
parents:
9638
diff
changeset
|
477 file functions) |
7cad0025f303
(describe-function-find-file): New function.
Richard M. Stallman <rms@gnu.org>
parents:
9638
diff
changeset
|
478 (while files |
7cad0025f303
(describe-function-find-file): New function.
Richard M. Stallman <rms@gnu.org>
parents:
9638
diff
changeset
|
479 (if (memq function (cdr (car files))) |
7cad0025f303
(describe-function-find-file): New function.
Richard M. Stallman <rms@gnu.org>
parents:
9638
diff
changeset
|
480 (setq file (car (car files)) files nil)) |
7cad0025f303
(describe-function-find-file): New function.
Richard M. Stallman <rms@gnu.org>
parents:
9638
diff
changeset
|
481 (setq files (cdr files))) |
7cad0025f303
(describe-function-find-file): New function.
Richard M. Stallman <rms@gnu.org>
parents:
9638
diff
changeset
|
482 file)) |
7cad0025f303
(describe-function-find-file): New function.
Richard M. Stallman <rms@gnu.org>
parents:
9638
diff
changeset
|
483 |
409 | 484 (defun describe-function (function) |
485 "Display the full documentation of FUNCTION (a symbol)." | |
486 (interactive | |
487 (let ((fn (function-called-at-point)) | |
488 (enable-recursive-minibuffers t) | |
489 val) | |
490 (setq val (completing-read (if fn | |
491 (format "Describe function (default %s): " fn) | |
492 "Describe function: ") | |
493 obarray 'fboundp t)) | |
494 (list (if (equal val "") | |
495 fn (intern val))))) | |
16439
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
496 (if function |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
497 (with-output-to-temp-buffer "*Help*" |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
498 (prin1 function) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
499 (princ ": ") |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
500 (let* ((def (symbol-function function)) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
501 file-name |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
502 (beg (if (commandp def) "an interactive " "a "))) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
503 (princ (cond ((or (stringp def) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
504 (vectorp def)) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
505 "a keyboard macro") |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
506 ((subrp def) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
507 (concat beg "built-in function")) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
508 ((byte-code-function-p def) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
509 (concat beg "compiled Lisp function")) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
510 ((symbolp def) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
511 (format "alias for `%s'" def)) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
512 ((eq (car-safe def) 'lambda) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
513 (concat beg "Lisp function")) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
514 ((eq (car-safe def) 'macro) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
515 "a Lisp macro") |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
516 ((eq (car-safe def) 'mocklisp) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
517 "a mocklisp function") |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
518 ((eq (car-safe def) 'autoload) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
519 (setq file-name (nth 1 def)) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
520 (format "%s autoloaded Lisp %s" |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
521 (if (commandp def) "an interactive" "an") |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
522 (if (nth 4 def) "macro" "function") |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
523 )) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
524 (t ""))) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
525 (or file-name |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
526 (setq file-name (describe-function-find-file function))) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
527 (if file-name |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
528 (progn |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
529 (princ " in `") |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
530 ;; We used to add .el to the file name, |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
531 ;; but that's completely wrong when the user used load-file. |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
532 (princ file-name) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
533 (princ "'"))) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
534 (princ ".") |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
535 (terpri) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
536 (let ((arglist (cond ((byte-code-function-p def) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
537 (car (append def nil))) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
538 ((eq (car-safe def) 'lambda) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
539 (nth 1 def)) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
540 (t t)))) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
541 (if (listp arglist) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
542 (progn |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
543 (princ (cons function |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
544 (mapcar (lambda (arg) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
545 (if (memq arg '(&optional &rest)) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
546 arg |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
547 (intern (upcase (symbol-name arg))))) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
548 arglist))) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
549 (terpri)))) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
550 (let ((doc (documentation function))) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
551 (if doc |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
552 (progn (terpri) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
553 (princ doc)) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
554 (princ "not documented")))) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
555 (print-help-return-message) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
556 (save-excursion |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
557 (set-buffer standard-output) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
558 (help-mode) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
559 ;; Return the text we displayed. |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
560 (buffer-string))) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
561 (message "You didn't specify a function"))) |
409 | 562 |
16439
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
563 ;; We return 0 if we can't find a variable to return. |
409 | 564 (defun variable-at-point () |
565 (condition-case () | |
13209
c2f172263810
(variable-at-point, function-called-at-point):
Richard M. Stallman <rms@gnu.org>
parents:
13197
diff
changeset
|
566 (let ((stab (syntax-table))) |
c2f172263810
(variable-at-point, function-called-at-point):
Richard M. Stallman <rms@gnu.org>
parents:
13197
diff
changeset
|
567 (unwind-protect |
c2f172263810
(variable-at-point, function-called-at-point):
Richard M. Stallman <rms@gnu.org>
parents:
13197
diff
changeset
|
568 (save-excursion |
c2f172263810
(variable-at-point, function-called-at-point):
Richard M. Stallman <rms@gnu.org>
parents:
13197
diff
changeset
|
569 (set-syntax-table emacs-lisp-mode-syntax-table) |
c2f172263810
(variable-at-point, function-called-at-point):
Richard M. Stallman <rms@gnu.org>
parents:
13197
diff
changeset
|
570 (or (not (zerop (skip-syntax-backward "_w"))) |
c2f172263810
(variable-at-point, function-called-at-point):
Richard M. Stallman <rms@gnu.org>
parents:
13197
diff
changeset
|
571 (eq (char-syntax (following-char)) ?w) |
c2f172263810
(variable-at-point, function-called-at-point):
Richard M. Stallman <rms@gnu.org>
parents:
13197
diff
changeset
|
572 (eq (char-syntax (following-char)) ?_) |
c2f172263810
(variable-at-point, function-called-at-point):
Richard M. Stallman <rms@gnu.org>
parents:
13197
diff
changeset
|
573 (forward-sexp -1)) |
c2f172263810
(variable-at-point, function-called-at-point):
Richard M. Stallman <rms@gnu.org>
parents:
13197
diff
changeset
|
574 (skip-chars-forward "'") |
c2f172263810
(variable-at-point, function-called-at-point):
Richard M. Stallman <rms@gnu.org>
parents:
13197
diff
changeset
|
575 (let ((obj (read (current-buffer)))) |
16439
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
576 (or (and (symbolp obj) (boundp obj) obj) |
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
577 0))) |
13209
c2f172263810
(variable-at-point, function-called-at-point):
Richard M. Stallman <rms@gnu.org>
parents:
13197
diff
changeset
|
578 (set-syntax-table stab))) |
16439
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
579 (error 0))) |
409 | 580 |
581 (defun describe-variable (variable) | |
582 "Display the full documentation of VARIABLE (a symbol). | |
583 Returns the documentation as a string, also." | |
584 (interactive | |
585 (let ((v (variable-at-point)) | |
586 (enable-recursive-minibuffers t) | |
587 val) | |
16439
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
588 (setq val (completing-read (if (symbolp v) |
409 | 589 (format "Describe variable (default %s): " v) |
590 "Describe variable: ") | |
591 obarray 'boundp t)) | |
592 (list (if (equal val "") | |
593 v (intern val))))) | |
16439
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
594 (if (symbolp variable) |
16557
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
595 (let (valvoid) |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
596 (with-output-to-temp-buffer "*Help*" |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
597 (prin1 variable) |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
598 (if (not (boundp variable)) |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
599 (progn |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
600 (princ " is void") |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
601 (terpri) |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
602 (setq valvoid t)) |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
603 (princ "'s value is ") |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
604 (terpri) |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
605 (pp (symbol-value variable)) |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
606 (terpri)) |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
607 (if (local-variable-p variable) |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
608 (progn |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
609 (princ (format "Local in buffer %s; " (buffer-name))) |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
610 (if (not (default-boundp variable)) |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
611 (princ "globally void") |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
612 (princ "global value is ") |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
613 (terpri) |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
614 (pp (default-value variable))) |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
615 (terpri))) |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
616 (terpri) |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
617 (save-current-buffer |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
618 (set-buffer standard-output) |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
619 (if (> (count-lines (point-min) (point-max)) 10) |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
620 (progn |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
621 (goto-char (point-min)) |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
622 (if valvoid |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
623 (forward-line 1) |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
624 (forward-sexp 1) |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
625 (delete-region (point) (progn (end-of-line) (point))) |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
626 (insert "'s value is shown below.\n\n") |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
627 (save-excursion |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
628 (insert "\n\nValue:")))))) |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
629 (princ "Documentation:") |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
630 (terpri) |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
631 (let ((doc (documentation-property variable 'variable-documentation))) |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
632 (princ (or doc "not documented as a variable."))) |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
633 (print-help-return-message) |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
634 (save-excursion |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
635 (set-buffer standard-output) |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
636 (help-mode) |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
637 ;; Return the text we displayed. |
4ff6a0f0f5c7
(describe-variable): Pretty-print the values.
Richard M. Stallman <rms@gnu.org>
parents:
16439
diff
changeset
|
638 (buffer-string)))) |
16439
0c61b1f40de2
(describe-function): If no fn specified, say so.
Richard M. Stallman <rms@gnu.org>
parents:
16391
diff
changeset
|
639 (message "You did not specify a variable"))) |
409 | 640 |
6476
2e28b96d5b64
(where-is): New function.
Richard M. Stallman <rms@gnu.org>
parents:
6433
diff
changeset
|
641 (defun where-is (definition) |
2e28b96d5b64
(where-is): New function.
Richard M. Stallman <rms@gnu.org>
parents:
6433
diff
changeset
|
642 "Print message listing key sequences that invoke specified command. |
2e28b96d5b64
(where-is): New function.
Richard M. Stallman <rms@gnu.org>
parents:
6433
diff
changeset
|
643 Argument is a command definition, usually a symbol with a function definition." |
2e28b96d5b64
(where-is): New function.
Richard M. Stallman <rms@gnu.org>
parents:
6433
diff
changeset
|
644 (interactive |
2e28b96d5b64
(where-is): New function.
Richard M. Stallman <rms@gnu.org>
parents:
6433
diff
changeset
|
645 (let ((fn (function-called-at-point)) |
2e28b96d5b64
(where-is): New function.
Richard M. Stallman <rms@gnu.org>
parents:
6433
diff
changeset
|
646 (enable-recursive-minibuffers t) |
2e28b96d5b64
(where-is): New function.
Richard M. Stallman <rms@gnu.org>
parents:
6433
diff
changeset
|
647 val) |
2e28b96d5b64
(where-is): New function.
Richard M. Stallman <rms@gnu.org>
parents:
6433
diff
changeset
|
648 (setq val (completing-read (if fn |
2e28b96d5b64
(where-is): New function.
Richard M. Stallman <rms@gnu.org>
parents:
6433
diff
changeset
|
649 (format "Where is command (default %s): " fn) |
2e28b96d5b64
(where-is): New function.
Richard M. Stallman <rms@gnu.org>
parents:
6433
diff
changeset
|
650 "Where is command: ") |
2e28b96d5b64
(where-is): New function.
Richard M. Stallman <rms@gnu.org>
parents:
6433
diff
changeset
|
651 obarray 'fboundp t)) |
2e28b96d5b64
(where-is): New function.
Richard M. Stallman <rms@gnu.org>
parents:
6433
diff
changeset
|
652 (list (if (equal val "") |
2e28b96d5b64
(where-is): New function.
Richard M. Stallman <rms@gnu.org>
parents:
6433
diff
changeset
|
653 fn (intern val))))) |
2e28b96d5b64
(where-is): New function.
Richard M. Stallman <rms@gnu.org>
parents:
6433
diff
changeset
|
654 (let* ((keys (where-is-internal definition overriding-local-map nil nil)) |
2e28b96d5b64
(where-is): New function.
Richard M. Stallman <rms@gnu.org>
parents:
6433
diff
changeset
|
655 (keys1 (mapconcat 'key-description keys ", "))) |
2e28b96d5b64
(where-is): New function.
Richard M. Stallman <rms@gnu.org>
parents:
6433
diff
changeset
|
656 (if (> (length keys1) 0) |
2e28b96d5b64
(where-is): New function.
Richard M. Stallman <rms@gnu.org>
parents:
6433
diff
changeset
|
657 (message "%s is on %s" definition keys1) |
2e28b96d5b64
(where-is): New function.
Richard M. Stallman <rms@gnu.org>
parents:
6433
diff
changeset
|
658 (message "%s is not on any key" definition))) |
2e28b96d5b64
(where-is): New function.
Richard M. Stallman <rms@gnu.org>
parents:
6433
diff
changeset
|
659 nil) |
2e28b96d5b64
(where-is): New function.
Richard M. Stallman <rms@gnu.org>
parents:
6433
diff
changeset
|
660 |
16273
14ff4afa06ec
(locate-library): Print no messages if called from Lisp.
Richard M. Stallman <rms@gnu.org>
parents:
16064
diff
changeset
|
661 (defun locate-library (library &optional nosuffix path interactive-call) |
16063
b4427bbd451e
(locate-library): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents:
15826
diff
changeset
|
662 "Show the precise file name of Emacs library LIBRARY. |
409 | 663 This command searches the directories in `load-path' like `M-x load-library' |
664 to find the file that `M-x load-library RET LIBRARY RET' would load. | |
665 Optional second arg NOSUFFIX non-nil means don't add suffixes `.elc' or `.el' | |
16064
a9d32637ee38
(locate-library): New arg PATH. Handle autocompression mode.
Richard M. Stallman <rms@gnu.org>
parents:
16063
diff
changeset
|
666 to the specified name LIBRARY. |
a9d32637ee38
(locate-library): New arg PATH. Handle autocompression mode.
Richard M. Stallman <rms@gnu.org>
parents:
16063
diff
changeset
|
667 |
a9d32637ee38
(locate-library): New arg PATH. Handle autocompression mode.
Richard M. Stallman <rms@gnu.org>
parents:
16063
diff
changeset
|
668 If the optional third arg PATH is specified, that list of directories |
a9d32637ee38
(locate-library): New arg PATH. Handle autocompression mode.
Richard M. Stallman <rms@gnu.org>
parents:
16063
diff
changeset
|
669 is used instead of `load-path'." |
16273
14ff4afa06ec
(locate-library): Print no messages if called from Lisp.
Richard M. Stallman <rms@gnu.org>
parents:
16064
diff
changeset
|
670 (interactive (list (read-string "Locate library: ") |
14ff4afa06ec
(locate-library): Print no messages if called from Lisp.
Richard M. Stallman <rms@gnu.org>
parents:
16064
diff
changeset
|
671 nil nil |
14ff4afa06ec
(locate-library): Print no messages if called from Lisp.
Richard M. Stallman <rms@gnu.org>
parents:
16064
diff
changeset
|
672 t)) |
14ff4afa06ec
(locate-library): Print no messages if called from Lisp.
Richard M. Stallman <rms@gnu.org>
parents:
16064
diff
changeset
|
673 (let (result) |
14ff4afa06ec
(locate-library): Print no messages if called from Lisp.
Richard M. Stallman <rms@gnu.org>
parents:
16064
diff
changeset
|
674 (catch 'answer |
14ff4afa06ec
(locate-library): Print no messages if called from Lisp.
Richard M. Stallman <rms@gnu.org>
parents:
16064
diff
changeset
|
675 (mapcar |
16391
5d64d742ccbb
(print-help-return-message): Use new functions `special-display-p' and
Erik Naggum <erik@naggum.no>
parents:
16273
diff
changeset
|
676 (lambda (dir) |
5d64d742ccbb
(print-help-return-message): Use new functions `special-display-p' and
Erik Naggum <erik@naggum.no>
parents:
16273
diff
changeset
|
677 (mapcar |
5d64d742ccbb
(print-help-return-message): Use new functions `special-display-p' and
Erik Naggum <erik@naggum.no>
parents:
16273
diff
changeset
|
678 (lambda (suf) |
5d64d742ccbb
(print-help-return-message): Use new functions `special-display-p' and
Erik Naggum <erik@naggum.no>
parents:
16273
diff
changeset
|
679 (let ((try (expand-file-name (concat library suf) dir))) |
5d64d742ccbb
(print-help-return-message): Use new functions `special-display-p' and
Erik Naggum <erik@naggum.no>
parents:
16273
diff
changeset
|
680 (and (file-readable-p try) |
5d64d742ccbb
(print-help-return-message): Use new functions `special-display-p' and
Erik Naggum <erik@naggum.no>
parents:
16273
diff
changeset
|
681 (null (file-directory-p try)) |
5d64d742ccbb
(print-help-return-message): Use new functions `special-display-p' and
Erik Naggum <erik@naggum.no>
parents:
16273
diff
changeset
|
682 (progn |
5d64d742ccbb
(print-help-return-message): Use new functions `special-display-p' and
Erik Naggum <erik@naggum.no>
parents:
16273
diff
changeset
|
683 (setq result try) |
5d64d742ccbb
(print-help-return-message): Use new functions `special-display-p' and
Erik Naggum <erik@naggum.no>
parents:
16273
diff
changeset
|
684 (throw 'answer try))))) |
5d64d742ccbb
(print-help-return-message): Use new functions `special-display-p' and
Erik Naggum <erik@naggum.no>
parents:
16273
diff
changeset
|
685 (if nosuffix |
5d64d742ccbb
(print-help-return-message): Use new functions `special-display-p' and
Erik Naggum <erik@naggum.no>
parents:
16273
diff
changeset
|
686 '("") |
5d64d742ccbb
(print-help-return-message): Use new functions `special-display-p' and
Erik Naggum <erik@naggum.no>
parents:
16273
diff
changeset
|
687 (let ((basic '(".elc" ".el" "")) |
5d64d742ccbb
(print-help-return-message): Use new functions `special-display-p' and
Erik Naggum <erik@naggum.no>
parents:
16273
diff
changeset
|
688 (compressed '(".Z" ".gz" ""))) |
5d64d742ccbb
(print-help-return-message): Use new functions `special-display-p' and
Erik Naggum <erik@naggum.no>
parents:
16273
diff
changeset
|
689 ;; If autocompression mode is on, |
5d64d742ccbb
(print-help-return-message): Use new functions `special-display-p' and
Erik Naggum <erik@naggum.no>
parents:
16273
diff
changeset
|
690 ;; consider all combinations of library suffixes |
5d64d742ccbb
(print-help-return-message): Use new functions `special-display-p' and
Erik Naggum <erik@naggum.no>
parents:
16273
diff
changeset
|
691 ;; and compression suffixes. |
5d64d742ccbb
(print-help-return-message): Use new functions `special-display-p' and
Erik Naggum <erik@naggum.no>
parents:
16273
diff
changeset
|
692 (if (rassq 'jka-compr-handler file-name-handler-alist) |
5d64d742ccbb
(print-help-return-message): Use new functions `special-display-p' and
Erik Naggum <erik@naggum.no>
parents:
16273
diff
changeset
|
693 (apply 'nconc |
5d64d742ccbb
(print-help-return-message): Use new functions `special-display-p' and
Erik Naggum <erik@naggum.no>
parents:
16273
diff
changeset
|
694 (mapcar (lambda (compelt) |
5d64d742ccbb
(print-help-return-message): Use new functions `special-display-p' and
Erik Naggum <erik@naggum.no>
parents:
16273
diff
changeset
|
695 (mapcar (lambda (baselt) |
5d64d742ccbb
(print-help-return-message): Use new functions `special-display-p' and
Erik Naggum <erik@naggum.no>
parents:
16273
diff
changeset
|
696 (concat baselt compelt)) |
5d64d742ccbb
(print-help-return-message): Use new functions `special-display-p' and
Erik Naggum <erik@naggum.no>
parents:
16273
diff
changeset
|
697 basic)) |
5d64d742ccbb
(print-help-return-message): Use new functions `special-display-p' and
Erik Naggum <erik@naggum.no>
parents:
16273
diff
changeset
|
698 compressed)) |
5d64d742ccbb
(print-help-return-message): Use new functions `special-display-p' and
Erik Naggum <erik@naggum.no>
parents:
16273
diff
changeset
|
699 basic))))) |
16273
14ff4afa06ec
(locate-library): Print no messages if called from Lisp.
Richard M. Stallman <rms@gnu.org>
parents:
16064
diff
changeset
|
700 (or path load-path))) |
14ff4afa06ec
(locate-library): Print no messages if called from Lisp.
Richard M. Stallman <rms@gnu.org>
parents:
16064
diff
changeset
|
701 (and interactive-call |
14ff4afa06ec
(locate-library): Print no messages if called from Lisp.
Richard M. Stallman <rms@gnu.org>
parents:
16064
diff
changeset
|
702 (if result |
14ff4afa06ec
(locate-library): Print no messages if called from Lisp.
Richard M. Stallman <rms@gnu.org>
parents:
16064
diff
changeset
|
703 (message "Library is file %s" result) |
14ff4afa06ec
(locate-library): Print no messages if called from Lisp.
Richard M. Stallman <rms@gnu.org>
parents:
16064
diff
changeset
|
704 (message "No library %s in search path" library))) |
14ff4afa06ec
(locate-library): Print no messages if called from Lisp.
Richard M. Stallman <rms@gnu.org>
parents:
16064
diff
changeset
|
705 result)) |
660
08eb386dd0f3
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
444
diff
changeset
|
706 |
08eb386dd0f3
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
444
diff
changeset
|
707 ;;; help.el ends here |