|
428
|
1 ;;; subr.el --- basic lisp subroutines for XEmacs
|
|
|
2
|
|
|
3 ;; Copyright (C) 1985, 1986, 1992, 1994-5, 1997 Free Software Foundation, Inc.
|
|
|
4 ;; Copyright (C) 1995 Tinker Systems and INS Engineering Corp.
|
|
|
5 ;; Copyright (C) 1995 Sun Microsystems.
|
|
772
|
6 ;; Copyright (C) 2000, 2001, 2002 Ben Wing.
|
|
428
|
7
|
|
|
8 ;; Maintainer: XEmacs Development Team
|
|
|
9 ;; Keywords: extensions, dumped
|
|
|
10
|
|
|
11 ;; This file is part of XEmacs.
|
|
|
12
|
|
|
13 ;; XEmacs is free software; you can redistribute it and/or modify it
|
|
|
14 ;; under the terms of the GNU General Public License as published by
|
|
|
15 ;; the Free Software Foundation; either version 2, or (at your option)
|
|
|
16 ;; any later version.
|
|
|
17
|
|
|
18 ;; XEmacs is distributed in the hope that it will be useful, but
|
|
|
19 ;; WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
20 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
|
21 ;; General Public License for more details.
|
|
|
22
|
|
|
23 ;; You should have received a copy of the GNU General Public License
|
|
|
24 ;; along with XEmacs; see the file COPYING. If not, write to the Free
|
|
|
25 ;; Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
|
|
|
26 ;; 02111-1307, USA.
|
|
|
27
|
|
|
28 ;;; Synched up with: FSF 19.34.
|
|
|
29
|
|
|
30 ;;; Commentary:
|
|
|
31
|
|
|
32 ;; This file is dumped with XEmacs.
|
|
|
33
|
|
|
34 ;; There's not a whole lot in common now with the FSF version,
|
|
|
35 ;; be wary when applying differences. I've left in a number of lines
|
|
|
36 ;; of commentary just to give diff(1) something to synch itself with to
|
|
|
37 ;; provide useful context diffs. -sb
|
|
|
38
|
|
|
39 ;;; Code:
|
|
|
40
|
|
|
41
|
|
|
42 ;;;; Lisp language features.
|
|
|
43
|
|
|
44 (defmacro lambda (&rest cdr)
|
|
|
45 "Return a lambda expression.
|
|
|
46 A call of the form (lambda ARGS DOCSTRING INTERACTIVE BODY) is
|
|
|
47 self-quoting; the result of evaluating the lambda expression is the
|
|
|
48 expression itself. The lambda expression may then be treated as a
|
|
|
49 function, i.e., stored as the function value of a symbol, passed to
|
|
|
50 funcall or mapcar, etc.
|
|
|
51
|
|
|
52 ARGS should take the same form as an argument list for a `defun'.
|
|
|
53 DOCSTRING is an optional documentation string.
|
|
|
54 If present, it should describe how to call the function.
|
|
|
55 But documentation strings are usually not useful in nameless functions.
|
|
|
56 INTERACTIVE should be a call to the function `interactive', which see.
|
|
|
57 It may also be omitted.
|
|
|
58 BODY should be a list of lisp expressions."
|
|
|
59 `(function (lambda ,@cdr)))
|
|
|
60
|
|
|
61 (defmacro defun-when-void (&rest args)
|
|
|
62 "Define a function, just like `defun', unless it's already defined.
|
|
|
63 Used for compatibility among different emacs variants."
|
|
|
64 `(if (fboundp ',(car args))
|
|
|
65 nil
|
|
|
66 (defun ,@args)))
|
|
|
67
|
|
|
68 (defmacro define-function-when-void (&rest args)
|
|
|
69 "Define a function, just like `define-function', unless it's already defined.
|
|
|
70 Used for compatibility among different emacs variants."
|
|
|
71 `(if (fboundp ,(car args))
|
|
|
72 nil
|
|
|
73 (define-function ,@args)))
|
|
|
74
|
|
|
75
|
|
|
76 ;;;; Keymap support.
|
|
|
77 ;; XEmacs: removed to keymap.el
|
|
|
78
|
|
|
79 ;;;; The global keymap tree.
|
|
|
80
|
|
|
81 ;;; global-map, esc-map, and ctl-x-map have their values set up in
|
|
|
82 ;;; keymap.c; we just give them docstrings here.
|
|
|
83
|
|
|
84 ;;;; Event manipulation functions.
|
|
|
85
|
|
|
86 ;; XEmacs: This stuff is done in C Code.
|
|
|
87
|
|
|
88 ;;;; Obsolescent names for functions.
|
|
|
89 ;; XEmacs: not used.
|
|
|
90
|
|
|
91 ;; XEmacs:
|
|
|
92 (defun local-variable-if-set-p (sym buffer)
|
|
|
93 "Return t if SYM would be local to BUFFER after it is set.
|
|
|
94 A nil value for BUFFER is *not* the same as (current-buffer), but
|
|
|
95 can be used to determine whether `make-variable-buffer-local' has been
|
|
|
96 called on SYM."
|
|
|
97 (local-variable-p sym buffer t))
|
|
|
98
|
|
|
99
|
|
|
100 ;;;; Hook manipulation functions.
|
|
|
101
|
|
|
102 ;; (defconst run-hooks 'run-hooks ...)
|
|
|
103
|
|
|
104 (defun make-local-hook (hook)
|
|
|
105 "Make the hook HOOK local to the current buffer.
|
|
|
106 When a hook is local, its local and global values
|
|
|
107 work in concert: running the hook actually runs all the hook
|
|
|
108 functions listed in *either* the local value *or* the global value
|
|
|
109 of the hook variable.
|
|
|
110
|
|
|
111 This function works by making `t' a member of the buffer-local value,
|
|
|
112 which acts as a flag to run the hook functions in the default value as
|
|
|
113 well. This works for all normal hooks, but does not work for most
|
|
|
114 non-normal hooks yet. We will be changing the callers of non-normal
|
|
|
115 hooks so that they can handle localness; this has to be done one by
|
|
|
116 one.
|
|
|
117
|
|
|
118 This function does nothing if HOOK is already local in the current
|
|
|
119 buffer.
|
|
|
120
|
|
442
|
121 Do not use `make-local-variable' to make a hook variable buffer-local.
|
|
|
122
|
|
|
123 See also `add-local-hook' and `remove-local-hook'."
|
|
428
|
124 (if (local-variable-p hook (current-buffer)) ; XEmacs
|
|
|
125 nil
|
|
|
126 (or (boundp hook) (set hook nil))
|
|
|
127 (make-local-variable hook)
|
|
|
128 (set hook (list t))))
|
|
|
129
|
|
|
130 (defun add-hook (hook function &optional append local)
|
|
|
131 "Add to the value of HOOK the function FUNCTION.
|
|
|
132 FUNCTION is not added if already present.
|
|
|
133 FUNCTION is added (if necessary) at the beginning of the hook list
|
|
|
134 unless the optional argument APPEND is non-nil, in which case
|
|
|
135 FUNCTION is added at the end.
|
|
|
136
|
|
|
137 The optional fourth argument, LOCAL, if non-nil, says to modify
|
|
|
138 the hook's buffer-local value rather than its default value.
|
|
|
139 This makes no difference if the hook is not buffer-local.
|
|
|
140 To make a hook variable buffer-local, always use
|
|
|
141 `make-local-hook', not `make-local-variable'.
|
|
|
142
|
|
|
143 HOOK should be a symbol, and FUNCTION may be any valid function. If
|
|
|
144 HOOK is void, it is first set to nil. If HOOK's value is a single
|
|
442
|
145 function, it is changed to a list of functions.
|
|
|
146
|
|
|
147 You can remove this hook yourself using `remove-hook'.
|
|
|
148
|
|
|
149 See also `add-local-hook' and `add-one-shot-hook'."
|
|
428
|
150 (or (boundp hook) (set hook nil))
|
|
|
151 (or (default-boundp hook) (set-default hook nil))
|
|
|
152 ;; If the hook value is a single function, turn it into a list.
|
|
|
153 (let ((old (symbol-value hook)))
|
|
|
154 (if (or (not (listp old)) (eq (car old) 'lambda))
|
|
|
155 (set hook (list old))))
|
|
|
156 (if (or local
|
|
|
157 ;; Detect the case where make-local-variable was used on a hook
|
|
|
158 ;; and do what we used to do.
|
|
|
159 (and (local-variable-if-set-p hook (current-buffer)) ; XEmacs
|
|
|
160 (not (memq t (symbol-value hook)))))
|
|
|
161 ;; Alter the local value only.
|
|
|
162 (or (if (consp function)
|
|
|
163 (member function (symbol-value hook))
|
|
|
164 (memq function (symbol-value hook)))
|
|
|
165 (set hook
|
|
|
166 (if append
|
|
|
167 (append (symbol-value hook) (list function))
|
|
|
168 (cons function (symbol-value hook)))))
|
|
|
169 ;; Alter the global value (which is also the only value,
|
|
|
170 ;; if the hook doesn't have a local value).
|
|
|
171 (or (if (consp function)
|
|
|
172 (member function (default-value hook))
|
|
|
173 (memq function (default-value hook)))
|
|
|
174 (set-default hook
|
|
|
175 (if append
|
|
|
176 (append (default-value hook) (list function))
|
|
|
177 (cons function (default-value hook)))))))
|
|
|
178
|
|
|
179 (defun remove-hook (hook function &optional local)
|
|
|
180 "Remove from the value of HOOK the function FUNCTION.
|
|
|
181 HOOK should be a symbol, and FUNCTION may be any valid function. If
|
|
|
182 FUNCTION isn't the value of HOOK, or, if FUNCTION doesn't appear in the
|
|
|
183 list of hooks to run in HOOK, then nothing is done. See `add-hook'.
|
|
|
184
|
|
|
185 The optional third argument, LOCAL, if non-nil, says to modify
|
|
|
186 the hook's buffer-local value rather than its default value.
|
|
|
187 This makes no difference if the hook is not buffer-local.
|
|
|
188 To make a hook variable buffer-local, always use
|
|
|
189 `make-local-hook', not `make-local-variable'."
|
|
|
190 (if (or (not (boundp hook)) ;unbound symbol, or
|
|
|
191 (not (default-boundp 'hook))
|
|
|
192 (null (symbol-value hook)) ;value is nil, or
|
|
|
193 (null function)) ;function is nil, then
|
|
|
194 nil ;Do nothing.
|
|
442
|
195 (flet ((hook-remove
|
|
|
196 (function hook-value)
|
|
|
197 (flet ((hook-test
|
|
|
198 (fn hel)
|
|
|
199 (or (equal fn hel)
|
|
|
200 (and (symbolp hel)
|
|
|
201 (equal fn
|
|
|
202 (get hel 'one-shot-hook-fun))))))
|
|
|
203 (if (and (consp hook-value)
|
|
|
204 (not (functionp hook-value)))
|
|
|
205 (if (member* function hook-value :test 'hook-test)
|
|
|
206 (setq hook-value
|
|
|
207 (delete* function (copy-sequence hook-value)
|
|
|
208 :test 'hook-test)))
|
|
|
209 (if (equal hook-value function)
|
|
|
210 (setq hook-value nil)))
|
|
|
211 hook-value)))
|
|
|
212 (if (or local
|
|
|
213 ;; Detect the case where make-local-variable was used on a hook
|
|
|
214 ;; and do what we used to do.
|
|
|
215 (and (local-variable-p hook (current-buffer))
|
|
|
216 (not (memq t (symbol-value hook)))))
|
|
|
217 (set hook (hook-remove function (symbol-value hook)))
|
|
|
218 (set-default hook (hook-remove function (default-value hook)))))))
|
|
|
219
|
|
|
220 ;; XEmacs addition
|
|
|
221 ;; #### we need a coherent scheme for indicating compatibility info,
|
|
|
222 ;; so that it can be programmatically retrieved.
|
|
|
223 (defun add-local-hook (hook function &optional append)
|
|
|
224 "Add to the local value of HOOK the function FUNCTION.
|
|
|
225 This modifies only the buffer-local value for the hook (which is
|
|
|
226 automatically make buffer-local, if necessary), not its default value.
|
|
|
227 FUNCTION is not added if already present.
|
|
|
228 FUNCTION is added (if necessary) at the beginning of the hook list
|
|
|
229 unless the optional argument APPEND is non-nil, in which case
|
|
|
230 FUNCTION is added at the end.
|
|
|
231
|
|
|
232 HOOK should be a symbol, and FUNCTION may be any valid function. If
|
|
|
233 HOOK is void, it is first set to nil. If HOOK's value is a single
|
|
|
234 function, it is changed to a list of functions.
|
|
|
235
|
|
|
236 You can remove this hook yourself using `remove-local-hook'.
|
|
|
237
|
|
|
238 See also `add-hook' and `make-local-hook'."
|
|
|
239 (make-local-hook hook)
|
|
|
240 (add-hook hook function append t))
|
|
|
241
|
|
|
242 ;; XEmacs addition
|
|
|
243 (defun remove-local-hook (hook function)
|
|
|
244 "Remove from the local value of HOOK the function FUNCTION.
|
|
|
245 This modifies only the buffer-local value for the hook, not its default
|
|
|
246 value. (Nothing happens if the hook is not buffer-local.)
|
|
|
247 HOOK should be a symbol, and FUNCTION may be any valid function. If
|
|
|
248 FUNCTION isn't the value of HOOK, or, if FUNCTION doesn't appear in the
|
|
|
249 list of hooks to run in HOOK, then nothing is done. See `add-hook'.
|
|
|
250
|
|
|
251 See also `add-local-hook' and `make-local-hook'."
|
|
|
252 (if (local-variable-p hook (current-buffer))
|
|
|
253 (remove-hook hook function t)))
|
|
|
254
|
|
|
255 (defun add-one-shot-hook (hook function &optional append local)
|
|
|
256 "Add to the value of HOOK the one-shot function FUNCTION.
|
|
|
257 FUNCTION will automatically be removed from the hook the first time
|
|
|
258 after it runs (whether to completion or to an error).
|
|
|
259 FUNCTION is not added if already present.
|
|
|
260 FUNCTION is added (if necessary) at the beginning of the hook list
|
|
|
261 unless the optional argument APPEND is non-nil, in which case
|
|
|
262 FUNCTION is added at the end.
|
|
|
263
|
|
|
264 HOOK should be a symbol, and FUNCTION may be any valid function. If
|
|
|
265 HOOK is void, it is first set to nil. If HOOK's value is a single
|
|
|
266 function, it is changed to a list of functions.
|
|
|
267
|
|
|
268 You can remove this hook yourself using `remove-hook'.
|
|
|
269
|
|
|
270 See also `add-hook', `add-local-hook', and `add-local-one-shot-hook'."
|
|
|
271 (let ((sym (gensym)))
|
|
|
272 (fset sym `(lambda (&rest args)
|
|
|
273 (unwind-protect
|
|
|
274 (apply ',function args)
|
|
|
275 (remove-hook ',hook ',sym ',local))))
|
|
|
276 (put sym 'one-shot-hook-fun function)
|
|
|
277 (add-hook hook sym append local)))
|
|
|
278
|
|
|
279 (defun add-local-one-shot-hook (hook function &optional append)
|
|
|
280 "Add to the local value of HOOK the one-shot function FUNCTION.
|
|
|
281 FUNCTION will automatically be removed from the hook the first time
|
|
|
282 after it runs (whether to completion or to an error).
|
|
|
283 FUNCTION is not added if already present.
|
|
|
284 FUNCTION is added (if necessary) at the beginning of the hook list
|
|
|
285 unless the optional argument APPEND is non-nil, in which case
|
|
|
286 FUNCTION is added at the end.
|
|
|
287
|
|
|
288 The optional fourth argument, LOCAL, if non-nil, says to modify
|
|
|
289 the hook's buffer-local value rather than its default value.
|
|
|
290 This makes no difference if the hook is not buffer-local.
|
|
|
291 To make a hook variable buffer-local, always use
|
|
|
292 `make-local-hook', not `make-local-variable'.
|
|
|
293
|
|
|
294 HOOK should be a symbol, and FUNCTION may be any valid function. If
|
|
|
295 HOOK is void, it is first set to nil. If HOOK's value is a single
|
|
|
296 function, it is changed to a list of functions.
|
|
|
297
|
|
|
298 You can remove this hook yourself using `remove-local-hook'.
|
|
|
299
|
|
|
300 See also `add-hook', `add-local-hook', and `add-local-one-shot-hook'."
|
|
|
301 (make-local-hook hook)
|
|
|
302 (add-one-shot-hook hook function append t))
|
|
428
|
303
|
|
|
304 (defun add-to-list (list-var element)
|
|
|
305 "Add to the value of LIST-VAR the element ELEMENT if it isn't there yet.
|
|
|
306 The test for presence of ELEMENT is done with `equal'.
|
|
|
307 If you want to use `add-to-list' on a variable that is not defined
|
|
|
308 until a certain package is loaded, you should put the call to `add-to-list'
|
|
|
309 into a hook function that will be run only after loading the package.
|
|
|
310 `eval-after-load' provides one way to do this. In some cases
|
|
|
311 other hooks, such as major mode hooks, can do the job."
|
|
|
312 (or (member element (symbol-value list-var))
|
|
|
313 (set list-var (cons element (symbol-value list-var)))))
|
|
|
314
|
|
|
315 ;; XEmacs additions
|
|
|
316 ;; called by Fkill_buffer()
|
|
|
317 (defvar kill-buffer-hook nil
|
|
|
318 "Function or functions to be called when a buffer is killed.
|
|
|
319 The value of this variable may be buffer-local.
|
|
|
320 The buffer about to be killed is current when this hook is run.")
|
|
|
321
|
|
|
322 ;; in C in FSFmacs
|
|
|
323 (defvar kill-emacs-hook nil
|
|
|
324 "Function or functions to be called when `kill-emacs' is called,
|
|
|
325 just before emacs is actually killed.")
|
|
|
326
|
|
|
327 ;; not obsolete.
|
|
|
328 ;; #### These are a bad idea, because the CL RPLACA and RPLACD
|
|
|
329 ;; return the cons cell, not the new CAR/CDR. -hniksic
|
|
|
330 ;; The proper definition would be:
|
|
|
331 ;; (defun rplaca (conscell newcar)
|
|
|
332 ;; (setcar conscell newcar)
|
|
|
333 ;; conscell)
|
|
|
334 ;; ...and analogously for RPLACD.
|
|
|
335 (define-function 'rplaca 'setcar)
|
|
|
336 (define-function 'rplacd 'setcdr)
|
|
|
337
|
|
|
338 (defun copy-symbol (symbol &optional copy-properties)
|
|
|
339 "Return a new uninterned symbol with the same name as SYMBOL.
|
|
|
340 If COPY-PROPERTIES is non-nil, the new symbol will have a copy of
|
|
|
341 SYMBOL's value, function, and property lists."
|
|
|
342 (let ((new (make-symbol (symbol-name symbol))))
|
|
|
343 (when copy-properties
|
|
|
344 ;; This will not copy SYMBOL's chain of forwarding objects, but
|
|
|
345 ;; I think that's OK. Callers should not expect such magic to
|
|
|
346 ;; keep working in the copy in the first place.
|
|
|
347 (and (boundp symbol)
|
|
|
348 (set new (symbol-value symbol)))
|
|
|
349 (and (fboundp symbol)
|
|
|
350 (fset new (symbol-function symbol)))
|
|
|
351 (setplist new (copy-list (symbol-plist symbol))))
|
|
|
352 new))
|
|
|
353
|
|
442
|
354 (defun set-symbol-value-in-buffer (sym val buffer)
|
|
|
355 "Set the value of SYM to VAL in BUFFER. Useful with buffer-local variables.
|
|
|
356 If SYM has a buffer-local value in BUFFER, or will have one if set, this
|
|
|
357 function allows you to set the local value.
|
|
|
358
|
|
|
359 NOTE: At some point, this will be moved into C and will be very fast."
|
|
|
360 (with-current-buffer buffer
|
|
|
361 (set sym val)))
|
|
444
|
362
|
|
428
|
363 ;;;; String functions.
|
|
|
364
|
|
|
365 ;; XEmacs
|
|
|
366 (defun replace-in-string (str regexp newtext &optional literal)
|
|
|
367 "Replace all matches in STR for REGEXP with NEWTEXT string,
|
|
|
368 and returns the new string.
|
|
|
369 Optional LITERAL non-nil means do a literal replacement.
|
|
442
|
370 Otherwise treat `\\' in NEWTEXT as special:
|
|
|
371 `\\&' in NEWTEXT means substitute original matched text.
|
|
|
372 `\\N' means substitute what matched the Nth `\\(...\\)'.
|
|
|
373 If Nth parens didn't match, substitute nothing.
|
|
|
374 `\\\\' means insert one `\\'.
|
|
|
375 `\\u' means upcase the next character.
|
|
|
376 `\\l' means downcase the next character.
|
|
|
377 `\\U' means begin upcasing all following characters.
|
|
|
378 `\\L' means begin downcasing all following characters.
|
|
|
379 `\\E' means terminate the effect of any `\\U' or `\\L'."
|
|
428
|
380 (check-argument-type 'stringp str)
|
|
|
381 (check-argument-type 'stringp newtext)
|
|
442
|
382 (if (> (length str) 50)
|
|
|
383 (with-temp-buffer
|
|
|
384 (insert str)
|
|
|
385 (goto-char 1)
|
|
|
386 (while (re-search-forward regexp nil t)
|
|
|
387 (replace-match newtext t literal))
|
|
|
388 (buffer-string))
|
|
|
389 (let ((start 0) newstr)
|
|
|
390 (while (string-match regexp str start)
|
|
|
391 (setq newstr (replace-match newtext t literal str)
|
|
|
392 start (+ (match-end 0) (- (length newstr) (length str)))
|
|
|
393 str newstr))
|
|
|
394 str)))
|
|
428
|
395
|
|
|
396 (defun split-string (string &optional pattern)
|
|
|
397 "Return a list of substrings of STRING which are separated by PATTERN.
|
|
|
398 If PATTERN is omitted, it defaults to \"[ \\f\\t\\n\\r\\v]+\"."
|
|
|
399 (or pattern
|
|
|
400 (setq pattern "[ \f\t\n\r\v]+"))
|
|
|
401 (let (parts (start 0) (len (length string)))
|
|
|
402 (if (string-match pattern string)
|
|
|
403 (setq parts (cons (substring string 0 (match-beginning 0)) parts)
|
|
|
404 start (match-end 0)))
|
|
|
405 (while (and (< start len)
|
|
|
406 (string-match pattern string (if (> start (match-beginning 0))
|
|
|
407 start
|
|
|
408 (1+ start))))
|
|
|
409 (setq parts (cons (substring string start (match-beginning 0)) parts)
|
|
|
410 start (match-end 0)))
|
|
|
411 (nreverse (cons (substring string start) parts))))
|
|
|
412
|
|
|
413 ;; #### #### #### AAaargh! Must be in C, because it is used insanely
|
|
|
414 ;; early in the bootstrap process.
|
|
|
415 ;(defun split-path (path)
|
|
|
416 ; "Explode a search path into a list of strings.
|
|
|
417 ;The path components are separated with the characters specified
|
|
|
418 ;with `path-separator'."
|
|
|
419 ; (while (or (not stringp path-separator)
|
|
|
420 ; (/= (length path-separator) 1))
|
|
|
421 ; (setq path-separator (signal 'error (list "\
|
|
|
422 ;`path-separator' should be set to a single-character string"
|
|
|
423 ; path-separator))))
|
|
|
424 ; (split-string-by-char path (aref separator 0)))
|
|
|
425
|
|
|
426 (defmacro with-output-to-string (&rest forms)
|
|
|
427 "Collect output to `standard-output' while evaluating FORMS and return
|
|
|
428 it as a string."
|
|
|
429 ;; by "William G. Dubuque" <wgd@zurich.ai.mit.edu> w/ mods from Stig
|
|
442
|
430 `(with-current-buffer (get-buffer-create
|
|
|
431 (generate-new-buffer-name " *string-output*"))
|
|
428
|
432 (setq buffer-read-only nil)
|
|
|
433 (buffer-disable-undo (current-buffer))
|
|
|
434 (erase-buffer)
|
|
|
435 (let ((standard-output (current-buffer)))
|
|
|
436 ,@forms)
|
|
|
437 (prog1
|
|
|
438 (buffer-string)
|
|
|
439 (erase-buffer))))
|
|
|
440
|
|
|
441 (defmacro with-current-buffer (buffer &rest body)
|
|
|
442 "Temporarily make BUFFER the current buffer and execute the forms in BODY.
|
|
|
443 The value returned is the value of the last form in BODY.
|
|
|
444 See also `with-temp-buffer'."
|
|
|
445 `(save-current-buffer
|
|
|
446 (set-buffer ,buffer)
|
|
|
447 ,@body))
|
|
|
448
|
|
444
|
449 (defmacro with-temp-file (filename &rest forms)
|
|
|
450 "Create a new buffer, evaluate FORMS there, and write the buffer to FILENAME.
|
|
428
|
451 The value of the last form in FORMS is returned, like `progn'.
|
|
|
452 See also `with-temp-buffer'."
|
|
|
453 (let ((temp-file (make-symbol "temp-file"))
|
|
|
454 (temp-buffer (make-symbol "temp-buffer")))
|
|
444
|
455 `(let ((,temp-file ,filename)
|
|
428
|
456 (,temp-buffer
|
|
|
457 (get-buffer-create (generate-new-buffer-name " *temp file*"))))
|
|
|
458 (unwind-protect
|
|
|
459 (prog1
|
|
|
460 (with-current-buffer ,temp-buffer
|
|
|
461 ,@forms)
|
|
|
462 (with-current-buffer ,temp-buffer
|
|
|
463 (widen)
|
|
|
464 (write-region (point-min) (point-max) ,temp-file nil 0)))
|
|
|
465 (and (buffer-name ,temp-buffer)
|
|
|
466 (kill-buffer ,temp-buffer))))))
|
|
|
467
|
|
|
468 (defmacro with-temp-buffer (&rest forms)
|
|
|
469 "Create a temporary buffer, and evaluate FORMS there like `progn'.
|
|
|
470 See also `with-temp-file' and `with-output-to-string'."
|
|
|
471 (let ((temp-buffer (make-symbol "temp-buffer")))
|
|
|
472 `(let ((,temp-buffer
|
|
|
473 (get-buffer-create (generate-new-buffer-name " *temp*"))))
|
|
|
474 (unwind-protect
|
|
|
475 (with-current-buffer ,temp-buffer
|
|
|
476 ,@forms)
|
|
|
477 (and (buffer-name ,temp-buffer)
|
|
|
478 (kill-buffer ,temp-buffer))))))
|
|
|
479
|
|
|
480 ;; Moved from mule-coding.el.
|
|
|
481 (defmacro with-string-as-buffer-contents (str &rest body)
|
|
|
482 "With the contents of the current buffer being STR, run BODY.
|
|
|
483 Returns the new contents of the buffer, as modified by BODY.
|
|
|
484 The original current buffer is restored afterwards."
|
|
442
|
485 `(with-temp-buffer
|
|
|
486 (insert ,str)
|
|
|
487 ,@body
|
|
|
488 (buffer-string)))
|
|
428
|
489
|
|
|
490 (defun insert-face (string face)
|
|
|
491 "Insert STRING and highlight with FACE. Return the extent created."
|
|
|
492 (let ((p (point)) ext)
|
|
|
493 (insert string)
|
|
|
494 (setq ext (make-extent p (point)))
|
|
|
495 (set-extent-face ext face)
|
|
|
496 ext))
|
|
|
497
|
|
|
498 ;; not obsolete.
|
|
|
499 (define-function 'string= 'string-equal)
|
|
|
500 (define-function 'string< 'string-lessp)
|
|
|
501 (define-function 'int-to-string 'number-to-string)
|
|
|
502 (define-function 'string-to-int 'string-to-number)
|
|
|
503
|
|
|
504 ;; These two names are a bit awkward, as they conflict with the normal
|
|
|
505 ;; foo-to-bar naming scheme, but CLtL2 has them, so they stay.
|
|
|
506 (define-function 'char-int 'char-to-int)
|
|
|
507 (define-function 'int-char 'int-to-char)
|
|
|
508
|
|
771
|
509 (defun string-width (string)
|
|
|
510 "Return number of columns STRING occupies when displayed.
|
|
|
511 With international (Mule) support, uses the charset-columns attribute of
|
|
|
512 the characters in STRING, which may not accurately represent the actual
|
|
|
513 display width when using a window system. With no international support,
|
|
|
514 simply returns the length of the string."
|
|
|
515 (if (featurep 'mule)
|
|
|
516 (let ((col 0)
|
|
|
517 (len (length string))
|
|
|
518 (i 0))
|
|
772
|
519 (with-fboundp '(charset-width char-charset)
|
|
|
520 (while (< i len)
|
|
|
521 (setq col (+ col (charset-width (char-charset (aref string i)))))
|
|
|
522 (setq i (1+ i))))
|
|
771
|
523 col)
|
|
|
524 (length string)))
|
|
|
525
|
|
777
|
526 (defun char-width (character)
|
|
|
527 "Return number of columns a CHARACTER occupies when displayed."
|
|
|
528 (if (featurep 'mule)
|
|
|
529 (with-fboundp '(charset-width char-charset)
|
|
|
530 (charset-width (char-charset character)))
|
|
|
531 1))
|
|
|
532
|
|
|
533 ;; The following several functions are useful in GNU Emacs 20 because
|
|
|
534 ;; of the multibyte "characters" the internal representation of which
|
|
|
535 ;; leaks into Lisp. In XEmacs/Mule they are trivial and unnecessary.
|
|
|
536 ;; We provide them for compatibility reasons solely.
|
|
|
537
|
|
|
538 (defun string-to-sequence (string type)
|
|
|
539 "Convert STRING to a sequence of TYPE which contains characters in STRING.
|
|
|
540 TYPE should be `list' or `vector'."
|
|
|
541 (ecase type
|
|
|
542 (list
|
|
|
543 (mapcar #'identity string))
|
|
|
544 (vector
|
|
|
545 (mapvector #'identity string))))
|
|
|
546
|
|
|
547 (defun string-to-list (string)
|
|
|
548 "Return a list of characters in STRING."
|
|
|
549 (mapcar #'identity string))
|
|
|
550
|
|
|
551 (defun string-to-vector (string)
|
|
|
552 "Return a vector of characters in STRING."
|
|
|
553 (mapvector #'identity string))
|
|
|
554
|
|
|
555 (defun store-substring (string idx obj)
|
|
|
556 "Embed OBJ (string or character) at index IDX of STRING."
|
|
|
557 (let* ((str (cond ((stringp obj) obj)
|
|
|
558 ((characterp obj) (char-to-string obj))
|
|
|
559 (t (error
|
|
|
560 "Invalid argument (should be string or character): %s"
|
|
|
561 obj))))
|
|
|
562 (string-len (length string))
|
|
|
563 (len (length str))
|
|
|
564 (i 0))
|
|
|
565 (while (and (< i len) (< idx string-len))
|
|
|
566 (aset string idx (aref str i))
|
|
|
567 (setq idx (1+ idx) i (1+ i)))
|
|
|
568 string))
|
|
|
569
|
|
|
570 ;; #### This function is not compatible with FSF in some cases. Hard
|
|
|
571 ;; to fix, because it is hard to trace the logic of the FSF function.
|
|
|
572 ;; In case we need the exact behavior, we can always copy the FSF
|
|
|
573 ;; version, which is very long and does lots of unnecessary stuff.
|
|
|
574 (defun truncate-string-to-width (str end-column &optional start-column padding)
|
|
|
575 "Truncate string STR to end at column END-COLUMN.
|
|
|
576 The optional 2nd arg START-COLUMN, if non-nil, specifies
|
|
|
577 the starting column; that means to return the characters occupying
|
|
|
578 columns START-COLUMN ... END-COLUMN of STR.
|
|
|
579
|
|
|
580 The optional 3rd arg PADDING, if non-nil, specifies a padding character
|
|
|
581 to add at the end of the result if STR doesn't reach column END-COLUMN,
|
|
|
582 or if END-COLUMN comes in the middle of a character in STR.
|
|
|
583 PADDING is also added at the beginning of the result
|
|
|
584 if column START-COLUMN appears in the middle of a character in STR.
|
|
|
585
|
|
|
586 If PADDING is nil, no padding is added in these cases, so
|
|
|
587 the resulting string may be narrower than END-COLUMN."
|
|
|
588 (or start-column
|
|
|
589 (setq start-column 0))
|
|
|
590 (let ((len (length str)))
|
|
|
591 (concat (substring str (min start-column len) (min end-column len))
|
|
|
592 (and padding (> end-column len)
|
|
|
593 (make-string (- end-column len) padding)))))
|
|
|
594
|
|
428
|
595
|
|
|
596 ;; alist/plist functions
|
|
|
597 (defun plist-to-alist (plist)
|
|
|
598 "Convert property list PLIST into the equivalent association-list form.
|
|
|
599 The alist is returned. This converts from
|
|
|
600
|
|
|
601 \(a 1 b 2 c 3)
|
|
|
602
|
|
|
603 into
|
|
|
604
|
|
|
605 \((a . 1) (b . 2) (c . 3))
|
|
|
606
|
|
|
607 The original plist is not modified. See also `destructive-plist-to-alist'."
|
|
|
608 (let (alist)
|
|
|
609 (while plist
|
|
|
610 (setq alist (cons (cons (car plist) (cadr plist)) alist))
|
|
|
611 (setq plist (cddr plist)))
|
|
|
612 (nreverse alist)))
|
|
|
613
|
|
783
|
614 (defun map-plist (_mp_fun _mp_plist)
|
|
|
615 "Map _MP_FUN (a function of two args) over each key/value pair in _MP_PLIST.
|
|
|
616 Return a list of the results."
|
|
|
617 (let (_mp_result)
|
|
|
618 (while _mp_plist
|
|
|
619 (push (funcall _mp_fun (car _mp_plist) (cadr _mp_plist)) _mp_result)
|
|
|
620 (setq _mp_plist (cddr _mp_plist)))
|
|
|
621 (nreverse _mp_result)))
|
|
|
622
|
|
428
|
623 (defun destructive-plist-to-alist (plist)
|
|
|
624 "Convert property list PLIST into the equivalent association-list form.
|
|
|
625 The alist is returned. This converts from
|
|
|
626
|
|
|
627 \(a 1 b 2 c 3)
|
|
|
628
|
|
|
629 into
|
|
|
630
|
|
|
631 \((a . 1) (b . 2) (c . 3))
|
|
|
632
|
|
|
633 The original plist is destroyed in the process of constructing the alist.
|
|
|
634 See also `plist-to-alist'."
|
|
|
635 (let ((head plist)
|
|
|
636 next)
|
|
|
637 (while plist
|
|
|
638 ;; remember the next plist pair.
|
|
|
639 (setq next (cddr plist))
|
|
|
640 ;; make the cons holding the property value into the alist element.
|
|
|
641 (setcdr (cdr plist) (cadr plist))
|
|
|
642 (setcar (cdr plist) (car plist))
|
|
|
643 ;; reattach into alist form.
|
|
|
644 (setcar plist (cdr plist))
|
|
|
645 (setcdr plist next)
|
|
|
646 (setq plist next))
|
|
|
647 head))
|
|
|
648
|
|
|
649 (defun alist-to-plist (alist)
|
|
|
650 "Convert association list ALIST into the equivalent property-list form.
|
|
|
651 The plist is returned. This converts from
|
|
|
652
|
|
|
653 \((a . 1) (b . 2) (c . 3))
|
|
|
654
|
|
|
655 into
|
|
|
656
|
|
|
657 \(a 1 b 2 c 3)
|
|
|
658
|
|
|
659 The original alist is not modified. See also `destructive-alist-to-plist'."
|
|
|
660 (let (plist)
|
|
|
661 (while alist
|
|
|
662 (let ((el (car alist)))
|
|
|
663 (setq plist (cons (cdr el) (cons (car el) plist))))
|
|
|
664 (setq alist (cdr alist)))
|
|
|
665 (nreverse plist)))
|
|
|
666
|
|
|
667 ;; getf, remf in cl*.el.
|
|
|
668
|
|
444
|
669 (defmacro putf (plist property value)
|
|
|
670 "Add property PROPERTY to plist PLIST with value VALUE.
|
|
|
671 Analogous to (setq PLIST (plist-put PLIST PROPERTY VALUE))."
|
|
|
672 `(setq ,plist (plist-put ,plist ,property ,value)))
|
|
428
|
673
|
|
444
|
674 (defmacro laxputf (lax-plist property value)
|
|
|
675 "Add property PROPERTY to lax plist LAX-PLIST with value VALUE.
|
|
|
676 Analogous to (setq LAX-PLIST (lax-plist-put LAX-PLIST PROPERTY VALUE))."
|
|
|
677 `(setq ,lax-plist (lax-plist-put ,lax-plist ,property ,value)))
|
|
428
|
678
|
|
444
|
679 (defmacro laxremf (lax-plist property)
|
|
|
680 "Remove property PROPERTY from lax plist LAX-PLIST.
|
|
|
681 Analogous to (setq LAX-PLIST (lax-plist-remprop LAX-PLIST PROPERTY))."
|
|
|
682 `(setq ,lax-plist (lax-plist-remprop ,lax-plist ,property)))
|
|
428
|
683
|
|
|
684 ;;; Error functions
|
|
|
685
|
|
442
|
686 (defun error (datum &rest args)
|
|
|
687 "Signal a non-continuable error.
|
|
|
688 DATUM should normally be an error symbol, i.e. a symbol defined using
|
|
|
689 `define-error'. ARGS will be made into a list, and DATUM and ARGS passed
|
|
|
690 as the two arguments to `signal', the most basic error handling function.
|
|
|
691
|
|
428
|
692 This error is not continuable: you cannot continue execution after the
|
|
442
|
693 error using the debugger `r' command. See also `cerror'.
|
|
|
694
|
|
|
695 The correct semantics of ARGS varies from error to error, but for most
|
|
|
696 errors that need to be generated in Lisp code, the first argument
|
|
|
697 should be a string describing the *context* of the error (i.e. the
|
|
|
698 exact operation being performed and what went wrong), and the remaining
|
|
|
699 arguments or \"frobs\" (most often, there is one) specify the
|
|
|
700 offending object(s) and/or provide additional details such as the exact
|
|
|
701 error when a file error occurred, e.g.:
|
|
|
702
|
|
|
703 -- the buffer in which an editing error occurred.
|
|
|
704 -- an invalid value that was encountered. (In such cases, the string
|
|
|
705 should describe the purpose or \"semantics\" of the value [e.g. if the
|
|
|
706 value is an argument to a function, the name of the argument; if the value
|
|
|
707 is the value corresponding to a keyword, the name of the keyword; if the
|
|
|
708 value is supposed to be a list length, say this and say what the purpose
|
|
|
709 of the list is; etc.] as well as specifying why the value is invalid, if
|
|
|
710 that's not self-evident.)
|
|
|
711 -- the file in which an error occurred. (In such cases, there should be a
|
|
|
712 second frob, probably a string, specifying the exact error that occurred.
|
|
|
713 This does not occur in the string that precedes the first frob, because
|
|
|
714 that frob describes the exact operation that was happening.
|
|
|
715
|
|
|
716 For historical compatibility, DATUM can also be a string. In this case,
|
|
|
717 DATUM and ARGS are passed together as the arguments to `format', and then
|
|
|
718 an error is signalled using the error symbol `error' and formatted string.
|
|
|
719 Although this usage of `error' is very common, it is deprecated because it
|
|
|
720 totally defeats the purpose of having structured errors. There is now
|
|
|
721 a rich set of defined errors you can use:
|
|
|
722
|
|
563
|
723 quit
|
|
|
724
|
|
442
|
725 error
|
|
|
726 invalid-argument
|
|
563
|
727 syntax-error
|
|
|
728 invalid-read-syntax
|
|
|
729 invalid-regexp
|
|
|
730 structure-formation-error
|
|
|
731 list-formation-error
|
|
|
732 malformed-list
|
|
|
733 malformed-property-list
|
|
|
734 circular-list
|
|
|
735 circular-property-list
|
|
|
736 invalid-function
|
|
|
737 no-catch
|
|
|
738 undefined-keystroke-sequence
|
|
|
739 invalid-constant
|
|
442
|
740 wrong-type-argument
|
|
|
741 args-out-of-range
|
|
|
742 wrong-number-of-arguments
|
|
428
|
743
|
|
442
|
744 invalid-state
|
|
|
745 void-function
|
|
|
746 cyclic-function-indirection
|
|
|
747 void-variable
|
|
|
748 cyclic-variable-indirection
|
|
509
|
749 invalid-byte-code
|
|
563
|
750 stack-overflow
|
|
|
751 out-of-memory
|
|
|
752 invalid-key-binding
|
|
|
753 internal-error
|
|
442
|
754
|
|
|
755 invalid-operation
|
|
|
756 invalid-change
|
|
|
757 setting-constant
|
|
563
|
758 protected-field
|
|
442
|
759 editing-error
|
|
|
760 beginning-of-buffer
|
|
|
761 end-of-buffer
|
|
|
762 buffer-read-only
|
|
|
763 io-error
|
|
509
|
764 file-error
|
|
|
765 file-already-exists
|
|
|
766 file-locked
|
|
|
767 file-supersession
|
|
563
|
768 end-of-file
|
|
|
769 process-error
|
|
|
770 network-error
|
|
509
|
771 tooltalk-error
|
|
563
|
772 gui-error
|
|
|
773 dialog-box-error
|
|
|
774 sound-error
|
|
|
775 conversion-error
|
|
|
776 text-conversion-error
|
|
|
777 image-conversion-error
|
|
|
778 base64-conversion-error
|
|
|
779 selection-conversion-error
|
|
442
|
780 arith-error
|
|
|
781 range-error
|
|
|
782 domain-error
|
|
|
783 singularity-error
|
|
|
784 overflow-error
|
|
|
785 underflow-error
|
|
509
|
786 search-failed
|
|
563
|
787 printing-unreadable-object
|
|
|
788 unimplemented
|
|
509
|
789
|
|
563
|
790 Note the semantic differences between some of the more common errors:
|
|
442
|
791
|
|
563
|
792 -- `invalid-argument' is for all cases where a bad value is encountered.
|
|
|
793 -- `invalid-constant' is for arguments where only a specific set of values
|
|
|
794 is allowed.
|
|
|
795 -- `syntax-error' is when complex structures (parsed strings, lists,
|
|
|
796 and the like) are badly formed. If the problem is just a single bad
|
|
|
797 value inside the structure, you should probably be using something else,
|
|
|
798 e.g. `invalid-constant', `wrong-type-argument', or `invalid-argument'.
|
|
442
|
799 -- `invalid-state' means that some settings have been changed in such a way
|
|
|
800 that their current state is unallowable. More and more, code is being
|
|
|
801 written more carefully, and catches the error when the settings are being
|
|
|
802 changed, rather than afterwards. This leads us to the next error:
|
|
|
803 -- `invalid-change' means that an attempt is being made to change some settings
|
|
|
804 into an invalid state. `invalid-change' is a type of `invalid-operation'.
|
|
|
805 -- `invalid-operation' refers to all cases where code is trying to do something
|
|
563
|
806 that's disallowed, or when an error occurred during an operation. (These
|
|
|
807 two concepts are merged because there's no clear distinction between them.)
|
|
|
808 -- `io-error' refers to errors involving interaction with any external
|
|
|
809 components (files, other programs, the operating system, etc).
|
|
442
|
810
|
|
|
811 See also `cerror', `signal', and `signal-error'."
|
|
|
812 (while t (apply
|
|
|
813 'cerror datum args)))
|
|
|
814
|
|
|
815 (defun cerror (datum &rest args)
|
|
428
|
816 "Like `error' but signals a continuable error."
|
|
442
|
817 (cond ((stringp datum)
|
|
|
818 (signal 'error (list (apply 'format datum args))))
|
|
|
819 ((defined-error-p datum)
|
|
|
820 (signal datum args))
|
|
|
821 (t
|
|
|
822 (error 'invalid-argument "datum not string or error symbol" datum))))
|
|
428
|
823
|
|
|
824 (defmacro check-argument-type (predicate argument)
|
|
|
825 "Check that ARGUMENT satisfies PREDICATE.
|
|
442
|
826 This is a macro, and ARGUMENT is not evaluated. If ARGUMENT is an lvalue,
|
|
|
827 this function signals a continuable `wrong-type-argument' error until the
|
|
|
828 returned value satisfies PREDICATE, and assigns the returned value
|
|
|
829 to ARGUMENT. Otherwise, this function signals a non-continuable
|
|
|
830 `wrong-type-argument' error if the returned value does not satisfy PREDICATE."
|
|
|
831 (if (symbolp argument)
|
|
|
832 `(if (not (,(eval predicate) ,argument))
|
|
|
833 (setq ,argument
|
|
|
834 (wrong-type-argument ,predicate ,argument)))
|
|
|
835 `(if (not (,(eval predicate) ,argument))
|
|
|
836 (signal-error 'wrong-type-argument (list ,predicate ,argument)))))
|
|
428
|
837
|
|
|
838 (defun signal-error (error-symbol data)
|
|
|
839 "Signal a non-continuable error. Args are ERROR-SYMBOL, and associated DATA.
|
|
|
840 An error symbol is a symbol defined using `define-error'.
|
|
|
841 DATA should be a list. Its elements are printed as part of the error message.
|
|
|
842 If the signal is handled, DATA is made available to the handler.
|
|
|
843 See also `signal', and the functions to handle errors: `condition-case'
|
|
|
844 and `call-with-condition-handler'."
|
|
|
845 (while t
|
|
|
846 (signal error-symbol data)))
|
|
|
847
|
|
|
848 (defun define-error (error-sym doc-string &optional inherits-from)
|
|
|
849 "Define a new error, denoted by ERROR-SYM.
|
|
|
850 DOC-STRING is an informative message explaining the error, and will be
|
|
|
851 printed out when an unhandled error occurs.
|
|
|
852 ERROR-SYM is a sub-error of INHERITS-FROM (which defaults to `error').
|
|
|
853
|
|
|
854 \[`define-error' internally works by putting on ERROR-SYM an `error-message'
|
|
|
855 property whose value is DOC-STRING, and an `error-conditions' property
|
|
|
856 that is a list of ERROR-SYM followed by each of its super-errors, up
|
|
|
857 to and including `error'. You will sometimes see code that sets this up
|
|
|
858 directly rather than calling `define-error', but you should *not* do this
|
|
|
859 yourself.]"
|
|
|
860 (check-argument-type 'symbolp error-sym)
|
|
|
861 (check-argument-type 'stringp doc-string)
|
|
|
862 (put error-sym 'error-message doc-string)
|
|
|
863 (or inherits-from (setq inherits-from 'error))
|
|
|
864 (let ((conds (get inherits-from 'error-conditions)))
|
|
|
865 (or conds (signal-error 'error (list "Not an error symbol" error-sym)))
|
|
|
866 (put error-sym 'error-conditions (cons error-sym conds))))
|
|
|
867
|
|
442
|
868 (defun defined-error-p (sym)
|
|
|
869 "Returns non-nil if SYM names a currently-defined error."
|
|
|
870 (and (symbolp sym) (not (null (get sym 'error-conditions)))))
|
|
|
871
|
|
793
|
872 (defun backtrace-in-condition-handler-eliminating-handler (handler-arg-name)
|
|
|
873 "Return a backtrace inside of a condition handler, eliminating the handler.
|
|
|
874 This is for use in the condition handler inside of call-with-condition-handler,
|
|
|
875 when written like this:
|
|
|
876
|
|
|
877 \(call-with-condition-handler
|
|
|
878 #'(lambda (__some_weird_arg__)
|
|
|
879 do the handling ...)
|
|
|
880 #'(lambda ()
|
|
|
881 do the stuff that might cause an error))
|
|
|
882
|
|
|
883 Pass in the name (a symbol) of the argument used in the lambda function
|
|
|
884 that specifies the handler, and make sure the argument name is unique, and
|
|
|
885 this function generates a backtrace and strips off the part above where the
|
|
|
886 error occurred (i.e. the handler itself)."
|
|
|
887 (let* ((bt (with-output-to-string (backtrace nil t)))
|
|
|
888 (bt (save-match-data
|
|
|
889 ;; Try to eliminate the part of the backtrace
|
|
|
890 ;; above where the error occurred.
|
|
|
891 (if (string-match
|
|
|
892 (concat "bind (\\(?:.* \\)?" (symbol-name handler-arg-name)
|
|
|
893 "\\(?:.* \\)?)[ \t\n]*\\(?:(lambda \\|#<compiled-function \\)("
|
|
|
894 (symbol-name handler-arg-name)
|
|
|
895 ").*\n\\(\\(?:.\\|\n\\)*\\)$")
|
|
|
896 bt) (match-string 1 bt) bt))))
|
|
|
897 bt))
|
|
|
898
|
|
|
899 (put 'with-trapping-errors 'lisp-indent-function 0)
|
|
|
900 (defmacro with-trapping-errors (&rest keys-body)
|
|
|
901 "Trap errors in BODY, outputting a warning and a backtrace.
|
|
|
902 Usage looks like
|
|
|
903
|
|
|
904 \(with-trapping-errors
|
|
|
905 [:operation OPERATION]
|
|
|
906 [:error-form ERROR-FORM]
|
|
|
907 [:no-backtrace NO-BACKTRACE]
|
|
|
908 [:class CLASS]
|
|
|
909 [:level LEVEL]
|
|
|
910 [:resignal RESIGNAL]
|
|
|
911 BODY)
|
|
|
912
|
|
|
913 Return value without error is whatever BODY returns. With error, return
|
|
|
914 result of ERROR-FORM (which will be evaluated only when the error actually
|
|
|
915 occurs), which defaults to nil. OPERATION is given in the warning message.
|
|
|
916 CLASS and LEVEL are the warning class and level (default to class
|
|
|
917 `general', level `warning'). If NO-BACKTRACE is given, no backtrace is
|
|
|
918 displayed. If RESIGNAL is given, the error is resignaled after the warning
|
|
|
919 is displayed and the ERROR-FORM is executed."
|
|
|
920 (let ((operation "unknown")
|
|
|
921 (error-form nil)
|
|
|
922 (no-backtrace nil)
|
|
|
923 (class ''general)
|
|
|
924 (level ''warning)
|
|
|
925 (resignal nil))
|
|
|
926 (let* ((keys '(operation error-form no-backtrace class level resignal))
|
|
|
927 (keys-with-colon
|
|
|
928 (mapcar #'(lambda (sym)
|
|
|
929 (intern (concat ":" (symbol-name sym)))) keys)))
|
|
|
930 (while (memq (car keys-body) keys-with-colon)
|
|
|
931 (let* ((key-with-colon (pop keys-body))
|
|
|
932 (key (intern (substring (symbol-name key-with-colon) 1))))
|
|
|
933 (set key (pop keys-body)))))
|
|
|
934 `(condition-case ,(if resignal '__cte_cc_var__ nil)
|
|
|
935 (call-with-condition-handler
|
|
|
936 #'(lambda (__call_trapping_errors_arg__)
|
|
|
937 (let ((errstr (error-message-string
|
|
|
938 __call_trapping_errors_arg__)))
|
|
|
939 ,(if no-backtrace
|
|
|
940 `(lwarn ,class ,level
|
|
|
941 (if (warning-level-<
|
|
|
942 ,level
|
|
|
943 display-warning-minimum-level)
|
|
|
944 "Error in %s: %s"
|
|
|
945 "Error in %s:\n%s\n")
|
|
|
946 ,operation errstr)
|
|
|
947 `(lwarn ,class ,level
|
|
|
948 "Error in %s: %s\n\nBacktrace follows:\n\n%s"
|
|
|
949 ,operation errstr
|
|
|
950 (backtrace-in-condition-handler-eliminating-handler
|
|
|
951 '__call_trapping_errors_arg__)))))
|
|
|
952 #'(lambda ()
|
|
|
953 (progn ,@keys-body)))
|
|
|
954 (error
|
|
|
955 ,error-form
|
|
|
956 ,@(if resignal '((signal (car __cte_cc_var__) (cdr __cte_cc_var__)))))
|
|
|
957 )))
|
|
|
958
|
|
428
|
959 ;;;; Miscellanea.
|
|
|
960
|
|
|
961 ;; This is now in C.
|
|
444
|
962 ;(defun buffer-substring-no-properties (start end)
|
|
|
963 ; "Return the text from START to END, without text properties, as a string."
|
|
|
964 ; (let ((string (buffer-substring start end)))
|
|
428
|
965 ; (set-text-properties 0 (length string) nil string)
|
|
|
966 ; string))
|
|
|
967
|
|
|
968 (defun get-buffer-window-list (&optional buffer minibuf frame)
|
|
|
969 "Return windows currently displaying BUFFER, or nil if none.
|
|
|
970 BUFFER defaults to the current buffer.
|
|
|
971 See `walk-windows' for the meaning of MINIBUF and FRAME."
|
|
|
972 (cond ((null buffer)
|
|
|
973 (setq buffer (current-buffer)))
|
|
|
974 ((not (bufferp buffer))
|
|
|
975 (setq buffer (get-buffer buffer))))
|
|
|
976 (let (windows)
|
|
|
977 (walk-windows (lambda (window)
|
|
|
978 (if (eq (window-buffer window) buffer)
|
|
|
979 (push window windows)))
|
|
|
980 minibuf frame)
|
|
|
981 windows))
|
|
|
982
|
|
|
983 (defun ignore (&rest ignore)
|
|
|
984 "Do nothing and return nil.
|
|
|
985 This function accepts any number of arguments, but ignores them."
|
|
|
986 (interactive)
|
|
|
987 nil)
|
|
|
988
|
|
|
989 (define-function 'eval-in-buffer 'with-current-buffer)
|
|
|
990 (make-obsolete 'eval-in-buffer 'with-current-buffer)
|
|
|
991
|
|
|
992 ;;; The real defn is in abbrev.el but some early callers
|
|
|
993 ;;; (eg lisp-mode-abbrev-table) want this before abbrev.el is loaded...
|
|
|
994
|
|
|
995 (if (not (fboundp 'define-abbrev-table))
|
|
|
996 (progn
|
|
|
997 (setq abbrev-table-name-list '())
|
|
|
998 (fset 'define-abbrev-table (function (lambda (name defs)
|
|
|
999 ;; These are fixed-up when abbrev.el loads.
|
|
|
1000 (setq abbrev-table-name-list
|
|
|
1001 (cons (cons name defs)
|
|
|
1002 abbrev-table-name-list)))))))
|
|
|
1003
|
|
|
1004 ;;; `functionp' has been moved into C.
|
|
|
1005
|
|
|
1006 ;;(defun functionp (object)
|
|
|
1007 ;; "Non-nil if OBJECT can be called as a function."
|
|
|
1008 ;; (or (and (symbolp object) (fboundp object))
|
|
|
1009 ;; (subrp object)
|
|
|
1010 ;; (compiled-function-p object)
|
|
|
1011 ;; (eq (car-safe object) 'lambda)))
|
|
|
1012
|
|
|
1013
|
|
|
1014
|
|
|
1015 (defun function-interactive (function)
|
|
|
1016 "Return the interactive specification of FUNCTION.
|
|
|
1017 FUNCTION can be any funcallable object.
|
|
|
1018 The specification will be returned as the list of the symbol `interactive'
|
|
|
1019 and the specs.
|
|
|
1020 If FUNCTION is not interactive, nil will be returned."
|
|
|
1021 (setq function (indirect-function function))
|
|
|
1022 (cond ((compiled-function-p function)
|
|
|
1023 (compiled-function-interactive function))
|
|
|
1024 ((subrp function)
|
|
|
1025 (subr-interactive function))
|
|
|
1026 ((eq (car-safe function) 'lambda)
|
|
|
1027 (let ((spec (if (stringp (nth 2 function))
|
|
|
1028 (nth 3 function)
|
|
|
1029 (nth 2 function))))
|
|
|
1030 (and (eq (car-safe spec) 'interactive)
|
|
|
1031 spec)))
|
|
|
1032 (t
|
|
|
1033 (error "Non-funcallable object: %s" function))))
|
|
|
1034
|
|
442
|
1035 (defun function-allows-args (function n)
|
|
|
1036 "Return whether FUNCTION can be called with N arguments."
|
|
|
1037 (and (<= (function-min-args function) n)
|
|
|
1038 (or (null (function-max-args function))
|
|
|
1039 (<= n (function-max-args function)))))
|
|
|
1040
|
|
428
|
1041 ;; This function used to be an alias to `buffer-substring', except
|
|
|
1042 ;; that FSF Emacs 20.4 added a BUFFER argument in an incompatible way.
|
|
|
1043 ;; The new FSF's semantics makes more sense, but we try to support
|
|
|
1044 ;; both for backward compatibility.
|
|
|
1045 (defun buffer-string (&optional buffer old-end old-buffer)
|
|
|
1046 "Return the contents of the current buffer as a string.
|
|
|
1047 If narrowing is in effect, this function returns only the visible part
|
|
|
1048 of the buffer.
|
|
|
1049
|
|
|
1050 If BUFFER is specified, the contents of that buffer are returned.
|
|
|
1051
|
|
|
1052 The arguments OLD-END and OLD-BUFFER are supported for backward
|
|
|
1053 compatibility with pre-21.2 XEmacsen times when arguments to this
|
|
|
1054 function were (buffer-string &optional START END BUFFER)."
|
|
|
1055 (cond
|
|
|
1056 ((or (stringp buffer) (bufferp buffer))
|
|
|
1057 ;; Most definitely the new way.
|
|
|
1058 (buffer-substring nil nil buffer))
|
|
|
1059 ((or (stringp old-buffer) (bufferp old-buffer)
|
|
|
1060 (natnump buffer) (natnump old-end))
|
|
|
1061 ;; Definitely the old way.
|
|
|
1062 (buffer-substring buffer old-end old-buffer))
|
|
|
1063 (t
|
|
|
1064 ;; Probably the old way.
|
|
|
1065 (buffer-substring buffer old-end old-buffer))))
|
|
|
1066
|
|
|
1067 ;; This was not present before. I think Jamie had some objections
|
|
|
1068 ;; to this, so I'm leaving this undefined for now. --ben
|
|
|
1069
|
|
|
1070 ;;; The objection is this: there is more than one way to load the same file.
|
|
|
1071 ;;; "foo", "foo.elc", "foo.el", and "/some/path/foo.elc" are all different
|
|
|
1072 ;;; ways to load the exact same code. `eval-after-load' is too stupid to
|
|
|
1073 ;;; deal with this sort of thing. If this sort of feature is desired, then
|
|
|
1074 ;;; it should work off of a hook on `provide'. Features are unique and
|
|
|
1075 ;;; the arguments to (load) are not. --Stig
|
|
|
1076
|
|
|
1077 ;; We provide this for FSFmacs compatibility, at least until we devise
|
|
|
1078 ;; something better.
|
|
|
1079
|
|
|
1080 ;;;; Specifying things to do after certain files are loaded.
|
|
|
1081
|
|
|
1082 (defun eval-after-load (file form)
|
|
|
1083 "Arrange that, if FILE is ever loaded, FORM will be run at that time.
|
|
|
1084 This makes or adds to an entry on `after-load-alist'.
|
|
|
1085 If FILE is already loaded, evaluate FORM right now.
|
|
|
1086 It does nothing if FORM is already on the list for FILE.
|
|
|
1087 FILE should be the name of a library, with no directory name."
|
|
|
1088 ;; Make sure there is an element for FILE.
|
|
|
1089 (or (assoc file after-load-alist)
|
|
|
1090 (setq after-load-alist (cons (list file) after-load-alist)))
|
|
|
1091 ;; Add FORM to the element if it isn't there.
|
|
|
1092 (let ((elt (assoc file after-load-alist)))
|
|
|
1093 (or (member form (cdr elt))
|
|
|
1094 (progn
|
|
|
1095 (nconc elt (list form))
|
|
|
1096 ;; If the file has been loaded already, run FORM right away.
|
|
|
1097 (and (assoc file load-history)
|
|
|
1098 (eval form)))))
|
|
|
1099 form)
|
|
|
1100 (make-compatible 'eval-after-load "")
|
|
|
1101
|
|
|
1102 (defun eval-next-after-load (file)
|
|
|
1103 "Read the following input sexp, and run it whenever FILE is loaded.
|
|
|
1104 This makes or adds to an entry on `after-load-alist'.
|
|
|
1105 FILE should be the name of a library, with no directory name."
|
|
|
1106 (eval-after-load file (read)))
|
|
|
1107 (make-compatible 'eval-next-after-load "")
|
|
|
1108
|
|
|
1109 ; alternate names (not obsolete)
|
|
|
1110 (if (not (fboundp 'mod)) (define-function 'mod '%))
|
|
|
1111 (define-function 'move-marker 'set-marker)
|
|
|
1112 (define-function 'beep 'ding) ; preserve lingual purity
|
|
|
1113 (define-function 'indent-to-column 'indent-to)
|
|
|
1114 (define-function 'backward-delete-char 'delete-backward-char)
|
|
|
1115 (define-function 'search-forward-regexp (symbol-function 're-search-forward))
|
|
|
1116 (define-function 'search-backward-regexp (symbol-function 're-search-backward))
|
|
|
1117 (define-function 'remove-directory 'delete-directory)
|
|
|
1118 (define-function 'set-match-data 'store-match-data)
|
|
|
1119 (define-function 'send-string-to-terminal 'external-debugging-output)
|
|
|
1120
|
|
|
1121 ;;; subr.el ends here
|
