|
428
|
1 /* Evaluator for XEmacs Lisp interpreter.
|
|
|
2 Copyright (C) 1985-1987, 1992-1994 Free Software Foundation, Inc.
|
|
|
3 Copyright (C) 1995 Sun Microsystems, Inc.
|
|
793
|
4 Copyright (C) 2000, 2001, 2002 Ben Wing.
|
|
428
|
5
|
|
|
6 This file is part of XEmacs.
|
|
|
7
|
|
|
8 XEmacs is free software; you can redistribute it and/or modify it
|
|
|
9 under the terms of the GNU General Public License as published by the
|
|
|
10 Free Software Foundation; either version 2, or (at your option) any
|
|
|
11 later version.
|
|
|
12
|
|
|
13 XEmacs is distributed in the hope that it will be useful, but WITHOUT
|
|
|
14 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
|
|
15 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
|
|
16 for more details.
|
|
|
17
|
|
|
18 You should have received a copy of the GNU General Public License
|
|
|
19 along with XEmacs; see the file COPYING. If not, write to
|
|
|
20 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
|
|
21 Boston, MA 02111-1307, USA. */
|
|
|
22
|
|
|
23 /* Synched up with: FSF 19.30 (except for Fsignal), Mule 2.0. */
|
|
|
24
|
|
|
25 #include <config.h>
|
|
|
26 #include "lisp.h"
|
|
|
27
|
|
|
28 #include "commands.h"
|
|
|
29 #include "backtrace.h"
|
|
|
30 #include "bytecode.h"
|
|
|
31 #include "buffer.h"
|
|
|
32 #include "console.h"
|
|
|
33 #include "opaque.h"
|
|
|
34
|
|
|
35 #ifdef ERROR_CHECK_GC
|
|
|
36 int always_gc; /* Debugging hack */
|
|
|
37 #else
|
|
|
38 #define always_gc 0
|
|
|
39 #endif
|
|
|
40
|
|
|
41 struct backtrace *backtrace_list;
|
|
|
42
|
|
|
43 /* Note: you must always fill in all of the fields in a backtrace structure
|
|
|
44 before pushing them on the backtrace_list. The profiling code depends
|
|
|
45 on this. */
|
|
|
46
|
|
|
47 #define PUSH_BACKTRACE(bt) do { \
|
|
|
48 (bt).next = backtrace_list; \
|
|
|
49 backtrace_list = &(bt); \
|
|
|
50 } while (0)
|
|
|
51
|
|
|
52 #define POP_BACKTRACE(bt) do { \
|
|
|
53 backtrace_list = (bt).next; \
|
|
|
54 } while (0)
|
|
|
55
|
|
|
56 /* Macros for calling subrs with an argument list whose length is only
|
|
|
57 known at runtime. See EXFUN and DEFUN for similar hackery. */
|
|
|
58
|
|
|
59 #define AV_0(av)
|
|
|
60 #define AV_1(av) av[0]
|
|
|
61 #define AV_2(av) AV_1(av), av[1]
|
|
|
62 #define AV_3(av) AV_2(av), av[2]
|
|
|
63 #define AV_4(av) AV_3(av), av[3]
|
|
|
64 #define AV_5(av) AV_4(av), av[4]
|
|
|
65 #define AV_6(av) AV_5(av), av[5]
|
|
|
66 #define AV_7(av) AV_6(av), av[6]
|
|
|
67 #define AV_8(av) AV_7(av), av[7]
|
|
|
68
|
|
|
69 #define PRIMITIVE_FUNCALL_1(fn, av, ac) \
|
|
444
|
70 (((Lisp_Object (*)(EXFUN_##ac)) (fn)) (AV_##ac (av)))
|
|
428
|
71
|
|
|
72 /* If subrs take more than 8 arguments, more cases need to be added
|
|
|
73 to this switch. (But wait - don't do it - if you really need
|
|
|
74 a SUBR with more than 8 arguments, use max_args == MANY.
|
|
|
75 See the DEFUN macro in lisp.h) */
|
|
|
76 #define PRIMITIVE_FUNCALL(rv, fn, av, ac) do { \
|
|
|
77 void (*PF_fn)(void) = (void (*)(void)) fn; \
|
|
|
78 Lisp_Object *PF_av = (av); \
|
|
|
79 switch (ac) \
|
|
|
80 { \
|
|
436
|
81 default:rv = PRIMITIVE_FUNCALL_1(PF_fn, PF_av, 0); break; \
|
|
428
|
82 case 1: rv = PRIMITIVE_FUNCALL_1(PF_fn, PF_av, 1); break; \
|
|
|
83 case 2: rv = PRIMITIVE_FUNCALL_1(PF_fn, PF_av, 2); break; \
|
|
|
84 case 3: rv = PRIMITIVE_FUNCALL_1(PF_fn, PF_av, 3); break; \
|
|
|
85 case 4: rv = PRIMITIVE_FUNCALL_1(PF_fn, PF_av, 4); break; \
|
|
|
86 case 5: rv = PRIMITIVE_FUNCALL_1(PF_fn, PF_av, 5); break; \
|
|
|
87 case 6: rv = PRIMITIVE_FUNCALL_1(PF_fn, PF_av, 6); break; \
|
|
|
88 case 7: rv = PRIMITIVE_FUNCALL_1(PF_fn, PF_av, 7); break; \
|
|
|
89 case 8: rv = PRIMITIVE_FUNCALL_1(PF_fn, PF_av, 8); break; \
|
|
|
90 } \
|
|
|
91 } while (0)
|
|
|
92
|
|
|
93 #define FUNCALL_SUBR(rv, subr, av, ac) \
|
|
|
94 PRIMITIVE_FUNCALL (rv, subr_function (subr), av, ac);
|
|
|
95
|
|
|
96
|
|
|
97 /* This is the list of current catches (and also condition-cases).
|
|
|
98 This is a stack: the most recent catch is at the head of the
|
|
|
99 list. Catches are created by declaring a 'struct catchtag'
|
|
|
100 locally, filling the .TAG field in with the tag, and doing
|
|
|
101 a setjmp() on .JMP. Fthrow() will store the value passed
|
|
|
102 to it in .VAL and longjmp() back to .JMP, back to the function
|
|
|
103 that established the catch. This will always be either
|
|
|
104 internal_catch() (catches established internally or through
|
|
|
105 `catch') or condition_case_1 (condition-cases established
|
|
|
106 internally or through `condition-case').
|
|
|
107
|
|
|
108 The catchtag also records the current position in the
|
|
|
109 call stack (stored in BACKTRACE_LIST), the current position
|
|
|
110 in the specpdl stack (used for variable bindings and
|
|
|
111 unwind-protects), the value of LISP_EVAL_DEPTH, and the
|
|
|
112 current position in the GCPRO stack. All of these are
|
|
|
113 restored by Fthrow().
|
|
|
114 */
|
|
|
115
|
|
|
116 struct catchtag *catchlist;
|
|
|
117
|
|
|
118 Lisp_Object Qautoload, Qmacro, Qexit;
|
|
|
119 Lisp_Object Qinteractive, Qcommandp, Qdefun, Qprogn, Qvalues;
|
|
|
120 Lisp_Object Vquit_flag, Vinhibit_quit;
|
|
|
121 Lisp_Object Qand_rest, Qand_optional;
|
|
|
122 Lisp_Object Qdebug_on_error, Qstack_trace_on_error;
|
|
|
123 Lisp_Object Qdebug_on_signal, Qstack_trace_on_signal;
|
|
|
124 Lisp_Object Qdebugger;
|
|
|
125 Lisp_Object Qinhibit_quit;
|
|
|
126 Lisp_Object Qrun_hooks;
|
|
|
127 Lisp_Object Qsetq;
|
|
|
128 Lisp_Object Qdisplay_warning;
|
|
|
129 Lisp_Object Vpending_warnings, Vpending_warnings_tail;
|
|
|
130 Lisp_Object Qif;
|
|
|
131
|
|
|
132 /* Records whether we want errors to occur. This will be a boolean,
|
|
|
133 nil (errors OK) or t (no errors). If t, an error will cause a
|
|
|
134 throw to Qunbound_suspended_errors_tag.
|
|
|
135
|
|
|
136 See call_with_suspended_errors(). */
|
|
|
137 Lisp_Object Vcurrent_error_state;
|
|
|
138
|
|
|
139 /* Current warning class when warnings occur, or nil for no warnings.
|
|
|
140 Only meaningful when Vcurrent_error_state is non-nil.
|
|
|
141 See call_with_suspended_errors(). */
|
|
|
142 Lisp_Object Vcurrent_warning_class;
|
|
|
143
|
|
793
|
144 /* Current warning level when warnings occur, or nil for no warnings.
|
|
|
145 Only meaningful when Vcurrent_error_state is non-nil.
|
|
|
146 See call_with_suspended_errors(). */
|
|
|
147 Lisp_Object Vcurrent_warning_level;
|
|
|
148
|
|
|
149 /* Minimum level at which warnings are logged. Below this, they're ignored
|
|
|
150 entirely -- not even generated. */
|
|
|
151 Lisp_Object Vlog_warning_minimum_level;
|
|
|
152
|
|
428
|
153 /* Special catch tag used in call_with_suspended_errors(). */
|
|
|
154 Lisp_Object Qunbound_suspended_errors_tag;
|
|
|
155
|
|
|
156 /* Non-nil means record all fset's and provide's, to be undone
|
|
|
157 if the file being autoloaded is not fully loaded.
|
|
|
158 They are recorded by being consed onto the front of Vautoload_queue:
|
|
|
159 (FUN . ODEF) for a defun, (OFEATURES . nil) for a provide. */
|
|
|
160 Lisp_Object Vautoload_queue;
|
|
|
161
|
|
|
162 /* Current number of specbindings allocated in specpdl. */
|
|
|
163 int specpdl_size;
|
|
|
164
|
|
|
165 /* Pointer to beginning of specpdl. */
|
|
|
166 struct specbinding *specpdl;
|
|
|
167
|
|
|
168 /* Pointer to first unused element in specpdl. */
|
|
|
169 struct specbinding *specpdl_ptr;
|
|
|
170
|
|
|
171 /* specpdl_ptr - specpdl */
|
|
|
172 int specpdl_depth_counter;
|
|
|
173
|
|
|
174 /* Maximum size allowed for specpdl allocation */
|
|
458
|
175 Fixnum max_specpdl_size;
|
|
428
|
176
|
|
|
177 /* Depth in Lisp evaluations and function calls. */
|
|
|
178 static int lisp_eval_depth;
|
|
|
179
|
|
|
180 /* Maximum allowed depth in Lisp evaluations and function calls. */
|
|
458
|
181 Fixnum max_lisp_eval_depth;
|
|
428
|
182
|
|
|
183 /* Nonzero means enter debugger before next function call */
|
|
|
184 static int debug_on_next_call;
|
|
|
185
|
|
|
186 /* List of conditions (non-nil atom means all) which cause a backtrace
|
|
|
187 if an error is handled by the command loop's error handler. */
|
|
|
188 Lisp_Object Vstack_trace_on_error;
|
|
|
189
|
|
|
190 /* List of conditions (non-nil atom means all) which enter the debugger
|
|
|
191 if an error is handled by the command loop's error handler. */
|
|
|
192 Lisp_Object Vdebug_on_error;
|
|
|
193
|
|
|
194 /* List of conditions and regexps specifying error messages which
|
|
|
195 do not enter the debugger even if Vdebug_on_error says they should. */
|
|
|
196 Lisp_Object Vdebug_ignored_errors;
|
|
|
197
|
|
|
198 /* List of conditions (non-nil atom means all) which cause a backtrace
|
|
|
199 if any error is signalled. */
|
|
|
200 Lisp_Object Vstack_trace_on_signal;
|
|
|
201
|
|
|
202 /* List of conditions (non-nil atom means all) which enter the debugger
|
|
|
203 if any error is signalled. */
|
|
|
204 Lisp_Object Vdebug_on_signal;
|
|
|
205
|
|
|
206 /* Nonzero means enter debugger if a quit signal
|
|
|
207 is handled by the command loop's error handler.
|
|
|
208
|
|
|
209 From lisp, this is a boolean variable and may have the values 0 and 1.
|
|
|
210 But, eval.c temporarily uses the second bit of this variable to indicate
|
|
|
211 that a critical_quit is in progress. The second bit is reset immediately
|
|
|
212 after it is processed in signal_call_debugger(). */
|
|
|
213 int debug_on_quit;
|
|
|
214
|
|
|
215 #if 0 /* FSFmacs */
|
|
|
216 /* entering_debugger is basically equivalent */
|
|
|
217 /* The value of num_nonmacro_input_chars as of the last time we
|
|
|
218 started to enter the debugger. If we decide to enter the debugger
|
|
|
219 again when this is still equal to num_nonmacro_input_chars, then we
|
|
|
220 know that the debugger itself has an error, and we should just
|
|
|
221 signal the error instead of entering an infinite loop of debugger
|
|
|
222 invocations. */
|
|
|
223 int when_entered_debugger;
|
|
|
224 #endif
|
|
|
225
|
|
|
226 /* Nonzero means we are trying to enter the debugger.
|
|
|
227 This is to prevent recursive attempts.
|
|
|
228 Cleared by the debugger calling Fbacktrace */
|
|
|
229 static int entering_debugger;
|
|
|
230
|
|
|
231 /* Function to call to invoke the debugger */
|
|
|
232 Lisp_Object Vdebugger;
|
|
|
233
|
|
|
234 /* Chain of condition handlers currently in effect.
|
|
|
235 The elements of this chain are contained in the stack frames
|
|
|
236 of Fcondition_case and internal_condition_case.
|
|
|
237 When an error is signaled (by calling Fsignal, below),
|
|
|
238 this chain is searched for an element that applies.
|
|
|
239
|
|
|
240 Each element of this list is one of the following:
|
|
|
241
|
|
|
242 A list of a handler function and possibly args to pass to
|
|
|
243 the function. This is a handler established with
|
|
|
244 `call-with-condition-handler' (q.v.).
|
|
|
245
|
|
|
246 A list whose car is Qunbound and whose cdr is Qt.
|
|
|
247 This is a special condition-case handler established
|
|
|
248 by C code with condition_case_1(). All errors are
|
|
|
249 trapped; the debugger is not invoked even if
|
|
|
250 `debug-on-error' was set.
|
|
|
251
|
|
|
252 A list whose car is Qunbound and whose cdr is Qerror.
|
|
|
253 This is a special condition-case handler established
|
|
|
254 by C code with condition_case_1(). It is like Qt
|
|
|
255 except that the debugger is invoked normally if it is
|
|
|
256 called for.
|
|
|
257
|
|
|
258 A list whose car is Qunbound and whose cdr is a list
|
|
|
259 of lists (CONDITION-NAME BODY ...) exactly as in
|
|
|
260 `condition-case'. This is a normal `condition-case'
|
|
|
261 handler.
|
|
|
262
|
|
|
263 Note that in all cases *except* the first, there is a
|
|
|
264 corresponding catch, whose TAG is the value of
|
|
|
265 Vcondition_handlers just after the handler data just
|
|
|
266 described is pushed onto it. The reason is that
|
|
|
267 `condition-case' handlers need to throw back to the
|
|
|
268 place where the handler was installed before invoking
|
|
|
269 it, while `call-with-condition-handler' handlers are
|
|
|
270 invoked in the environment that `signal' was invoked
|
|
|
271 in.
|
|
|
272 */
|
|
|
273 static Lisp_Object Vcondition_handlers;
|
|
|
274
|
|
|
275
|
|
442
|
276 #define DEFEND_AGAINST_THROW_RECURSION
|
|
|
277
|
|
|
278 #ifdef DEFEND_AGAINST_THROW_RECURSION
|
|
428
|
279 /* Used for error catching purposes by throw_or_bomb_out */
|
|
|
280 static int throw_level;
|
|
442
|
281 #endif
|
|
|
282
|
|
|
283 #ifdef ERROR_CHECK_TYPECHECK
|
|
|
284 void check_error_state_sanity (void);
|
|
|
285 #endif
|
|
428
|
286
|
|
|
287
|
|
|
288 /************************************************************************/
|
|
|
289 /* The subr object type */
|
|
|
290 /************************************************************************/
|
|
|
291
|
|
|
292 static void
|
|
|
293 print_subr (Lisp_Object obj, Lisp_Object printcharfun, int escapeflag)
|
|
|
294 {
|
|
|
295 Lisp_Subr *subr = XSUBR (obj);
|
|
665
|
296 const CIntbyte *header =
|
|
428
|
297 (subr->max_args == UNEVALLED) ? "#<special-form " : "#<subr ";
|
|
665
|
298 const CIntbyte *name = subr_name (subr);
|
|
|
299 const CIntbyte *trailer = subr->prompt ? " (interactive)>" : ">";
|
|
428
|
300
|
|
|
301 if (print_readably)
|
|
563
|
302 printing_unreadable_object ("%s%s%s", header, name, trailer);
|
|
428
|
303
|
|
|
304 write_c_string (header, printcharfun);
|
|
|
305 write_c_string (name, printcharfun);
|
|
|
306 write_c_string (trailer, printcharfun);
|
|
|
307 }
|
|
|
308
|
|
|
309 static const struct lrecord_description subr_description[] = {
|
|
440
|
310 { XD_DOC_STRING, offsetof (Lisp_Subr, doc) },
|
|
428
|
311 { XD_END }
|
|
|
312 };
|
|
|
313
|
|
|
314 DEFINE_BASIC_LRECORD_IMPLEMENTATION ("subr", subr,
|
|
442
|
315 0, print_subr, 0, 0, 0,
|
|
428
|
316 subr_description,
|
|
|
317 Lisp_Subr);
|
|
|
318
|
|
|
319 /************************************************************************/
|
|
|
320 /* Entering the debugger */
|
|
|
321 /************************************************************************/
|
|
|
322
|
|
|
323 /* unwind-protect used by call_debugger() to restore the value of
|
|
|
324 entering_debugger. (We cannot use specbind() because the
|
|
|
325 variable is not Lisp-accessible.) */
|
|
|
326
|
|
|
327 static Lisp_Object
|
|
|
328 restore_entering_debugger (Lisp_Object arg)
|
|
|
329 {
|
|
|
330 entering_debugger = ! NILP (arg);
|
|
|
331 return arg;
|
|
|
332 }
|
|
|
333
|
|
|
334 /* Actually call the debugger. ARG is a list of args that will be
|
|
|
335 passed to the debugger function, as follows;
|
|
|
336
|
|
|
337 If due to frame exit, args are `exit' and the value being returned;
|
|
|
338 this function's value will be returned instead of that.
|
|
|
339 If due to error, args are `error' and a list of the args to `signal'.
|
|
|
340 If due to `apply' or `funcall' entry, one arg, `lambda'.
|
|
|
341 If due to `eval' entry, one arg, t.
|
|
|
342
|
|
|
343 */
|
|
|
344
|
|
|
345 static Lisp_Object
|
|
|
346 call_debugger_259 (Lisp_Object arg)
|
|
|
347 {
|
|
|
348 return apply1 (Vdebugger, arg);
|
|
|
349 }
|
|
|
350
|
|
|
351 /* Call the debugger, doing some encapsulation. We make sure we have
|
|
|
352 some room on the eval and specpdl stacks, and bind entering_debugger
|
|
|
353 to 1 during this call. This is used to trap errors that may occur
|
|
|
354 when entering the debugger (e.g. the value of `debugger' is invalid),
|
|
|
355 so that the debugger will not be recursively entered if debug-on-error
|
|
|
356 is set. (Otherwise, XEmacs would infinitely recurse, attempting to
|
|
|
357 enter the debugger.) entering_debugger gets reset to 0 as soon
|
|
|
358 as a backtrace is displayed, so that further errors can indeed be
|
|
|
359 handled normally.
|
|
|
360
|
|
|
361 We also establish a catch for 'debugger. If the debugger function
|
|
|
362 throws to this instead of returning a value, it means that the user
|
|
|
363 pressed 'c' (pretend like the debugger was never entered). The
|
|
|
364 function then returns Qunbound. (If the user pressed 'r', for
|
|
|
365 return a value, then the debugger function returns normally with
|
|
|
366 this value.)
|
|
|
367
|
|
|
368 The difference between 'c' and 'r' is as follows:
|
|
|
369
|
|
|
370 debug-on-call:
|
|
|
371 No difference. The call proceeds as normal.
|
|
|
372 debug-on-exit:
|
|
|
373 With 'r', the specified value is returned as the function's
|
|
|
374 return value. With 'c', the value that would normally be
|
|
|
375 returned is returned.
|
|
|
376 signal:
|
|
|
377 With 'r', the specified value is returned as the return
|
|
|
378 value of `signal'. (This is the only time that `signal'
|
|
|
379 can return, instead of making a non-local exit.) With `c',
|
|
|
380 `signal' will continue looking for handlers as if the
|
|
|
381 debugger was never entered, and will probably end up
|
|
|
382 throwing to a handler or to top-level.
|
|
|
383 */
|
|
|
384
|
|
|
385 static Lisp_Object
|
|
|
386 call_debugger (Lisp_Object arg)
|
|
|
387 {
|
|
|
388 int threw;
|
|
|
389 Lisp_Object val;
|
|
|
390 int speccount;
|
|
|
391
|
|
|
392 if (lisp_eval_depth + 20 > max_lisp_eval_depth)
|
|
|
393 max_lisp_eval_depth = lisp_eval_depth + 20;
|
|
|
394 if (specpdl_size + 40 > max_specpdl_size)
|
|
|
395 max_specpdl_size = specpdl_size + 40;
|
|
|
396 debug_on_next_call = 0;
|
|
|
397
|
|
|
398 speccount = specpdl_depth();
|
|
|
399 record_unwind_protect (restore_entering_debugger,
|
|
|
400 (entering_debugger ? Qt : Qnil));
|
|
|
401 entering_debugger = 1;
|
|
|
402 val = internal_catch (Qdebugger, call_debugger_259, arg, &threw);
|
|
|
403
|
|
771
|
404 return unbind_to_1 (speccount, ((threw)
|
|
428
|
405 ? Qunbound /* Not returning a value */
|
|
|
406 : val));
|
|
|
407 }
|
|
|
408
|
|
|
409 /* Called when debug-on-exit behavior is called for. Enter the debugger
|
|
|
410 with the appropriate args for this. VAL is the exit value that is
|
|
|
411 about to be returned. */
|
|
|
412
|
|
|
413 static Lisp_Object
|
|
|
414 do_debug_on_exit (Lisp_Object val)
|
|
|
415 {
|
|
|
416 /* This is falsified by call_debugger */
|
|
|
417 Lisp_Object v = call_debugger (list2 (Qexit, val));
|
|
|
418
|
|
|
419 return !UNBOUNDP (v) ? v : val;
|
|
|
420 }
|
|
|
421
|
|
|
422 /* Called when debug-on-call behavior is called for. Enter the debugger
|
|
|
423 with the appropriate args for this. VAL is either t for a call
|
|
|
424 through `eval' or 'lambda for a call through `funcall'.
|
|
|
425
|
|
|
426 #### The differentiation here between EVAL and FUNCALL is bogus.
|
|
|
427 FUNCALL can be defined as
|
|
|
428
|
|
|
429 (defmacro func (fun &rest args)
|
|
|
430 (cons (eval fun) args))
|
|
|
431
|
|
|
432 and should be treated as such.
|
|
|
433 */
|
|
|
434
|
|
|
435 static void
|
|
|
436 do_debug_on_call (Lisp_Object code)
|
|
|
437 {
|
|
|
438 debug_on_next_call = 0;
|
|
|
439 backtrace_list->debug_on_exit = 1;
|
|
|
440 call_debugger (list1 (code));
|
|
|
441 }
|
|
|
442
|
|
|
443 /* LIST is the value of one of the variables `debug-on-error',
|
|
|
444 `debug-on-signal', `stack-trace-on-error', or `stack-trace-on-signal',
|
|
|
445 and CONDITIONS is the list of error conditions associated with
|
|
|
446 the error being signalled. This returns non-nil if LIST
|
|
|
447 matches CONDITIONS. (A nil value for LIST does not match
|
|
|
448 CONDITIONS. A non-list value for LIST does match CONDITIONS.
|
|
|
449 A list matches CONDITIONS when one of the symbols in LIST is the
|
|
|
450 same as one of the symbols in CONDITIONS.) */
|
|
|
451
|
|
|
452 static int
|
|
|
453 wants_debugger (Lisp_Object list, Lisp_Object conditions)
|
|
|
454 {
|
|
|
455 if (NILP (list))
|
|
|
456 return 0;
|
|
|
457 if (! CONSP (list))
|
|
|
458 return 1;
|
|
|
459
|
|
|
460 while (CONSP (conditions))
|
|
|
461 {
|
|
|
462 Lisp_Object this, tail;
|
|
|
463 this = XCAR (conditions);
|
|
|
464 for (tail = list; CONSP (tail); tail = XCDR (tail))
|
|
|
465 if (EQ (XCAR (tail), this))
|
|
|
466 return 1;
|
|
|
467 conditions = XCDR (conditions);
|
|
|
468 }
|
|
|
469 return 0;
|
|
|
470 }
|
|
|
471
|
|
|
472
|
|
|
473 /* Return 1 if an error with condition-symbols CONDITIONS,
|
|
|
474 and described by SIGNAL-DATA, should skip the debugger
|
|
|
475 according to debugger-ignore-errors. */
|
|
|
476
|
|
|
477 static int
|
|
|
478 skip_debugger (Lisp_Object conditions, Lisp_Object data)
|
|
|
479 {
|
|
|
480 /* This function can GC */
|
|
|
481 Lisp_Object tail;
|
|
|
482 int first_string = 1;
|
|
|
483 Lisp_Object error_message = Qnil;
|
|
|
484
|
|
|
485 for (tail = Vdebug_ignored_errors; CONSP (tail); tail = XCDR (tail))
|
|
|
486 {
|
|
|
487 if (STRINGP (XCAR (tail)))
|
|
|
488 {
|
|
|
489 if (first_string)
|
|
|
490 {
|
|
|
491 error_message = Ferror_message_string (data);
|
|
|
492 first_string = 0;
|
|
|
493 }
|
|
|
494 if (fast_lisp_string_match (XCAR (tail), error_message) >= 0)
|
|
|
495 return 1;
|
|
|
496 }
|
|
|
497 else
|
|
|
498 {
|
|
|
499 Lisp_Object contail;
|
|
|
500
|
|
|
501 for (contail = conditions; CONSP (contail); contail = XCDR (contail))
|
|
|
502 if (EQ (XCAR (tail), XCAR (contail)))
|
|
|
503 return 1;
|
|
|
504 }
|
|
|
505 }
|
|
|
506
|
|
|
507 return 0;
|
|
|
508 }
|
|
|
509
|
|
|
510 /* Actually generate a backtrace on STREAM. */
|
|
|
511
|
|
|
512 static Lisp_Object
|
|
|
513 backtrace_259 (Lisp_Object stream)
|
|
|
514 {
|
|
|
515 return Fbacktrace (stream, Qt);
|
|
|
516 }
|
|
|
517
|
|
|
518 /* An error was signaled. Maybe call the debugger, if the `debug-on-error'
|
|
|
519 etc. variables call for this. CONDITIONS is the list of conditions
|
|
|
520 associated with the error being signalled. SIG is the actual error
|
|
|
521 being signalled, and DATA is the associated data (these are exactly
|
|
|
522 the same as the arguments to `signal'). ACTIVE_HANDLERS is the
|
|
|
523 list of error handlers that are to be put in place while the debugger
|
|
|
524 is called. This is generally the remaining handlers that are
|
|
|
525 outside of the innermost handler trapping this error. This way,
|
|
|
526 if the same error occurs inside of the debugger, you usually don't get
|
|
|
527 the debugger entered recursively.
|
|
|
528
|
|
|
529 This function returns Qunbound if it didn't call the debugger or if
|
|
|
530 the user asked (through 'c') that XEmacs should pretend like the
|
|
|
531 debugger was never entered. Otherwise, it returns the value
|
|
|
532 that the user specified with `r'. (Note that much of the time,
|
|
|
533 the user will abort with C-], and we will never have a chance to
|
|
|
534 return anything at all.)
|
|
|
535
|
|
|
536 SIGNAL_VARS_ONLY means we should only look at debug-on-signal
|
|
|
537 and stack-trace-on-signal to control whether we do anything.
|
|
|
538 This is so that debug-on-error doesn't make handled errors
|
|
|
539 cause the debugger to get invoked.
|
|
|
540
|
|
|
541 STACK_TRACE_DISPLAYED and DEBUGGER_ENTERED are used so that
|
|
|
542 those functions aren't done more than once in a single `signal'
|
|
|
543 session. */
|
|
|
544
|
|
|
545 static Lisp_Object
|
|
|
546 signal_call_debugger (Lisp_Object conditions,
|
|
|
547 Lisp_Object sig, Lisp_Object data,
|
|
|
548 Lisp_Object active_handlers,
|
|
|
549 int signal_vars_only,
|
|
|
550 int *stack_trace_displayed,
|
|
|
551 int *debugger_entered)
|
|
|
552 {
|
|
|
553 /* This function can GC */
|
|
|
554 Lisp_Object val = Qunbound;
|
|
|
555 Lisp_Object all_handlers = Vcondition_handlers;
|
|
|
556 Lisp_Object temp_data = Qnil;
|
|
|
557 int speccount = specpdl_depth();
|
|
|
558 struct gcpro gcpro1, gcpro2;
|
|
|
559 GCPRO2 (all_handlers, temp_data);
|
|
|
560
|
|
|
561 Vcondition_handlers = active_handlers;
|
|
|
562
|
|
|
563 temp_data = Fcons (sig, data); /* needed for skip_debugger */
|
|
|
564
|
|
|
565 if (!entering_debugger && !*stack_trace_displayed && !signal_vars_only
|
|
|
566 && wants_debugger (Vstack_trace_on_error, conditions)
|
|
|
567 && !skip_debugger (conditions, temp_data))
|
|
|
568 {
|
|
|
569 specbind (Qdebug_on_error, Qnil);
|
|
|
570 specbind (Qstack_trace_on_error, Qnil);
|
|
|
571 specbind (Qdebug_on_signal, Qnil);
|
|
|
572 specbind (Qstack_trace_on_signal, Qnil);
|
|
|
573
|
|
442
|
574 if (!noninteractive)
|
|
|
575 internal_with_output_to_temp_buffer (build_string ("*Backtrace*"),
|
|
|
576 backtrace_259,
|
|
|
577 Qnil,
|
|
|
578 Qnil);
|
|
|
579 else /* in batch mode, we want this going to stderr. */
|
|
|
580 backtrace_259 (Qnil);
|
|
771
|
581 unbind_to (speccount);
|
|
428
|
582 *stack_trace_displayed = 1;
|
|
|
583 }
|
|
|
584
|
|
|
585 if (!entering_debugger && !*debugger_entered && !signal_vars_only
|
|
|
586 && (EQ (sig, Qquit)
|
|
|
587 ? debug_on_quit
|
|
|
588 : wants_debugger (Vdebug_on_error, conditions))
|
|
|
589 && !skip_debugger (conditions, temp_data))
|
|
|
590 {
|
|
|
591 debug_on_quit &= ~2; /* reset critical bit */
|
|
|
592 specbind (Qdebug_on_error, Qnil);
|
|
|
593 specbind (Qstack_trace_on_error, Qnil);
|
|
|
594 specbind (Qdebug_on_signal, Qnil);
|
|
|
595 specbind (Qstack_trace_on_signal, Qnil);
|
|
|
596
|
|
|
597 val = call_debugger (list2 (Qerror, (Fcons (sig, data))));
|
|
|
598 *debugger_entered = 1;
|
|
|
599 }
|
|
|
600
|
|
|
601 if (!entering_debugger && !*stack_trace_displayed
|
|
|
602 && wants_debugger (Vstack_trace_on_signal, conditions))
|
|
|
603 {
|
|
|
604 specbind (Qdebug_on_error, Qnil);
|
|
|
605 specbind (Qstack_trace_on_error, Qnil);
|
|
|
606 specbind (Qdebug_on_signal, Qnil);
|
|
|
607 specbind (Qstack_trace_on_signal, Qnil);
|
|
|
608
|
|
442
|
609 if (!noninteractive)
|
|
|
610 internal_with_output_to_temp_buffer (build_string ("*Backtrace*"),
|
|
|
611 backtrace_259,
|
|
|
612 Qnil,
|
|
|
613 Qnil);
|
|
|
614 else /* in batch mode, we want this going to stderr. */
|
|
|
615 backtrace_259 (Qnil);
|
|
771
|
616 unbind_to (speccount);
|
|
428
|
617 *stack_trace_displayed = 1;
|
|
|
618 }
|
|
|
619
|
|
|
620 if (!entering_debugger && !*debugger_entered
|
|
|
621 && (EQ (sig, Qquit)
|
|
|
622 ? debug_on_quit
|
|
|
623 : wants_debugger (Vdebug_on_signal, conditions)))
|
|
|
624 {
|
|
|
625 debug_on_quit &= ~2; /* reset critical bit */
|
|
|
626 specbind (Qdebug_on_error, Qnil);
|
|
|
627 specbind (Qstack_trace_on_error, Qnil);
|
|
|
628 specbind (Qdebug_on_signal, Qnil);
|
|
|
629 specbind (Qstack_trace_on_signal, Qnil);
|
|
|
630
|
|
|
631 val = call_debugger (list2 (Qerror, (Fcons (sig, data))));
|
|
|
632 *debugger_entered = 1;
|
|
|
633 }
|
|
|
634
|
|
|
635 UNGCPRO;
|
|
|
636 Vcondition_handlers = all_handlers;
|
|
771
|
637 return unbind_to_1 (speccount, val);
|
|
428
|
638 }
|
|
|
639
|
|
|
640
|
|
|
641 /************************************************************************/
|
|
|
642 /* The basic special forms */
|
|
|
643 /************************************************************************/
|
|
|
644
|
|
|
645 /* Except for Fprogn(), the basic special forms below are only called
|
|
|
646 from interpreted code. The byte compiler turns them into bytecodes. */
|
|
|
647
|
|
|
648 DEFUN ("or", For, 0, UNEVALLED, 0, /*
|
|
|
649 Eval args until one of them yields non-nil, then return that value.
|
|
|
650 The remaining args are not evalled at all.
|
|
|
651 If all args return nil, return nil.
|
|
|
652 */
|
|
|
653 (args))
|
|
|
654 {
|
|
|
655 /* This function can GC */
|
|
442
|
656 REGISTER Lisp_Object val;
|
|
428
|
657
|
|
|
658 LIST_LOOP_2 (arg, args)
|
|
|
659 {
|
|
|
660 if (!NILP (val = Feval (arg)))
|
|
|
661 return val;
|
|
|
662 }
|
|
|
663
|
|
|
664 return Qnil;
|
|
|
665 }
|
|
|
666
|
|
|
667 DEFUN ("and", Fand, 0, UNEVALLED, 0, /*
|
|
|
668 Eval args until one of them yields nil, then return nil.
|
|
|
669 The remaining args are not evalled at all.
|
|
|
670 If no arg yields nil, return the last arg's value.
|
|
|
671 */
|
|
|
672 (args))
|
|
|
673 {
|
|
|
674 /* This function can GC */
|
|
442
|
675 REGISTER Lisp_Object val = Qt;
|
|
428
|
676
|
|
|
677 LIST_LOOP_2 (arg, args)
|
|
|
678 {
|
|
|
679 if (NILP (val = Feval (arg)))
|
|
|
680 return val;
|
|
|
681 }
|
|
|
682
|
|
|
683 return val;
|
|
|
684 }
|
|
|
685
|
|
|
686 DEFUN ("if", Fif, 2, UNEVALLED, 0, /*
|
|
|
687 \(if COND THEN ELSE...): if COND yields non-nil, do THEN, else do ELSE...
|
|
|
688 Returns the value of THEN or the value of the last of the ELSE's.
|
|
|
689 THEN must be one expression, but ELSE... can be zero or more expressions.
|
|
|
690 If COND yields nil, and there are no ELSE's, the value is nil.
|
|
|
691 */
|
|
|
692 (args))
|
|
|
693 {
|
|
|
694 /* This function can GC */
|
|
|
695 Lisp_Object condition = XCAR (args);
|
|
|
696 Lisp_Object then_form = XCAR (XCDR (args));
|
|
|
697 Lisp_Object else_forms = XCDR (XCDR (args));
|
|
|
698
|
|
|
699 if (!NILP (Feval (condition)))
|
|
|
700 return Feval (then_form);
|
|
|
701 else
|
|
|
702 return Fprogn (else_forms);
|
|
|
703 }
|
|
|
704
|
|
|
705 /* Macros `when' and `unless' are trivially defined in Lisp,
|
|
|
706 but it helps for bootstrapping to have them ALWAYS defined. */
|
|
|
707
|
|
|
708 DEFUN ("when", Fwhen, 1, MANY, 0, /*
|
|
|
709 \(when COND BODY...): if COND yields non-nil, do BODY, else return nil.
|
|
|
710 BODY can be zero or more expressions. If BODY is nil, return nil.
|
|
|
711 */
|
|
|
712 (int nargs, Lisp_Object *args))
|
|
|
713 {
|
|
|
714 Lisp_Object cond = args[0];
|
|
|
715 Lisp_Object body;
|
|
|
716
|
|
|
717 switch (nargs)
|
|
|
718 {
|
|
|
719 case 1: body = Qnil; break;
|
|
|
720 case 2: body = args[1]; break;
|
|
|
721 default: body = Fcons (Qprogn, Flist (nargs-1, args+1)); break;
|
|
|
722 }
|
|
|
723
|
|
|
724 return list3 (Qif, cond, body);
|
|
|
725 }
|
|
|
726
|
|
|
727 DEFUN ("unless", Funless, 1, MANY, 0, /*
|
|
|
728 \(unless COND BODY...): if COND yields nil, do BODY, else return nil.
|
|
|
729 BODY can be zero or more expressions. If BODY is nil, return nil.
|
|
|
730 */
|
|
|
731 (int nargs, Lisp_Object *args))
|
|
|
732 {
|
|
|
733 Lisp_Object cond = args[0];
|
|
|
734 Lisp_Object body = Flist (nargs-1, args+1);
|
|
|
735 return Fcons (Qif, Fcons (cond, Fcons (Qnil, body)));
|
|
|
736 }
|
|
|
737
|
|
|
738 DEFUN ("cond", Fcond, 0, UNEVALLED, 0, /*
|
|
444
|
739 \(cond CLAUSES...): try each clause until one succeeds.
|
|
428
|
740 Each clause looks like (CONDITION BODY...). CONDITION is evaluated
|
|
|
741 and, if the value is non-nil, this clause succeeds:
|
|
|
742 then the expressions in BODY are evaluated and the last one's
|
|
|
743 value is the value of the cond-form.
|
|
|
744 If no clause succeeds, cond returns nil.
|
|
|
745 If a clause has one element, as in (CONDITION),
|
|
|
746 CONDITION's value if non-nil is returned from the cond-form.
|
|
|
747 */
|
|
|
748 (args))
|
|
|
749 {
|
|
|
750 /* This function can GC */
|
|
442
|
751 REGISTER Lisp_Object val;
|
|
428
|
752
|
|
|
753 LIST_LOOP_2 (clause, args)
|
|
|
754 {
|
|
|
755 CHECK_CONS (clause);
|
|
|
756 if (!NILP (val = Feval (XCAR (clause))))
|
|
|
757 {
|
|
|
758 if (!NILP (clause = XCDR (clause)))
|
|
|
759 {
|
|
|
760 CHECK_TRUE_LIST (clause);
|
|
|
761 val = Fprogn (clause);
|
|
|
762 }
|
|
|
763 return val;
|
|
|
764 }
|
|
|
765 }
|
|
|
766
|
|
|
767 return Qnil;
|
|
|
768 }
|
|
|
769
|
|
|
770 DEFUN ("progn", Fprogn, 0, UNEVALLED, 0, /*
|
|
|
771 \(progn BODY...): eval BODY forms sequentially and return value of last one.
|
|
|
772 */
|
|
|
773 (args))
|
|
|
774 {
|
|
|
775 /* This function can GC */
|
|
|
776 /* Caller must provide a true list in ARGS */
|
|
442
|
777 REGISTER Lisp_Object val = Qnil;
|
|
428
|
778 struct gcpro gcpro1;
|
|
|
779
|
|
|
780 GCPRO1 (args);
|
|
|
781
|
|
|
782 {
|
|
|
783 LIST_LOOP_2 (form, args)
|
|
|
784 val = Feval (form);
|
|
|
785 }
|
|
|
786
|
|
|
787 UNGCPRO;
|
|
|
788 return val;
|
|
|
789 }
|
|
|
790
|
|
|
791 /* Fprog1() is the canonical example of a function that must GCPRO a
|
|
|
792 Lisp_Object across calls to Feval(). */
|
|
|
793
|
|
|
794 DEFUN ("prog1", Fprog1, 1, UNEVALLED, 0, /*
|
|
|
795 Similar to `progn', but the value of the first form is returned.
|
|
|
796 \(prog1 FIRST BODY...): All the arguments are evaluated sequentially.
|
|
|
797 The value of FIRST is saved during evaluation of the remaining args,
|
|
|
798 whose values are discarded.
|
|
|
799 */
|
|
|
800 (args))
|
|
|
801 {
|
|
|
802 /* This function can GC */
|
|
442
|
803 REGISTER Lisp_Object val;
|
|
428
|
804 struct gcpro gcpro1;
|
|
|
805
|
|
|
806 val = Feval (XCAR (args));
|
|
|
807
|
|
|
808 GCPRO1 (val);
|
|
|
809
|
|
|
810 {
|
|
|
811 LIST_LOOP_2 (form, XCDR (args))
|
|
|
812 Feval (form);
|
|
|
813 }
|
|
|
814
|
|
|
815 UNGCPRO;
|
|
|
816 return val;
|
|
|
817 }
|
|
|
818
|
|
|
819 DEFUN ("prog2", Fprog2, 2, UNEVALLED, 0, /*
|
|
|
820 Similar to `progn', but the value of the second form is returned.
|
|
|
821 \(prog2 FIRST SECOND BODY...): All the arguments are evaluated sequentially.
|
|
|
822 The value of SECOND is saved during evaluation of the remaining args,
|
|
|
823 whose values are discarded.
|
|
|
824 */
|
|
|
825 (args))
|
|
|
826 {
|
|
|
827 /* This function can GC */
|
|
442
|
828 REGISTER Lisp_Object val;
|
|
428
|
829 struct gcpro gcpro1;
|
|
|
830
|
|
|
831 Feval (XCAR (args));
|
|
|
832 args = XCDR (args);
|
|
|
833 val = Feval (XCAR (args));
|
|
|
834 args = XCDR (args);
|
|
|
835
|
|
|
836 GCPRO1 (val);
|
|
|
837
|
|
442
|
838 {
|
|
|
839 LIST_LOOP_2 (form, args)
|
|
|
840 Feval (form);
|
|
|
841 }
|
|
428
|
842
|
|
|
843 UNGCPRO;
|
|
|
844 return val;
|
|
|
845 }
|
|
|
846
|
|
|
847 DEFUN ("let*", FletX, 1, UNEVALLED, 0, /*
|
|
|
848 \(let* VARLIST BODY...): bind variables according to VARLIST then eval BODY.
|
|
|
849 The value of the last form in BODY is returned.
|
|
|
850 Each element of VARLIST is a symbol (which is bound to nil)
|
|
|
851 or a list (SYMBOL VALUEFORM) (which binds SYMBOL to the value of VALUEFORM).
|
|
|
852 Each VALUEFORM can refer to the symbols already bound by this VARLIST.
|
|
|
853 */
|
|
|
854 (args))
|
|
|
855 {
|
|
|
856 /* This function can GC */
|
|
|
857 Lisp_Object varlist = XCAR (args);
|
|
|
858 Lisp_Object body = XCDR (args);
|
|
|
859 int speccount = specpdl_depth();
|
|
|
860
|
|
|
861 EXTERNAL_LIST_LOOP_3 (var, varlist, tail)
|
|
|
862 {
|
|
|
863 Lisp_Object symbol, value, tem;
|
|
|
864 if (SYMBOLP (var))
|
|
|
865 symbol = var, value = Qnil;
|
|
|
866 else
|
|
|
867 {
|
|
|
868 CHECK_CONS (var);
|
|
|
869 symbol = XCAR (var);
|
|
|
870 tem = XCDR (var);
|
|
|
871 if (NILP (tem))
|
|
|
872 value = Qnil;
|
|
|
873 else
|
|
|
874 {
|
|
|
875 CHECK_CONS (tem);
|
|
|
876 value = Feval (XCAR (tem));
|
|
|
877 if (!NILP (XCDR (tem)))
|
|
563
|
878 sferror
|
|
428
|
879 ("`let' bindings can have only one value-form", var);
|
|
|
880 }
|
|
|
881 }
|
|
|
882 specbind (symbol, value);
|
|
|
883 }
|
|
771
|
884 return unbind_to_1 (speccount, Fprogn (body));
|
|
428
|
885 }
|
|
|
886
|
|
|
887 DEFUN ("let", Flet, 1, UNEVALLED, 0, /*
|
|
|
888 \(let VARLIST BODY...): bind variables according to VARLIST then eval BODY.
|
|
|
889 The value of the last form in BODY is returned.
|
|
|
890 Each element of VARLIST is a symbol (which is bound to nil)
|
|
|
891 or a list (SYMBOL VALUEFORM) (which binds SYMBOL to the value of VALUEFORM).
|
|
|
892 All the VALUEFORMs are evalled before any symbols are bound.
|
|
|
893 */
|
|
|
894 (args))
|
|
|
895 {
|
|
|
896 /* This function can GC */
|
|
|
897 Lisp_Object varlist = XCAR (args);
|
|
|
898 Lisp_Object body = XCDR (args);
|
|
|
899 int speccount = specpdl_depth();
|
|
|
900 Lisp_Object *temps;
|
|
|
901 int idx;
|
|
|
902 struct gcpro gcpro1;
|
|
|
903
|
|
|
904 /* Make space to hold the values to give the bound variables. */
|
|
|
905 {
|
|
|
906 int varcount;
|
|
|
907 GET_EXTERNAL_LIST_LENGTH (varlist, varcount);
|
|
|
908 temps = alloca_array (Lisp_Object, varcount);
|
|
|
909 }
|
|
|
910
|
|
|
911 /* Compute the values and store them in `temps' */
|
|
|
912 GCPRO1 (*temps);
|
|
|
913 gcpro1.nvars = 0;
|
|
|
914
|
|
|
915 idx = 0;
|
|
442
|
916 {
|
|
|
917 LIST_LOOP_2 (var, varlist)
|
|
|
918 {
|
|
|
919 Lisp_Object *value = &temps[idx++];
|
|
|
920 if (SYMBOLP (var))
|
|
|
921 *value = Qnil;
|
|
|
922 else
|
|
|
923 {
|
|
|
924 Lisp_Object tem;
|
|
|
925 CHECK_CONS (var);
|
|
|
926 tem = XCDR (var);
|
|
|
927 if (NILP (tem))
|
|
|
928 *value = Qnil;
|
|
|
929 else
|
|
|
930 {
|
|
|
931 CHECK_CONS (tem);
|
|
|
932 *value = Feval (XCAR (tem));
|
|
|
933 gcpro1.nvars = idx;
|
|
|
934
|
|
|
935 if (!NILP (XCDR (tem)))
|
|
563
|
936 sferror
|
|
442
|
937 ("`let' bindings can have only one value-form", var);
|
|
|
938 }
|
|
|
939 }
|
|
|
940 }
|
|
|
941 }
|
|
428
|
942
|
|
|
943 idx = 0;
|
|
442
|
944 {
|
|
|
945 LIST_LOOP_2 (var, varlist)
|
|
|
946 {
|
|
|
947 specbind (SYMBOLP (var) ? var : XCAR (var), temps[idx++]);
|
|
|
948 }
|
|
|
949 }
|
|
428
|
950
|
|
|
951 UNGCPRO;
|
|
|
952
|
|
771
|
953 return unbind_to_1 (speccount, Fprogn (body));
|
|
428
|
954 }
|
|
|
955
|
|
|
956 DEFUN ("while", Fwhile, 1, UNEVALLED, 0, /*
|
|
|
957 \(while TEST BODY...): if TEST yields non-nil, eval BODY... and repeat.
|
|
|
958 The order of execution is thus TEST, BODY, TEST, BODY and so on
|
|
|
959 until TEST returns nil.
|
|
|
960 */
|
|
|
961 (args))
|
|
|
962 {
|
|
|
963 /* This function can GC */
|
|
|
964 Lisp_Object test = XCAR (args);
|
|
|
965 Lisp_Object body = XCDR (args);
|
|
|
966
|
|
|
967 while (!NILP (Feval (test)))
|
|
|
968 {
|
|
|
969 QUIT;
|
|
|
970 Fprogn (body);
|
|
|
971 }
|
|
|
972
|
|
|
973 return Qnil;
|
|
|
974 }
|
|
|
975
|
|
|
976 DEFUN ("setq", Fsetq, 0, UNEVALLED, 0, /*
|
|
|
977 \(setq SYM VAL SYM VAL ...): set each SYM to the value of its VAL.
|
|
|
978 The symbols SYM are variables; they are literal (not evaluated).
|
|
|
979 The values VAL are expressions; they are evaluated.
|
|
|
980 Thus, (setq x (1+ y)) sets `x' to the value of `(1+ y)'.
|
|
|
981 The second VAL is not computed until after the first SYM is set, and so on;
|
|
|
982 each VAL can use the new value of variables set earlier in the `setq'.
|
|
|
983 The return value of the `setq' form is the value of the last VAL.
|
|
|
984 */
|
|
|
985 (args))
|
|
|
986 {
|
|
|
987 /* This function can GC */
|
|
|
988 Lisp_Object symbol, tail, val = Qnil;
|
|
|
989 int nargs;
|
|
|
990 struct gcpro gcpro1;
|
|
|
991
|
|
|
992 GET_LIST_LENGTH (args, nargs);
|
|
|
993
|
|
|
994 if (nargs & 1) /* Odd number of arguments? */
|
|
|
995 Fsignal (Qwrong_number_of_arguments, list2 (Qsetq, make_int (nargs)));
|
|
|
996
|
|
|
997 GCPRO1 (val);
|
|
|
998
|
|
|
999 PROPERTY_LIST_LOOP (tail, symbol, val, args)
|
|
|
1000 {
|
|
|
1001 val = Feval (val);
|
|
|
1002 Fset (symbol, val);
|
|
|
1003 }
|
|
|
1004
|
|
|
1005 UNGCPRO;
|
|
|
1006 return val;
|
|
|
1007 }
|
|
|
1008
|
|
|
1009 DEFUN ("quote", Fquote, 1, UNEVALLED, 0, /*
|
|
|
1010 Return the argument, without evaluating it. `(quote x)' yields `x'.
|
|
|
1011 */
|
|
|
1012 (args))
|
|
|
1013 {
|
|
|
1014 return XCAR (args);
|
|
|
1015 }
|
|
|
1016
|
|
|
1017 DEFUN ("function", Ffunction, 1, UNEVALLED, 0, /*
|
|
|
1018 Like `quote', but preferred for objects which are functions.
|
|
|
1019 In byte compilation, `function' causes its argument to be compiled.
|
|
|
1020 `quote' cannot do that.
|
|
|
1021 */
|
|
|
1022 (args))
|
|
|
1023 {
|
|
|
1024 return XCAR (args);
|
|
|
1025 }
|
|
|
1026
|
|
|
1027
|
|
|
1028 /************************************************************************/
|
|
|
1029 /* Defining functions/variables */
|
|
|
1030 /************************************************************************/
|
|
|
1031 static Lisp_Object
|
|
|
1032 define_function (Lisp_Object name, Lisp_Object defn)
|
|
|
1033 {
|
|
|
1034 Ffset (name, defn);
|
|
|
1035 LOADHIST_ATTACH (name);
|
|
|
1036 return name;
|
|
|
1037 }
|
|
|
1038
|
|
|
1039 DEFUN ("defun", Fdefun, 2, UNEVALLED, 0, /*
|
|
|
1040 \(defun NAME ARGLIST [DOCSTRING] BODY...): define NAME as a function.
|
|
|
1041 The definition is (lambda ARGLIST [DOCSTRING] BODY...).
|
|
|
1042 See also the function `interactive'.
|
|
|
1043 */
|
|
|
1044 (args))
|
|
|
1045 {
|
|
|
1046 /* This function can GC */
|
|
|
1047 return define_function (XCAR (args),
|
|
|
1048 Fcons (Qlambda, XCDR (args)));
|
|
|
1049 }
|
|
|
1050
|
|
|
1051 DEFUN ("defmacro", Fdefmacro, 2, UNEVALLED, 0, /*
|
|
|
1052 \(defmacro NAME ARGLIST [DOCSTRING] BODY...): define NAME as a macro.
|
|
|
1053 The definition is (macro lambda ARGLIST [DOCSTRING] BODY...).
|
|
|
1054 When the macro is called, as in (NAME ARGS...),
|
|
|
1055 the function (lambda ARGLIST BODY...) is applied to
|
|
|
1056 the list ARGS... as it appears in the expression,
|
|
|
1057 and the result should be a form to be evaluated instead of the original.
|
|
|
1058 */
|
|
|
1059 (args))
|
|
|
1060 {
|
|
|
1061 /* This function can GC */
|
|
|
1062 return define_function (XCAR (args),
|
|
|
1063 Fcons (Qmacro, Fcons (Qlambda, XCDR (args))));
|
|
|
1064 }
|
|
|
1065
|
|
|
1066 DEFUN ("defvar", Fdefvar, 1, UNEVALLED, 0, /*
|
|
|
1067 \(defvar SYMBOL INITVALUE DOCSTRING): define SYMBOL as a variable.
|
|
|
1068 You are not required to define a variable in order to use it,
|
|
|
1069 but the definition can supply documentation and an initial value
|
|
|
1070 in a way that tags can recognize.
|
|
|
1071
|
|
|
1072 INITVALUE is evaluated, and used to set SYMBOL, only if SYMBOL's value is
|
|
|
1073 void. (However, when you evaluate a defvar interactively, it acts like a
|
|
|
1074 defconst: SYMBOL's value is always set regardless of whether it's currently
|
|
|
1075 void.)
|
|
|
1076 If SYMBOL is buffer-local, its default value is what is set;
|
|
|
1077 buffer-local values are not affected.
|
|
|
1078 INITVALUE and DOCSTRING are optional.
|
|
|
1079 If DOCSTRING starts with *, this variable is identified as a user option.
|
|
442
|
1080 This means that M-x set-variable recognizes it.
|
|
428
|
1081 If INITVALUE is missing, SYMBOL's value is not set.
|
|
|
1082
|
|
|
1083 In lisp-interaction-mode defvar is treated as defconst.
|
|
|
1084 */
|
|
|
1085 (args))
|
|
|
1086 {
|
|
|
1087 /* This function can GC */
|
|
|
1088 Lisp_Object sym = XCAR (args);
|
|
|
1089
|
|
|
1090 if (!NILP (args = XCDR (args)))
|
|
|
1091 {
|
|
|
1092 Lisp_Object val = XCAR (args);
|
|
|
1093
|
|
|
1094 if (NILP (Fdefault_boundp (sym)))
|
|
|
1095 {
|
|
|
1096 struct gcpro gcpro1;
|
|
|
1097 GCPRO1 (val);
|
|
|
1098 val = Feval (val);
|
|
|
1099 Fset_default (sym, val);
|
|
|
1100 UNGCPRO;
|
|
|
1101 }
|
|
|
1102
|
|
|
1103 if (!NILP (args = XCDR (args)))
|
|
|
1104 {
|
|
|
1105 Lisp_Object doc = XCAR (args);
|
|
|
1106 Fput (sym, Qvariable_documentation, doc);
|
|
|
1107 if (!NILP (args = XCDR (args)))
|
|
563
|
1108 signal_error (Qwrong_number_of_arguments, "too many arguments", Qunbound);
|
|
428
|
1109 }
|
|
|
1110 }
|
|
|
1111
|
|
|
1112 #ifdef I18N3
|
|
|
1113 if (!NILP (Vfile_domain))
|
|
|
1114 Fput (sym, Qvariable_domain, Vfile_domain);
|
|
|
1115 #endif
|
|
|
1116
|
|
|
1117 LOADHIST_ATTACH (sym);
|
|
|
1118 return sym;
|
|
|
1119 }
|
|
|
1120
|
|
|
1121 DEFUN ("defconst", Fdefconst, 2, UNEVALLED, 0, /*
|
|
|
1122 \(defconst SYMBOL INITVALUE DOCSTRING): define SYMBOL as a constant
|
|
|
1123 variable.
|
|
|
1124 The intent is that programs do not change this value, but users may.
|
|
|
1125 Always sets the value of SYMBOL to the result of evalling INITVALUE.
|
|
|
1126 If SYMBOL is buffer-local, its default value is what is set;
|
|
|
1127 buffer-local values are not affected.
|
|
|
1128 DOCSTRING is optional.
|
|
|
1129 If DOCSTRING starts with *, this variable is identified as a user option.
|
|
442
|
1130 This means that M-x set-variable recognizes it.
|
|
428
|
1131
|
|
|
1132 Note: do not use `defconst' for user options in libraries that are not
|
|
|
1133 normally loaded, since it is useful for users to be able to specify
|
|
|
1134 their own values for such variables before loading the library.
|
|
|
1135 Since `defconst' unconditionally assigns the variable,
|
|
|
1136 it would override the user's choice.
|
|
|
1137 */
|
|
|
1138 (args))
|
|
|
1139 {
|
|
|
1140 /* This function can GC */
|
|
|
1141 Lisp_Object sym = XCAR (args);
|
|
|
1142 Lisp_Object val = Feval (XCAR (args = XCDR (args)));
|
|
|
1143 struct gcpro gcpro1;
|
|
|
1144
|
|
|
1145 GCPRO1 (val);
|
|
|
1146
|
|
|
1147 Fset_default (sym, val);
|
|
|
1148
|
|
|
1149 UNGCPRO;
|
|
|
1150
|
|
|
1151 if (!NILP (args = XCDR (args)))
|
|
|
1152 {
|
|
|
1153 Lisp_Object doc = XCAR (args);
|
|
|
1154 Fput (sym, Qvariable_documentation, doc);
|
|
|
1155 if (!NILP (args = XCDR (args)))
|
|
563
|
1156 signal_error (Qwrong_number_of_arguments, "too many arguments", Qunbound);
|
|
428
|
1157 }
|
|
|
1158
|
|
|
1159 #ifdef I18N3
|
|
|
1160 if (!NILP (Vfile_domain))
|
|
|
1161 Fput (sym, Qvariable_domain, Vfile_domain);
|
|
|
1162 #endif
|
|
|
1163
|
|
|
1164 LOADHIST_ATTACH (sym);
|
|
|
1165 return sym;
|
|
|
1166 }
|
|
|
1167
|
|
|
1168 DEFUN ("user-variable-p", Fuser_variable_p, 1, 1, 0, /*
|
|
|
1169 Return t if VARIABLE is intended to be set and modified by users.
|
|
|
1170 \(The alternative is a variable used internally in a Lisp program.)
|
|
|
1171 Determined by whether the first character of the documentation
|
|
|
1172 for the variable is `*'.
|
|
|
1173 */
|
|
|
1174 (variable))
|
|
|
1175 {
|
|
|
1176 Lisp_Object documentation = Fget (variable, Qvariable_documentation, Qnil);
|
|
|
1177
|
|
|
1178 return
|
|
|
1179 ((INTP (documentation) && XINT (documentation) < 0) ||
|
|
|
1180
|
|
|
1181 (STRINGP (documentation) &&
|
|
793
|
1182 (XSTRING_BYTE (documentation, 0) == '*')) ||
|
|
428
|
1183
|
|
|
1184 /* If (STRING . INTEGER), a negative integer means a user variable. */
|
|
|
1185 (CONSP (documentation)
|
|
|
1186 && STRINGP (XCAR (documentation))
|
|
|
1187 && INTP (XCDR (documentation))
|
|
|
1188 && XINT (XCDR (documentation)) < 0)) ?
|
|
|
1189 Qt : Qnil;
|
|
|
1190 }
|
|
|
1191
|
|
|
1192 DEFUN ("macroexpand-internal", Fmacroexpand_internal, 1, 2, 0, /*
|
|
|
1193 Return result of expanding macros at top level of FORM.
|
|
|
1194 If FORM is not a macro call, it is returned unchanged.
|
|
|
1195 Otherwise, the macro is expanded and the expansion is considered
|
|
|
1196 in place of FORM. When a non-macro-call results, it is returned.
|
|
|
1197
|
|
442
|
1198 The second optional arg ENVIRONMENT specifies an environment of macro
|
|
428
|
1199 definitions to shadow the loaded ones for use in file byte-compilation.
|
|
|
1200 */
|
|
442
|
1201 (form, environment))
|
|
428
|
1202 {
|
|
|
1203 /* This function can GC */
|
|
|
1204 /* With cleanups from Hallvard Furuseth. */
|
|
|
1205 REGISTER Lisp_Object expander, sym, def, tem;
|
|
|
1206
|
|
|
1207 while (1)
|
|
|
1208 {
|
|
|
1209 /* Come back here each time we expand a macro call,
|
|
|
1210 in case it expands into another macro call. */
|
|
|
1211 if (!CONSP (form))
|
|
|
1212 break;
|
|
|
1213 /* Set SYM, give DEF and TEM right values in case SYM is not a symbol. */
|
|
|
1214 def = sym = XCAR (form);
|
|
|
1215 tem = Qnil;
|
|
|
1216 /* Trace symbols aliases to other symbols
|
|
|
1217 until we get a symbol that is not an alias. */
|
|
|
1218 while (SYMBOLP (def))
|
|
|
1219 {
|
|
|
1220 QUIT;
|
|
|
1221 sym = def;
|
|
442
|
1222 tem = Fassq (sym, environment);
|
|
428
|
1223 if (NILP (tem))
|
|
|
1224 {
|
|
|
1225 def = XSYMBOL (sym)->function;
|
|
|
1226 if (!UNBOUNDP (def))
|
|
|
1227 continue;
|
|
|
1228 }
|
|
|
1229 break;
|
|
|
1230 }
|
|
442
|
1231 /* Right now TEM is the result from SYM in ENVIRONMENT,
|
|
428
|
1232 and if TEM is nil then DEF is SYM's function definition. */
|
|
|
1233 if (NILP (tem))
|
|
|
1234 {
|
|
442
|
1235 /* SYM is not mentioned in ENVIRONMENT.
|
|
428
|
1236 Look at its function definition. */
|
|
|
1237 if (UNBOUNDP (def)
|
|
|
1238 || !CONSP (def))
|
|
|
1239 /* Not defined or definition not suitable */
|
|
|
1240 break;
|
|
|
1241 if (EQ (XCAR (def), Qautoload))
|
|
|
1242 {
|
|
|
1243 /* Autoloading function: will it be a macro when loaded? */
|
|
|
1244 tem = Felt (def, make_int (4));
|
|
|
1245 if (EQ (tem, Qt) || EQ (tem, Qmacro))
|
|
|
1246 {
|
|
|
1247 /* Yes, load it and try again. */
|
|
|
1248 do_autoload (def, sym);
|
|
|
1249 continue;
|
|
|
1250 }
|
|
|
1251 else
|
|
|
1252 break;
|
|
|
1253 }
|
|
|
1254 else if (!EQ (XCAR (def), Qmacro))
|
|
|
1255 break;
|
|
|
1256 else expander = XCDR (def);
|
|
|
1257 }
|
|
|
1258 else
|
|
|
1259 {
|
|
|
1260 expander = XCDR (tem);
|
|
|
1261 if (NILP (expander))
|
|
|
1262 break;
|
|
|
1263 }
|
|
|
1264 form = apply1 (expander, XCDR (form));
|
|
|
1265 }
|
|
|
1266 return form;
|
|
|
1267 }
|
|
|
1268
|
|
|
1269
|
|
|
1270 /************************************************************************/
|
|
|
1271 /* Non-local exits */
|
|
|
1272 /************************************************************************/
|
|
|
1273
|
|
|
1274 DEFUN ("catch", Fcatch, 1, UNEVALLED, 0, /*
|
|
|
1275 \(catch TAG BODY...): eval BODY allowing nonlocal exits using `throw'.
|
|
|
1276 TAG is evalled to get the tag to use. Then the BODY is executed.
|
|
|
1277 Within BODY, (throw TAG) with same tag exits BODY and exits this `catch'.
|
|
|
1278 If no throw happens, `catch' returns the value of the last BODY form.
|
|
|
1279 If a throw happens, it specifies the value to return from `catch'.
|
|
|
1280 */
|
|
|
1281 (args))
|
|
|
1282 {
|
|
|
1283 /* This function can GC */
|
|
|
1284 Lisp_Object tag = Feval (XCAR (args));
|
|
|
1285 Lisp_Object body = XCDR (args);
|
|
|
1286 return internal_catch (tag, Fprogn, body, 0);
|
|
|
1287 }
|
|
|
1288
|
|
|
1289 /* Set up a catch, then call C function FUNC on argument ARG.
|
|
|
1290 FUNC should return a Lisp_Object.
|
|
|
1291 This is how catches are done from within C code. */
|
|
|
1292
|
|
|
1293 Lisp_Object
|
|
|
1294 internal_catch (Lisp_Object tag,
|
|
|
1295 Lisp_Object (*func) (Lisp_Object arg),
|
|
|
1296 Lisp_Object arg,
|
|
|
1297 int * volatile threw)
|
|
|
1298 {
|
|
|
1299 /* This structure is made part of the chain `catchlist'. */
|
|
|
1300 struct catchtag c;
|
|
|
1301
|
|
|
1302 /* Fill in the components of c, and put it on the list. */
|
|
|
1303 c.next = catchlist;
|
|
|
1304 c.tag = tag;
|
|
|
1305 c.val = Qnil;
|
|
|
1306 c.backlist = backtrace_list;
|
|
|
1307 #if 0 /* FSFmacs */
|
|
|
1308 /* #### */
|
|
|
1309 c.handlerlist = handlerlist;
|
|
|
1310 #endif
|
|
|
1311 c.lisp_eval_depth = lisp_eval_depth;
|
|
|
1312 c.pdlcount = specpdl_depth();
|
|
|
1313 #if 0 /* FSFmacs */
|
|
|
1314 c.poll_suppress_count = async_timer_suppress_count;
|
|
|
1315 #endif
|
|
|
1316 c.gcpro = gcprolist;
|
|
|
1317 catchlist = &c;
|
|
|
1318
|
|
|
1319 /* Call FUNC. */
|
|
|
1320 if (SETJMP (c.jmp))
|
|
|
1321 {
|
|
|
1322 /* Throw works by a longjmp that comes right here. */
|
|
|
1323 if (threw) *threw = 1;
|
|
|
1324 return c.val;
|
|
|
1325 }
|
|
|
1326 c.val = (*func) (arg);
|
|
|
1327 if (threw) *threw = 0;
|
|
|
1328 catchlist = c.next;
|
|
442
|
1329 #ifdef ERROR_CHECK_TYPECHECK
|
|
|
1330 check_error_state_sanity ();
|
|
|
1331 #endif
|
|
428
|
1332 return c.val;
|
|
|
1333 }
|
|
|
1334
|
|
|
1335
|
|
|
1336 /* Unwind the specbind, catch, and handler stacks back to CATCH, and
|
|
|
1337 jump to that CATCH, returning VALUE as the value of that catch.
|
|
|
1338
|
|
|
1339 This is the guts Fthrow and Fsignal; they differ only in the way
|
|
|
1340 they choose the catch tag to throw to. A catch tag for a
|
|
|
1341 condition-case form has a TAG of Qnil.
|
|
|
1342
|
|
|
1343 Before each catch is discarded, unbind all special bindings and
|
|
|
1344 execute all unwind-protect clauses made above that catch. Unwind
|
|
|
1345 the handler stack as we go, so that the proper handlers are in
|
|
|
1346 effect for each unwind-protect clause we run. At the end, restore
|
|
|
1347 some static info saved in CATCH, and longjmp to the location
|
|
|
1348 specified in the
|
|
|
1349
|
|
|
1350 This is used for correct unwinding in Fthrow and Fsignal. */
|
|
|
1351
|
|
|
1352 static void
|
|
|
1353 unwind_to_catch (struct catchtag *c, Lisp_Object val)
|
|
|
1354 {
|
|
|
1355 REGISTER int last_time;
|
|
|
1356
|
|
|
1357 /* Unwind the specbind, catch, and handler stacks back to CATCH
|
|
|
1358 Before each catch is discarded, unbind all special bindings
|
|
|
1359 and execute all unwind-protect clauses made above that catch.
|
|
|
1360 At the end, restore some static info saved in CATCH,
|
|
|
1361 and longjmp to the location specified.
|
|
|
1362 */
|
|
|
1363
|
|
|
1364 /* Save the value somewhere it will be GC'ed.
|
|
|
1365 (Can't overwrite tag slot because an unwind-protect may
|
|
|
1366 want to throw to this same tag, which isn't yet invalid.) */
|
|
|
1367 c->val = val;
|
|
|
1368
|
|
|
1369 #if 0 /* FSFmacs */
|
|
|
1370 /* Restore the polling-suppression count. */
|
|
|
1371 set_poll_suppress_count (catch->poll_suppress_count);
|
|
|
1372 #endif
|
|
|
1373
|
|
617
|
1374 #if 1
|
|
428
|
1375 do
|
|
|
1376 {
|
|
|
1377 last_time = catchlist == c;
|
|
|
1378
|
|
|
1379 /* Unwind the specpdl stack, and then restore the proper set of
|
|
|
1380 handlers. */
|
|
771
|
1381 unbind_to (catchlist->pdlcount);
|
|
428
|
1382 catchlist = catchlist->next;
|
|
442
|
1383 #ifdef ERROR_CHECK_TYPECHECK
|
|
|
1384 check_error_state_sanity ();
|
|
|
1385 #endif
|
|
428
|
1386 }
|
|
|
1387 while (! last_time);
|
|
617
|
1388 #else
|
|
|
1389 /* Former XEmacs code. This is definitely not as correct because
|
|
|
1390 there may be a number of catches we're unwinding, and a number
|
|
|
1391 of unwind-protects in the process. By not undoing the catches till
|
|
|
1392 the end, there may be invalid catches still current. (This would
|
|
|
1393 be a particular problem with code like this:
|
|
|
1394
|
|
|
1395 (catch 'foo
|
|
|
1396 (call-some-code-which-does...
|
|
|
1397 (catch 'bar
|
|
|
1398 (unwind-protect
|
|
|
1399 (call-some-code-which-does...
|
|
|
1400 (catch 'bar
|
|
|
1401 (call-some-code-which-does...
|
|
|
1402 (throw 'foo nil))))
|
|
|
1403 (throw 'bar nil)))))
|
|
|
1404
|
|
|
1405 This would try to throw to the inner (catch 'bar)!
|
|
|
1406
|
|
|
1407 --ben
|
|
|
1408 */
|
|
428
|
1409 /* Unwind the specpdl stack */
|
|
771
|
1410 unbind_to (c->pdlcount);
|
|
428
|
1411 catchlist = c->next;
|
|
442
|
1412 #ifdef ERROR_CHECK_TYPECHECK
|
|
|
1413 check_error_state_sanity ();
|
|
|
1414 #endif
|
|
617
|
1415 #endif /* Former code */
|
|
428
|
1416
|
|
|
1417 gcprolist = c->gcpro;
|
|
|
1418 backtrace_list = c->backlist;
|
|
|
1419 lisp_eval_depth = c->lisp_eval_depth;
|
|
|
1420
|
|
442
|
1421 #ifdef DEFEND_AGAINST_THROW_RECURSION
|
|
428
|
1422 throw_level = 0;
|
|
|
1423 #endif
|
|
|
1424 LONGJMP (c->jmp, 1);
|
|
|
1425 }
|
|
|
1426
|
|
|
1427 static DOESNT_RETURN
|
|
|
1428 throw_or_bomb_out (Lisp_Object tag, Lisp_Object val, int bomb_out_p,
|
|
|
1429 Lisp_Object sig, Lisp_Object data)
|
|
|
1430 {
|
|
442
|
1431 #ifdef DEFEND_AGAINST_THROW_RECURSION
|
|
428
|
1432 /* die if we recurse more than is reasonable */
|
|
|
1433 if (++throw_level > 20)
|
|
793
|
1434 abort ();
|
|
428
|
1435 #endif
|
|
|
1436
|
|
|
1437 /* If bomb_out_p is t, this is being called from Fsignal as a
|
|
|
1438 "last resort" when there is no handler for this error and
|
|
|
1439 the debugger couldn't be invoked, so we are throwing to
|
|
|
1440 'top-level. If this tag doesn't exist (happens during the
|
|
|
1441 initialization stages) we would get in an infinite recursive
|
|
|
1442 Fsignal/Fthrow loop, so instead we bomb out to the
|
|
|
1443 really-early-error-handler.
|
|
|
1444
|
|
|
1445 Note that in fact the only time that the "last resort"
|
|
|
1446 occurs is when there's no catch for 'top-level -- the
|
|
|
1447 'top-level catch and the catch-all error handler are
|
|
|
1448 established at the same time, in initial_command_loop/
|
|
|
1449 top_level_1.
|
|
|
1450
|
|
|
1451 #### Fix this horrifitude!
|
|
|
1452 */
|
|
|
1453
|
|
|
1454 while (1)
|
|
|
1455 {
|
|
|
1456 REGISTER struct catchtag *c;
|
|
|
1457
|
|
|
1458 #if 0 /* FSFmacs */
|
|
|
1459 if (!NILP (tag)) /* #### */
|
|
|
1460 #endif
|
|
|
1461 for (c = catchlist; c; c = c->next)
|
|
|
1462 {
|
|
|
1463 if (EQ (c->tag, tag))
|
|
|
1464 unwind_to_catch (c, val);
|
|
|
1465 }
|
|
|
1466 if (!bomb_out_p)
|
|
|
1467 tag = Fsignal (Qno_catch, list2 (tag, val));
|
|
|
1468 else
|
|
|
1469 call1 (Qreally_early_error_handler, Fcons (sig, data));
|
|
|
1470 }
|
|
|
1471
|
|
|
1472 /* can't happen. who cares? - (Sun's compiler does) */
|
|
|
1473 /* throw_level--; */
|
|
|
1474 /* getting tired of compilation warnings */
|
|
|
1475 /* return Qnil; */
|
|
|
1476 }
|
|
|
1477
|
|
|
1478 /* See above, where CATCHLIST is defined, for a description of how
|
|
|
1479 Fthrow() works.
|
|
|
1480
|
|
|
1481 Fthrow() is also called by Fsignal(), to do a non-local jump
|
|
|
1482 back to the appropriate condition-case handler after (maybe)
|
|
|
1483 the debugger is entered. In that case, TAG is the value
|
|
|
1484 of Vcondition_handlers that was in place just after the
|
|
|
1485 condition-case handler was set up. The car of this will be
|
|
|
1486 some data referring to the handler: Its car will be Qunbound
|
|
|
1487 (thus, this tag can never be generated by Lisp code), and
|
|
|
1488 its CDR will be the HANDLERS argument to condition_case_1()
|
|
|
1489 (either Qerror, Qt, or a list of handlers as in `condition-case').
|
|
|
1490 This works fine because Fthrow() does not care what TAG was
|
|
|
1491 passed to it: it just looks up the catch list for something
|
|
|
1492 that is EQ() to TAG. When it finds it, it will longjmp()
|
|
|
1493 back to the place that established the catch (in this case,
|
|
|
1494 condition_case_1). See below for more info.
|
|
|
1495 */
|
|
|
1496
|
|
|
1497 DEFUN ("throw", Fthrow, 2, 2, 0, /*
|
|
444
|
1498 Throw to the catch for TAG and return VALUE from it.
|
|
428
|
1499 Both TAG and VALUE are evalled.
|
|
|
1500 */
|
|
444
|
1501 (tag, value))
|
|
|
1502 {
|
|
|
1503 throw_or_bomb_out (tag, value, 0, Qnil, Qnil); /* Doesn't return */
|
|
428
|
1504 return Qnil;
|
|
|
1505 }
|
|
|
1506
|
|
|
1507 DEFUN ("unwind-protect", Funwind_protect, 1, UNEVALLED, 0, /*
|
|
|
1508 Do BODYFORM, protecting with UNWINDFORMS.
|
|
|
1509 Usage looks like (unwind-protect BODYFORM UNWINDFORMS...).
|
|
|
1510 If BODYFORM completes normally, its value is returned
|
|
|
1511 after executing the UNWINDFORMS.
|
|
|
1512 If BODYFORM exits nonlocally, the UNWINDFORMS are executed anyway.
|
|
|
1513 */
|
|
|
1514 (args))
|
|
|
1515 {
|
|
|
1516 /* This function can GC */
|
|
|
1517 int speccount = specpdl_depth();
|
|
|
1518
|
|
|
1519 record_unwind_protect (Fprogn, XCDR (args));
|
|
771
|
1520 return unbind_to_1 (speccount, Feval (XCAR (args)));
|
|
428
|
1521 }
|
|
|
1522
|
|
|
1523
|
|
|
1524 /************************************************************************/
|
|
|
1525 /* Signalling and trapping errors */
|
|
|
1526 /************************************************************************/
|
|
|
1527
|
|
|
1528 static Lisp_Object
|
|
|
1529 condition_bind_unwind (Lisp_Object loser)
|
|
|
1530 {
|
|
617
|
1531 /* There is no problem freeing stuff here like there is in
|
|
|
1532 condition_case_unwind(), because there are no outside pointers
|
|
|
1533 (like the tag below in the catchlist) pointing to the objects. */
|
|
440
|
1534 Lisp_Cons *victim;
|
|
428
|
1535 /* ((handler-fun . handler-args) ... other handlers) */
|
|
|
1536 Lisp_Object tem = XCAR (loser);
|
|
|
1537
|
|
|
1538 while (CONSP (tem))
|
|
|
1539 {
|
|
|
1540 victim = XCONS (tem);
|
|
|
1541 tem = victim->cdr;
|
|
|
1542 free_cons (victim);
|
|
|
1543 }
|
|
|
1544 victim = XCONS (loser);
|
|
|
1545
|
|
|
1546 if (EQ (loser, Vcondition_handlers)) /* may have been rebound to some tail */
|
|
|
1547 Vcondition_handlers = victim->cdr;
|
|
|
1548
|
|
|
1549 free_cons (victim);
|
|
|
1550 return Qnil;
|
|
|
1551 }
|
|
|
1552
|
|
|
1553 static Lisp_Object
|
|
|
1554 condition_case_unwind (Lisp_Object loser)
|
|
|
1555 {
|
|
|
1556 /* ((<unbound> . clauses) ... other handlers */
|
|
617
|
1557 /* NO! Doing this now leaves the tag deleted in a still-active
|
|
|
1558 catch. With the recent changes to unwind_to_catch(), the
|
|
|
1559 evil situation might not happen any more; it certainly could
|
|
|
1560 happen before because it did. But it's very precarious to rely
|
|
|
1561 on something like this. #### Instead we should rewrite, adopting
|
|
|
1562 the FSF's mechanism with a struct handler instead of
|
|
|
1563 Vcondition_handlers; then we have NO Lisp-object structures used
|
|
|
1564 to hold all of the values, and there's no possibility either of
|
|
|
1565 crashes from freeing objects too quickly, or objects not getting
|
|
|
1566 freed and hanging around till the next GC.
|
|
|
1567
|
|
|
1568 In practice, the extra consing here should not matter because
|
|
|
1569 it only happens when we throw past the condition-case, which almost
|
|
|
1570 always is the result of an error. Most of the time, there will be
|
|
|
1571 no error, and we will free the objects below in the main function.
|
|
|
1572
|
|
|
1573 --ben
|
|
|
1574
|
|
|
1575 DO NOT DO: free_cons (XCAR (loser));
|
|
|
1576 */
|
|
|
1577
|
|
428
|
1578 if (EQ (loser, Vcondition_handlers)) /* may have been rebound to some tail */
|
|
617
|
1579 Vcondition_handlers = XCDR (loser);
|
|
|
1580
|
|
|
1581 /* DO NOT DO: free_cons (loser); */
|
|
428
|
1582 return Qnil;
|
|
|
1583 }
|
|
|
1584
|
|
|
1585 /* Split out from condition_case_3 so that primitive C callers
|
|
|
1586 don't have to cons up a lisp handler form to be evaluated. */
|
|
|
1587
|
|
|
1588 /* Call a function BFUN of one argument BARG, trapping errors as
|
|
|
1589 specified by HANDLERS. If no error occurs that is indicated by
|
|
|
1590 HANDLERS as something to be caught, the return value of this
|
|
|
1591 function is the return value from BFUN. If such an error does
|
|
|
1592 occur, HFUN is called, and its return value becomes the
|
|
|
1593 return value of condition_case_1(). The second argument passed
|
|
|
1594 to HFUN will always be HARG. The first argument depends on
|
|
|
1595 HANDLERS:
|
|
|
1596
|
|
|
1597 If HANDLERS is Qt, all errors (this includes QUIT, but not
|
|
|
1598 non-local exits with `throw') cause HFUN to be invoked, and VAL
|
|
|
1599 (the first argument to HFUN) is a cons (SIG . DATA) of the
|
|
|
1600 arguments passed to `signal'. The debugger is not invoked even if
|
|
|
1601 `debug-on-error' was set.
|
|
|
1602
|
|
|
1603 A HANDLERS value of Qerror is the same as Qt except that the
|
|
|
1604 debugger is invoked if `debug-on-error' was set.
|
|
|
1605
|
|
|
1606 Otherwise, HANDLERS should be a list of lists (CONDITION-NAME BODY ...)
|
|
|
1607 exactly as in `condition-case', and errors will be trapped
|
|
|
1608 as indicated in HANDLERS. VAL (the first argument to HFUN) will
|
|
|
1609 be a cons whose car is the cons (SIG . DATA) and whose CDR is the
|
|
|
1610 list (BODY ...) from the appropriate slot in HANDLERS.
|
|
|
1611
|
|
|
1612 This function pushes HANDLERS onto the front of Vcondition_handlers
|
|
|
1613 (actually with a Qunbound marker as well -- see Fthrow() above
|
|
|
1614 for why), establishes a catch whose tag is this new value of
|
|
|
1615 Vcondition_handlers, and calls BFUN. When Fsignal() is called,
|
|
|
1616 it calls Fthrow(), setting TAG to this same new value of
|
|
|
1617 Vcondition_handlers and setting VAL to the same thing that will
|
|
|
1618 be passed to HFUN, as above. Fthrow() longjmp()s back to the
|
|
|
1619 jump point we just established, and we in turn just call the
|
|
|
1620 HFUN and return its value.
|
|
|
1621
|
|
|
1622 For a real condition-case, HFUN will always be
|
|
|
1623 run_condition_case_handlers() and HARG is the argument VAR
|
|
|
1624 to condition-case. That function just binds VAR to the cons
|
|
|
1625 (SIG . DATA) that is the CAR of VAL, and calls the handler
|
|
|
1626 (BODY ...) that is the CDR of VAL. Note that before calling
|
|
|
1627 Fthrow(), Fsignal() restored Vcondition_handlers to the value
|
|
|
1628 it had *before* condition_case_1() was called. This maintains
|
|
|
1629 consistency (so that the state of things at exit of
|
|
|
1630 condition_case_1() is the same as at entry), and implies
|
|
|
1631 that the handler can signal the same error again (possibly
|
|
|
1632 after processing of its own), without getting in an infinite
|
|
|
1633 loop. */
|
|
|
1634
|
|
|
1635 Lisp_Object
|
|
|
1636 condition_case_1 (Lisp_Object handlers,
|
|
|
1637 Lisp_Object (*bfun) (Lisp_Object barg),
|
|
|
1638 Lisp_Object barg,
|
|
|
1639 Lisp_Object (*hfun) (Lisp_Object val, Lisp_Object harg),
|
|
|
1640 Lisp_Object harg)
|
|
|
1641 {
|
|
|
1642 int speccount = specpdl_depth();
|
|
|
1643 struct catchtag c;
|
|
617
|
1644 struct gcpro gcpro1, gcpro2, gcpro3;
|
|
428
|
1645
|
|
|
1646 #if 0 /* FSFmacs */
|
|
|
1647 c.tag = Qnil;
|
|
|
1648 #else
|
|
|
1649 /* Do consing now so out-of-memory error happens up front */
|
|
|
1650 /* (unbound . stuff) is a special condition-case kludge marker
|
|
|
1651 which is known specially by Fsignal.
|
|
617
|
1652 [[ This is an abomination, but to fix it would require either
|
|
428
|
1653 making condition_case cons (a union of the conditions of the clauses)
|
|
617
|
1654 or changing the byte-compiler output (no thanks).]]
|
|
|
1655
|
|
|
1656 The above comment is clearly wrong. FSF does not do it this way
|
|
|
1657 and did not change the byte-compiler output. Instead they use a
|
|
|
1658 `struct handler' to hold the various values (in place of our
|
|
|
1659 Vcondition_handlers) and chain them together, with pointers from
|
|
|
1660 the `struct catchtag' to the `struct handler'. We should perhaps
|
|
|
1661 consider moving to something similar, but not before I merge my
|
|
|
1662 stderr-proc workspace, which contains changes to these
|
|
|
1663 functions. --ben */
|
|
428
|
1664 c.tag = noseeum_cons (noseeum_cons (Qunbound, handlers),
|
|
|
1665 Vcondition_handlers);
|
|
|
1666 #endif
|
|
|
1667 c.val = Qnil;
|
|
|
1668 c.backlist = backtrace_list;
|
|
|
1669 #if 0 /* FSFmacs */
|
|
|
1670 /* #### */
|
|
|
1671 c.handlerlist = handlerlist;
|
|
|
1672 #endif
|
|
|
1673 c.lisp_eval_depth = lisp_eval_depth;
|
|
|
1674 c.pdlcount = specpdl_depth();
|
|
|
1675 #if 0 /* FSFmacs */
|
|
|
1676 c.poll_suppress_count = async_timer_suppress_count;
|
|
|
1677 #endif
|
|
|
1678 c.gcpro = gcprolist;
|
|
|
1679 /* #### FSFmacs does the following statement *after* the setjmp(). */
|
|
|
1680 c.next = catchlist;
|
|
|
1681
|
|
|
1682 if (SETJMP (c.jmp))
|
|
|
1683 {
|
|
|
1684 /* throw does ungcpro, etc */
|
|
|
1685 return (*hfun) (c.val, harg);
|
|
|
1686 }
|
|
|
1687
|
|
|
1688 record_unwind_protect (condition_case_unwind, c.tag);
|
|
|
1689
|
|
|
1690 catchlist = &c;
|
|
|
1691 #if 0 /* FSFmacs */
|
|
|
1692 h.handler = handlers;
|
|
|
1693 h.var = Qnil;
|
|
|
1694 h.next = handlerlist;
|
|
|
1695 h.tag = &c;
|
|
|
1696 handlerlist = &h;
|
|
|
1697 #else
|
|
|
1698 Vcondition_handlers = c.tag;
|
|
|
1699 #endif
|
|
|
1700 GCPRO1 (harg); /* Somebody has to gc-protect */
|
|
|
1701 c.val = ((*bfun) (barg));
|
|
|
1702 UNGCPRO;
|
|
617
|
1703
|
|
|
1704 /* Once we change `catchlist' below, the stuff in c will not be GCPRO'd. */
|
|
|
1705 GCPRO3 (harg, c.val, c.tag);
|
|
|
1706
|
|
428
|
1707 catchlist = c.next;
|
|
442
|
1708 #ifdef ERROR_CHECK_TYPECHECK
|
|
|
1709 check_error_state_sanity ();
|
|
|
1710 #endif
|
|
617
|
1711 /* Note: The unbind also resets Vcondition_handlers. Maybe we should
|
|
|
1712 delete this here. */
|
|
428
|
1713 Vcondition_handlers = XCDR (c.tag);
|
|
771
|
1714 unbind_to (speccount);
|
|
617
|
1715
|
|
|
1716 UNGCPRO;
|
|
|
1717 /* free the conses *after* the unbind, because the unbind will run
|
|
|
1718 condition_case_unwind above. */
|
|
|
1719 free_cons (XCONS (XCAR (c.tag)));
|
|
|
1720 free_cons (XCONS (c.tag));
|
|
|
1721 return c.val;
|
|
428
|
1722 }
|
|
|
1723
|
|
|
1724 static Lisp_Object
|
|
|
1725 run_condition_case_handlers (Lisp_Object val, Lisp_Object var)
|
|
|
1726 {
|
|
|
1727 /* This function can GC */
|
|
|
1728 #if 0 /* FSFmacs */
|
|
|
1729 if (!NILP (h.var))
|
|
|
1730 specbind (h.var, c.val);
|
|
|
1731 val = Fprogn (Fcdr (h.chosen_clause));
|
|
|
1732
|
|
|
1733 /* Note that this just undoes the binding of h.var; whoever
|
|
|
1734 longjmp()ed to us unwound the stack to c.pdlcount before
|
|
|
1735 throwing. */
|
|
771
|
1736 unbind_to (c.pdlcount);
|
|
428
|
1737 return val;
|
|
|
1738 #else
|
|
|
1739 int speccount;
|
|
|
1740
|
|
|
1741 CHECK_TRUE_LIST (val);
|
|
|
1742 if (NILP (var))
|
|
|
1743 return Fprogn (Fcdr (val)); /* tail call */
|
|
|
1744
|
|
|
1745 speccount = specpdl_depth();
|
|
|
1746 specbind (var, Fcar (val));
|
|
|
1747 val = Fprogn (Fcdr (val));
|
|
771
|
1748 return unbind_to_1 (speccount, val);
|
|
428
|
1749 #endif
|
|
|
1750 }
|
|
|
1751
|
|
|
1752 /* Here for bytecode to call non-consfully. This is exactly like
|
|
|
1753 condition-case except that it takes three arguments rather
|
|
|
1754 than a single list of arguments. */
|
|
|
1755 Lisp_Object
|
|
|
1756 condition_case_3 (Lisp_Object bodyform, Lisp_Object var, Lisp_Object handlers)
|
|
|
1757 {
|
|
|
1758 /* This function can GC */
|
|
|
1759 EXTERNAL_LIST_LOOP_2 (handler, handlers)
|
|
|
1760 {
|
|
|
1761 if (NILP (handler))
|
|
|
1762 ;
|
|
|
1763 else if (CONSP (handler))
|
|
|
1764 {
|
|
|
1765 Lisp_Object conditions = XCAR (handler);
|
|
|
1766 /* CONDITIONS must a condition name or a list of condition names */
|
|
|
1767 if (SYMBOLP (conditions))
|
|
|
1768 ;
|
|
|
1769 else
|
|
|
1770 {
|
|
|
1771 EXTERNAL_LIST_LOOP_2 (condition, conditions)
|
|
|
1772 if (!SYMBOLP (condition))
|
|
|
1773 goto invalid_condition_handler;
|
|
|
1774 }
|
|
|
1775 }
|
|
|
1776 else
|
|
|
1777 {
|
|
|
1778 invalid_condition_handler:
|
|
563
|
1779 sferror ("Invalid condition handler", handler);
|
|
428
|
1780 }
|
|
|
1781 }
|
|
|
1782
|
|
|
1783 CHECK_SYMBOL (var);
|
|
|
1784
|
|
|
1785 return condition_case_1 (handlers,
|
|
|
1786 Feval, bodyform,
|
|
|
1787 run_condition_case_handlers,
|
|
|
1788 var);
|
|
|
1789 }
|
|
|
1790
|
|
|
1791 DEFUN ("condition-case", Fcondition_case, 2, UNEVALLED, 0, /*
|
|
|
1792 Regain control when an error is signalled.
|
|
|
1793 Usage looks like (condition-case VAR BODYFORM HANDLERS...).
|
|
|
1794 Executes BODYFORM and returns its value if no error happens.
|
|
|
1795 Each element of HANDLERS looks like (CONDITION-NAME BODY...)
|
|
|
1796 where the BODY is made of Lisp expressions.
|
|
|
1797
|
|
771
|
1798 A typical usage of `condition-case' looks like this:
|
|
|
1799
|
|
|
1800 (condition-case nil
|
|
|
1801 ;; you need a progn here if you want more than one statement ...
|
|
|
1802 (progn
|
|
|
1803 (do-something)
|
|
|
1804 (do-something-else))
|
|
|
1805 (error
|
|
|
1806 (issue-warning-or)
|
|
|
1807 ;; but strangely, you don't need one here.
|
|
|
1808 (return-a-value-etc)
|
|
|
1809 ))
|
|
|
1810
|
|
428
|
1811 A handler is applicable to an error if CONDITION-NAME is one of the
|
|
|
1812 error's condition names. If an error happens, the first applicable
|
|
|
1813 handler is run. As a special case, a CONDITION-NAME of t matches
|
|
|
1814 all errors, even those without the `error' condition name on them
|
|
|
1815 \(e.g. `quit').
|
|
|
1816
|
|
|
1817 The car of a handler may be a list of condition names
|
|
|
1818 instead of a single condition name.
|
|
|
1819
|
|
|
1820 When a handler handles an error,
|
|
|
1821 control returns to the condition-case and the handler BODY... is executed
|
|
|
1822 with VAR bound to (SIGNALED-CONDITIONS . SIGNAL-DATA).
|
|
|
1823 VAR may be nil; then you do not get access to the signal information.
|
|
|
1824
|
|
|
1825 The value of the last BODY form is returned from the condition-case.
|
|
|
1826 See also the function `signal' for more info.
|
|
|
1827
|
|
|
1828 Note that at the time the condition handler is invoked, the Lisp stack
|
|
|
1829 and the current catches, condition-cases, and bindings have all been
|
|
|
1830 popped back to the state they were in just before the call to
|
|
|
1831 `condition-case'. This means that resignalling the error from
|
|
|
1832 within the handler will not result in an infinite loop.
|
|
|
1833
|
|
|
1834 If you want to establish an error handler that is called with the
|
|
|
1835 Lisp stack, bindings, etc. as they were when `signal' was called,
|
|
|
1836 rather than when the handler was set, use `call-with-condition-handler'.
|
|
|
1837 */
|
|
|
1838 (args))
|
|
|
1839 {
|
|
|
1840 /* This function can GC */
|
|
|
1841 Lisp_Object var = XCAR (args);
|
|
|
1842 Lisp_Object bodyform = XCAR (XCDR (args));
|
|
|
1843 Lisp_Object handlers = XCDR (XCDR (args));
|
|
|
1844 return condition_case_3 (bodyform, var, handlers);
|
|
|
1845 }
|
|
|
1846
|
|
|
1847 DEFUN ("call-with-condition-handler", Fcall_with_condition_handler, 2, MANY, 0, /*
|
|
|
1848 Regain control when an error is signalled, without popping the stack.
|
|
|
1849 Usage looks like (call-with-condition-handler HANDLER FUNCTION &rest ARGS).
|
|
|
1850 This function is similar to `condition-case', but the handler is invoked
|
|
|
1851 with the same environment (Lisp stack, bindings, catches, condition-cases)
|
|
|
1852 that was current when `signal' was called, rather than when the handler
|
|
|
1853 was established.
|
|
|
1854
|
|
|
1855 HANDLER should be a function of one argument, which is a cons of the args
|
|
|
1856 \(SIG . DATA) that were passed to `signal'. It is invoked whenever
|
|
|
1857 `signal' is called (this differs from `condition-case', which allows
|
|
|
1858 you to specify which errors are trapped). If the handler function
|
|
|
1859 returns, `signal' continues as if the handler were never invoked.
|
|
|
1860 \(It continues to look for handlers established earlier than this one,
|
|
|
1861 and invokes the standard error-handler if none is found.)
|
|
|
1862 */
|
|
|
1863 (int nargs, Lisp_Object *args)) /* Note! Args side-effected! */
|
|
|
1864 {
|
|
|
1865 /* This function can GC */
|
|
|
1866 int speccount = specpdl_depth();
|
|
|
1867 Lisp_Object tem;
|
|
|
1868
|
|
|
1869 /* #### If there were a way to check that args[0] were a function
|
|
|
1870 which accepted one arg, that should be done here ... */
|
|
|
1871
|
|
|
1872 /* (handler-fun . handler-args) */
|
|
|
1873 tem = noseeum_cons (list1 (args[0]), Vcondition_handlers);
|
|
|
1874 record_unwind_protect (condition_bind_unwind, tem);
|
|
|
1875 Vcondition_handlers = tem;
|
|
|
1876
|
|
|
1877 /* Caller should have GC-protected args */
|
|
771
|
1878 return unbind_to_1 (speccount, Ffuncall (nargs - 1, args + 1));
|
|
428
|
1879 }
|
|
|
1880
|
|
|
1881 static int
|
|
|
1882 condition_type_p (Lisp_Object type, Lisp_Object conditions)
|
|
|
1883 {
|
|
|
1884 if (EQ (type, Qt))
|
|
|
1885 /* (condition-case c # (t c)) catches -all- signals
|
|
|
1886 * Use with caution! */
|
|
|
1887 return 1;
|
|
|
1888
|
|
|
1889 if (SYMBOLP (type))
|
|
|
1890 return !NILP (Fmemq (type, conditions));
|
|
|
1891
|
|
|
1892 for (; CONSP (type); type = XCDR (type))
|
|
|
1893 if (!NILP (Fmemq (XCAR (type), conditions)))
|
|
|
1894 return 1;
|
|
|
1895
|
|
|
1896 return 0;
|
|
|
1897 }
|
|
|
1898
|
|
|
1899 static Lisp_Object
|
|
|
1900 return_from_signal (Lisp_Object value)
|
|
|
1901 {
|
|
|
1902 #if 1
|
|
|
1903 /* Most callers are not prepared to handle gc if this
|
|
|
1904 returns. So, since this feature is not very useful,
|
|
|
1905 take it out. */
|
|
|
1906 /* Have called debugger; return value to signaller */
|
|
|
1907 return value;
|
|
|
1908 #else /* But the reality is that that stinks, because: */
|
|
|
1909 /* GACK!!! Really want some way for debug-on-quit errors
|
|
|
1910 to be continuable!! */
|
|
563
|
1911 signal_error (Qunimplemented,
|
|
|
1912 "Returning a value from an error is no longer supported",
|
|
|
1913 Qunbound);
|
|
428
|
1914 #endif
|
|
|
1915 }
|
|
|
1916
|
|
|
1917 extern int in_display;
|
|
|
1918
|
|
|
1919
|
|
|
1920 /************************************************************************/
|
|
|
1921 /* the workhorse error-signaling function */
|
|
|
1922 /************************************************************************/
|
|
|
1923
|
|
|
1924 /* #### This function has not been synched with FSF. It diverges
|
|
|
1925 significantly. */
|
|
|
1926
|
|
|
1927 static Lisp_Object
|
|
|
1928 signal_1 (Lisp_Object sig, Lisp_Object data)
|
|
|
1929 {
|
|
|
1930 /* This function can GC */
|
|
|
1931 struct gcpro gcpro1, gcpro2;
|
|
|
1932 Lisp_Object conditions;
|
|
|
1933 Lisp_Object handlers;
|
|
|
1934 /* signal_call_debugger() could get called more than once
|
|
|
1935 (once when a call-with-condition-handler is about to
|
|
|
1936 be dealt with, and another when a condition-case handler
|
|
|
1937 is about to be invoked). So make sure the debugger and/or
|
|
|
1938 stack trace aren't done more than once. */
|
|
|
1939 int stack_trace_displayed = 0;
|
|
|
1940 int debugger_entered = 0;
|
|
|
1941 GCPRO2 (conditions, handlers);
|
|
|
1942
|
|
|
1943 if (!initialized)
|
|
|
1944 {
|
|
|
1945 /* who knows how much has been initialized? Safest bet is
|
|
|
1946 just to bomb out immediately. */
|
|
771
|
1947 stderr_out ("Error before initialization is complete!\n");
|
|
428
|
1948 abort ();
|
|
|
1949 }
|
|
|
1950
|
|
|
1951 if (gc_in_progress || in_display)
|
|
|
1952 /* This is one of many reasons why you can't run lisp code from redisplay.
|
|
|
1953 There is no sensible way to handle errors there. */
|
|
|
1954 abort ();
|
|
|
1955
|
|
|
1956 conditions = Fget (sig, Qerror_conditions, Qnil);
|
|
|
1957
|
|
|
1958 for (handlers = Vcondition_handlers;
|
|
|
1959 CONSP (handlers);
|
|
|
1960 handlers = XCDR (handlers))
|
|
|
1961 {
|
|
|
1962 Lisp_Object handler_fun = XCAR (XCAR (handlers));
|
|
|
1963 Lisp_Object handler_data = XCDR (XCAR (handlers));
|
|
|
1964 Lisp_Object outer_handlers = XCDR (handlers);
|
|
|
1965
|
|
|
1966 if (!UNBOUNDP (handler_fun))
|
|
|
1967 {
|
|
|
1968 /* call-with-condition-handler */
|
|
|
1969 Lisp_Object tem;
|
|
|
1970 Lisp_Object all_handlers = Vcondition_handlers;
|
|
|
1971 struct gcpro ngcpro1;
|
|
|
1972 NGCPRO1 (all_handlers);
|
|
|
1973 Vcondition_handlers = outer_handlers;
|
|
|
1974
|
|
|
1975 tem = signal_call_debugger (conditions, sig, data,
|
|
|
1976 outer_handlers, 1,
|
|
|
1977 &stack_trace_displayed,
|
|
|
1978 &debugger_entered);
|
|
|
1979 if (!UNBOUNDP (tem))
|
|
|
1980 RETURN_NUNGCPRO (return_from_signal (tem));
|
|
|
1981
|
|
|
1982 tem = Fcons (sig, data);
|
|
|
1983 if (NILP (handler_data))
|
|
|
1984 tem = call1 (handler_fun, tem);
|
|
|
1985 else
|
|
|
1986 {
|
|
|
1987 /* (This code won't be used (for now?).) */
|
|
|
1988 struct gcpro nngcpro1;
|
|
|
1989 Lisp_Object args[3];
|
|
|
1990 NNGCPRO1 (args[0]);
|
|
|
1991 nngcpro1.nvars = 3;
|
|
|
1992 args[0] = handler_fun;
|
|
|
1993 args[1] = tem;
|
|
|
1994 args[2] = handler_data;
|
|
|
1995 nngcpro1.var = args;
|
|
|
1996 tem = Fapply (3, args);
|
|
|
1997 NNUNGCPRO;
|
|
|
1998 }
|
|
|
1999 NUNGCPRO;
|
|
|
2000 #if 0
|
|
|
2001 if (!EQ (tem, Qsignal))
|
|
|
2002 return return_from_signal (tem);
|
|
|
2003 #endif
|
|
|
2004 /* If handler didn't throw, try another handler */
|
|
|
2005 Vcondition_handlers = all_handlers;
|
|
|
2006 }
|
|
|
2007
|
|
|
2008 /* It's a condition-case handler */
|
|
|
2009
|
|
|
2010 /* t is used by handlers for all conditions, set up by C code.
|
|
|
2011 * debugger is not called even if debug_on_error */
|
|
|
2012 else if (EQ (handler_data, Qt))
|
|
|
2013 {
|
|
|
2014 UNGCPRO;
|
|
|
2015 return Fthrow (handlers, Fcons (sig, data));
|
|
|
2016 }
|
|
|
2017 /* `error' is used similarly to the way `t' is used, but in
|
|
|
2018 addition it invokes the debugger if debug_on_error.
|
|
|
2019 This is normally used for the outer command-loop error
|
|
|
2020 handler. */
|
|
|
2021 else if (EQ (handler_data, Qerror))
|
|
|
2022 {
|
|
|
2023 Lisp_Object tem = signal_call_debugger (conditions, sig, data,
|
|
|
2024 outer_handlers, 0,
|
|
|
2025 &stack_trace_displayed,
|
|
|
2026 &debugger_entered);
|
|
|
2027
|
|
|
2028 UNGCPRO;
|
|
|
2029 if (!UNBOUNDP (tem))
|
|
|
2030 return return_from_signal (tem);
|
|
|
2031
|
|
|
2032 tem = Fcons (sig, data);
|
|
|
2033 return Fthrow (handlers, tem);
|
|
|
2034 }
|
|
|
2035 else
|
|
|
2036 {
|
|
|
2037 /* handler established by real (Lisp) condition-case */
|
|
|
2038 Lisp_Object h;
|
|
|
2039
|
|
|
2040 for (h = handler_data; CONSP (h); h = Fcdr (h))
|
|
|
2041 {
|
|
|
2042 Lisp_Object clause = Fcar (h);
|
|
|
2043 Lisp_Object tem = Fcar (clause);
|
|
|
2044
|
|
|
2045 if (condition_type_p (tem, conditions))
|
|
|
2046 {
|
|
|
2047 tem = signal_call_debugger (conditions, sig, data,
|
|
|
2048 outer_handlers, 1,
|
|
|
2049 &stack_trace_displayed,
|
|
|
2050 &debugger_entered);
|
|
|
2051 UNGCPRO;
|
|
|
2052 if (!UNBOUNDP (tem))
|
|
|
2053 return return_from_signal (tem);
|
|
|
2054
|
|
|
2055 /* Doesn't return */
|
|
|
2056 tem = Fcons (Fcons (sig, data), Fcdr (clause));
|
|
|
2057 return Fthrow (handlers, tem);
|
|
|
2058 }
|
|
|
2059 }
|
|
|
2060 }
|
|
|
2061 }
|
|
|
2062
|
|
|
2063 /* If no handler is present now, try to run the debugger,
|
|
|
2064 and if that fails, throw to top level.
|
|
|
2065
|
|
|
2066 #### The only time that no handler is present is during
|
|
|
2067 temacs or perhaps very early in XEmacs. In both cases,
|
|
|
2068 there is no 'top-level catch. (That's why the
|
|
|
2069 "bomb-out" hack was added.)
|
|
|
2070
|
|
|
2071 #### Fix this horrifitude!
|
|
|
2072 */
|
|
|
2073 signal_call_debugger (conditions, sig, data, Qnil, 0,
|
|
|
2074 &stack_trace_displayed,
|
|
|
2075 &debugger_entered);
|
|
|
2076 UNGCPRO;
|
|
|
2077 throw_or_bomb_out (Qtop_level, Qt, 1, sig, data); /* Doesn't return */
|
|
|
2078 return Qnil;
|
|
|
2079 }
|
|
|
2080
|
|
|
2081
|
|
|
2082 /****************** Error functions class 1 ******************/
|
|
|
2083
|
|
|
2084 /* Class 1: General functions that signal an error.
|
|
|
2085 These functions take an error type and a list of associated error
|
|
|
2086 data. */
|
|
|
2087
|
|
|
2088 /* The simplest external error function: it would be called
|
|
563
|
2089 signal_continuable_error_1() in the terminology below, but it's
|
|
428
|
2090 Lisp-callable. */
|
|
|
2091
|
|
|
2092 DEFUN ("signal", Fsignal, 2, 2, 0, /*
|
|
|
2093 Signal a continuable error. Args are ERROR-SYMBOL, and associated DATA.
|
|
|
2094 An error symbol is a symbol defined using `define-error'.
|
|
|
2095 DATA should be a list. Its elements are printed as part of the error message.
|
|
|
2096 If the signal is handled, DATA is made available to the handler.
|
|
|
2097 See also the function `signal-error', and the functions to handle errors:
|
|
|
2098 `condition-case' and `call-with-condition-handler'.
|
|
|
2099
|
|
|
2100 Note that this function can return, if the debugger is invoked and the
|
|
|
2101 user invokes the "return from signal" option.
|
|
|
2102 */
|
|
|
2103 (error_symbol, data))
|
|
|
2104 {
|
|
|
2105 /* Fsignal() is one of these functions that's called all the time
|
|
|
2106 with newly-created Lisp objects. We allow this; but we must GC-
|
|
|
2107 protect the objects because all sorts of weird stuff could
|
|
|
2108 happen. */
|
|
|
2109
|
|
|
2110 struct gcpro gcpro1;
|
|
|
2111
|
|
|
2112 GCPRO1 (data);
|
|
|
2113 if (!NILP (Vcurrent_error_state))
|
|
|
2114 {
|
|
793
|
2115 if (!NILP (Vcurrent_warning_class) && !NILP (Vcurrent_warning_level))
|
|
|
2116 warn_when_safe_lispobj (Vcurrent_warning_class, Vcurrent_warning_level,
|
|
428
|
2117 Fcons (error_symbol, data));
|
|
|
2118 Fthrow (Qunbound_suspended_errors_tag, Qnil);
|
|
|
2119 abort (); /* Better not get here! */
|
|
|
2120 }
|
|
|
2121 RETURN_UNGCPRO (signal_1 (error_symbol, data));
|
|
|
2122 }
|
|
|
2123
|
|
|
2124 /* Signal a non-continuable error. */
|
|
|
2125
|
|
|
2126 DOESNT_RETURN
|
|
563
|
2127 signal_error_1 (Lisp_Object sig, Lisp_Object data)
|
|
428
|
2128 {
|
|
|
2129 for (;;)
|
|
|
2130 Fsignal (sig, data);
|
|
|
2131 }
|
|
442
|
2132 #ifdef ERROR_CHECK_TYPECHECK
|
|
|
2133 void
|
|
|
2134 check_error_state_sanity (void)
|
|
|
2135 {
|
|
|
2136 struct catchtag *c;
|
|
|
2137 int found_error_tag = 0;
|
|
|
2138
|
|
|
2139 for (c = catchlist; c; c = c->next)
|
|
|
2140 {
|
|
|
2141 if (EQ (c->tag, Qunbound_suspended_errors_tag))
|
|
|
2142 {
|
|
|
2143 found_error_tag = 1;
|
|
|
2144 break;
|
|
|
2145 }
|
|
|
2146 }
|
|
|
2147
|
|
|
2148 assert (found_error_tag || NILP (Vcurrent_error_state));
|
|
|
2149 }
|
|
|
2150 #endif
|
|
428
|
2151
|
|
|
2152 static Lisp_Object
|
|
|
2153 restore_current_warning_class (Lisp_Object warning_class)
|
|
|
2154 {
|
|
|
2155 Vcurrent_warning_class = warning_class;
|
|
|
2156 return Qnil;
|
|
|
2157 }
|
|
|
2158
|
|
|
2159 static Lisp_Object
|
|
793
|
2160 restore_current_warning_level (Lisp_Object warning_level)
|
|
|
2161 {
|
|
|
2162 Vcurrent_warning_level = warning_level;
|
|
|
2163 return Qnil;
|
|
|
2164 }
|
|
|
2165
|
|
|
2166 static Lisp_Object
|
|
428
|
2167 restore_current_error_state (Lisp_Object error_state)
|
|
|
2168 {
|
|
|
2169 Vcurrent_error_state = error_state;
|
|
|
2170 return Qnil;
|
|
|
2171 }
|
|
|
2172
|
|
442
|
2173 static Lisp_Object
|
|
|
2174 call_with_suspended_errors_1 (Lisp_Object opaque_arg)
|
|
|
2175 {
|
|
|
2176 Lisp_Object val;
|
|
|
2177 Lisp_Object *kludgy_args = (Lisp_Object *) get_opaque_ptr (opaque_arg);
|
|
|
2178 int speccount = specpdl_depth ();
|
|
|
2179
|
|
793
|
2180 if (NILP (Vcurrent_error_state))
|
|
442
|
2181 {
|
|
|
2182 record_unwind_protect (restore_current_error_state,
|
|
|
2183 Vcurrent_error_state);
|
|
793
|
2184 Vcurrent_error_state = Qt;
|
|
442
|
2185 }
|
|
|
2186 PRIMITIVE_FUNCALL (val, get_opaque_ptr (kludgy_args[0]),
|
|
793
|
2187 kludgy_args + 2, XINT (kludgy_args[1]));
|
|
771
|
2188 return unbind_to_1 (speccount, val);
|
|
442
|
2189 }
|
|
|
2190
|
|
428
|
2191 /* Many functions would like to do one of three things if an error
|
|
|
2192 occurs:
|
|
|
2193
|
|
|
2194 (1) signal the error, as usual.
|
|
|
2195 (2) silently fail and return some error value.
|
|
|
2196 (3) do as (2) but issue a warning in the process.
|
|
|
2197
|
|
578
|
2198 Currently there's lots of stuff that passes an Error_Behavior
|
|
428
|
2199 value and calls maybe_signal_error() and other such functions.
|
|
|
2200 This approach is inherently error-prone and broken. A much
|
|
|
2201 more robust and easier approach is to use call_with_suspended_errors().
|
|
|
2202 Wrap this around any function in which you might want errors
|
|
|
2203 to not be errors.
|
|
|
2204 */
|
|
|
2205
|
|
|
2206 Lisp_Object
|
|
|
2207 call_with_suspended_errors (lisp_fn_t fun, volatile Lisp_Object retval,
|
|
578
|
2208 Lisp_Object class, Error_Behavior errb,
|
|
428
|
2209 int nargs, ...)
|
|
|
2210 {
|
|
|
2211 va_list vargs;
|
|
|
2212 int speccount;
|
|
793
|
2213 Lisp_Object kludgy_args[22];
|
|
|
2214 Lisp_Object *args = kludgy_args + 2;
|
|
428
|
2215 int i;
|
|
|
2216
|
|
|
2217 assert (SYMBOLP (class)); /* sanity-check */
|
|
|
2218 assert (!NILP (class));
|
|
|
2219 assert (nargs >= 0 && nargs < 20);
|
|
|
2220
|
|
|
2221 va_start (vargs, nargs);
|
|
|
2222 for (i = 0; i < nargs; i++)
|
|
|
2223 args[i] = va_arg (vargs, Lisp_Object);
|
|
|
2224 va_end (vargs);
|
|
|
2225
|
|
793
|
2226 /* ERROR_ME means don't trap errors. (However, if errors are
|
|
|
2227 already trapped, we leave them trapped.)
|
|
|
2228
|
|
|
2229 Otherwise, we trap errors, and display as warnings if ERROR_ME_WARN.
|
|
|
2230
|
|
|
2231 If ERROR_ME_NOT, we silently fail.
|
|
|
2232
|
|
|
2233 If ERROR_ME_DEBUG_WARN, we display a warning, but at warning level to
|
|
|
2234 `debug'. Normally these disappear, but can be seen if we changed
|
|
|
2235 log-warning-minimum-level.
|
|
|
2236 */
|
|
|
2237
|
|
428
|
2238 /* If error-checking is not disabled, just call the function.
|
|
|
2239 It's important not to override disabled error-checking with
|
|
|
2240 enabled error-checking. */
|
|
|
2241
|
|
|
2242 if (ERRB_EQ (errb, ERROR_ME))
|
|
|
2243 {
|
|
|
2244 Lisp_Object val;
|
|
|
2245 PRIMITIVE_FUNCALL (val, fun, args, nargs);
|
|
|
2246 return val;
|
|
|
2247 }
|
|
|
2248
|
|
442
|
2249 speccount = specpdl_depth ();
|
|
793
|
2250 if (NILP (Vcurrent_warning_class))
|
|
428
|
2251 {
|
|
793
|
2252 /* Don't change the existing class.
|
|
|
2253 #### Should we be consing the two together? */
|
|
428
|
2254 record_unwind_protect (restore_current_warning_class,
|
|
|
2255 Vcurrent_warning_class);
|
|
|
2256 Vcurrent_warning_class = class;
|
|
|
2257 }
|
|
|
2258
|
|
793
|
2259 record_unwind_protect (restore_current_warning_level,
|
|
|
2260 Vcurrent_warning_level);
|
|
|
2261 Vcurrent_warning_level =
|
|
|
2262 (ERRB_EQ (errb, ERROR_ME_NOT) ? Qnil :
|
|
|
2263 ERRB_EQ (errb, ERROR_ME_DEBUG_WARN) ? Qdebug :
|
|
|
2264 Qwarning);
|
|
|
2265
|
|
|
2266
|
|
428
|
2267 {
|
|
|
2268 int threw;
|
|
|
2269 Lisp_Object the_retval;
|
|
|
2270 Lisp_Object opaque1 = make_opaque_ptr (kludgy_args);
|
|
|
2271 Lisp_Object opaque2 = make_opaque_ptr ((void *) fun);
|
|
|
2272 struct gcpro gcpro1, gcpro2;
|
|
|
2273
|
|
|
2274 GCPRO2 (opaque1, opaque2);
|
|
|
2275 kludgy_args[0] = opaque2;
|
|
|
2276 kludgy_args[1] = make_int (nargs);
|
|
|
2277 the_retval = internal_catch (Qunbound_suspended_errors_tag,
|
|
|
2278 call_with_suspended_errors_1,
|
|
|
2279 opaque1, &threw);
|
|
|
2280 free_opaque_ptr (opaque1);
|
|
|
2281 free_opaque_ptr (opaque2);
|
|
|
2282 UNGCPRO;
|
|
|
2283 /* Use the returned value except in non-local exit, when
|
|
|
2284 RETVAL applies. */
|
|
|
2285 /* Some perverse compilers require the perverse cast below. */
|
|
771
|
2286 return unbind_to_1 (speccount,
|
|
428
|
2287 threw ? *((Lisp_Object*) &(retval)) : the_retval);
|
|
|
2288 }
|
|
|
2289 }
|
|
|
2290
|
|
|
2291 /* Signal a non-continuable error or display a warning or do nothing,
|
|
|
2292 according to ERRB. CLASS is the class of warning and should
|
|
|
2293 refer to what sort of operation is being done (e.g. Qtoolbar,
|
|
|
2294 Qresource, etc.). */
|
|
|
2295
|
|
|
2296 void
|
|
563
|
2297 maybe_signal_error_1 (Lisp_Object sig, Lisp_Object data, Lisp_Object class,
|
|
578
|
2298 Error_Behavior errb)
|
|
428
|
2299 {
|
|
|
2300 if (ERRB_EQ (errb, ERROR_ME_NOT))
|
|
|
2301 return;
|
|
793
|
2302 else if (ERRB_EQ (errb, ERROR_ME_DEBUG_WARN))
|
|
|
2303 warn_when_safe_lispobj (class, Qdebug, Fcons (sig, data));
|
|
428
|
2304 else if (ERRB_EQ (errb, ERROR_ME_WARN))
|
|
|
2305 warn_when_safe_lispobj (class, Qwarning, Fcons (sig, data));
|
|
|
2306 else
|
|
|
2307 for (;;)
|
|
|
2308 Fsignal (sig, data);
|
|
|
2309 }
|
|
|
2310
|
|
|
2311 /* Signal a continuable error or display a warning or do nothing,
|
|
|
2312 according to ERRB. */
|
|
|
2313
|
|
|
2314 Lisp_Object
|
|
563
|
2315 maybe_signal_continuable_error_1 (Lisp_Object sig, Lisp_Object data,
|
|
578
|
2316 Lisp_Object class, Error_Behavior errb)
|
|
428
|
2317 {
|
|
|
2318 if (ERRB_EQ (errb, ERROR_ME_NOT))
|
|
|
2319 return Qnil;
|
|
793
|
2320 else if (ERRB_EQ (errb, ERROR_ME_DEBUG_WARN))
|
|
|
2321 {
|
|
|
2322 warn_when_safe_lispobj (class, Qdebug, Fcons (sig, data));
|
|
|
2323 return Qnil;
|
|
|
2324 }
|
|
428
|
2325 else if (ERRB_EQ (errb, ERROR_ME_WARN))
|
|
|
2326 {
|
|
|
2327 warn_when_safe_lispobj (class, Qwarning, Fcons (sig, data));
|
|
|
2328 return Qnil;
|
|
|
2329 }
|
|
|
2330 else
|
|
|
2331 return Fsignal (sig, data);
|
|
|
2332 }
|
|
|
2333
|
|
|
2334
|
|
|
2335 /****************** Error functions class 2 ******************/
|
|
|
2336
|
|
563
|
2337 /* Class 2: Signal an error with a string and an associated object.
|
|
|
2338 Normally these functions are used to attach one associated object,
|
|
|
2339 but to attach no objects, specify Qunbound for FROB, and for more
|
|
|
2340 than one object, make a list of the objects with Qunbound as the
|
|
|
2341 first element. (If you have specifically two objects to attach,
|
|
|
2342 consider using the function in class 3 below.) These functions
|
|
|
2343 signal an error of a specified type, whose data is one or more
|
|
|
2344 objects (usually two), a string the related Lisp object(s)
|
|
|
2345 specified as FROB. */
|
|
|
2346
|
|
|
2347 /* Out of REASON and FROB, return a list of elements suitable for passing
|
|
|
2348 to signal_error_1(). */
|
|
|
2349
|
|
|
2350 Lisp_Object
|
|
665
|
2351 build_error_data (const CIntbyte *reason, Lisp_Object frob)
|
|
563
|
2352 {
|
|
|
2353 if (EQ (frob, Qunbound))
|
|
|
2354 frob = Qnil;
|
|
|
2355 else if (CONSP (frob) && EQ (XCAR (frob), Qunbound))
|
|
|
2356 frob = XCDR (frob);
|
|
|
2357 else
|
|
|
2358 frob = list1 (frob);
|
|
|
2359 if (!reason)
|
|
|
2360 return frob;
|
|
|
2361 else
|
|
771
|
2362 return Fcons (build_msg_string (reason), frob);
|
|
563
|
2363 }
|
|
|
2364
|
|
|
2365 DOESNT_RETURN
|
|
665
|
2366 signal_error (Lisp_Object type, const CIntbyte *reason, Lisp_Object frob)
|
|
563
|
2367 {
|
|
|
2368 signal_error_1 (type, build_error_data (reason, frob));
|
|
|
2369 }
|
|
|
2370
|
|
|
2371 void
|
|
665
|
2372 maybe_signal_error (Lisp_Object type, const CIntbyte *reason,
|
|
563
|
2373 Lisp_Object frob, Lisp_Object class,
|
|
578
|
2374 Error_Behavior errb)
|
|
563
|
2375 {
|
|
|
2376 /* Optimization: */
|
|
|
2377 if (ERRB_EQ (errb, ERROR_ME_NOT))
|
|
|
2378 return;
|
|
|
2379 maybe_signal_error_1 (type, build_error_data (reason, frob), class, errb);
|
|
|
2380 }
|
|
|
2381
|
|
|
2382 Lisp_Object
|
|
665
|
2383 signal_continuable_error (Lisp_Object type, const CIntbyte *reason,
|
|
563
|
2384 Lisp_Object frob)
|
|
|
2385 {
|
|
|
2386 return Fsignal (type, build_error_data (reason, frob));
|
|
|
2387 }
|
|
|
2388
|
|
|
2389 Lisp_Object
|
|
665
|
2390 maybe_signal_continuable_error (Lisp_Object type, const CIntbyte *reason,
|
|
563
|
2391 Lisp_Object frob, Lisp_Object class,
|
|
578
|
2392 Error_Behavior errb)
|
|
563
|
2393 {
|
|
|
2394 /* Optimization: */
|
|
|
2395 if (ERRB_EQ (errb, ERROR_ME_NOT))
|
|
|
2396 return Qnil;
|
|
|
2397 return maybe_signal_continuable_error_1 (type,
|
|
|
2398 build_error_data (reason, frob),
|
|
|
2399 class, errb);
|
|
|
2400 }
|
|
|
2401
|
|
|
2402
|
|
|
2403 /****************** Error functions class 3 ******************/
|
|
|
2404
|
|
|
2405 /* Class 3: Signal an error with a string and two associated objects.
|
|
|
2406 These functions signal an error of a specified type, whose data
|
|
|
2407 is three objects, a string and two related Lisp objects.
|
|
|
2408 (The equivalent could be accomplished using the class 2 functions,
|
|
|
2409 but these are more convenient in this particular case.) */
|
|
|
2410
|
|
|
2411 DOESNT_RETURN
|
|
665
|
2412 signal_error_2 (Lisp_Object type, const CIntbyte *reason,
|
|
563
|
2413 Lisp_Object frob0, Lisp_Object frob1)
|
|
|
2414 {
|
|
771
|
2415 signal_error_1 (type, list3 (build_msg_string (reason), frob0,
|
|
563
|
2416 frob1));
|
|
|
2417 }
|
|
|
2418
|
|
|
2419 void
|
|
665
|
2420 maybe_signal_error_2 (Lisp_Object type, const CIntbyte *reason,
|
|
563
|
2421 Lisp_Object frob0, Lisp_Object frob1,
|
|
578
|
2422 Lisp_Object class, Error_Behavior errb)
|
|
563
|
2423 {
|
|
|
2424 /* Optimization: */
|
|
|
2425 if (ERRB_EQ (errb, ERROR_ME_NOT))
|
|
|
2426 return;
|
|
771
|
2427 maybe_signal_error_1 (type, list3 (build_msg_string (reason), frob0,
|
|
563
|
2428 frob1), class, errb);
|
|
|
2429 }
|
|
|
2430
|
|
|
2431 Lisp_Object
|
|
665
|
2432 signal_continuable_error_2 (Lisp_Object type, const CIntbyte *reason,
|
|
563
|
2433 Lisp_Object frob0, Lisp_Object frob1)
|
|
|
2434 {
|
|
771
|
2435 return Fsignal (type, list3 (build_msg_string (reason), frob0,
|
|
563
|
2436 frob1));
|
|
|
2437 }
|
|
|
2438
|
|
|
2439 Lisp_Object
|
|
665
|
2440 maybe_signal_continuable_error_2 (Lisp_Object type, const CIntbyte *reason,
|
|
563
|
2441 Lisp_Object frob0, Lisp_Object frob1,
|
|
578
|
2442 Lisp_Object class, Error_Behavior errb)
|
|
563
|
2443 {
|
|
|
2444 /* Optimization: */
|
|
|
2445 if (ERRB_EQ (errb, ERROR_ME_NOT))
|
|
|
2446 return Qnil;
|
|
|
2447 return maybe_signal_continuable_error_1
|
|
771
|
2448 (type, list3 (build_msg_string (reason), frob0, frob1),
|
|
563
|
2449 class, errb);
|
|
|
2450 }
|
|
|
2451
|
|
|
2452
|
|
|
2453 /****************** Error functions class 4 ******************/
|
|
|
2454
|
|
|
2455 /* Class 4: Printf-like functions that signal an error.
|
|
442
|
2456 These functions signal an error of a specified type, whose data
|
|
428
|
2457 is a single string, created using the arguments. */
|
|
|
2458
|
|
|
2459 DOESNT_RETURN
|
|
665
|
2460 signal_ferror (Lisp_Object type, const CIntbyte *fmt, ...)
|
|
442
|
2461 {
|
|
|
2462 Lisp_Object obj;
|
|
|
2463 va_list args;
|
|
|
2464
|
|
|
2465 va_start (args, fmt);
|
|
771
|
2466 obj = emacs_vsprintf_string (CGETTEXT (fmt), args);
|
|
442
|
2467 va_end (args);
|
|
|
2468
|
|
|
2469 /* Fsignal GC-protects its args */
|
|
563
|
2470 signal_error (type, 0, obj);
|
|
442
|
2471 }
|
|
|
2472
|
|
|
2473 void
|
|
578
|
2474 maybe_signal_ferror (Lisp_Object type, Lisp_Object class, Error_Behavior errb,
|
|
665
|
2475 const CIntbyte *fmt, ...)
|
|
442
|
2476 {
|
|
|
2477 Lisp_Object obj;
|
|
|
2478 va_list args;
|
|
|
2479
|
|
|
2480 /* Optimization: */
|
|
|
2481 if (ERRB_EQ (errb, ERROR_ME_NOT))
|
|
|
2482 return;
|
|
|
2483
|
|
|
2484 va_start (args, fmt);
|
|
771
|
2485 obj = emacs_vsprintf_string (CGETTEXT (fmt), args);
|
|
442
|
2486 va_end (args);
|
|
|
2487
|
|
|
2488 /* Fsignal GC-protects its args */
|
|
563
|
2489 maybe_signal_error (type, 0, obj, class, errb);
|
|
442
|
2490 }
|
|
|
2491
|
|
|
2492 Lisp_Object
|
|
665
|
2493 signal_continuable_ferror (Lisp_Object type, const CIntbyte *fmt, ...)
|
|
428
|
2494 {
|
|
|
2495 Lisp_Object obj;
|
|
|
2496 va_list args;
|
|
|
2497
|
|
|
2498 va_start (args, fmt);
|
|
771
|
2499 obj = emacs_vsprintf_string (CGETTEXT (fmt), args);
|
|
442
|
2500 va_end (args);
|
|
|
2501
|
|
|
2502 /* Fsignal GC-protects its args */
|
|
|
2503 return Fsignal (type, list1 (obj));
|
|
|
2504 }
|
|
|
2505
|
|
|
2506 Lisp_Object
|
|
563
|
2507 maybe_signal_continuable_ferror (Lisp_Object type, Lisp_Object class,
|
|
665
|
2508 Error_Behavior errb, const CIntbyte *fmt, ...)
|
|
442
|
2509 {
|
|
|
2510 Lisp_Object obj;
|
|
|
2511 va_list args;
|
|
|
2512
|
|
|
2513 /* Optimization: */
|
|
|
2514 if (ERRB_EQ (errb, ERROR_ME_NOT))
|
|
|
2515 return Qnil;
|
|
|
2516
|
|
|
2517 va_start (args, fmt);
|
|
771
|
2518 obj = emacs_vsprintf_string (CGETTEXT (fmt), args);
|
|
442
|
2519 va_end (args);
|
|
|
2520
|
|
|
2521 /* Fsignal GC-protects its args */
|
|
563
|
2522 return maybe_signal_continuable_error (type, 0, obj, class, errb);
|
|
442
|
2523 }
|
|
|
2524
|
|
|
2525
|
|
|
2526 /****************** Error functions class 5 ******************/
|
|
|
2527
|
|
563
|
2528 /* Class 5: Printf-like functions that signal an error.
|
|
442
|
2529 These functions signal an error of a specified type, whose data
|
|
563
|
2530 is a one or more objects, a string (created using the arguments)
|
|
|
2531 and additional Lisp objects specified in FROB. (The syntax of FROB
|
|
|
2532 is the same as for class 2.)
|
|
|
2533
|
|
|
2534 There is no need for a class 6 because you can always attach 2
|
|
|
2535 objects using class 5 (for FROB, specify a list with three
|
|
|
2536 elements, the first of which is Qunbound), and these functions are
|
|
|
2537 not commonly used.
|
|
|
2538 */
|
|
442
|
2539
|
|
|
2540 DOESNT_RETURN
|
|
665
|
2541 signal_ferror_with_frob (Lisp_Object type, Lisp_Object frob, const CIntbyte *fmt,
|
|
563
|
2542 ...)
|
|
442
|
2543 {
|
|
|
2544 Lisp_Object obj;
|
|
|
2545 va_list args;
|
|
|
2546
|
|
|
2547 va_start (args, fmt);
|
|
771
|
2548 obj = emacs_vsprintf_string (CGETTEXT (fmt), args);
|
|
442
|
2549 va_end (args);
|
|
|
2550
|
|
|
2551 /* Fsignal GC-protects its args */
|
|
563
|
2552 signal_error_1 (type, Fcons (obj, build_error_data (0, frob)));
|
|
442
|
2553 }
|
|
|
2554
|
|
|
2555 void
|
|
563
|
2556 maybe_signal_ferror_with_frob (Lisp_Object type, Lisp_Object frob,
|
|
578
|
2557 Lisp_Object class, Error_Behavior errb,
|
|
665
|
2558 const CIntbyte *fmt, ...)
|
|
442
|
2559 {
|
|
|
2560 Lisp_Object obj;
|
|
|
2561 va_list args;
|
|
|
2562
|
|
|
2563 /* Optimization: */
|
|
|
2564 if (ERRB_EQ (errb, ERROR_ME_NOT))
|
|
|
2565 return;
|
|
|
2566
|
|
|
2567 va_start (args, fmt);
|
|
771
|
2568 obj = emacs_vsprintf_string (CGETTEXT (fmt), args);
|
|
428
|
2569 va_end (args);
|
|
|
2570
|
|
|
2571 /* Fsignal GC-protects its args */
|
|
563
|
2572 maybe_signal_error_1 (type, Fcons (obj, build_error_data (0, frob)), class,
|
|
|
2573 errb);
|
|
428
|
2574 }
|
|
|
2575
|
|
|
2576 Lisp_Object
|
|
563
|
2577 signal_continuable_ferror_with_frob (Lisp_Object type, Lisp_Object frob,
|
|
665
|
2578 const CIntbyte *fmt, ...)
|
|
428
|
2579 {
|
|
|
2580 Lisp_Object obj;
|
|
|
2581 va_list args;
|
|
|
2582
|
|
|
2583 va_start (args, fmt);
|
|
771
|
2584 obj = emacs_vsprintf_string (CGETTEXT (fmt), args);
|
|
428
|
2585 va_end (args);
|
|
|
2586
|
|
|
2587 /* Fsignal GC-protects its args */
|
|
563
|
2588 return Fsignal (type, Fcons (obj, build_error_data (0, frob)));
|
|
428
|
2589 }
|
|
|
2590
|
|
|
2591 Lisp_Object
|
|
563
|
2592 maybe_signal_continuable_ferror_with_frob (Lisp_Object type, Lisp_Object frob,
|
|
|
2593 Lisp_Object class,
|
|
578
|
2594 Error_Behavior errb,
|
|
665
|
2595 const CIntbyte *fmt, ...)
|
|
428
|
2596 {
|
|
|
2597 Lisp_Object obj;
|
|
|
2598 va_list args;
|
|
|
2599
|
|
|
2600 /* Optimization: */
|
|
|
2601 if (ERRB_EQ (errb, ERROR_ME_NOT))
|
|
|
2602 return Qnil;
|
|
|
2603
|
|
|
2604 va_start (args, fmt);
|
|
771
|
2605 obj = emacs_vsprintf_string (CGETTEXT (fmt), args);
|
|
428
|
2606 va_end (args);
|
|
|
2607
|
|
|
2608 /* Fsignal GC-protects its args */
|
|
563
|
2609 return maybe_signal_continuable_error_1 (type,
|
|
|
2610 Fcons (obj,
|
|
|
2611 build_error_data (0, frob)),
|
|
|
2612 class, errb);
|
|
428
|
2613 }
|
|
|
2614
|
|
|
2615
|
|
|
2616 /* This is what the QUIT macro calls to signal a quit */
|
|
|
2617 void
|
|
|
2618 signal_quit (void)
|
|
|
2619 {
|
|
|
2620 /* This function can GC */
|
|
|
2621 if (EQ (Vquit_flag, Qcritical))
|
|
|
2622 debug_on_quit |= 2; /* set critical bit. */
|
|
|
2623 Vquit_flag = Qnil;
|
|
|
2624 /* note that this is continuable. */
|
|
|
2625 Fsignal (Qquit, Qnil);
|
|
|
2626 }
|
|
|
2627
|
|
|
2628
|
|
563
|
2629 /************************ convenience error functions ***********************/
|
|
|
2630
|
|
436
|
2631 Lisp_Object
|
|
428
|
2632 signal_void_function_error (Lisp_Object function)
|
|
|
2633 {
|
|
436
|
2634 return Fsignal (Qvoid_function, list1 (function));
|
|
428
|
2635 }
|
|
|
2636
|
|
436
|
2637 Lisp_Object
|
|
428
|
2638 signal_invalid_function_error (Lisp_Object function)
|
|
|
2639 {
|
|
436
|
2640 return Fsignal (Qinvalid_function, list1 (function));
|
|
428
|
2641 }
|
|
|
2642
|
|
436
|
2643 Lisp_Object
|
|
428
|
2644 signal_wrong_number_of_arguments_error (Lisp_Object function, int nargs)
|
|
|
2645 {
|
|
436
|
2646 return Fsignal (Qwrong_number_of_arguments,
|
|
|
2647 list2 (function, make_int (nargs)));
|
|
428
|
2648 }
|
|
|
2649
|
|
|
2650 /* Used in list traversal macros for efficiency. */
|
|
436
|
2651 DOESNT_RETURN
|
|
428
|
2652 signal_malformed_list_error (Lisp_Object list)
|
|
|
2653 {
|
|
563
|
2654 signal_error (Qmalformed_list, 0, list);
|
|
428
|
2655 }
|
|
|
2656
|
|
436
|
2657 DOESNT_RETURN
|
|
428
|
2658 signal_malformed_property_list_error (Lisp_Object list)
|
|
|
2659 {
|
|
563
|
2660 signal_error (Qmalformed_property_list, 0, list);
|
|
428
|
2661 }
|
|
|
2662
|
|
436
|
2663 DOESNT_RETURN
|
|
428
|
2664 signal_circular_list_error (Lisp_Object list)
|
|
|
2665 {
|
|
563
|
2666 signal_error (Qcircular_list, 0, list);
|
|
428
|
2667 }
|
|
|
2668
|
|
436
|
2669 DOESNT_RETURN
|
|
428
|
2670 signal_circular_property_list_error (Lisp_Object list)
|
|
|
2671 {
|
|
563
|
2672 signal_error (Qcircular_property_list, 0, list);
|
|
428
|
2673 }
|
|
442
|
2674
|
|
|
2675 DOESNT_RETURN
|
|
665
|
2676 syntax_error (const CIntbyte *reason, Lisp_Object frob)
|
|
442
|
2677 {
|
|
563
|
2678 signal_error (Qsyntax_error, reason, frob);
|
|
442
|
2679 }
|
|
|
2680
|
|
|
2681 DOESNT_RETURN
|
|
665
|
2682 syntax_error_2 (const CIntbyte *reason, Lisp_Object frob1, Lisp_Object frob2)
|
|
442
|
2683 {
|
|
563
|
2684 signal_error_2 (Qsyntax_error, reason, frob1, frob2);
|
|
|
2685 }
|
|
|
2686
|
|
|
2687 void
|
|
665
|
2688 maybe_syntax_error (const CIntbyte *reason, Lisp_Object frob,
|
|
578
|
2689 Lisp_Object class, Error_Behavior errb)
|
|
563
|
2690 {
|
|
|
2691 maybe_signal_error (Qsyntax_error, reason, frob, class, errb);
|
|
|
2692 }
|
|
|
2693
|
|
|
2694 DOESNT_RETURN
|
|
665
|
2695 sferror (const CIntbyte *reason, Lisp_Object frob)
|
|
563
|
2696 {
|
|
|
2697 signal_error (Qstructure_formation_error, reason, frob);
|
|
|
2698 }
|
|
|
2699
|
|
|
2700 DOESNT_RETURN
|
|
665
|
2701 sferror_2 (const CIntbyte *reason, Lisp_Object frob1, Lisp_Object frob2)
|
|
563
|
2702 {
|
|
|
2703 signal_error_2 (Qstructure_formation_error, reason, frob1, frob2);
|
|
|
2704 }
|
|
|
2705
|
|
|
2706 void
|
|
665
|
2707 maybe_sferror (const CIntbyte *reason, Lisp_Object frob,
|
|
578
|
2708 Lisp_Object class, Error_Behavior errb)
|
|
563
|
2709 {
|
|
|
2710 maybe_signal_error (Qstructure_formation_error, reason, frob, class, errb);
|
|
442
|
2711 }
|
|
|
2712
|
|
|
2713 DOESNT_RETURN
|
|
665
|
2714 invalid_argument (const CIntbyte *reason, Lisp_Object frob)
|
|
442
|
2715 {
|
|
563
|
2716 signal_error (Qinvalid_argument, reason, frob);
|
|
442
|
2717 }
|
|
|
2718
|
|
|
2719 DOESNT_RETURN
|
|
665
|
2720 invalid_argument_2 (const CIntbyte *reason, Lisp_Object frob1,
|
|
609
|
2721 Lisp_Object frob2)
|
|
442
|
2722 {
|
|
563
|
2723 signal_error_2 (Qinvalid_argument, reason, frob1, frob2);
|
|
|
2724 }
|
|
|
2725
|
|
|
2726 void
|
|
665
|
2727 maybe_invalid_argument (const CIntbyte *reason, Lisp_Object frob,
|
|
578
|
2728 Lisp_Object class, Error_Behavior errb)
|
|
563
|
2729 {
|
|
|
2730 maybe_signal_error (Qinvalid_argument, reason, frob, class, errb);
|
|
|
2731 }
|
|
|
2732
|
|
|
2733 DOESNT_RETURN
|
|
665
|
2734 invalid_constant (const CIntbyte *reason, Lisp_Object frob)
|
|
563
|
2735 {
|
|
|
2736 signal_error (Qinvalid_constant, reason, frob);
|
|
|
2737 }
|
|
|
2738
|
|
|
2739 DOESNT_RETURN
|
|
665
|
2740 invalid_constant_2 (const CIntbyte *reason, Lisp_Object frob1,
|
|
609
|
2741 Lisp_Object frob2)
|
|
563
|
2742 {
|
|
|
2743 signal_error_2 (Qinvalid_constant, reason, frob1, frob2);
|
|
|
2744 }
|
|
|
2745
|
|
|
2746 void
|
|
665
|
2747 maybe_invalid_constant (const CIntbyte *reason, Lisp_Object frob,
|
|
578
|
2748 Lisp_Object class, Error_Behavior errb)
|
|
563
|
2749 {
|
|
|
2750 maybe_signal_error (Qinvalid_constant, reason, frob, class, errb);
|
|
442
|
2751 }
|
|
|
2752
|
|
|
2753 DOESNT_RETURN
|
|
665
|
2754 invalid_operation (const CIntbyte *reason, Lisp_Object frob)
|
|
442
|
2755 {
|
|
563
|
2756 signal_error (Qinvalid_operation, reason, frob);
|
|
442
|
2757 }
|
|
|
2758
|
|
|
2759 DOESNT_RETURN
|
|
665
|
2760 invalid_operation_2 (const CIntbyte *reason, Lisp_Object frob1,
|
|
609
|
2761 Lisp_Object frob2)
|
|
442
|
2762 {
|
|
563
|
2763 signal_error_2 (Qinvalid_operation, reason, frob1, frob2);
|
|
|
2764 }
|
|
|
2765
|
|
|
2766 void
|
|
665
|
2767 maybe_invalid_operation (const CIntbyte *reason, Lisp_Object frob,
|
|
578
|
2768 Lisp_Object class, Error_Behavior errb)
|
|
563
|
2769 {
|
|
|
2770 maybe_signal_error (Qinvalid_operation, reason, frob, class, errb);
|
|
442
|
2771 }
|
|
|
2772
|
|
|
2773 DOESNT_RETURN
|
|
665
|
2774 invalid_change (const CIntbyte *reason, Lisp_Object frob)
|
|
442
|
2775 {
|
|
563
|
2776 signal_error (Qinvalid_change, reason, frob);
|
|
442
|
2777 }
|
|
|
2778
|
|
|
2779 DOESNT_RETURN
|
|
665
|
2780 invalid_change_2 (const CIntbyte *reason, Lisp_Object frob1, Lisp_Object frob2)
|
|
442
|
2781 {
|
|
563
|
2782 signal_error_2 (Qinvalid_change, reason, frob1, frob2);
|
|
|
2783 }
|
|
|
2784
|
|
|
2785 void
|
|
665
|
2786 maybe_invalid_change (const CIntbyte *reason, Lisp_Object frob,
|
|
578
|
2787 Lisp_Object class, Error_Behavior errb)
|
|
563
|
2788 {
|
|
|
2789 maybe_signal_error (Qinvalid_change, reason, frob, class, errb);
|
|
|
2790 }
|
|
|
2791
|
|
|
2792 DOESNT_RETURN
|
|
665
|
2793 invalid_state (const CIntbyte *reason, Lisp_Object frob)
|
|
563
|
2794 {
|
|
|
2795 signal_error (Qinvalid_state, reason, frob);
|
|
|
2796 }
|
|
|
2797
|
|
|
2798 DOESNT_RETURN
|
|
665
|
2799 invalid_state_2 (const CIntbyte *reason, Lisp_Object frob1, Lisp_Object frob2)
|
|
563
|
2800 {
|
|
|
2801 signal_error_2 (Qinvalid_state, reason, frob1, frob2);
|
|
|
2802 }
|
|
|
2803
|
|
|
2804 void
|
|
665
|
2805 maybe_invalid_state (const CIntbyte *reason, Lisp_Object frob,
|
|
578
|
2806 Lisp_Object class, Error_Behavior errb)
|
|
563
|
2807 {
|
|
|
2808 maybe_signal_error (Qinvalid_state, reason, frob, class, errb);
|
|
|
2809 }
|
|
|
2810
|
|
|
2811 DOESNT_RETURN
|
|
665
|
2812 wtaerror (const CIntbyte *reason, Lisp_Object frob)
|
|
563
|
2813 {
|
|
|
2814 signal_error (Qwrong_type_argument, reason, frob);
|
|
|
2815 }
|
|
|
2816
|
|
|
2817 DOESNT_RETURN
|
|
665
|
2818 stack_overflow (const CIntbyte *reason, Lisp_Object frob)
|
|
563
|
2819 {
|
|
|
2820 signal_error (Qstack_overflow, reason, frob);
|
|
|
2821 }
|
|
|
2822
|
|
|
2823 DOESNT_RETURN
|
|
665
|
2824 out_of_memory (const CIntbyte *reason, Lisp_Object frob)
|
|
563
|
2825 {
|
|
|
2826 signal_error (Qout_of_memory, reason, frob);
|
|
|
2827 }
|
|
|
2828
|
|
|
2829 DOESNT_RETURN
|
|
665
|
2830 printing_unreadable_object (const CIntbyte *fmt, ...)
|
|
563
|
2831 {
|
|
|
2832 Lisp_Object obj;
|
|
|
2833 va_list args;
|
|
|
2834
|
|
|
2835 va_start (args, fmt);
|
|
771
|
2836 obj = emacs_vsprintf_string (CGETTEXT (fmt), args);
|
|
563
|
2837 va_end (args);
|
|
|
2838
|
|
|
2839 /* Fsignal GC-protects its args */
|
|
|
2840 signal_error (Qprinting_unreadable_object, 0, obj);
|
|
442
|
2841 }
|
|
|
2842
|
|
428
|
2843
|
|
|
2844 /************************************************************************/
|
|
|
2845 /* User commands */
|
|
|
2846 /************************************************************************/
|
|
|
2847
|
|
|
2848 DEFUN ("commandp", Fcommandp, 1, 1, 0, /*
|
|
|
2849 Return t if FUNCTION makes provisions for interactive calling.
|
|
|
2850 This means it contains a description for how to read arguments to give it.
|
|
|
2851 The value is nil for an invalid function or a symbol with no function
|
|
|
2852 definition.
|
|
|
2853
|
|
|
2854 Interactively callable functions include
|
|
|
2855
|
|
|
2856 -- strings and vectors (treated as keyboard macros)
|
|
|
2857 -- lambda-expressions that contain a top-level call to `interactive'
|
|
|
2858 -- autoload definitions made by `autoload' with non-nil fourth argument
|
|
|
2859 (i.e. the interactive flag)
|
|
|
2860 -- compiled-function objects with a non-nil `compiled-function-interactive'
|
|
|
2861 value
|
|
|
2862 -- subrs (built-in functions) that are interactively callable
|
|
|
2863
|
|
|
2864 Also, a symbol satisfies `commandp' if its function definition does so.
|
|
|
2865 */
|
|
|
2866 (function))
|
|
|
2867 {
|
|
|
2868 Lisp_Object fun = indirect_function (function, 0);
|
|
|
2869
|
|
|
2870 if (COMPILED_FUNCTIONP (fun))
|
|
|
2871 return XCOMPILED_FUNCTION (fun)->flags.interactivep ? Qt : Qnil;
|
|
|
2872
|
|
|
2873 /* Lists may represent commands. */
|
|
|
2874 if (CONSP (fun))
|
|
|
2875 {
|
|
|
2876 Lisp_Object funcar = XCAR (fun);
|
|
|
2877 if (EQ (funcar, Qlambda))
|
|
|
2878 return Fassq (Qinteractive, Fcdr (Fcdr (fun)));
|
|
|
2879 if (EQ (funcar, Qautoload))
|
|
|
2880 return Fcar (Fcdr (Fcdr (Fcdr (fun))));
|
|
|
2881 else
|
|
|
2882 return Qnil;
|
|
|
2883 }
|
|
|
2884
|
|
|
2885 /* Emacs primitives are interactive if their DEFUN specifies an
|
|
|
2886 interactive spec. */
|
|
|
2887 if (SUBRP (fun))
|
|
|
2888 return XSUBR (fun)->prompt ? Qt : Qnil;
|
|
|
2889
|
|
|
2890 /* Strings and vectors are keyboard macros. */
|
|
|
2891 if (VECTORP (fun) || STRINGP (fun))
|
|
|
2892 return Qt;
|
|
|
2893
|
|
|
2894 /* Everything else (including Qunbound) is not a command. */
|
|
|
2895 return Qnil;
|
|
|
2896 }
|
|
|
2897
|
|
|
2898 DEFUN ("command-execute", Fcommand_execute, 1, 3, 0, /*
|
|
|
2899 Execute CMD as an editor command.
|
|
|
2900 CMD must be an object that satisfies the `commandp' predicate.
|
|
|
2901 Optional second arg RECORD-FLAG is as in `call-interactively'.
|
|
|
2902 The argument KEYS specifies the value to use instead of (this-command-keys)
|
|
|
2903 when reading the arguments.
|
|
|
2904 */
|
|
444
|
2905 (cmd, record_flag, keys))
|
|
428
|
2906 {
|
|
|
2907 /* This function can GC */
|
|
|
2908 Lisp_Object prefixarg;
|
|
|
2909 Lisp_Object final = cmd;
|
|
|
2910 struct backtrace backtrace;
|
|
|
2911 struct console *con = XCONSOLE (Vselected_console);
|
|
|
2912
|
|
|
2913 prefixarg = con->prefix_arg;
|
|
|
2914 con->prefix_arg = Qnil;
|
|
|
2915 Vcurrent_prefix_arg = prefixarg;
|
|
|
2916 debug_on_next_call = 0; /* #### from FSFmacs; correct? */
|
|
|
2917
|
|
|
2918 if (SYMBOLP (cmd) && !NILP (Fget (cmd, Qdisabled, Qnil)))
|
|
733
|
2919 return run_hook (Qdisabled_command_hook);
|
|
428
|
2920
|
|
|
2921 for (;;)
|
|
|
2922 {
|
|
|
2923 final = indirect_function (cmd, 1);
|
|
|
2924 if (CONSP (final) && EQ (Fcar (final), Qautoload))
|
|
|
2925 do_autoload (final, cmd);
|
|
|
2926 else
|
|
|
2927 break;
|
|
|
2928 }
|
|
|
2929
|
|
|
2930 if (CONSP (final) || SUBRP (final) || COMPILED_FUNCTIONP (final))
|
|
|
2931 {
|
|
|
2932 backtrace.function = &Qcall_interactively;
|
|
|
2933 backtrace.args = &cmd;
|
|
|
2934 backtrace.nargs = 1;
|
|
|
2935 backtrace.evalargs = 0;
|
|
|
2936 backtrace.pdlcount = specpdl_depth();
|
|
|
2937 backtrace.debug_on_exit = 0;
|
|
|
2938 PUSH_BACKTRACE (backtrace);
|
|
|
2939
|
|
444
|
2940 final = Fcall_interactively (cmd, record_flag, keys);
|
|
428
|
2941
|
|
|
2942 POP_BACKTRACE (backtrace);
|
|
|
2943 return final;
|
|
|
2944 }
|
|
|
2945 else if (STRINGP (final) || VECTORP (final))
|
|
|
2946 {
|
|
|
2947 return Fexecute_kbd_macro (final, prefixarg);
|
|
|
2948 }
|
|
|
2949 else
|
|
|
2950 {
|
|
|
2951 Fsignal (Qwrong_type_argument,
|
|
|
2952 Fcons (Qcommandp,
|
|
|
2953 (EQ (cmd, final)
|
|
|
2954 ? list1 (cmd)
|
|
|
2955 : list2 (cmd, final))));
|
|
|
2956 return Qnil;
|
|
|
2957 }
|
|
|
2958 }
|
|
|
2959
|
|
|
2960 DEFUN ("interactive-p", Finteractive_p, 0, 0, 0, /*
|
|
|
2961 Return t if function in which this appears was called interactively.
|
|
|
2962 This means that the function was called with call-interactively (which
|
|
|
2963 includes being called as the binding of a key)
|
|
|
2964 and input is currently coming from the keyboard (not in keyboard macro).
|
|
|
2965 */
|
|
|
2966 ())
|
|
|
2967 {
|
|
|
2968 REGISTER struct backtrace *btp;
|
|
|
2969 REGISTER Lisp_Object fun;
|
|
|
2970
|
|
|
2971 if (!INTERACTIVE)
|
|
|
2972 return Qnil;
|
|
|
2973
|
|
|
2974 /* Unless the object was compiled, skip the frame of interactive-p itself
|
|
|
2975 (if interpreted) or the frame of byte-code (if called from a compiled
|
|
|
2976 function). Note that *btp->function may be a symbol pointing at a
|
|
|
2977 compiled function. */
|
|
|
2978 btp = backtrace_list;
|
|
|
2979
|
|
|
2980 #if 0 /* FSFmacs */
|
|
|
2981
|
|
|
2982 /* #### FSFmacs does the following instead. I can't figure
|
|
|
2983 out which one is more correct. */
|
|
|
2984 /* If this isn't a byte-compiled function, there may be a frame at
|
|
|
2985 the top for Finteractive_p itself. If so, skip it. */
|
|
|
2986 fun = Findirect_function (*btp->function);
|
|
|
2987 if (SUBRP (fun) && XSUBR (fun) == &Sinteractive_p)
|
|
|
2988 btp = btp->next;
|
|
|
2989
|
|
|
2990 /* If we're running an Emacs 18-style byte-compiled function, there
|
|
|
2991 may be a frame for Fbyte_code. Now, given the strictest
|
|
|
2992 definition, this function isn't really being called
|
|
|
2993 interactively, but because that's the way Emacs 18 always builds
|
|
|
2994 byte-compiled functions, we'll accept it for now. */
|
|
|
2995 if (EQ (*btp->function, Qbyte_code))
|
|
|
2996 btp = btp->next;
|
|
|
2997
|
|
|
2998 /* If this isn't a byte-compiled function, then we may now be
|
|
|
2999 looking at several frames for special forms. Skip past them. */
|
|
|
3000 while (btp &&
|
|
|
3001 btp->nargs == UNEVALLED)
|
|
|
3002 btp = btp->next;
|
|
|
3003
|
|
|
3004 #else
|
|
|
3005
|
|
|
3006 if (! (COMPILED_FUNCTIONP (Findirect_function (*btp->function))))
|
|
|
3007 btp = btp->next;
|
|
|
3008 for (;
|
|
|
3009 btp && (btp->nargs == UNEVALLED
|
|
|
3010 || EQ (*btp->function, Qbyte_code));
|
|
|
3011 btp = btp->next)
|
|
|
3012 {}
|
|
|
3013 /* btp now points at the frame of the innermost function
|
|
|
3014 that DOES eval its args.
|
|
|
3015 If it is a built-in function (such as load or eval-region)
|
|
|
3016 return nil. */
|
|
|
3017 /* Beats me why this is necessary, but it is */
|
|
|
3018 if (btp && EQ (*btp->function, Qcall_interactively))
|
|
|
3019 return Qt;
|
|
|
3020
|
|
|
3021 #endif
|
|
|
3022
|
|
|
3023 fun = Findirect_function (*btp->function);
|
|
|
3024 if (SUBRP (fun))
|
|
|
3025 return Qnil;
|
|
|
3026 /* btp points to the frame of a Lisp function that called interactive-p.
|
|
|
3027 Return t if that function was called interactively. */
|
|
|
3028 if (btp && btp->next && EQ (*btp->next->function, Qcall_interactively))
|
|
|
3029 return Qt;
|
|
|
3030 return Qnil;
|
|
|
3031 }
|
|
|
3032
|
|
|
3033
|
|
|
3034 /************************************************************************/
|
|
|
3035 /* Autoloading */
|
|
|
3036 /************************************************************************/
|
|
|
3037
|
|
|
3038 DEFUN ("autoload", Fautoload, 2, 5, 0, /*
|
|
444
|
3039 Define FUNCTION to autoload from FILENAME.
|
|
|
3040 FUNCTION is a symbol; FILENAME is a file name string to pass to `load'.
|
|
|
3041 The remaining optional arguments provide additional info about the
|
|
|
3042 real definition.
|
|
|
3043 DOCSTRING is documentation for FUNCTION.
|
|
|
3044 INTERACTIVE, if non-nil, says FUNCTION can be called interactively.
|
|
|
3045 TYPE indicates the type of the object:
|
|
428
|
3046 nil or omitted says FUNCTION is a function,
|
|
|
3047 `keymap' says FUNCTION is really a keymap, and
|
|
|
3048 `macro' or t says FUNCTION is really a macro.
|
|
444
|
3049 If FUNCTION already has a non-void function definition that is not an
|
|
|
3050 autoload object, this function does nothing and returns nil.
|
|
428
|
3051 */
|
|
444
|
3052 (function, filename, docstring, interactive, type))
|
|
428
|
3053 {
|
|
|
3054 /* This function can GC */
|
|
|
3055 CHECK_SYMBOL (function);
|
|
444
|
3056 CHECK_STRING (filename);
|
|
428
|
3057
|
|
|
3058 /* If function is defined and not as an autoload, don't override */
|
|
|
3059 {
|
|
|
3060 Lisp_Object f = XSYMBOL (function)->function;
|
|
|
3061 if (!UNBOUNDP (f) && !(CONSP (f) && EQ (XCAR (f), Qautoload)))
|
|
|
3062 return Qnil;
|
|
|
3063 }
|
|
|
3064
|
|
|
3065 if (purify_flag)
|
|
|
3066 {
|
|
|
3067 /* Attempt to avoid consing identical (string=) pure strings. */
|
|
444
|
3068 filename = Fsymbol_name (Fintern (filename, Qnil));
|
|
428
|
3069 }
|
|
440
|
3070
|
|
444
|
3071 return Ffset (function, Fcons (Qautoload, list4 (filename,
|
|
428
|
3072 docstring,
|
|
|
3073 interactive,
|
|
|
3074 type)));
|
|
|
3075 }
|
|
|
3076
|
|
|
3077 Lisp_Object
|
|
|
3078 un_autoload (Lisp_Object oldqueue)
|
|
|
3079 {
|
|
|
3080 /* This function can GC */
|
|
|
3081 REGISTER Lisp_Object queue, first, second;
|
|
|
3082
|
|
|
3083 /* Queue to unwind is current value of Vautoload_queue.
|
|
|
3084 oldqueue is the shadowed value to leave in Vautoload_queue. */
|
|
|
3085 queue = Vautoload_queue;
|
|
|
3086 Vautoload_queue = oldqueue;
|
|
|
3087 while (CONSP (queue))
|
|
|
3088 {
|
|
|
3089 first = XCAR (queue);
|
|
|
3090 second = Fcdr (first);
|
|
|
3091 first = Fcar (first);
|
|
|
3092 if (NILP (second))
|
|
|
3093 Vfeatures = first;
|
|
|
3094 else
|
|
|
3095 Ffset (first, second);
|
|
|
3096 queue = Fcdr (queue);
|
|
|
3097 }
|
|
|
3098 return Qnil;
|
|
|
3099 }
|
|
|
3100
|
|
|
3101 void
|
|
|
3102 do_autoload (Lisp_Object fundef,
|
|
|
3103 Lisp_Object funname)
|
|
|
3104 {
|
|
|
3105 /* This function can GC */
|
|
|
3106 int speccount = specpdl_depth();
|
|
|
3107 Lisp_Object fun = funname;
|
|
|
3108 struct gcpro gcpro1, gcpro2;
|
|
|
3109
|
|
|
3110 CHECK_SYMBOL (funname);
|
|
|
3111 GCPRO2 (fun, funname);
|
|
|
3112
|
|
|
3113 /* Value saved here is to be restored into Vautoload_queue */
|
|
|
3114 record_unwind_protect (un_autoload, Vautoload_queue);
|
|
|
3115 Vautoload_queue = Qt;
|
|
|
3116 call4 (Qload, Fcar (Fcdr (fundef)), Qnil, noninteractive ? Qt : Qnil, Qnil);
|
|
|
3117
|
|
|
3118 {
|
|
|
3119 Lisp_Object queue;
|
|
|
3120
|
|
|
3121 /* Save the old autoloads, in case we ever do an unload. */
|
|
|
3122 for (queue = Vautoload_queue; CONSP (queue); queue = XCDR (queue))
|
|
|
3123 {
|
|
|
3124 Lisp_Object first = XCAR (queue);
|
|
|
3125 Lisp_Object second = Fcdr (first);
|
|
|
3126
|
|
|
3127 first = Fcar (first);
|
|
|
3128
|
|
|
3129 /* Note: This test is subtle. The cdr of an autoload-queue entry
|
|
|
3130 may be an atom if the autoload entry was generated by a defalias
|
|
|
3131 or fset. */
|
|
|
3132 if (CONSP (second))
|
|
|
3133 Fput (first, Qautoload, (XCDR (second)));
|
|
|
3134 }
|
|
|
3135 }
|
|
|
3136
|
|
|
3137 /* Once loading finishes, don't undo it. */
|
|
|
3138 Vautoload_queue = Qt;
|
|
771
|
3139 unbind_to (speccount);
|
|
428
|
3140
|
|
|
3141 fun = indirect_function (fun, 0);
|
|
|
3142
|
|
|
3143 #if 0 /* FSFmacs */
|
|
|
3144 if (!NILP (Fequal (fun, fundef)))
|
|
|
3145 #else
|
|
|
3146 if (UNBOUNDP (fun)
|
|
|
3147 || (CONSP (fun)
|
|
|
3148 && EQ (XCAR (fun), Qautoload)))
|
|
|
3149 #endif
|
|
563
|
3150 invalid_state ("Autoloading failed to define function", funname);
|
|
428
|
3151 UNGCPRO;
|
|
|
3152 }
|
|
|
3153
|
|
|
3154
|
|
|
3155 /************************************************************************/
|
|
|
3156 /* eval, funcall, apply */
|
|
|
3157 /************************************************************************/
|
|
|
3158
|
|
|
3159 static Lisp_Object funcall_lambda (Lisp_Object fun,
|
|
442
|
3160 int nargs, Lisp_Object args[]);
|
|
428
|
3161 static int in_warnings;
|
|
|
3162
|
|
|
3163 static Lisp_Object
|
|
|
3164 in_warnings_restore (Lisp_Object minimus)
|
|
|
3165 {
|
|
|
3166 in_warnings = 0;
|
|
|
3167 return Qnil;
|
|
|
3168 }
|
|
|
3169
|
|
|
3170 DEFUN ("eval", Feval, 1, 1, 0, /*
|
|
|
3171 Evaluate FORM and return its value.
|
|
|
3172 */
|
|
|
3173 (form))
|
|
|
3174 {
|
|
|
3175 /* This function can GC */
|
|
|
3176 Lisp_Object fun, val, original_fun, original_args;
|
|
|
3177 int nargs;
|
|
|
3178 struct backtrace backtrace;
|
|
|
3179
|
|
|
3180 /* I think this is a pretty safe place to call Lisp code, don't you? */
|
|
|
3181 while (!in_warnings && !NILP (Vpending_warnings))
|
|
|
3182 {
|
|
|
3183 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
|
|
|
3184 int speccount = specpdl_depth();
|
|
|
3185 Lisp_Object this_warning_cons, this_warning, class, level, messij;
|
|
|
3186
|
|
|
3187 record_unwind_protect (in_warnings_restore, Qnil);
|
|
|
3188 in_warnings = 1;
|
|
|
3189 this_warning_cons = Vpending_warnings;
|
|
|
3190 this_warning = XCAR (this_warning_cons);
|
|
|
3191 /* in case an error occurs in the warn function, at least
|
|
|
3192 it won't happen infinitely */
|
|
|
3193 Vpending_warnings = XCDR (Vpending_warnings);
|
|
|
3194 free_cons (XCONS (this_warning_cons));
|
|
|
3195 class = XCAR (this_warning);
|
|
|
3196 level = XCAR (XCDR (this_warning));
|
|
|
3197 messij = XCAR (XCDR (XCDR (this_warning)));
|
|
|
3198 free_list (this_warning);
|
|
|
3199
|
|
|
3200 if (NILP (Vpending_warnings))
|
|
|
3201 Vpending_warnings_tail = Qnil; /* perhaps not strictly necessary,
|
|
|
3202 but safer */
|
|
|
3203
|
|
|
3204 GCPRO4 (form, class, level, messij);
|
|
|
3205 if (!STRINGP (messij))
|
|
|
3206 messij = Fprin1_to_string (messij, Qnil);
|
|
|
3207 call3 (Qdisplay_warning, class, messij, level);
|
|
|
3208 UNGCPRO;
|
|
771
|
3209 unbind_to (speccount);
|
|
428
|
3210 }
|
|
|
3211
|
|
|
3212 if (!CONSP (form))
|
|
|
3213 {
|
|
|
3214 if (SYMBOLP (form))
|
|
|
3215 return Fsymbol_value (form);
|
|
|
3216 else
|
|
|
3217 return form;
|
|
|
3218 }
|
|
|
3219
|
|
|
3220 QUIT;
|
|
|
3221 if ((consing_since_gc > gc_cons_threshold) || always_gc)
|
|
|
3222 {
|
|
|
3223 struct gcpro gcpro1;
|
|
|
3224 GCPRO1 (form);
|
|
|
3225 garbage_collect_1 ();
|
|
|
3226 UNGCPRO;
|
|
|
3227 }
|
|
|
3228
|
|
|
3229 if (++lisp_eval_depth > max_lisp_eval_depth)
|
|
|
3230 {
|
|
|
3231 if (max_lisp_eval_depth < 100)
|
|
|
3232 max_lisp_eval_depth = 100;
|
|
|
3233 if (lisp_eval_depth > max_lisp_eval_depth)
|
|
563
|
3234 stack_overflow ("Lisp nesting exceeds `max-lisp-eval-depth'",
|
|
|
3235 Qunbound);
|
|
428
|
3236 }
|
|
|
3237
|
|
|
3238 /* We guaranteed CONSP (form) above */
|
|
|
3239 original_fun = XCAR (form);
|
|
|
3240 original_args = XCDR (form);
|
|
|
3241
|
|
|
3242 GET_EXTERNAL_LIST_LENGTH (original_args, nargs);
|
|
|
3243
|
|
|
3244 backtrace.pdlcount = specpdl_depth();
|
|
|
3245 backtrace.function = &original_fun; /* This also protects them from gc */
|
|
|
3246 backtrace.args = &original_args;
|
|
|
3247 backtrace.nargs = UNEVALLED;
|
|
|
3248 backtrace.evalargs = 1;
|
|
|
3249 backtrace.debug_on_exit = 0;
|
|
|
3250 PUSH_BACKTRACE (backtrace);
|
|
|
3251
|
|
|
3252 if (debug_on_next_call)
|
|
|
3253 do_debug_on_call (Qt);
|
|
|
3254
|
|
|
3255 if (profiling_active)
|
|
|
3256 profile_increase_call_count (original_fun);
|
|
|
3257
|
|
|
3258 /* At this point, only original_fun and original_args
|
|
|
3259 have values that will be used below. */
|
|
|
3260 retry:
|
|
|
3261 fun = indirect_function (original_fun, 1);
|
|
|
3262
|
|
|
3263 if (SUBRP (fun))
|
|
|
3264 {
|
|
|
3265 Lisp_Subr *subr = XSUBR (fun);
|
|
|
3266 int max_args = subr->max_args;
|
|
|
3267
|
|
|
3268 if (nargs < subr->min_args)
|
|
|
3269 goto wrong_number_of_arguments;
|
|
|
3270
|
|
|
3271 if (max_args == UNEVALLED) /* Optimize for the common case */
|
|
|
3272 {
|
|
|
3273 backtrace.evalargs = 0;
|
|
|
3274 val = (((Lisp_Object (*) (Lisp_Object)) subr_function (subr))
|
|
|
3275 (original_args));
|
|
|
3276 }
|
|
|
3277 else if (nargs <= max_args)
|
|
|
3278 {
|
|
|
3279 struct gcpro gcpro1;
|
|
|
3280 Lisp_Object args[SUBR_MAX_ARGS];
|
|
|
3281 REGISTER Lisp_Object *p = args;
|
|
|
3282
|
|
|
3283 GCPRO1 (args[0]);
|
|
|
3284 gcpro1.nvars = 0;
|
|
|
3285
|
|
|
3286 {
|
|
|
3287 LIST_LOOP_2 (arg, original_args)
|
|
|
3288 {
|
|
|
3289 *p++ = Feval (arg);
|
|
|
3290 gcpro1.nvars++;
|
|
|
3291 }
|
|
|
3292 }
|
|
|
3293
|
|
|
3294 /* &optional args default to nil. */
|
|
|
3295 while (p - args < max_args)
|
|
|
3296 *p++ = Qnil;
|
|
|
3297
|
|
|
3298 backtrace.args = args;
|
|
|
3299 backtrace.nargs = nargs;
|
|
|
3300
|
|
|
3301 FUNCALL_SUBR (val, subr, args, max_args);
|
|
|
3302
|
|
|
3303 UNGCPRO;
|
|
|
3304 }
|
|
|
3305 else if (max_args == MANY)
|
|
|
3306 {
|
|
|
3307 /* Pass a vector of evaluated arguments */
|
|
|
3308 struct gcpro gcpro1;
|
|
|
3309 Lisp_Object *args = alloca_array (Lisp_Object, nargs);
|
|
|
3310 REGISTER Lisp_Object *p = args;
|
|
|
3311
|
|
|
3312 GCPRO1 (args[0]);
|
|
|
3313 gcpro1.nvars = 0;
|
|
|
3314
|
|
|
3315 {
|
|
|
3316 LIST_LOOP_2 (arg, original_args)
|
|
|
3317 {
|
|
|
3318 *p++ = Feval (arg);
|
|
|
3319 gcpro1.nvars++;
|
|
|
3320 }
|
|
|
3321 }
|
|
|
3322
|
|
|
3323 backtrace.args = args;
|
|
|
3324 backtrace.nargs = nargs;
|
|
|
3325
|
|
|
3326 val = (((Lisp_Object (*) (int, Lisp_Object *)) subr_function (subr))
|
|
|
3327 (nargs, args));
|
|
|
3328
|
|
|
3329 UNGCPRO;
|
|
|
3330 }
|
|
|
3331 else
|
|
|
3332 {
|
|
|
3333 wrong_number_of_arguments:
|
|
440
|
3334 val = signal_wrong_number_of_arguments_error (original_fun, nargs);
|
|
428
|
3335 }
|
|
|
3336 }
|
|
|
3337 else if (COMPILED_FUNCTIONP (fun))
|
|
|
3338 {
|
|
|
3339 struct gcpro gcpro1;
|
|
|
3340 Lisp_Object *args = alloca_array (Lisp_Object, nargs);
|
|
|
3341 REGISTER Lisp_Object *p = args;
|
|
|
3342
|
|
|
3343 GCPRO1 (args[0]);
|
|
|
3344 gcpro1.nvars = 0;
|
|
|
3345
|
|
|
3346 {
|
|
|
3347 LIST_LOOP_2 (arg, original_args)
|
|
|
3348 {
|
|
|
3349 *p++ = Feval (arg);
|
|
|
3350 gcpro1.nvars++;
|
|
|
3351 }
|
|
|
3352 }
|
|
|
3353
|
|
|
3354 backtrace.args = args;
|
|
|
3355 backtrace.nargs = nargs;
|
|
|
3356 backtrace.evalargs = 0;
|
|
|
3357
|
|
|
3358 val = funcall_compiled_function (fun, nargs, args);
|
|
|
3359
|
|
|
3360 /* Do the debug-on-exit now, while args is still GCPROed. */
|
|
|
3361 if (backtrace.debug_on_exit)
|
|
|
3362 val = do_debug_on_exit (val);
|
|
|
3363 /* Don't do it again when we return to eval. */
|
|
|
3364 backtrace.debug_on_exit = 0;
|
|
|
3365
|
|
|
3366 UNGCPRO;
|
|
|
3367 }
|
|
|
3368 else if (CONSP (fun))
|
|
|
3369 {
|
|
|
3370 Lisp_Object funcar = XCAR (fun);
|
|
|
3371
|
|
|
3372 if (EQ (funcar, Qautoload))
|
|
|
3373 {
|
|
|
3374 do_autoload (fun, original_fun);
|
|
|
3375 goto retry;
|
|
|
3376 }
|
|
|
3377 else if (EQ (funcar, Qmacro))
|
|
|
3378 {
|
|
|
3379 val = Feval (apply1 (XCDR (fun), original_args));
|
|
|
3380 }
|
|
|
3381 else if (EQ (funcar, Qlambda))
|
|
|
3382 {
|
|
|
3383 struct gcpro gcpro1;
|
|
|
3384 Lisp_Object *args = alloca_array (Lisp_Object, nargs);
|
|
|
3385 REGISTER Lisp_Object *p = args;
|
|
|
3386
|
|
|
3387 GCPRO1 (args[0]);
|
|
|
3388 gcpro1.nvars = 0;
|
|
|
3389
|
|
|
3390 {
|
|
|
3391 LIST_LOOP_2 (arg, original_args)
|
|
|
3392 {
|
|
|
3393 *p++ = Feval (arg);
|
|
|
3394 gcpro1.nvars++;
|
|
|
3395 }
|
|
|
3396 }
|
|
|
3397
|
|
|
3398 UNGCPRO;
|
|
|
3399
|
|
|
3400 backtrace.args = args; /* this also GCPROs `args' */
|
|
|
3401 backtrace.nargs = nargs;
|
|
|
3402 backtrace.evalargs = 0;
|
|
|
3403
|
|
|
3404 val = funcall_lambda (fun, nargs, args);
|
|
|
3405
|
|
|
3406 /* Do the debug-on-exit now, while args is still GCPROed. */
|
|
|
3407 if (backtrace.debug_on_exit)
|
|
|
3408 val = do_debug_on_exit (val);
|
|
|
3409 /* Don't do it again when we return to eval. */
|
|
|
3410 backtrace.debug_on_exit = 0;
|
|
|
3411 }
|
|
|
3412 else
|
|
|
3413 {
|
|
|
3414 goto invalid_function;
|
|
|
3415 }
|
|
|
3416 }
|
|
|
3417 else /* ! (SUBRP (fun) || COMPILED_FUNCTIONP (fun) || CONSP (fun)) */
|
|
|
3418 {
|
|
|
3419 invalid_function:
|
|
436
|
3420 val = signal_invalid_function_error (fun);
|
|
428
|
3421 }
|
|
|
3422
|
|
|
3423 lisp_eval_depth--;
|
|
|
3424 if (backtrace.debug_on_exit)
|
|
|
3425 val = do_debug_on_exit (val);
|
|
|
3426 POP_BACKTRACE (backtrace);
|
|
|
3427 return val;
|
|
|
3428 }
|
|
|
3429
|
|
|
3430
|
|
|
3431 DEFUN ("funcall", Ffuncall, 1, MANY, 0, /*
|
|
|
3432 Call first argument as a function, passing the remaining arguments to it.
|
|
|
3433 Thus, (funcall 'cons 'x 'y) returns (x . y).
|
|
|
3434 */
|
|
|
3435 (int nargs, Lisp_Object *args))
|
|
|
3436 {
|
|
|
3437 /* This function can GC */
|
|
|
3438 Lisp_Object fun;
|
|
|
3439 Lisp_Object val;
|
|
|
3440 struct backtrace backtrace;
|
|
|
3441 int fun_nargs = nargs - 1;
|
|
|
3442 Lisp_Object *fun_args = args + 1;
|
|
|
3443
|
|
|
3444 QUIT;
|
|
|
3445 if ((consing_since_gc > gc_cons_threshold) || always_gc)
|
|
|
3446 /* Callers should gcpro lexpr args */
|
|
|
3447 garbage_collect_1 ();
|
|
|
3448
|
|
|
3449 if (++lisp_eval_depth > max_lisp_eval_depth)
|
|
|
3450 {
|
|
|
3451 if (max_lisp_eval_depth < 100)
|
|
|
3452 max_lisp_eval_depth = 100;
|
|
|
3453 if (lisp_eval_depth > max_lisp_eval_depth)
|
|
563
|
3454 stack_overflow ("Lisp nesting exceeds `max-lisp-eval-depth'",
|
|
|
3455 Qunbound);
|
|
428
|
3456 }
|
|
|
3457
|
|
|
3458 backtrace.pdlcount = specpdl_depth();
|
|
|
3459 backtrace.function = &args[0];
|
|
|
3460 backtrace.args = fun_args;
|
|
|
3461 backtrace.nargs = fun_nargs;
|
|
|
3462 backtrace.evalargs = 0;
|
|
|
3463 backtrace.debug_on_exit = 0;
|
|
|
3464 PUSH_BACKTRACE (backtrace);
|
|
|
3465
|
|
|
3466 if (debug_on_next_call)
|
|
|
3467 do_debug_on_call (Qlambda);
|
|
|
3468
|
|
|
3469 retry:
|
|
|
3470
|
|
|
3471 fun = args[0];
|
|
|
3472
|
|
|
3473 /* It might be useful to place this *after* all the checks. */
|
|
|
3474 if (profiling_active)
|
|
|
3475 profile_increase_call_count (fun);
|
|
|
3476
|
|
|
3477 /* We could call indirect_function directly, but profiling shows
|
|
|
3478 this is worth optimizing by partially unrolling the loop. */
|
|
|
3479 if (SYMBOLP (fun))
|
|
|
3480 {
|
|
|
3481 fun = XSYMBOL (fun)->function;
|
|
|
3482 if (SYMBOLP (fun))
|
|
|
3483 {
|
|
|
3484 fun = XSYMBOL (fun)->function;
|
|
|
3485 if (SYMBOLP (fun))
|
|
|
3486 fun = indirect_function (fun, 1);
|
|
|
3487 }
|
|
|
3488 }
|
|
|
3489
|
|
|
3490 if (SUBRP (fun))
|
|
|
3491 {
|
|
|
3492 Lisp_Subr *subr = XSUBR (fun);
|
|
|
3493 int max_args = subr->max_args;
|
|
|
3494 Lisp_Object spacious_args[SUBR_MAX_ARGS];
|
|
|
3495
|
|
|
3496 if (fun_nargs == max_args) /* Optimize for the common case */
|
|
|
3497 {
|
|
|
3498 funcall_subr:
|
|
|
3499 FUNCALL_SUBR (val, subr, fun_args, max_args);
|
|
|
3500 }
|
|
436
|
3501 else if (fun_nargs < subr->min_args)
|
|
|
3502 {
|
|
|
3503 goto wrong_number_of_arguments;
|
|
|
3504 }
|
|
428
|
3505 else if (fun_nargs < max_args)
|
|
|
3506 {
|
|
|
3507 Lisp_Object *p = spacious_args;
|
|
|
3508
|
|
|
3509 /* Default optionals to nil */
|
|
|
3510 while (fun_nargs--)
|
|
|
3511 *p++ = *fun_args++;
|
|
|
3512 while (p - spacious_args < max_args)
|
|
|
3513 *p++ = Qnil;
|
|
|
3514
|
|
|
3515 fun_args = spacious_args;
|
|
|
3516 goto funcall_subr;
|
|
|
3517 }
|
|
|
3518 else if (max_args == MANY)
|
|
|
3519 {
|
|
436
|
3520 val = SUBR_FUNCTION (subr, MANY) (fun_nargs, fun_args);
|
|
428
|
3521 }
|
|
|
3522 else if (max_args == UNEVALLED) /* Can't funcall a special form */
|
|
|
3523 {
|
|
|
3524 goto invalid_function;
|
|
|
3525 }
|
|
|
3526 else
|
|
|
3527 {
|
|
|
3528 wrong_number_of_arguments:
|
|
436
|
3529 val = signal_wrong_number_of_arguments_error (fun, fun_nargs);
|
|
428
|
3530 }
|
|
|
3531 }
|
|
|
3532 else if (COMPILED_FUNCTIONP (fun))
|
|
|
3533 {
|
|
|
3534 val = funcall_compiled_function (fun, fun_nargs, fun_args);
|
|
|
3535 }
|
|
|
3536 else if (CONSP (fun))
|
|
|
3537 {
|
|
|
3538 Lisp_Object funcar = XCAR (fun);
|
|
|
3539
|
|
|
3540 if (EQ (funcar, Qlambda))
|
|
|
3541 {
|
|
|
3542 val = funcall_lambda (fun, fun_nargs, fun_args);
|
|
|
3543 }
|
|
|
3544 else if (EQ (funcar, Qautoload))
|
|
|
3545 {
|
|
|
3546 do_autoload (fun, args[0]);
|
|
|
3547 goto retry;
|
|
|
3548 }
|
|
|
3549 else /* Can't funcall a macro */
|
|
|
3550 {
|
|
|
3551 goto invalid_function;
|
|
|
3552 }
|
|
|
3553 }
|
|
|
3554 else if (UNBOUNDP (fun))
|
|
|
3555 {
|
|
436
|
3556 val = signal_void_function_error (args[0]);
|
|
428
|
3557 }
|
|
|
3558 else
|
|
|
3559 {
|
|
|
3560 invalid_function:
|
|
436
|
3561 val = signal_invalid_function_error (fun);
|
|
428
|
3562 }
|
|
|
3563
|
|
|
3564 lisp_eval_depth--;
|
|
|
3565 if (backtrace.debug_on_exit)
|
|
|
3566 val = do_debug_on_exit (val);
|
|
|
3567 POP_BACKTRACE (backtrace);
|
|
|
3568 return val;
|
|
|
3569 }
|
|
|
3570
|
|
|
3571 DEFUN ("functionp", Ffunctionp, 1, 1, 0, /*
|
|
|
3572 Return t if OBJECT can be called as a function, else nil.
|
|
|
3573 A function is an object that can be applied to arguments,
|
|
|
3574 using for example `funcall' or `apply'.
|
|
|
3575 */
|
|
|
3576 (object))
|
|
|
3577 {
|
|
|
3578 if (SYMBOLP (object))
|
|
|
3579 object = indirect_function (object, 0);
|
|
|
3580
|
|
|
3581 return
|
|
|
3582 (SUBRP (object) ||
|
|
|
3583 COMPILED_FUNCTIONP (object) ||
|
|
|
3584 (CONSP (object) &&
|
|
|
3585 (EQ (XCAR (object), Qlambda) ||
|
|
|
3586 EQ (XCAR (object), Qautoload))))
|
|
|
3587 ? Qt : Qnil;
|
|
|
3588 }
|
|
|
3589
|
|
|
3590 static Lisp_Object
|
|
|
3591 function_argcount (Lisp_Object function, int function_min_args_p)
|
|
|
3592 {
|
|
|
3593 Lisp_Object orig_function = function;
|
|
|
3594 Lisp_Object arglist;
|
|
|
3595
|
|
|
3596 retry:
|
|
|
3597
|
|
|
3598 if (SYMBOLP (function))
|
|
|
3599 function = indirect_function (function, 1);
|
|
|
3600
|
|
|
3601 if (SUBRP (function))
|
|
|
3602 {
|
|
442
|
3603 /* Using return with the ?: operator tickles a DEC CC compiler bug. */
|
|
|
3604 if (function_min_args_p)
|
|
|
3605 return Fsubr_min_args (function);
|
|
|
3606 else
|
|
|
3607 return Fsubr_max_args (function);
|
|
428
|
3608 }
|
|
|
3609 else if (COMPILED_FUNCTIONP (function))
|
|
|
3610 {
|
|
|
3611 arglist = compiled_function_arglist (XCOMPILED_FUNCTION (function));
|
|
|
3612 }
|
|
|
3613 else if (CONSP (function))
|
|
|
3614 {
|
|
|
3615 Lisp_Object funcar = XCAR (function);
|
|
|
3616
|
|
|
3617 if (EQ (funcar, Qmacro))
|
|
|
3618 {
|
|
|
3619 function = XCDR (function);
|
|
|
3620 goto retry;
|
|
|
3621 }
|
|
|
3622 else if (EQ (funcar, Qautoload))
|
|
|
3623 {
|
|
442
|
3624 struct gcpro gcpro1;
|
|
|
3625
|
|
|
3626 GCPRO1 (function);
|
|
428
|
3627 do_autoload (function, orig_function);
|
|
442
|
3628 UNGCPRO;
|
|
|
3629 function = orig_function;
|
|
428
|
3630 goto retry;
|
|
|
3631 }
|
|
|
3632 else if (EQ (funcar, Qlambda))
|
|
|
3633 {
|
|
|
3634 arglist = Fcar (XCDR (function));
|
|
|
3635 }
|
|
|
3636 else
|
|
|
3637 {
|
|
|
3638 goto invalid_function;
|
|
|
3639 }
|
|
|
3640 }
|
|
|
3641 else
|
|
|
3642 {
|
|
|
3643 invalid_function:
|
|
442
|
3644 return signal_invalid_function_error (orig_function);
|
|
428
|
3645 }
|
|
|
3646
|
|
|
3647 {
|
|
|
3648 int argcount = 0;
|
|
|
3649
|
|
|
3650 EXTERNAL_LIST_LOOP_2 (arg, arglist)
|
|
|
3651 {
|
|
|
3652 if (EQ (arg, Qand_optional))
|
|
|
3653 {
|
|
|
3654 if (function_min_args_p)
|
|
|
3655 break;
|
|
|
3656 }
|
|
|
3657 else if (EQ (arg, Qand_rest))
|
|
|
3658 {
|
|
|
3659 if (function_min_args_p)
|
|
|
3660 break;
|
|
|
3661 else
|
|
|
3662 return Qnil;
|
|
|
3663 }
|
|
|
3664 else
|
|
|
3665 {
|
|
|
3666 argcount++;
|
|
|
3667 }
|
|
|
3668 }
|
|
|
3669
|
|
|
3670 return make_int (argcount);
|
|
|
3671 }
|
|
|
3672 }
|
|
|
3673
|
|
|
3674 DEFUN ("function-min-args", Ffunction_min_args, 1, 1, 0, /*
|
|
617
|
3675 Return the minimum number of arguments a function may be called with.
|
|
428
|
3676 The function may be any form that can be passed to `funcall',
|
|
|
3677 any special form, or any macro.
|
|
|
3678 */
|
|
|
3679 (function))
|
|
|
3680 {
|
|
|
3681 return function_argcount (function, 1);
|
|
|
3682 }
|
|
|
3683
|
|
|
3684 DEFUN ("function-max-args", Ffunction_max_args, 1, 1, 0, /*
|
|
617
|
3685 Return the maximum number of arguments a function may be called with.
|
|
428
|
3686 The function may be any form that can be passed to `funcall',
|
|
|
3687 any special form, or any macro.
|
|
|
3688 If the function takes an arbitrary number of arguments or is
|
|
|
3689 a built-in special form, nil is returned.
|
|
|
3690 */
|
|
|
3691 (function))
|
|
|
3692 {
|
|
|
3693 return function_argcount (function, 0);
|
|
|
3694 }
|
|
|
3695
|
|
|
3696
|
|
|
3697 DEFUN ("apply", Fapply, 2, MANY, 0, /*
|
|
|
3698 Call FUNCTION with the remaining args, using the last arg as a list of args.
|
|
|
3699 Thus, (apply '+ 1 2 '(3 4)) returns 10.
|
|
|
3700 */
|
|
|
3701 (int nargs, Lisp_Object *args))
|
|
|
3702 {
|
|
|
3703 /* This function can GC */
|
|
|
3704 Lisp_Object fun = args[0];
|
|
|
3705 Lisp_Object spread_arg = args [nargs - 1];
|
|
|
3706 int numargs;
|
|
|
3707 int funcall_nargs;
|
|
|
3708
|
|
|
3709 GET_EXTERNAL_LIST_LENGTH (spread_arg, numargs);
|
|
|
3710
|
|
|
3711 if (numargs == 0)
|
|
|
3712 /* (apply foo 0 1 '()) */
|
|
|
3713 return Ffuncall (nargs - 1, args);
|
|
|
3714 else if (numargs == 1)
|
|
|
3715 {
|
|
|
3716 /* (apply foo 0 1 '(2)) */
|
|
|
3717 args [nargs - 1] = XCAR (spread_arg);
|
|
|
3718 return Ffuncall (nargs, args);
|
|
|
3719 }
|
|
|
3720
|
|
|
3721 /* -1 for function, -1 for spread arg */
|
|
|
3722 numargs = nargs - 2 + numargs;
|
|
|
3723 /* +1 for function */
|
|
|
3724 funcall_nargs = 1 + numargs;
|
|
|
3725
|
|
|
3726 if (SYMBOLP (fun))
|
|
|
3727 fun = indirect_function (fun, 0);
|
|
|
3728
|
|
|
3729 if (SUBRP (fun))
|
|
|
3730 {
|
|
|
3731 Lisp_Subr *subr = XSUBR (fun);
|
|
|
3732 int max_args = subr->max_args;
|
|
|
3733
|
|
|
3734 if (numargs < subr->min_args
|
|
|
3735 || (max_args >= 0 && max_args < numargs))
|
|
|
3736 {
|
|
|
3737 /* Let funcall get the error */
|
|
|
3738 }
|
|
|
3739 else if (max_args > numargs)
|
|
|
3740 {
|
|
|
3741 /* Avoid having funcall cons up yet another new vector of arguments
|
|
|
3742 by explicitly supplying nil's for optional values */
|
|
|
3743 funcall_nargs += (max_args - numargs);
|
|
|
3744 }
|
|
|
3745 }
|
|
|
3746 else if (UNBOUNDP (fun))
|
|
|
3747 {
|
|
|
3748 /* Let funcall get the error */
|
|
|
3749 fun = args[0];
|
|
|
3750 }
|
|
|
3751
|
|
|
3752 {
|
|
|
3753 REGISTER int i;
|
|
|
3754 Lisp_Object *funcall_args = alloca_array (Lisp_Object, funcall_nargs);
|
|
|
3755 struct gcpro gcpro1;
|
|
|
3756
|
|
|
3757 GCPRO1 (*funcall_args);
|
|
|
3758 gcpro1.nvars = funcall_nargs;
|
|
|
3759
|
|
|
3760 /* Copy in the unspread args */
|
|
|
3761 memcpy (funcall_args, args, (nargs - 1) * sizeof (Lisp_Object));
|
|
|
3762 /* Spread the last arg we got. Its first element goes in
|
|
|
3763 the slot that it used to occupy, hence this value of I. */
|
|
|
3764 for (i = nargs - 1;
|
|
|
3765 !NILP (spread_arg); /* i < 1 + numargs */
|
|
|
3766 i++, spread_arg = XCDR (spread_arg))
|
|
|
3767 {
|
|
|
3768 funcall_args [i] = XCAR (spread_arg);
|
|
|
3769 }
|
|
|
3770 /* Supply nil for optional args (to subrs) */
|
|
|
3771 for (; i < funcall_nargs; i++)
|
|
|
3772 funcall_args[i] = Qnil;
|
|
|
3773
|
|
|
3774
|
|
|
3775 RETURN_UNGCPRO (Ffuncall (funcall_nargs, funcall_args));
|
|
|
3776 }
|
|
|
3777 }
|
|
|
3778
|
|
|
3779
|
|
|
3780 /* Apply lambda list FUN to the NARGS evaluated arguments in ARGS and
|
|
|
3781 return the result of evaluation. */
|
|
|
3782
|
|
|
3783 static Lisp_Object
|
|
|
3784 funcall_lambda (Lisp_Object fun, int nargs, Lisp_Object args[])
|
|
|
3785 {
|
|
|
3786 /* This function can GC */
|
|
442
|
3787 Lisp_Object arglist, body, tail;
|
|
428
|
3788 int speccount = specpdl_depth();
|
|
|
3789 REGISTER int i = 0;
|
|
|
3790
|
|
|
3791 tail = XCDR (fun);
|
|
|
3792
|
|
|
3793 if (!CONSP (tail))
|
|
|
3794 goto invalid_function;
|
|
|
3795
|
|
|
3796 arglist = XCAR (tail);
|
|
|
3797 body = XCDR (tail);
|
|
|
3798
|
|
|
3799 {
|
|
|
3800 int optional = 0, rest = 0;
|
|
|
3801
|
|
442
|
3802 EXTERNAL_LIST_LOOP_2 (symbol, arglist)
|
|
428
|
3803 {
|
|
|
3804 if (!SYMBOLP (symbol))
|
|
|
3805 goto invalid_function;
|
|
|
3806 if (EQ (symbol, Qand_rest))
|
|
|
3807 rest = 1;
|
|
|
3808 else if (EQ (symbol, Qand_optional))
|
|
|
3809 optional = 1;
|
|
|
3810 else if (rest)
|
|
|
3811 {
|
|
|
3812 specbind (symbol, Flist (nargs - i, &args[i]));
|
|
|
3813 i = nargs;
|
|
|
3814 }
|
|
|
3815 else if (i < nargs)
|
|
|
3816 specbind (symbol, args[i++]);
|
|
|
3817 else if (!optional)
|
|
|
3818 goto wrong_number_of_arguments;
|
|
|
3819 else
|
|
|
3820 specbind (symbol, Qnil);
|
|
|
3821 }
|
|
|
3822 }
|
|
|
3823
|
|
|
3824 if (i < nargs)
|
|
|
3825 goto wrong_number_of_arguments;
|
|
|
3826
|
|
771
|
3827 return unbind_to_1 (speccount, Fprogn (body));
|
|
428
|
3828
|
|
|
3829 wrong_number_of_arguments:
|
|
436
|
3830 return signal_wrong_number_of_arguments_error (fun, nargs);
|
|
428
|
3831
|
|
|
3832 invalid_function:
|
|
436
|
3833 return signal_invalid_function_error (fun);
|
|
428
|
3834 }
|
|
|
3835
|
|
|
3836
|
|
|
3837 /************************************************************************/
|
|
|
3838 /* Run hook variables in various ways. */
|
|
|
3839 /************************************************************************/
|
|
|
3840
|
|
|
3841 DEFUN ("run-hooks", Frun_hooks, 1, MANY, 0, /*
|
|
|
3842 Run each hook in HOOKS. Major mode functions use this.
|
|
|
3843 Each argument should be a symbol, a hook variable.
|
|
|
3844 These symbols are processed in the order specified.
|
|
|
3845 If a hook symbol has a non-nil value, that value may be a function
|
|
|
3846 or a list of functions to be called to run the hook.
|
|
|
3847 If the value is a function, it is called with no arguments.
|
|
|
3848 If it is a list, the elements are called, in order, with no arguments.
|
|
|
3849
|
|
|
3850 To make a hook variable buffer-local, use `make-local-hook',
|
|
|
3851 not `make-local-variable'.
|
|
|
3852 */
|
|
|
3853 (int nargs, Lisp_Object *args))
|
|
|
3854 {
|
|
|
3855 REGISTER int i;
|
|
|
3856
|
|
|
3857 for (i = 0; i < nargs; i++)
|
|
|
3858 run_hook_with_args (1, args + i, RUN_HOOKS_TO_COMPLETION);
|
|
|
3859
|
|
|
3860 return Qnil;
|
|
|
3861 }
|
|
|
3862
|
|
|
3863 DEFUN ("run-hook-with-args", Frun_hook_with_args, 1, MANY, 0, /*
|
|
|
3864 Run HOOK with the specified arguments ARGS.
|
|
|
3865 HOOK should be a symbol, a hook variable. If HOOK has a non-nil
|
|
|
3866 value, that value may be a function or a list of functions to be
|
|
|
3867 called to run the hook. If the value is a function, it is called with
|
|
|
3868 the given arguments and its return value is returned. If it is a list
|
|
|
3869 of functions, those functions are called, in order,
|
|
|
3870 with the given arguments ARGS.
|
|
444
|
3871 It is best not to depend on the value returned by `run-hook-with-args',
|
|
428
|
3872 as that may change.
|
|
|
3873
|
|
|
3874 To make a hook variable buffer-local, use `make-local-hook',
|
|
|
3875 not `make-local-variable'.
|
|
|
3876 */
|
|
|
3877 (int nargs, Lisp_Object *args))
|
|
|
3878 {
|
|
|
3879 return run_hook_with_args (nargs, args, RUN_HOOKS_TO_COMPLETION);
|
|
|
3880 }
|
|
|
3881
|
|
|
3882 DEFUN ("run-hook-with-args-until-success", Frun_hook_with_args_until_success, 1, MANY, 0, /*
|
|
|
3883 Run HOOK with the specified arguments ARGS.
|
|
|
3884 HOOK should be a symbol, a hook variable. Its value should
|
|
|
3885 be a list of functions. We call those functions, one by one,
|
|
|
3886 passing arguments ARGS to each of them, until one of them
|
|
|
3887 returns a non-nil value. Then we return that value.
|
|
|
3888 If all the functions return nil, we return nil.
|
|
|
3889
|
|
|
3890 To make a hook variable buffer-local, use `make-local-hook',
|
|
|
3891 not `make-local-variable'.
|
|
|
3892 */
|
|
|
3893 (int nargs, Lisp_Object *args))
|
|
|
3894 {
|
|
|
3895 return run_hook_with_args (nargs, args, RUN_HOOKS_UNTIL_SUCCESS);
|
|
|
3896 }
|
|
|
3897
|
|
|
3898 DEFUN ("run-hook-with-args-until-failure", Frun_hook_with_args_until_failure, 1, MANY, 0, /*
|
|
|
3899 Run HOOK with the specified arguments ARGS.
|
|
|
3900 HOOK should be a symbol, a hook variable. Its value should
|
|
|
3901 be a list of functions. We call those functions, one by one,
|
|
|
3902 passing arguments ARGS to each of them, until one of them
|
|
|
3903 returns nil. Then we return nil.
|
|
|
3904 If all the functions return non-nil, we return non-nil.
|
|
|
3905
|
|
|
3906 To make a hook variable buffer-local, use `make-local-hook',
|
|
|
3907 not `make-local-variable'.
|
|
|
3908 */
|
|
|
3909 (int nargs, Lisp_Object *args))
|
|
|
3910 {
|
|
|
3911 return run_hook_with_args (nargs, args, RUN_HOOKS_UNTIL_FAILURE);
|
|
|
3912 }
|
|
|
3913
|
|
|
3914 /* ARGS[0] should be a hook symbol.
|
|
|
3915 Call each of the functions in the hook value, passing each of them
|
|
|
3916 as arguments all the rest of ARGS (all NARGS - 1 elements).
|
|
|
3917 COND specifies a condition to test after each call
|
|
|
3918 to decide whether to stop.
|
|
|
3919 The caller (or its caller, etc) must gcpro all of ARGS,
|
|
|
3920 except that it isn't necessary to gcpro ARGS[0]. */
|
|
|
3921
|
|
|
3922 Lisp_Object
|
|
|
3923 run_hook_with_args_in_buffer (struct buffer *buf, int nargs, Lisp_Object *args,
|
|
|
3924 enum run_hooks_condition cond)
|
|
|
3925 {
|
|
|
3926 Lisp_Object sym, val, ret;
|
|
|
3927
|
|
|
3928 if (!initialized || preparing_for_armageddon)
|
|
|
3929 /* We need to bail out of here pronto. */
|
|
|
3930 return Qnil;
|
|
|
3931
|
|
|
3932 /* Whenever gc_in_progress is true, preparing_for_armageddon
|
|
|
3933 will also be true unless something is really hosed. */
|
|
|
3934 assert (!gc_in_progress);
|
|
|
3935
|
|
|
3936 sym = args[0];
|
|
771
|
3937 val = symbol_value_in_buffer (sym, wrap_buffer (buf));
|
|
428
|
3938 ret = (cond == RUN_HOOKS_UNTIL_FAILURE ? Qt : Qnil);
|
|
|
3939
|
|
|
3940 if (UNBOUNDP (val) || NILP (val))
|
|
|
3941 return ret;
|
|
|
3942 else if (!CONSP (val) || EQ (XCAR (val), Qlambda))
|
|
|
3943 {
|
|
|
3944 args[0] = val;
|
|
|
3945 return Ffuncall (nargs, args);
|
|
|
3946 }
|
|
|
3947 else
|
|
|
3948 {
|
|
|
3949 struct gcpro gcpro1, gcpro2, gcpro3;
|
|
|
3950 Lisp_Object globals = Qnil;
|
|
|
3951 GCPRO3 (sym, val, globals);
|
|
|
3952
|
|
|
3953 for (;
|
|
|
3954 CONSP (val) && ((cond == RUN_HOOKS_TO_COMPLETION)
|
|
|
3955 || (cond == RUN_HOOKS_UNTIL_SUCCESS ? NILP (ret)
|
|
|
3956 : !NILP (ret)));
|
|
|
3957 val = XCDR (val))
|
|
|
3958 {
|
|
|
3959 if (EQ (XCAR (val), Qt))
|
|
|
3960 {
|
|
|
3961 /* t indicates this hook has a local binding;
|
|
|
3962 it means to run the global binding too. */
|
|
|
3963 globals = Fdefault_value (sym);
|
|
|
3964
|
|
|
3965 if ((! CONSP (globals) || EQ (XCAR (globals), Qlambda)) &&
|
|
|
3966 ! NILP (globals))
|
|
|
3967 {
|
|
|
3968 args[0] = globals;
|
|
|
3969 ret = Ffuncall (nargs, args);
|
|
|
3970 }
|
|
|
3971 else
|
|
|
3972 {
|
|
|
3973 for (;
|
|
|
3974 CONSP (globals) && ((cond == RUN_HOOKS_TO_COMPLETION)
|
|
|
3975 || (cond == RUN_HOOKS_UNTIL_SUCCESS
|
|
|
3976 ? NILP (ret)
|
|
|
3977 : !NILP (ret)));
|
|
|
3978 globals = XCDR (globals))
|
|
|
3979 {
|
|
|
3980 args[0] = XCAR (globals);
|
|
|
3981 /* In a global value, t should not occur. If it does, we
|
|
|
3982 must ignore it to avoid an endless loop. */
|
|
|
3983 if (!EQ (args[0], Qt))
|
|
|
3984 ret = Ffuncall (nargs, args);
|
|
|
3985 }
|
|
|
3986 }
|
|
|
3987 }
|
|
|
3988 else
|
|
|
3989 {
|
|
|
3990 args[0] = XCAR (val);
|
|
|
3991 ret = Ffuncall (nargs, args);
|
|
|
3992 }
|
|
|
3993 }
|
|
|
3994
|
|
|
3995 UNGCPRO;
|
|
|
3996 return ret;
|
|
|
3997 }
|
|
|
3998 }
|
|
|
3999
|
|
|
4000 Lisp_Object
|
|
|
4001 run_hook_with_args (int nargs, Lisp_Object *args,
|
|
|
4002 enum run_hooks_condition cond)
|
|
|
4003 {
|
|
|
4004 return run_hook_with_args_in_buffer (current_buffer, nargs, args, cond);
|
|
|
4005 }
|
|
|
4006
|
|
|
4007 #if 0
|
|
|
4008
|
|
|
4009 /* From FSF 19.30, not currently used */
|
|
|
4010
|
|
|
4011 /* Run a hook symbol ARGS[0], but use FUNLIST instead of the actual
|
|
|
4012 present value of that symbol.
|
|
|
4013 Call each element of FUNLIST,
|
|
|
4014 passing each of them the rest of ARGS.
|
|
|
4015 The caller (or its caller, etc) must gcpro all of ARGS,
|
|
|
4016 except that it isn't necessary to gcpro ARGS[0]. */
|
|
|
4017
|
|
|
4018 Lisp_Object
|
|
|
4019 run_hook_list_with_args (Lisp_Object funlist, int nargs, Lisp_Object *args)
|
|
|
4020 {
|
|
|
4021 Lisp_Object sym = args[0];
|
|
|
4022 Lisp_Object val;
|
|
|
4023 struct gcpro gcpro1, gcpro2;
|
|
|
4024
|
|
|
4025 GCPRO2 (sym, val);
|
|
|
4026
|
|
|
4027 for (val = funlist; CONSP (val); val = XCDR (val))
|
|
|
4028 {
|
|
|
4029 if (EQ (XCAR (val), Qt))
|
|
|
4030 {
|
|
|
4031 /* t indicates this hook has a local binding;
|
|
|
4032 it means to run the global binding too. */
|
|
|
4033 Lisp_Object globals;
|
|
|
4034
|
|
|
4035 for (globals = Fdefault_value (sym);
|
|
|
4036 CONSP (globals);
|
|
|
4037 globals = XCDR (globals))
|
|
|
4038 {
|
|
|
4039 args[0] = XCAR (globals);
|
|
|
4040 /* In a global value, t should not occur. If it does, we
|
|
|
4041 must ignore it to avoid an endless loop. */
|
|
|
4042 if (!EQ (args[0], Qt))
|
|
|
4043 Ffuncall (nargs, args);
|
|
|
4044 }
|
|
|
4045 }
|
|
|
4046 else
|
|
|
4047 {
|
|
|
4048 args[0] = XCAR (val);
|
|
|
4049 Ffuncall (nargs, args);
|
|
|
4050 }
|
|
|
4051 }
|
|
|
4052 UNGCPRO;
|
|
|
4053 return Qnil;
|
|
|
4054 }
|
|
|
4055
|
|
|
4056 #endif /* 0 */
|
|
|
4057
|
|
|
4058 void
|
|
|
4059 va_run_hook_with_args (Lisp_Object hook_var, int nargs, ...)
|
|
|
4060 {
|
|
|
4061 /* This function can GC */
|
|
|
4062 struct gcpro gcpro1;
|
|
|
4063 int i;
|
|
|
4064 va_list vargs;
|
|
|
4065 Lisp_Object *funcall_args = alloca_array (Lisp_Object, 1 + nargs);
|
|
|
4066
|
|
|
4067 va_start (vargs, nargs);
|
|
|
4068 funcall_args[0] = hook_var;
|
|
|
4069 for (i = 0; i < nargs; i++)
|
|
|
4070 funcall_args[i + 1] = va_arg (vargs, Lisp_Object);
|
|
|
4071 va_end (vargs);
|
|
|
4072
|
|
|
4073 GCPRO1 (*funcall_args);
|
|
|
4074 gcpro1.nvars = nargs + 1;
|
|
|
4075 run_hook_with_args (nargs + 1, funcall_args, RUN_HOOKS_TO_COMPLETION);
|
|
|
4076 UNGCPRO;
|
|
|
4077 }
|
|
|
4078
|
|
|
4079 void
|
|
|
4080 va_run_hook_with_args_in_buffer (struct buffer *buf, Lisp_Object hook_var,
|
|
|
4081 int nargs, ...)
|
|
|
4082 {
|
|
|
4083 /* This function can GC */
|
|
|
4084 struct gcpro gcpro1;
|
|
|
4085 int i;
|
|
|
4086 va_list vargs;
|
|
|
4087 Lisp_Object *funcall_args = alloca_array (Lisp_Object, 1 + nargs);
|
|
|
4088
|
|
|
4089 va_start (vargs, nargs);
|
|
|
4090 funcall_args[0] = hook_var;
|
|
|
4091 for (i = 0; i < nargs; i++)
|
|
|
4092 funcall_args[i + 1] = va_arg (vargs, Lisp_Object);
|
|
|
4093 va_end (vargs);
|
|
|
4094
|
|
|
4095 GCPRO1 (*funcall_args);
|
|
|
4096 gcpro1.nvars = nargs + 1;
|
|
|
4097 run_hook_with_args_in_buffer (buf, nargs + 1, funcall_args,
|
|
|
4098 RUN_HOOKS_TO_COMPLETION);
|
|
|
4099 UNGCPRO;
|
|
|
4100 }
|
|
|
4101
|
|
|
4102 Lisp_Object
|
|
|
4103 run_hook (Lisp_Object hook)
|
|
|
4104 {
|
|
|
4105 Frun_hooks (1, &hook);
|
|
|
4106 return Qnil;
|
|
|
4107 }
|
|
|
4108
|
|
|
4109
|
|
|
4110 /************************************************************************/
|
|
|
4111 /* Front-ends to eval, funcall, apply */
|
|
|
4112 /************************************************************************/
|
|
|
4113
|
|
|
4114 /* Apply fn to arg */
|
|
|
4115 Lisp_Object
|
|
|
4116 apply1 (Lisp_Object fn, Lisp_Object arg)
|
|
|
4117 {
|
|
|
4118 /* This function can GC */
|
|
|
4119 struct gcpro gcpro1;
|
|
|
4120 Lisp_Object args[2];
|
|
|
4121
|
|
|
4122 if (NILP (arg))
|
|
|
4123 return Ffuncall (1, &fn);
|
|
|
4124 GCPRO1 (args[0]);
|
|
|
4125 gcpro1.nvars = 2;
|
|
|
4126 args[0] = fn;
|
|
|
4127 args[1] = arg;
|
|
|
4128 RETURN_UNGCPRO (Fapply (2, args));
|
|
|
4129 }
|
|
|
4130
|
|
|
4131 /* Call function fn on no arguments */
|
|
|
4132 Lisp_Object
|
|
|
4133 call0 (Lisp_Object fn)
|
|
|
4134 {
|
|
|
4135 /* This function can GC */
|
|
|
4136 struct gcpro gcpro1;
|
|
|
4137
|
|
|
4138 GCPRO1 (fn);
|
|
|
4139 RETURN_UNGCPRO (Ffuncall (1, &fn));
|
|
|
4140 }
|
|
|
4141
|
|
|
4142 /* Call function fn with argument arg0 */
|
|
|
4143 Lisp_Object
|
|
|
4144 call1 (Lisp_Object fn,
|
|
|
4145 Lisp_Object arg0)
|
|
|
4146 {
|
|
|
4147 /* This function can GC */
|
|
|
4148 struct gcpro gcpro1;
|
|
|
4149 Lisp_Object args[2];
|
|
|
4150 args[0] = fn;
|
|
|
4151 args[1] = arg0;
|
|
|
4152 GCPRO1 (args[0]);
|
|
|
4153 gcpro1.nvars = 2;
|
|
|
4154 RETURN_UNGCPRO (Ffuncall (2, args));
|
|
|
4155 }
|
|
|
4156
|
|
|
4157 /* Call function fn with arguments arg0, arg1 */
|
|
|
4158 Lisp_Object
|
|
|
4159 call2 (Lisp_Object fn,
|
|
|
4160 Lisp_Object arg0, Lisp_Object arg1)
|
|
|
4161 {
|
|
|
4162 /* This function can GC */
|
|
|
4163 struct gcpro gcpro1;
|
|
|
4164 Lisp_Object args[3];
|
|
|
4165 args[0] = fn;
|
|
|
4166 args[1] = arg0;
|
|
|
4167 args[2] = arg1;
|
|
|
4168 GCPRO1 (args[0]);
|
|
|
4169 gcpro1.nvars = 3;
|
|
|
4170 RETURN_UNGCPRO (Ffuncall (3, args));
|
|
|
4171 }
|
|
|
4172
|
|
|
4173 /* Call function fn with arguments arg0, arg1, arg2 */
|
|
|
4174 Lisp_Object
|
|
|
4175 call3 (Lisp_Object fn,
|
|
|
4176 Lisp_Object arg0, Lisp_Object arg1, Lisp_Object arg2)
|
|
|
4177 {
|
|
|
4178 /* This function can GC */
|
|
|
4179 struct gcpro gcpro1;
|
|
|
4180 Lisp_Object args[4];
|
|
|
4181 args[0] = fn;
|
|
|
4182 args[1] = arg0;
|
|
|
4183 args[2] = arg1;
|
|
|
4184 args[3] = arg2;
|
|
|
4185 GCPRO1 (args[0]);
|
|
|
4186 gcpro1.nvars = 4;
|
|
|
4187 RETURN_UNGCPRO (Ffuncall (4, args));
|
|
|
4188 }
|
|
|
4189
|
|
|
4190 /* Call function fn with arguments arg0, arg1, arg2, arg3 */
|
|
|
4191 Lisp_Object
|
|
|
4192 call4 (Lisp_Object fn,
|
|
|
4193 Lisp_Object arg0, Lisp_Object arg1, Lisp_Object arg2,
|
|
|
4194 Lisp_Object arg3)
|
|
|
4195 {
|
|
|
4196 /* This function can GC */
|
|
|
4197 struct gcpro gcpro1;
|
|
|
4198 Lisp_Object args[5];
|
|
|
4199 args[0] = fn;
|
|
|
4200 args[1] = arg0;
|
|
|
4201 args[2] = arg1;
|
|
|
4202 args[3] = arg2;
|
|
|
4203 args[4] = arg3;
|
|
|
4204 GCPRO1 (args[0]);
|
|
|
4205 gcpro1.nvars = 5;
|
|
|
4206 RETURN_UNGCPRO (Ffuncall (5, args));
|
|
|
4207 }
|
|
|
4208
|
|
|
4209 /* Call function fn with arguments arg0, arg1, arg2, arg3, arg4 */
|
|
|
4210 Lisp_Object
|
|
|
4211 call5 (Lisp_Object fn,
|
|
|
4212 Lisp_Object arg0, Lisp_Object arg1, Lisp_Object arg2,
|
|
|
4213 Lisp_Object arg3, Lisp_Object arg4)
|
|
|
4214 {
|
|
|
4215 /* This function can GC */
|
|
|
4216 struct gcpro gcpro1;
|
|
|
4217 Lisp_Object args[6];
|
|
|
4218 args[0] = fn;
|
|
|
4219 args[1] = arg0;
|
|
|
4220 args[2] = arg1;
|
|
|
4221 args[3] = arg2;
|
|
|
4222 args[4] = arg3;
|
|
|
4223 args[5] = arg4;
|
|
|
4224 GCPRO1 (args[0]);
|
|
|
4225 gcpro1.nvars = 6;
|
|
|
4226 RETURN_UNGCPRO (Ffuncall (6, args));
|
|
|
4227 }
|
|
|
4228
|
|
|
4229 Lisp_Object
|
|
|
4230 call6 (Lisp_Object fn,
|
|
|
4231 Lisp_Object arg0, Lisp_Object arg1, Lisp_Object arg2,
|
|
|
4232 Lisp_Object arg3, Lisp_Object arg4, Lisp_Object arg5)
|
|
|
4233 {
|
|
|
4234 /* This function can GC */
|
|
|
4235 struct gcpro gcpro1;
|
|
|
4236 Lisp_Object args[7];
|
|
|
4237 args[0] = fn;
|
|
|
4238 args[1] = arg0;
|
|
|
4239 args[2] = arg1;
|
|
|
4240 args[3] = arg2;
|
|
|
4241 args[4] = arg3;
|
|
|
4242 args[5] = arg4;
|
|
|
4243 args[6] = arg5;
|
|
|
4244 GCPRO1 (args[0]);
|
|
|
4245 gcpro1.nvars = 7;
|
|
|
4246 RETURN_UNGCPRO (Ffuncall (7, args));
|
|
|
4247 }
|
|
|
4248
|
|
|
4249 Lisp_Object
|
|
|
4250 call7 (Lisp_Object fn,
|
|
|
4251 Lisp_Object arg0, Lisp_Object arg1, Lisp_Object arg2,
|
|
|
4252 Lisp_Object arg3, Lisp_Object arg4, Lisp_Object arg5,
|
|
|
4253 Lisp_Object arg6)
|
|
|
4254 {
|
|
|
4255 /* This function can GC */
|
|
|
4256 struct gcpro gcpro1;
|
|
|
4257 Lisp_Object args[8];
|
|
|
4258 args[0] = fn;
|
|
|
4259 args[1] = arg0;
|
|
|
4260 args[2] = arg1;
|
|
|
4261 args[3] = arg2;
|
|
|
4262 args[4] = arg3;
|
|
|
4263 args[5] = arg4;
|
|
|
4264 args[6] = arg5;
|
|
|
4265 args[7] = arg6;
|
|
|
4266 GCPRO1 (args[0]);
|
|
|
4267 gcpro1.nvars = 8;
|
|
|
4268 RETURN_UNGCPRO (Ffuncall (8, args));
|
|
|
4269 }
|
|
|
4270
|
|
|
4271 Lisp_Object
|
|
|
4272 call8 (Lisp_Object fn,
|
|
|
4273 Lisp_Object arg0, Lisp_Object arg1, Lisp_Object arg2,
|
|
|
4274 Lisp_Object arg3, Lisp_Object arg4, Lisp_Object arg5,
|
|
|
4275 Lisp_Object arg6, Lisp_Object arg7)
|
|
|
4276 {
|
|
|
4277 /* This function can GC */
|
|
|
4278 struct gcpro gcpro1;
|
|
|
4279 Lisp_Object args[9];
|
|
|
4280 args[0] = fn;
|
|
|
4281 args[1] = arg0;
|
|
|
4282 args[2] = arg1;
|
|
|
4283 args[3] = arg2;
|
|
|
4284 args[4] = arg3;
|
|
|
4285 args[5] = arg4;
|
|
|
4286 args[6] = arg5;
|
|
|
4287 args[7] = arg6;
|
|
|
4288 args[8] = arg7;
|
|
|
4289 GCPRO1 (args[0]);
|
|
|
4290 gcpro1.nvars = 9;
|
|
|
4291 RETURN_UNGCPRO (Ffuncall (9, args));
|
|
|
4292 }
|
|
|
4293
|
|
|
4294 Lisp_Object
|
|
|
4295 call0_in_buffer (struct buffer *buf, Lisp_Object fn)
|
|
|
4296 {
|
|
|
4297 if (current_buffer == buf)
|
|
|
4298 return call0 (fn);
|
|
|
4299 else
|
|
|
4300 {
|
|
|
4301 Lisp_Object val;
|
|
|
4302 int speccount = specpdl_depth();
|
|
|
4303 record_unwind_protect (Fset_buffer, Fcurrent_buffer ());
|
|
|
4304 set_buffer_internal (buf);
|
|
|
4305 val = call0 (fn);
|
|
771
|
4306 unbind_to (speccount);
|
|
428
|
4307 return val;
|
|
|
4308 }
|
|
|
4309 }
|
|
|
4310
|
|
|
4311 Lisp_Object
|
|
|
4312 call1_in_buffer (struct buffer *buf, Lisp_Object fn,
|
|
|
4313 Lisp_Object arg0)
|
|
|
4314 {
|
|
|
4315 if (current_buffer == buf)
|
|
|
4316 return call1 (fn, arg0);
|
|
|
4317 else
|
|
|
4318 {
|
|
|
4319 Lisp_Object val;
|
|
|
4320 int speccount = specpdl_depth();
|
|
|
4321 record_unwind_protect (Fset_buffer, Fcurrent_buffer ());
|
|
|
4322 set_buffer_internal (buf);
|
|
|
4323 val = call1 (fn, arg0);
|
|
771
|
4324 unbind_to (speccount);
|
|
428
|
4325 return val;
|
|
|
4326 }
|
|
|
4327 }
|
|
|
4328
|
|
|
4329 Lisp_Object
|
|
|
4330 call2_in_buffer (struct buffer *buf, Lisp_Object fn,
|
|
|
4331 Lisp_Object arg0, Lisp_Object arg1)
|
|
|
4332 {
|
|
|
4333 if (current_buffer == buf)
|
|
|
4334 return call2 (fn, arg0, arg1);
|
|
|
4335 else
|
|
|
4336 {
|
|
|
4337 Lisp_Object val;
|
|
|
4338 int speccount = specpdl_depth();
|
|
|
4339 record_unwind_protect (Fset_buffer, Fcurrent_buffer ());
|
|
|
4340 set_buffer_internal (buf);
|
|
|
4341 val = call2 (fn, arg0, arg1);
|
|
771
|
4342 unbind_to (speccount);
|
|
428
|
4343 return val;
|
|
|
4344 }
|
|
|
4345 }
|
|
|
4346
|
|
|
4347 Lisp_Object
|
|
|
4348 call3_in_buffer (struct buffer *buf, Lisp_Object fn,
|
|
|
4349 Lisp_Object arg0, Lisp_Object arg1, Lisp_Object arg2)
|
|
|
4350 {
|
|
|
4351 if (current_buffer == buf)
|
|
|
4352 return call3 (fn, arg0, arg1, arg2);
|
|
|
4353 else
|
|
|
4354 {
|
|
|
4355 Lisp_Object val;
|
|
|
4356 int speccount = specpdl_depth();
|
|
|
4357 record_unwind_protect (Fset_buffer, Fcurrent_buffer ());
|
|
|
4358 set_buffer_internal (buf);
|
|
|
4359 val = call3 (fn, arg0, arg1, arg2);
|
|
771
|
4360 unbind_to (speccount);
|
|
428
|
4361 return val;
|
|
|
4362 }
|
|
|
4363 }
|
|
|
4364
|
|
|
4365 Lisp_Object
|
|
|
4366 call4_in_buffer (struct buffer *buf, Lisp_Object fn,
|
|
|
4367 Lisp_Object arg0, Lisp_Object arg1, Lisp_Object arg2,
|
|
|
4368 Lisp_Object arg3)
|
|
|
4369 {
|
|
|
4370 if (current_buffer == buf)
|
|
|
4371 return call4 (fn, arg0, arg1, arg2, arg3);
|
|
|
4372 else
|
|
|
4373 {
|
|
|
4374 Lisp_Object val;
|
|
|
4375 int speccount = specpdl_depth();
|
|
|
4376 record_unwind_protect (Fset_buffer, Fcurrent_buffer ());
|
|
|
4377 set_buffer_internal (buf);
|
|
|
4378 val = call4 (fn, arg0, arg1, arg2, arg3);
|
|
771
|
4379 unbind_to (speccount);
|
|
428
|
4380 return val;
|
|
|
4381 }
|
|
|
4382 }
|
|
|
4383
|
|
|
4384 Lisp_Object
|
|
|
4385 eval_in_buffer (struct buffer *buf, Lisp_Object form)
|
|
|
4386 {
|
|
|
4387 if (current_buffer == buf)
|
|
|
4388 return Feval (form);
|
|
|
4389 else
|
|
|
4390 {
|
|
|
4391 Lisp_Object val;
|
|
|
4392 int speccount = specpdl_depth();
|
|
|
4393 record_unwind_protect (Fset_buffer, Fcurrent_buffer ());
|
|
|
4394 set_buffer_internal (buf);
|
|
|
4395 val = Feval (form);
|
|
771
|
4396 unbind_to (speccount);
|
|
428
|
4397 return val;
|
|
|
4398 }
|
|
|
4399 }
|
|
|
4400
|
|
|
4401
|
|
|
4402 /************************************************************************/
|
|
|
4403 /* Error-catching front-ends to eval, funcall, apply */
|
|
|
4404 /************************************************************************/
|
|
|
4405
|
|
|
4406 /* Call function fn on no arguments, with condition handler */
|
|
|
4407 Lisp_Object
|
|
|
4408 call0_with_handler (Lisp_Object handler, Lisp_Object fn)
|
|
|
4409 {
|
|
|
4410 /* This function can GC */
|
|
|
4411 struct gcpro gcpro1;
|
|
|
4412 Lisp_Object args[2];
|
|
|
4413 args[0] = handler;
|
|
|
4414 args[1] = fn;
|
|
|
4415 GCPRO1 (args[0]);
|
|
|
4416 gcpro1.nvars = 2;
|
|
|
4417 RETURN_UNGCPRO (Fcall_with_condition_handler (2, args));
|
|
|
4418 }
|
|
|
4419
|
|
|
4420 /* Call function fn with argument arg0, with condition handler */
|
|
|
4421 Lisp_Object
|
|
|
4422 call1_with_handler (Lisp_Object handler, Lisp_Object fn,
|
|
|
4423 Lisp_Object arg0)
|
|
|
4424 {
|
|
|
4425 /* This function can GC */
|
|
|
4426 struct gcpro gcpro1;
|
|
|
4427 Lisp_Object args[3];
|
|
|
4428 args[0] = handler;
|
|
|
4429 args[1] = fn;
|
|
|
4430 args[2] = arg0;
|
|
|
4431 GCPRO1 (args[0]);
|
|
|
4432 gcpro1.nvars = 3;
|
|
|
4433 RETURN_UNGCPRO (Fcall_with_condition_handler (3, args));
|
|
|
4434 }
|
|
|
4435
|
|
|
4436
|
|
|
4437 /* The following functions provide you with error-trapping versions
|
|
|
4438 of the various front-ends above. They take an additional
|
|
|
4439 "warning_string" argument; if non-zero, a warning with this
|
|
|
4440 string and the actual error that occurred will be displayed
|
|
|
4441 in the *Warnings* buffer if an error occurs. In all cases,
|
|
|
4442 QUIT is inhibited while these functions are running, and if
|
|
|
4443 an error occurs, Qunbound is returned instead of the normal
|
|
|
4444 return value.
|
|
|
4445 */
|
|
|
4446
|
|
|
4447 /* #### This stuff needs to catch throws as well. We need to
|
|
|
4448 improve internal_catch() so it can take a "catch anything"
|
|
|
4449 argument similar to Qt or Qerror for condition_case_1(). */
|
|
|
4450
|
|
|
4451 static Lisp_Object
|
|
|
4452 caught_a_squirmer (Lisp_Object errordata, Lisp_Object arg)
|
|
|
4453 {
|
|
771
|
4454 /* #### should be rewritten to work with emacs_sprintf_string_lisp(); but this
|
|
|
4455 whole stuff is getting junked and replaced from my stderr-proc ws */
|
|
428
|
4456 if (!NILP (errordata))
|
|
|
4457 {
|
|
|
4458 Lisp_Object args[2];
|
|
|
4459
|
|
|
4460 if (!NILP (arg))
|
|
|
4461 {
|
|
771
|
4462 Intbyte *str = (Intbyte *) get_opaque_ptr (arg);
|
|
|
4463 args[0] = build_intstring (str);
|
|
428
|
4464 }
|
|
|
4465 else
|
|
771
|
4466 args[0] = build_msg_string ("error");
|
|
428
|
4467 /* #### This should call
|
|
|
4468 (with-output-to-string (display-error errordata))
|
|
|
4469 but that stuff is all in Lisp currently. */
|
|
|
4470 args[1] = errordata;
|
|
|
4471 warn_when_safe_lispobj
|
|
|
4472 (Qerror, Qwarning,
|
|
771
|
4473 emacs_vsprintf_string_lisp ("%s: %s", Qnil, 2, args));
|
|
428
|
4474 }
|
|
|
4475 return Qunbound;
|
|
|
4476 }
|
|
|
4477
|
|
|
4478 static Lisp_Object
|
|
|
4479 allow_quit_caught_a_squirmer (Lisp_Object errordata, Lisp_Object arg)
|
|
|
4480 {
|
|
|
4481 if (CONSP (errordata) && EQ (XCAR (errordata), Qquit))
|
|
|
4482 return Fsignal (Qquit, XCDR (errordata));
|
|
|
4483 return caught_a_squirmer (errordata, arg);
|
|
|
4484 }
|
|
|
4485
|
|
|
4486 static Lisp_Object
|
|
|
4487 safe_run_hook_caught_a_squirmer (Lisp_Object errordata, Lisp_Object arg)
|
|
|
4488 {
|
|
|
4489 Lisp_Object hook = Fcar (arg);
|
|
|
4490 arg = Fcdr (arg);
|
|
|
4491 /* Clear out the hook. */
|
|
|
4492 Fset (hook, Qnil);
|
|
|
4493 return caught_a_squirmer (errordata, arg);
|
|
|
4494 }
|
|
|
4495
|
|
|
4496 static Lisp_Object
|
|
|
4497 allow_quit_safe_run_hook_caught_a_squirmer (Lisp_Object errordata,
|
|
|
4498 Lisp_Object arg)
|
|
|
4499 {
|
|
|
4500 Lisp_Object hook = Fcar (arg);
|
|
|
4501 arg = Fcdr (arg);
|
|
|
4502 if (!CONSP (errordata) || !EQ (XCAR (errordata), Qquit))
|
|
|
4503 /* Clear out the hook. */
|
|
|
4504 Fset (hook, Qnil);
|
|
|
4505 return allow_quit_caught_a_squirmer (errordata, arg);
|
|
|
4506 }
|
|
|
4507
|
|
|
4508 static Lisp_Object
|
|
|
4509 catch_them_squirmers_eval_in_buffer (Lisp_Object cons)
|
|
|
4510 {
|
|
|
4511 return eval_in_buffer (XBUFFER (XCAR (cons)), XCDR (cons));
|
|
|
4512 }
|
|
|
4513
|
|
|
4514 Lisp_Object
|
|
665
|
4515 eval_in_buffer_trapping_errors (const CIntbyte *warning_string,
|
|
428
|
4516 struct buffer *buf, Lisp_Object form)
|
|
|
4517 {
|
|
|
4518 int speccount = specpdl_depth();
|
|
|
4519 Lisp_Object tem;
|
|
|
4520 Lisp_Object buffer;
|
|
|
4521 Lisp_Object cons;
|
|
|
4522 Lisp_Object opaque;
|
|
|
4523 struct gcpro gcpro1, gcpro2;
|
|
|
4524
|
|
793
|
4525 buffer = wrap_buffer (buf);
|
|
428
|
4526
|
|
|
4527 specbind (Qinhibit_quit, Qt);
|
|
771
|
4528 /* begin_gc_forbidden(); Currently no reason to do this; */
|
|
428
|
4529
|
|
|
4530 cons = noseeum_cons (buffer, form);
|
|
|
4531 opaque = (warning_string ? make_opaque_ptr ((void *)warning_string) : Qnil);
|
|
|
4532 GCPRO2 (cons, opaque);
|
|
|
4533 /* Qerror not Qt, so you can get a backtrace */
|
|
|
4534 tem = condition_case_1 (Qerror,
|
|
|
4535 catch_them_squirmers_eval_in_buffer, cons,
|
|
|
4536 caught_a_squirmer, opaque);
|
|
|
4537 free_cons (XCONS (cons));
|
|
|
4538 if (OPAQUE_PTRP (opaque))
|
|
|
4539 free_opaque_ptr (opaque);
|
|
|
4540 UNGCPRO;
|
|
|
4541
|
|
771
|
4542 return unbind_to_1 (speccount, tem);
|
|
428
|
4543 }
|
|
|
4544
|
|
|
4545 static Lisp_Object
|
|
|
4546 catch_them_squirmers_run_hook (Lisp_Object hook_symbol)
|
|
|
4547 {
|
|
|
4548 /* This function can GC */
|
|
|
4549 run_hook (hook_symbol);
|
|
|
4550 return Qnil;
|
|
|
4551 }
|
|
|
4552
|
|
|
4553 Lisp_Object
|
|
665
|
4554 run_hook_trapping_errors (const CIntbyte *warning_string,
|
|
609
|
4555 Lisp_Object hook_symbol)
|
|
428
|
4556 {
|
|
|
4557 int speccount;
|
|
|
4558 Lisp_Object tem;
|
|
|
4559 Lisp_Object opaque;
|
|
|
4560 struct gcpro gcpro1;
|
|
|
4561
|
|
|
4562 if (!initialized || preparing_for_armageddon)
|
|
|
4563 return Qnil;
|
|
|
4564 tem = find_symbol_value (hook_symbol);
|
|
|
4565 if (NILP (tem) || UNBOUNDP (tem))
|
|
|
4566 return Qnil;
|
|
|
4567
|
|
|
4568 speccount = specpdl_depth();
|
|
|
4569 specbind (Qinhibit_quit, Qt);
|
|
|
4570
|
|
|
4571 opaque = (warning_string ? make_opaque_ptr ((void *)warning_string) : Qnil);
|
|
|
4572 GCPRO1 (opaque);
|
|
|
4573 /* Qerror not Qt, so you can get a backtrace */
|
|
|
4574 tem = condition_case_1 (Qerror,
|
|
|
4575 catch_them_squirmers_run_hook, hook_symbol,
|
|
|
4576 caught_a_squirmer, opaque);
|
|
|
4577 if (OPAQUE_PTRP (opaque))
|
|
|
4578 free_opaque_ptr (opaque);
|
|
|
4579 UNGCPRO;
|
|
|
4580
|
|
771
|
4581 return unbind_to_1 (speccount, tem);
|
|
428
|
4582 }
|
|
|
4583
|
|
|
4584 /* Same as run_hook_trapping_errors() but also set the hook to nil
|
|
|
4585 if an error occurs. */
|
|
|
4586
|
|
|
4587 Lisp_Object
|
|
665
|
4588 safe_run_hook_trapping_errors (const CIntbyte *warning_string,
|
|
428
|
4589 Lisp_Object hook_symbol,
|
|
|
4590 int allow_quit)
|
|
|
4591 {
|
|
|
4592 int speccount = specpdl_depth();
|
|
|
4593 Lisp_Object tem;
|
|
|
4594 Lisp_Object cons = Qnil;
|
|
|
4595 struct gcpro gcpro1;
|
|
|
4596
|
|
|
4597 if (!initialized || preparing_for_armageddon)
|
|
|
4598 return Qnil;
|
|
|
4599 tem = find_symbol_value (hook_symbol);
|
|
|
4600 if (NILP (tem) || UNBOUNDP (tem))
|
|
|
4601 return Qnil;
|
|
|
4602
|
|
|
4603 if (!allow_quit)
|
|
|
4604 specbind (Qinhibit_quit, Qt);
|
|
|
4605
|
|
|
4606 cons = noseeum_cons (hook_symbol,
|
|
|
4607 warning_string ? make_opaque_ptr ((void *)warning_string)
|
|
|
4608 : Qnil);
|
|
|
4609 GCPRO1 (cons);
|
|
|
4610 /* Qerror not Qt, so you can get a backtrace */
|
|
|
4611 tem = condition_case_1 (Qerror,
|
|
|
4612 catch_them_squirmers_run_hook,
|
|
|
4613 hook_symbol,
|
|
|
4614 allow_quit ?
|
|
|
4615 allow_quit_safe_run_hook_caught_a_squirmer :
|
|
|
4616 safe_run_hook_caught_a_squirmer,
|
|
|
4617 cons);
|
|
|
4618 if (OPAQUE_PTRP (XCDR (cons)))
|
|
|
4619 free_opaque_ptr (XCDR (cons));
|
|
|
4620 free_cons (XCONS (cons));
|
|
|
4621 UNGCPRO;
|
|
|
4622
|
|
771
|
4623 return unbind_to_1 (speccount, tem);
|
|
428
|
4624 }
|
|
|
4625
|
|
|
4626 static Lisp_Object
|
|
|
4627 catch_them_squirmers_call0 (Lisp_Object function)
|
|
|
4628 {
|
|
|
4629 /* This function can GC */
|
|
|
4630 return call0 (function);
|
|
|
4631 }
|
|
|
4632
|
|
|
4633 Lisp_Object
|
|
665
|
4634 call0_trapping_errors (const CIntbyte *warning_string, Lisp_Object function)
|
|
428
|
4635 {
|
|
|
4636 int speccount;
|
|
|
4637 Lisp_Object tem;
|
|
|
4638 Lisp_Object opaque = Qnil;
|
|
|
4639 struct gcpro gcpro1, gcpro2;
|
|
|
4640
|
|
|
4641 if (SYMBOLP (function))
|
|
|
4642 {
|
|
|
4643 tem = XSYMBOL (function)->function;
|
|
|
4644 if (NILP (tem) || UNBOUNDP (tem))
|
|
|
4645 return Qnil;
|
|
|
4646 }
|
|
|
4647
|
|
|
4648 GCPRO2 (opaque, function);
|
|
|
4649 speccount = specpdl_depth();
|
|
|
4650 specbind (Qinhibit_quit, Qt);
|
|
771
|
4651 /* begin_gc_forbidden(); Currently no reason to do this; */
|
|
428
|
4652
|
|
|
4653 opaque = (warning_string ? make_opaque_ptr ((void *)warning_string) : Qnil);
|
|
|
4654 /* Qerror not Qt, so you can get a backtrace */
|
|
|
4655 tem = condition_case_1 (Qerror,
|
|
|
4656 catch_them_squirmers_call0, function,
|
|
|
4657 caught_a_squirmer, opaque);
|
|
|
4658 if (OPAQUE_PTRP (opaque))
|
|
|
4659 free_opaque_ptr (opaque);
|
|
|
4660 UNGCPRO;
|
|
|
4661
|
|
771
|
4662 return unbind_to_1 (speccount, tem);
|
|
428
|
4663 }
|
|
|
4664
|
|
|
4665 static Lisp_Object
|
|
|
4666 catch_them_squirmers_call1 (Lisp_Object cons)
|
|
|
4667 {
|
|
|
4668 /* This function can GC */
|
|
|
4669 return call1 (XCAR (cons), XCDR (cons));
|
|
|
4670 }
|
|
|
4671
|
|
|
4672 static Lisp_Object
|
|
|
4673 catch_them_squirmers_call2 (Lisp_Object cons)
|
|
|
4674 {
|
|
|
4675 /* This function can GC */
|
|
|
4676 return call2 (XCAR (cons), XCAR (XCDR (cons)), XCAR (XCDR (XCDR (cons))));
|
|
|
4677 }
|
|
|
4678
|
|
|
4679 Lisp_Object
|
|
665
|
4680 call1_trapping_errors (const CIntbyte *warning_string, Lisp_Object function,
|
|
428
|
4681 Lisp_Object object)
|
|
|
4682 {
|
|
|
4683 int speccount = specpdl_depth();
|
|
|
4684 Lisp_Object tem;
|
|
|
4685 Lisp_Object cons = Qnil;
|
|
|
4686 Lisp_Object opaque = Qnil;
|
|
|
4687 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
|
|
|
4688
|
|
|
4689 if (SYMBOLP (function))
|
|
|
4690 {
|
|
|
4691 tem = XSYMBOL (function)->function;
|
|
|
4692 if (NILP (tem) || UNBOUNDP (tem))
|
|
|
4693 return Qnil;
|
|
|
4694 }
|
|
|
4695
|
|
|
4696 GCPRO4 (cons, opaque, function, object);
|
|
|
4697
|
|
|
4698 specbind (Qinhibit_quit, Qt);
|
|
771
|
4699 /* begin_gc_forbidden(); Currently no reason to do this; */
|
|
428
|
4700
|
|
|
4701 cons = noseeum_cons (function, object);
|
|
|
4702 opaque = (warning_string ? make_opaque_ptr ((void *)warning_string) : Qnil);
|
|
|
4703 /* Qerror not Qt, so you can get a backtrace */
|
|
|
4704 tem = condition_case_1 (Qerror,
|
|
|
4705 catch_them_squirmers_call1, cons,
|
|
|
4706 caught_a_squirmer, opaque);
|
|
|
4707 if (OPAQUE_PTRP (opaque))
|
|
|
4708 free_opaque_ptr (opaque);
|
|
|
4709 free_cons (XCONS (cons));
|
|
|
4710 UNGCPRO;
|
|
|
4711
|
|
771
|
4712 return unbind_to_1 (speccount, tem);
|
|
428
|
4713 }
|
|
|
4714
|
|
|
4715 Lisp_Object
|
|
665
|
4716 call2_trapping_errors (const CIntbyte *warning_string, Lisp_Object function,
|
|
428
|
4717 Lisp_Object object1, Lisp_Object object2)
|
|
|
4718 {
|
|
|
4719 int speccount = specpdl_depth();
|
|
|
4720 Lisp_Object tem;
|
|
|
4721 Lisp_Object cons = Qnil;
|
|
|
4722 Lisp_Object opaque = Qnil;
|
|
|
4723 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5;
|
|
|
4724
|
|
|
4725 if (SYMBOLP (function))
|
|
|
4726 {
|
|
|
4727 tem = XSYMBOL (function)->function;
|
|
|
4728 if (NILP (tem) || UNBOUNDP (tem))
|
|
|
4729 return Qnil;
|
|
|
4730 }
|
|
|
4731
|
|
|
4732 GCPRO5 (cons, opaque, function, object1, object2);
|
|
|
4733 specbind (Qinhibit_quit, Qt);
|
|
771
|
4734 /* begin_gc_forbidden(); Currently no reason to do this; */
|
|
428
|
4735
|
|
|
4736 cons = list3 (function, object1, object2);
|
|
|
4737 opaque = (warning_string ? make_opaque_ptr ((void *)warning_string) : Qnil);
|
|
|
4738 /* Qerror not Qt, so you can get a backtrace */
|
|
|
4739 tem = condition_case_1 (Qerror,
|
|
|
4740 catch_them_squirmers_call2, cons,
|
|
|
4741 caught_a_squirmer, opaque);
|
|
|
4742 if (OPAQUE_PTRP (opaque))
|
|
|
4743 free_opaque_ptr (opaque);
|
|
|
4744 free_list (cons);
|
|
|
4745 UNGCPRO;
|
|
|
4746
|
|
771
|
4747 return unbind_to_1 (speccount, tem);
|
|
428
|
4748 }
|
|
|
4749
|
|
|
4750
|
|
|
4751 /************************************************************************/
|
|
|
4752 /* The special binding stack */
|
|
771
|
4753 /* Most C code should simply use specbind() and unbind_to_1(). */
|
|
428
|
4754 /* When performance is critical, use the macros in backtrace.h. */
|
|
|
4755 /************************************************************************/
|
|
|
4756
|
|
|
4757 #define min_max_specpdl_size 400
|
|
|
4758
|
|
|
4759 void
|
|
647
|
4760 grow_specpdl (EMACS_INT reserved)
|
|
|
4761 {
|
|
|
4762 EMACS_INT size_needed = specpdl_depth() + reserved;
|
|
428
|
4763 if (size_needed >= max_specpdl_size)
|
|
|
4764 {
|
|
|
4765 if (max_specpdl_size < min_max_specpdl_size)
|
|
|
4766 max_specpdl_size = min_max_specpdl_size;
|
|
|
4767 if (size_needed >= max_specpdl_size)
|
|
|
4768 {
|
|
|
4769 if (!NILP (Vdebug_on_error) ||
|
|
|
4770 !NILP (Vdebug_on_signal))
|
|
|
4771 /* Leave room for some specpdl in the debugger. */
|
|
|
4772 max_specpdl_size = size_needed + 100;
|
|
563
|
4773 signal_continuable_error
|
|
|
4774 (Qstack_overflow,
|
|
|
4775 "Variable binding depth exceeds max-specpdl-size", Qunbound);
|
|
428
|
4776 }
|
|
|
4777 }
|
|
|
4778 while (specpdl_size < size_needed)
|
|
|
4779 {
|
|
|
4780 specpdl_size *= 2;
|
|
|
4781 if (specpdl_size > max_specpdl_size)
|
|
|
4782 specpdl_size = max_specpdl_size;
|
|
|
4783 }
|
|
|
4784 XREALLOC_ARRAY (specpdl, struct specbinding, specpdl_size);
|
|
|
4785 specpdl_ptr = specpdl + specpdl_depth();
|
|
|
4786 }
|
|
|
4787
|
|
|
4788
|
|
|
4789 /* Handle unbinding buffer-local variables */
|
|
|
4790 static Lisp_Object
|
|
|
4791 specbind_unwind_local (Lisp_Object ovalue)
|
|
|
4792 {
|
|
|
4793 Lisp_Object current = Fcurrent_buffer ();
|
|
|
4794 Lisp_Object symbol = specpdl_ptr->symbol;
|
|
440
|
4795 Lisp_Cons *victim = XCONS (ovalue);
|
|
428
|
4796 Lisp_Object buf = get_buffer (victim->car, 0);
|
|
|
4797 ovalue = victim->cdr;
|
|
|
4798
|
|
|
4799 free_cons (victim);
|
|
|
4800
|
|
|
4801 if (NILP (buf))
|
|
|
4802 {
|
|
|
4803 /* Deleted buffer -- do nothing */
|
|
|
4804 }
|
|
|
4805 else if (symbol_value_buffer_local_info (symbol, XBUFFER (buf)) == 0)
|
|
|
4806 {
|
|
|
4807 /* Was buffer-local when binding was made, now no longer is.
|
|
|
4808 * (kill-local-variable can do this.)
|
|
|
4809 * Do nothing in this case.
|
|
|
4810 */
|
|
|
4811 }
|
|
|
4812 else if (EQ (buf, current))
|
|
|
4813 Fset (symbol, ovalue);
|
|
|
4814 else
|
|
|
4815 {
|
|
|
4816 /* Urk! Somebody switched buffers */
|
|
|
4817 struct gcpro gcpro1;
|
|
|
4818 GCPRO1 (current);
|
|
|
4819 Fset_buffer (buf);
|
|
|
4820 Fset (symbol, ovalue);
|
|
|
4821 Fset_buffer (current);
|
|
|
4822 UNGCPRO;
|
|
|
4823 }
|
|
|
4824 return symbol;
|
|
|
4825 }
|
|
|
4826
|
|
|
4827 static Lisp_Object
|
|
|
4828 specbind_unwind_wasnt_local (Lisp_Object buffer)
|
|
|
4829 {
|
|
|
4830 Lisp_Object current = Fcurrent_buffer ();
|
|
|
4831 Lisp_Object symbol = specpdl_ptr->symbol;
|
|
|
4832
|
|
|
4833 buffer = get_buffer (buffer, 0);
|
|
|
4834 if (NILP (buffer))
|
|
|
4835 {
|
|
|
4836 /* Deleted buffer -- do nothing */
|
|
|
4837 }
|
|
|
4838 else if (symbol_value_buffer_local_info (symbol, XBUFFER (buffer)) == 0)
|
|
|
4839 {
|
|
|
4840 /* Was buffer-local when binding was made, now no longer is.
|
|
|
4841 * (kill-local-variable can do this.)
|
|
|
4842 * Do nothing in this case.
|
|
|
4843 */
|
|
|
4844 }
|
|
|
4845 else if (EQ (buffer, current))
|
|
|
4846 Fkill_local_variable (symbol);
|
|
|
4847 else
|
|
|
4848 {
|
|
|
4849 /* Urk! Somebody switched buffers */
|
|
|
4850 struct gcpro gcpro1;
|
|
|
4851 GCPRO1 (current);
|
|
|
4852 Fset_buffer (buffer);
|
|
|
4853 Fkill_local_variable (symbol);
|
|
|
4854 Fset_buffer (current);
|
|
|
4855 UNGCPRO;
|
|
|
4856 }
|
|
|
4857 return symbol;
|
|
|
4858 }
|
|
|
4859
|
|
|
4860
|
|
|
4861 void
|
|
|
4862 specbind (Lisp_Object symbol, Lisp_Object value)
|
|
|
4863 {
|
|
|
4864 SPECBIND (symbol, value);
|
|
|
4865 }
|
|
|
4866
|
|
|
4867 void
|
|
|
4868 specbind_magic (Lisp_Object symbol, Lisp_Object value)
|
|
|
4869 {
|
|
|
4870 int buffer_local =
|
|
|
4871 symbol_value_buffer_local_info (symbol, current_buffer);
|
|
|
4872
|
|
|
4873 if (buffer_local == 0)
|
|
|
4874 {
|
|
|
4875 specpdl_ptr->old_value = find_symbol_value (symbol);
|
|
771
|
4876 specpdl_ptr->func = 0; /* Handled specially by unbind_to_1 */
|
|
428
|
4877 }
|
|
|
4878 else if (buffer_local > 0)
|
|
|
4879 {
|
|
|
4880 /* Already buffer-local */
|
|
|
4881 specpdl_ptr->old_value = noseeum_cons (Fcurrent_buffer (),
|
|
|
4882 find_symbol_value (symbol));
|
|
|
4883 specpdl_ptr->func = specbind_unwind_local;
|
|
|
4884 }
|
|
|
4885 else
|
|
|
4886 {
|
|
|
4887 /* About to become buffer-local */
|
|
|
4888 specpdl_ptr->old_value = Fcurrent_buffer ();
|
|
|
4889 specpdl_ptr->func = specbind_unwind_wasnt_local;
|
|
|
4890 }
|
|
|
4891
|
|
|
4892 specpdl_ptr->symbol = symbol;
|
|
|
4893 specpdl_ptr++;
|
|
|
4894 specpdl_depth_counter++;
|
|
|
4895
|
|
|
4896 Fset (symbol, value);
|
|
|
4897 }
|
|
|
4898
|
|
771
|
4899 /* Record an unwind-protect -- FUNCTION will be called with ARG no matter
|
|
|
4900 whether a normal or non-local exit occurs. (You need to call unbind_to_1()
|
|
|
4901 before your function returns normally, passing in the integer returned
|
|
|
4902 by this function.) Note: As long as the unwind-protect exists, ARG is
|
|
|
4903 automatically GCPRO'd. The return value from FUNCTION is completely
|
|
|
4904 ignored. #### We should eliminate it entirely. */
|
|
|
4905
|
|
|
4906 int
|
|
428
|
4907 record_unwind_protect (Lisp_Object (*function) (Lisp_Object arg),
|
|
|
4908 Lisp_Object arg)
|
|
|
4909 {
|
|
|
4910 SPECPDL_RESERVE (1);
|
|
|
4911 specpdl_ptr->func = function;
|
|
|
4912 specpdl_ptr->symbol = Qnil;
|
|
|
4913 specpdl_ptr->old_value = arg;
|
|
|
4914 specpdl_ptr++;
|
|
|
4915 specpdl_depth_counter++;
|
|
771
|
4916 return specpdl_depth_counter - 1;
|
|
|
4917 }
|
|
|
4918
|
|
|
4919 static Lisp_Object
|
|
|
4920 free_pointer (Lisp_Object opaque)
|
|
|
4921 {
|
|
|
4922 xfree (get_opaque_ptr (opaque));
|
|
|
4923 free_opaque_ptr (opaque);
|
|
|
4924 return Qnil;
|
|
|
4925 }
|
|
|
4926
|
|
|
4927 /* Establish an unwind-protect which will free the specified block.
|
|
|
4928 */
|
|
|
4929 int
|
|
|
4930 record_unwind_protect_freeing (void *ptr)
|
|
|
4931 {
|
|
|
4932 Lisp_Object opaque = make_opaque_ptr (ptr);
|
|
|
4933 return record_unwind_protect (free_pointer, opaque);
|
|
|
4934 }
|
|
|
4935
|
|
|
4936 static Lisp_Object
|
|
|
4937 free_dynarr (Lisp_Object opaque)
|
|
|
4938 {
|
|
|
4939 Dynarr_free (get_opaque_ptr (opaque));
|
|
|
4940 free_opaque_ptr (opaque);
|
|
|
4941 return Qnil;
|
|
|
4942 }
|
|
|
4943
|
|
|
4944 int
|
|
|
4945 record_unwind_protect_freeing_dynarr (void *ptr)
|
|
|
4946 {
|
|
|
4947 Lisp_Object opaque = make_opaque_ptr (ptr);
|
|
|
4948 return record_unwind_protect (free_dynarr, opaque);
|
|
|
4949 }
|
|
428
|
4950
|
|
|
4951 /* Unwind the stack till specpdl_depth() == COUNT.
|
|
|
4952 VALUE is not used, except that, purely as a convenience to the
|
|
771
|
4953 caller, it is protected from garbage-protection and returned. */
|
|
428
|
4954 Lisp_Object
|
|
771
|
4955 unbind_to_1 (int count, Lisp_Object value)
|
|
428
|
4956 {
|
|
|
4957 UNBIND_TO_GCPRO (count, value);
|
|
|
4958 return value;
|
|
|
4959 }
|
|
|
4960
|
|
|
4961 /* Don't call this directly.
|
|
|
4962 Only for use by UNBIND_TO* macros in backtrace.h */
|
|
|
4963 void
|
|
|
4964 unbind_to_hairy (int count)
|
|
|
4965 {
|
|
771
|
4966 Lisp_Object oquit;
|
|
428
|
4967
|
|
442
|
4968 ++specpdl_ptr;
|
|
|
4969 ++specpdl_depth_counter;
|
|
|
4970
|
|
771
|
4971 /* Allow QUIT within unwind-protect routines, but defer any existing QUIT
|
|
|
4972 until afterwards. */
|
|
428
|
4973 check_quit (); /* make Vquit_flag accurate */
|
|
771
|
4974 oquit = Vquit_flag;
|
|
428
|
4975 Vquit_flag = Qnil;
|
|
|
4976
|
|
|
4977 while (specpdl_depth_counter != count)
|
|
|
4978 {
|
|
|
4979 --specpdl_ptr;
|
|
|
4980 --specpdl_depth_counter;
|
|
|
4981
|
|
|
4982 if (specpdl_ptr->func != 0)
|
|
|
4983 /* An unwind-protect */
|
|
|
4984 (*specpdl_ptr->func) (specpdl_ptr->old_value);
|
|
|
4985 else
|
|
|
4986 {
|
|
|
4987 /* We checked symbol for validity when we specbound it,
|
|
|
4988 so only need to call Fset if symbol has magic value. */
|
|
440
|
4989 Lisp_Symbol *sym = XSYMBOL (specpdl_ptr->symbol);
|
|
428
|
4990 if (!SYMBOL_VALUE_MAGIC_P (sym->value))
|
|
|
4991 sym->value = specpdl_ptr->old_value;
|
|
|
4992 else
|
|
|
4993 Fset (specpdl_ptr->symbol, specpdl_ptr->old_value);
|
|
|
4994 }
|
|
|
4995
|
|
|
4996 #if 0 /* martin */
|
|
|
4997 #ifndef EXCEEDINGLY_QUESTIONABLE_CODE
|
|
|
4998 /* There should never be anything here for us to remove.
|
|
|
4999 If so, it indicates a logic error in Emacs. Catches
|
|
|
5000 should get removed when a throw or signal occurs, or
|
|
|
5001 when a catch or condition-case exits normally. But
|
|
|
5002 it's too dangerous to just remove this code. --ben */
|
|
|
5003
|
|
|
5004 /* Furthermore, this code is not in FSFmacs!!!
|
|
|
5005 Braino on mly's part? */
|
|
|
5006 /* If we're unwound past the pdlcount of a catch frame,
|
|
|
5007 that catch can't possibly still be valid. */
|
|
|
5008 while (catchlist && catchlist->pdlcount > specpdl_depth_counter)
|
|
|
5009 {
|
|
|
5010 catchlist = catchlist->next;
|
|
|
5011 /* Don't mess with gcprolist, backtrace_list here */
|
|
|
5012 }
|
|
|
5013 #endif
|
|
|
5014 #endif
|
|
|
5015 }
|
|
771
|
5016 Vquit_flag = oquit;
|
|
428
|
5017 }
|
|
|
5018
|
|
|
5019
|
|
|
5020
|
|
|
5021 /* Get the value of symbol's global binding, even if that binding is
|
|
|
5022 not now dynamically visible. May return Qunbound or magic values. */
|
|
|
5023
|
|
|
5024 Lisp_Object
|
|
|
5025 top_level_value (Lisp_Object symbol)
|
|
|
5026 {
|
|
|
5027 REGISTER struct specbinding *ptr = specpdl;
|
|
|
5028
|
|
|
5029 CHECK_SYMBOL (symbol);
|
|
|
5030 for (; ptr != specpdl_ptr; ptr++)
|
|
|
5031 {
|
|
|
5032 if (EQ (ptr->symbol, symbol))
|
|
|
5033 return ptr->old_value;
|
|
|
5034 }
|
|
|
5035 return XSYMBOL (symbol)->value;
|
|
|
5036 }
|
|
|
5037
|
|
|
5038 #if 0
|
|
|
5039
|
|
|
5040 Lisp_Object
|
|
|
5041 top_level_set (Lisp_Object symbol, Lisp_Object newval)
|
|
|
5042 {
|
|
|
5043 REGISTER struct specbinding *ptr = specpdl;
|
|
|
5044
|
|
|
5045 CHECK_SYMBOL (symbol);
|
|
|
5046 for (; ptr != specpdl_ptr; ptr++)
|
|
|
5047 {
|
|
|
5048 if (EQ (ptr->symbol, symbol))
|
|
|
5049 {
|
|
|
5050 ptr->old_value = newval;
|
|
|
5051 return newval;
|
|
|
5052 }
|
|
|
5053 }
|
|
|
5054 return Fset (symbol, newval);
|
|
|
5055 }
|
|
|
5056
|
|
|
5057 #endif /* 0 */
|
|
|
5058
|
|
|
5059
|
|
|
5060 /************************************************************************/
|
|
|
5061 /* Backtraces */
|
|
|
5062 /************************************************************************/
|
|
|
5063
|
|
|
5064 DEFUN ("backtrace-debug", Fbacktrace_debug, 2, 2, 0, /*
|
|
|
5065 Set the debug-on-exit flag of eval frame LEVEL levels down to FLAG.
|
|
|
5066 The debugger is entered when that frame exits, if the flag is non-nil.
|
|
|
5067 */
|
|
|
5068 (level, flag))
|
|
|
5069 {
|
|
|
5070 REGISTER struct backtrace *backlist = backtrace_list;
|
|
|
5071 REGISTER int i;
|
|
|
5072
|
|
|
5073 CHECK_INT (level);
|
|
|
5074
|
|
|
5075 for (i = 0; backlist && i < XINT (level); i++)
|
|
|
5076 {
|
|
|
5077 backlist = backlist->next;
|
|
|
5078 }
|
|
|
5079
|
|
|
5080 if (backlist)
|
|
|
5081 backlist->debug_on_exit = !NILP (flag);
|
|
|
5082
|
|
|
5083 return flag;
|
|
|
5084 }
|
|
|
5085
|
|
|
5086 static void
|
|
|
5087 backtrace_specials (int speccount, int speclimit, Lisp_Object stream)
|
|
|
5088 {
|
|
|
5089 int printing_bindings = 0;
|
|
|
5090
|
|
|
5091 for (; speccount > speclimit; speccount--)
|
|
|
5092 {
|
|
|
5093 if (specpdl[speccount - 1].func == 0
|
|
|
5094 || specpdl[speccount - 1].func == specbind_unwind_local
|
|
|
5095 || specpdl[speccount - 1].func == specbind_unwind_wasnt_local)
|
|
|
5096 {
|
|
|
5097 write_c_string (((!printing_bindings) ? " # bind (" : " "),
|
|
|
5098 stream);
|
|
|
5099 Fprin1 (specpdl[speccount - 1].symbol, stream);
|
|
|
5100 printing_bindings = 1;
|
|
|
5101 }
|
|
|
5102 else
|
|
|
5103 {
|
|
|
5104 if (printing_bindings) write_c_string (")\n", stream);
|
|
|
5105 write_c_string (" # (unwind-protect ...)\n", stream);
|
|
|
5106 printing_bindings = 0;
|
|
|
5107 }
|
|
|
5108 }
|
|
|
5109 if (printing_bindings) write_c_string (")\n", stream);
|
|
|
5110 }
|
|
|
5111
|
|
|
5112 DEFUN ("backtrace", Fbacktrace, 0, 2, "", /*
|
|
|
5113 Print a trace of Lisp function calls currently active.
|
|
438
|
5114 Optional arg STREAM specifies the output stream to send the backtrace to,
|
|
444
|
5115 and defaults to the value of `standard-output'.
|
|
|
5116 Optional second arg DETAILED non-nil means show places where currently
|
|
|
5117 active variable bindings, catches, condition-cases, and
|
|
|
5118 unwind-protects, as well as function calls, were made.
|
|
428
|
5119 */
|
|
|
5120 (stream, detailed))
|
|
|
5121 {
|
|
|
5122 /* This function can GC */
|
|
|
5123 struct backtrace *backlist = backtrace_list;
|
|
|
5124 struct catchtag *catches = catchlist;
|
|
|
5125 int speccount = specpdl_depth();
|
|
|
5126
|
|
|
5127 int old_nl = print_escape_newlines;
|
|
|
5128 int old_pr = print_readably;
|
|
|
5129 Lisp_Object old_level = Vprint_level;
|
|
|
5130 Lisp_Object oiq = Vinhibit_quit;
|
|
|
5131 struct gcpro gcpro1, gcpro2;
|
|
|
5132
|
|
|
5133 /* We can't allow quits in here because that could cause the values
|
|
|
5134 of print_readably and print_escape_newlines to get screwed up.
|
|
|
5135 Normally we would use a record_unwind_protect but that would
|
|
|
5136 screw up the functioning of this function. */
|
|
|
5137 Vinhibit_quit = Qt;
|
|
|
5138
|
|
|
5139 entering_debugger = 0;
|
|
|
5140
|
|
|
5141 Vprint_level = make_int (3);
|
|
|
5142 print_readably = 0;
|
|
|
5143 print_escape_newlines = 1;
|
|
|
5144
|
|
|
5145 GCPRO2 (stream, old_level);
|
|
|
5146
|
|
|
5147 if (NILP (stream))
|
|
|
5148 stream = Vstandard_output;
|
|
|
5149 if (!noninteractive && (NILP (stream) || EQ (stream, Qt)))
|
|
|
5150 stream = Fselected_frame (Qnil);
|
|
|
5151
|
|
|
5152 for (;;)
|
|
|
5153 {
|
|
|
5154 if (!NILP (detailed) && catches && catches->backlist == backlist)
|
|
|
5155 {
|
|
|
5156 int catchpdl = catches->pdlcount;
|
|
438
|
5157 if (speccount > catchpdl
|
|
|
5158 && specpdl[catchpdl].func == condition_case_unwind)
|
|
428
|
5159 /* This is a condition-case catchpoint */
|
|
|
5160 catchpdl = catchpdl + 1;
|
|
|
5161
|
|
|
5162 backtrace_specials (speccount, catchpdl, stream);
|
|
|
5163
|
|
|
5164 speccount = catches->pdlcount;
|
|
|
5165 if (catchpdl == speccount)
|
|
|
5166 {
|
|
|
5167 write_c_string (" # (catch ", stream);
|
|
|
5168 Fprin1 (catches->tag, stream);
|
|
|
5169 write_c_string (" ...)\n", stream);
|
|
|
5170 }
|
|
|
5171 else
|
|
|
5172 {
|
|
|
5173 write_c_string (" # (condition-case ... . ", stream);
|
|
|
5174 Fprin1 (Fcdr (Fcar (catches->tag)), stream);
|
|
|
5175 write_c_string (")\n", stream);
|
|
|
5176 }
|
|
|
5177 catches = catches->next;
|
|
|
5178 }
|
|
|
5179 else if (!backlist)
|
|
|
5180 break;
|
|
|
5181 else
|
|
|
5182 {
|
|
|
5183 if (!NILP (detailed) && backlist->pdlcount < speccount)
|
|
|
5184 {
|
|
|
5185 backtrace_specials (speccount, backlist->pdlcount, stream);
|
|
|
5186 speccount = backlist->pdlcount;
|
|
|
5187 }
|
|
|
5188 write_c_string (((backlist->debug_on_exit) ? "* " : " "),
|
|
|
5189 stream);
|
|
|
5190 if (backlist->nargs == UNEVALLED)
|
|
|
5191 {
|
|
|
5192 Fprin1 (Fcons (*backlist->function, *backlist->args), stream);
|
|
|
5193 write_c_string ("\n", stream); /* from FSFmacs 19.30 */
|
|
|
5194 }
|
|
|
5195 else
|
|
|
5196 {
|
|
|
5197 Lisp_Object tem = *backlist->function;
|
|
|
5198 Fprin1 (tem, stream); /* This can QUIT */
|
|
|
5199 write_c_string ("(", stream);
|
|
|
5200 if (backlist->nargs == MANY)
|
|
|
5201 {
|
|
|
5202 int i;
|
|
|
5203 Lisp_Object tail = Qnil;
|
|
|
5204 struct gcpro ngcpro1;
|
|
|
5205
|
|
|
5206 NGCPRO1 (tail);
|
|
|
5207 for (tail = *backlist->args, i = 0;
|
|
|
5208 !NILP (tail);
|
|
|
5209 tail = Fcdr (tail), i++)
|
|
|
5210 {
|
|
|
5211 if (i != 0) write_c_string (" ", stream);
|
|
|
5212 Fprin1 (Fcar (tail), stream);
|
|
|
5213 }
|
|
|
5214 NUNGCPRO;
|
|
|
5215 }
|
|
|
5216 else
|
|
|
5217 {
|
|
|
5218 int i;
|
|
|
5219 for (i = 0; i < backlist->nargs; i++)
|
|
|
5220 {
|
|
|
5221 if (!i && EQ(tem, Qbyte_code)) {
|
|
|
5222 write_c_string("\"...\"", stream);
|
|
|
5223 continue;
|
|
|
5224 }
|
|
|
5225 if (i != 0) write_c_string (" ", stream);
|
|
|
5226 Fprin1 (backlist->args[i], stream);
|
|
|
5227 }
|
|
|
5228 }
|
|
442
|
5229 write_c_string (")\n", stream);
|
|
428
|
5230 }
|
|
|
5231 backlist = backlist->next;
|
|
|
5232 }
|
|
|
5233 }
|
|
|
5234 Vprint_level = old_level;
|
|
|
5235 print_readably = old_pr;
|
|
|
5236 print_escape_newlines = old_nl;
|
|
|
5237 UNGCPRO;
|
|
|
5238 Vinhibit_quit = oiq;
|
|
|
5239 return Qnil;
|
|
|
5240 }
|
|
|
5241
|
|
|
5242
|
|
444
|
5243 DEFUN ("backtrace-frame", Fbacktrace_frame, 1, 1, 0, /*
|
|
|
5244 Return the function and arguments NFRAMES up from current execution point.
|
|
428
|
5245 If that frame has not evaluated the arguments yet (or is a special form),
|
|
|
5246 the value is (nil FUNCTION ARG-FORMS...).
|
|
|
5247 If that frame has evaluated its arguments and called its function already,
|
|
|
5248 the value is (t FUNCTION ARG-VALUES...).
|
|
|
5249 A &rest arg is represented as the tail of the list ARG-VALUES.
|
|
|
5250 FUNCTION is whatever was supplied as car of evaluated list,
|
|
|
5251 or a lambda expression for macro calls.
|
|
444
|
5252 If NFRAMES is more than the number of frames, the value is nil.
|
|
428
|
5253 */
|
|
|
5254 (nframes))
|
|
|
5255 {
|
|
|
5256 REGISTER struct backtrace *backlist = backtrace_list;
|
|
|
5257 REGISTER int i;
|
|
|
5258 Lisp_Object tem;
|
|
|
5259
|
|
|
5260 CHECK_NATNUM (nframes);
|
|
|
5261
|
|
|
5262 /* Find the frame requested. */
|
|
|
5263 for (i = XINT (nframes); backlist && (i-- > 0);)
|
|
|
5264 backlist = backlist->next;
|
|
|
5265
|
|
|
5266 if (!backlist)
|
|
|
5267 return Qnil;
|
|
|
5268 if (backlist->nargs == UNEVALLED)
|
|
|
5269 return Fcons (Qnil, Fcons (*backlist->function, *backlist->args));
|
|
|
5270 else
|
|
|
5271 {
|
|
|
5272 if (backlist->nargs == MANY)
|
|
|
5273 tem = *backlist->args;
|
|
|
5274 else
|
|
|
5275 tem = Flist (backlist->nargs, backlist->args);
|
|
|
5276
|
|
|
5277 return Fcons (Qt, Fcons (*backlist->function, tem));
|
|
|
5278 }
|
|
|
5279 }
|
|
|
5280
|
|
|
5281
|
|
|
5282 /************************************************************************/
|
|
|
5283 /* Warnings */
|
|
|
5284 /************************************************************************/
|
|
|
5285
|
|
|
5286 void
|
|
|
5287 warn_when_safe_lispobj (Lisp_Object class, Lisp_Object level,
|
|
|
5288 Lisp_Object obj)
|
|
|
5289 {
|
|
793
|
5290 /* Don't even generate debug warnings if they're going to be discarded,
|
|
|
5291 to avoid excessive consing. */
|
|
|
5292 if (EQ (level, Qdebug) && !NILP (Vlog_warning_minimum_level) &&
|
|
|
5293 !EQ (Vlog_warning_minimum_level, Qdebug))
|
|
|
5294 return;
|
|
|
5295
|
|
428
|
5296 obj = list1 (list3 (class, level, obj));
|
|
|
5297 if (NILP (Vpending_warnings))
|
|
|
5298 Vpending_warnings = Vpending_warnings_tail = obj;
|
|
|
5299 else
|
|
|
5300 {
|
|
|
5301 Fsetcdr (Vpending_warnings_tail, obj);
|
|
|
5302 Vpending_warnings_tail = obj;
|
|
|
5303 }
|
|
|
5304 }
|
|
|
5305
|
|
|
5306 /* #### This should probably accept Lisp objects; but then we have
|
|
|
5307 to make sure that Feval() isn't called, since it might not be safe.
|
|
|
5308
|
|
|
5309 An alternative approach is to just pass some non-string type of
|
|
|
5310 Lisp_Object to warn_when_safe_lispobj(); `prin1-to-string' will
|
|
|
5311 automatically be called when it is safe to do so. */
|
|
|
5312
|
|
|
5313 void
|
|
665
|
5314 warn_when_safe (Lisp_Object class, Lisp_Object level, const CIntbyte *fmt, ...)
|
|
428
|
5315 {
|
|
|
5316 Lisp_Object obj;
|
|
|
5317 va_list args;
|
|
|
5318
|
|
793
|
5319 /* Don't even generate debug warnings if they're going to be discarded,
|
|
|
5320 to avoid excessive consing. */
|
|
|
5321 if (EQ (level, Qdebug) && !NILP (Vlog_warning_minimum_level) &&
|
|
|
5322 !EQ (Vlog_warning_minimum_level, Qdebug))
|
|
|
5323 return;
|
|
|
5324
|
|
428
|
5325 va_start (args, fmt);
|
|
771
|
5326 obj = emacs_vsprintf_string (CGETTEXT (fmt), args);
|
|
428
|
5327 va_end (args);
|
|
|
5328
|
|
|
5329 warn_when_safe_lispobj (class, level, obj);
|
|
|
5330 }
|
|
|
5331
|
|
|
5332
|
|
|
5333
|
|
|
5334
|
|
|
5335 /************************************************************************/
|
|
|
5336 /* Initialization */
|
|
|
5337 /************************************************************************/
|
|
|
5338
|
|
|
5339 void
|
|
|
5340 syms_of_eval (void)
|
|
|
5341 {
|
|
442
|
5342 INIT_LRECORD_IMPLEMENTATION (subr);
|
|
|
5343
|
|
563
|
5344 DEFSYMBOL (Qinhibit_quit);
|
|
|
5345 DEFSYMBOL (Qautoload);
|
|
|
5346 DEFSYMBOL (Qdebug_on_error);
|
|
|
5347 DEFSYMBOL (Qstack_trace_on_error);
|
|
|
5348 DEFSYMBOL (Qdebug_on_signal);
|
|
|
5349 DEFSYMBOL (Qstack_trace_on_signal);
|
|
|
5350 DEFSYMBOL (Qdebugger);
|
|
|
5351 DEFSYMBOL (Qmacro);
|
|
428
|
5352 defsymbol (&Qand_rest, "&rest");
|
|
|
5353 defsymbol (&Qand_optional, "&optional");
|
|
|
5354 /* Note that the process code also uses Qexit */
|
|
563
|
5355 DEFSYMBOL (Qexit);
|
|
|
5356 DEFSYMBOL (Qsetq);
|
|
|
5357 DEFSYMBOL (Qinteractive);
|
|
|
5358 DEFSYMBOL (Qcommandp);
|
|
|
5359 DEFSYMBOL (Qdefun);
|
|
|
5360 DEFSYMBOL (Qprogn);
|
|
|
5361 DEFSYMBOL (Qvalues);
|
|
|
5362 DEFSYMBOL (Qdisplay_warning);
|
|
|
5363 DEFSYMBOL (Qrun_hooks);
|
|
|
5364 DEFSYMBOL (Qif);
|
|
428
|
5365
|
|
|
5366 DEFSUBR (For);
|
|
|
5367 DEFSUBR (Fand);
|
|
|
5368 DEFSUBR (Fif);
|
|
|
5369 DEFSUBR_MACRO (Fwhen);
|
|
|
5370 DEFSUBR_MACRO (Funless);
|
|
|
5371 DEFSUBR (Fcond);
|
|
|
5372 DEFSUBR (Fprogn);
|
|
|
5373 DEFSUBR (Fprog1);
|
|
|
5374 DEFSUBR (Fprog2);
|
|
|
5375 DEFSUBR (Fsetq);
|
|
|
5376 DEFSUBR (Fquote);
|
|
|
5377 DEFSUBR (Ffunction);
|
|
|
5378 DEFSUBR (Fdefun);
|
|
|
5379 DEFSUBR (Fdefmacro);
|
|
|
5380 DEFSUBR (Fdefvar);
|
|
|
5381 DEFSUBR (Fdefconst);
|
|
|
5382 DEFSUBR (Fuser_variable_p);
|
|
|
5383 DEFSUBR (Flet);
|
|
|
5384 DEFSUBR (FletX);
|
|
|
5385 DEFSUBR (Fwhile);
|
|
|
5386 DEFSUBR (Fmacroexpand_internal);
|
|
|
5387 DEFSUBR (Fcatch);
|
|
|
5388 DEFSUBR (Fthrow);
|
|
|
5389 DEFSUBR (Funwind_protect);
|
|
|
5390 DEFSUBR (Fcondition_case);
|
|
|
5391 DEFSUBR (Fcall_with_condition_handler);
|
|
|
5392 DEFSUBR (Fsignal);
|
|
|
5393 DEFSUBR (Finteractive_p);
|
|
|
5394 DEFSUBR (Fcommandp);
|
|
|
5395 DEFSUBR (Fcommand_execute);
|
|
|
5396 DEFSUBR (Fautoload);
|
|
|
5397 DEFSUBR (Feval);
|
|
|
5398 DEFSUBR (Fapply);
|
|
|
5399 DEFSUBR (Ffuncall);
|
|
|
5400 DEFSUBR (Ffunctionp);
|
|
|
5401 DEFSUBR (Ffunction_min_args);
|
|
|
5402 DEFSUBR (Ffunction_max_args);
|
|
|
5403 DEFSUBR (Frun_hooks);
|
|
|
5404 DEFSUBR (Frun_hook_with_args);
|
|
|
5405 DEFSUBR (Frun_hook_with_args_until_success);
|
|
|
5406 DEFSUBR (Frun_hook_with_args_until_failure);
|
|
|
5407 DEFSUBR (Fbacktrace_debug);
|
|
|
5408 DEFSUBR (Fbacktrace);
|
|
|
5409 DEFSUBR (Fbacktrace_frame);
|
|
|
5410 }
|
|
|
5411
|
|
|
5412 void
|
|
771
|
5413 init_eval_early (void)
|
|
428
|
5414 {
|
|
|
5415 specpdl_ptr = specpdl;
|
|
|
5416 specpdl_depth_counter = 0;
|
|
|
5417 catchlist = 0;
|
|
|
5418 Vcondition_handlers = Qnil;
|
|
|
5419 backtrace_list = 0;
|
|
|
5420 Vquit_flag = Qnil;
|
|
|
5421 debug_on_next_call = 0;
|
|
|
5422 lisp_eval_depth = 0;
|
|
|
5423 entering_debugger = 0;
|
|
|
5424 }
|
|
|
5425
|
|
|
5426 void
|
|
|
5427 reinit_vars_of_eval (void)
|
|
|
5428 {
|
|
|
5429 preparing_for_armageddon = 0;
|
|
|
5430 in_warnings = 0;
|
|
|
5431 Qunbound_suspended_errors_tag = make_opaque_ptr (&Qunbound_suspended_errors_tag);
|
|
|
5432 staticpro_nodump (&Qunbound_suspended_errors_tag);
|
|
|
5433
|
|
|
5434 specpdl_size = 50;
|
|
|
5435 specpdl = xnew_array (struct specbinding, specpdl_size);
|
|
|
5436 /* XEmacs change: increase these values. */
|
|
|
5437 max_specpdl_size = 3000;
|
|
442
|
5438 max_lisp_eval_depth = 1000;
|
|
|
5439 #ifdef DEFEND_AGAINST_THROW_RECURSION
|
|
428
|
5440 throw_level = 0;
|
|
|
5441 #endif
|
|
|
5442 }
|
|
|
5443
|
|
|
5444 void
|
|
|
5445 vars_of_eval (void)
|
|
|
5446 {
|
|
|
5447 reinit_vars_of_eval ();
|
|
|
5448
|
|
|
5449 DEFVAR_INT ("max-specpdl-size", &max_specpdl_size /*
|
|
|
5450 Limit on number of Lisp variable bindings & unwind-protects before error.
|
|
|
5451 */ );
|
|
|
5452
|
|
|
5453 DEFVAR_INT ("max-lisp-eval-depth", &max_lisp_eval_depth /*
|
|
|
5454 Limit on depth in `eval', `apply' and `funcall' before error.
|
|
|
5455 This limit is to catch infinite recursions for you before they cause
|
|
|
5456 actual stack overflow in C, which would be fatal for Emacs.
|
|
|
5457 You can safely make it considerably larger than its default value,
|
|
|
5458 if that proves inconveniently small.
|
|
|
5459 */ );
|
|
|
5460
|
|
|
5461 DEFVAR_LISP ("quit-flag", &Vquit_flag /*
|
|
|
5462 Non-nil causes `eval' to abort, unless `inhibit-quit' is non-nil.
|
|
|
5463 Typing C-G sets `quit-flag' non-nil, regardless of `inhibit-quit'.
|
|
|
5464 */ );
|
|
|
5465 Vquit_flag = Qnil;
|
|
|
5466
|
|
|
5467 DEFVAR_LISP ("inhibit-quit", &Vinhibit_quit /*
|
|
|
5468 Non-nil inhibits C-g quitting from happening immediately.
|
|
|
5469 Note that `quit-flag' will still be set by typing C-g,
|
|
|
5470 so a quit will be signalled as soon as `inhibit-quit' is nil.
|
|
|
5471 To prevent this happening, set `quit-flag' to nil
|
|
|
5472 before making `inhibit-quit' nil. The value of `inhibit-quit' is
|
|
|
5473 ignored if a critical quit is requested by typing control-shift-G in
|
|
|
5474 an X frame.
|
|
|
5475 */ );
|
|
|
5476 Vinhibit_quit = Qnil;
|
|
|
5477
|
|
|
5478 DEFVAR_LISP ("stack-trace-on-error", &Vstack_trace_on_error /*
|
|
|
5479 *Non-nil means automatically display a backtrace buffer
|
|
|
5480 after any error that is not handled by a `condition-case'.
|
|
|
5481 If the value is a list, an error only means to display a backtrace
|
|
|
5482 if one of its condition symbols appears in the list.
|
|
|
5483 See also variable `stack-trace-on-signal'.
|
|
|
5484 */ );
|
|
|
5485 Vstack_trace_on_error = Qnil;
|
|
|
5486
|
|
|
5487 DEFVAR_LISP ("stack-trace-on-signal", &Vstack_trace_on_signal /*
|
|
|
5488 *Non-nil means automatically display a backtrace buffer
|
|
|
5489 after any error that is signalled, whether or not it is handled by
|
|
|
5490 a `condition-case'.
|
|
|
5491 If the value is a list, an error only means to display a backtrace
|
|
|
5492 if one of its condition symbols appears in the list.
|
|
|
5493 See also variable `stack-trace-on-error'.
|
|
|
5494 */ );
|
|
|
5495 Vstack_trace_on_signal = Qnil;
|
|
|
5496
|
|
|
5497 DEFVAR_LISP ("debug-ignored-errors", &Vdebug_ignored_errors /*
|
|
|
5498 *List of errors for which the debugger should not be called.
|
|
|
5499 Each element may be a condition-name or a regexp that matches error messages.
|
|
|
5500 If any element applies to a given error, that error skips the debugger
|
|
|
5501 and just returns to top level.
|
|
|
5502 This overrides the variable `debug-on-error'.
|
|
|
5503 It does not apply to errors handled by `condition-case'.
|
|
|
5504 */ );
|
|
|
5505 Vdebug_ignored_errors = Qnil;
|
|
|
5506
|
|
|
5507 DEFVAR_LISP ("debug-on-error", &Vdebug_on_error /*
|
|
|
5508 *Non-nil means enter debugger if an unhandled error is signalled.
|
|
|
5509 The debugger will not be entered if the error is handled by
|
|
|
5510 a `condition-case'.
|
|
|
5511 If the value is a list, an error only means to enter the debugger
|
|
|
5512 if one of its condition symbols appears in the list.
|
|
|
5513 This variable is overridden by `debug-ignored-errors'.
|
|
|
5514 See also variables `debug-on-quit' and `debug-on-signal'.
|
|
771
|
5515 If this variable is set while XEmacs is running noninteractively,
|
|
|
5516 an unhandled error will cause a backtrace to be output and the C
|
|
|
5517 debugger entered using `force-debugging-signal'. This can be very
|
|
|
5518 useful when debugging noninteractive errors in tricky situations,
|
|
|
5519 e.g. makefiles, since you can set this variable using an environment
|
|
|
5520 variable, like this:
|
|
|
5521
|
|
|
5522 \(using csh) setenv XEMACSDEBUG '(setq debug-on-error t)'
|
|
|
5523 \(using bash) export XEMACSDEBUG='(setq debug-on-error t)'
|
|
428
|
5524 */ );
|
|
|
5525 Vdebug_on_error = Qnil;
|
|
|
5526
|
|
|
5527 DEFVAR_LISP ("debug-on-signal", &Vdebug_on_signal /*
|
|
|
5528 *Non-nil means enter debugger if an error is signalled.
|
|
|
5529 The debugger will be entered whether or not the error is handled by
|
|
|
5530 a `condition-case'.
|
|
|
5531 If the value is a list, an error only means to enter the debugger
|
|
|
5532 if one of its condition symbols appears in the list.
|
|
|
5533 See also variable `debug-on-quit'.
|
|
|
5534 */ );
|
|
|
5535 Vdebug_on_signal = Qnil;
|
|
|
5536
|
|
|
5537 DEFVAR_BOOL ("debug-on-quit", &debug_on_quit /*
|
|
|
5538 *Non-nil means enter debugger if quit is signalled (C-G, for example).
|
|
|
5539 Does not apply if quit is handled by a `condition-case'. Entering the
|
|
|
5540 debugger can also be achieved at any time (for X11 console) by typing
|
|
|
5541 control-shift-G to signal a critical quit.
|
|
|
5542 */ );
|
|
|
5543 debug_on_quit = 0;
|
|
|
5544
|
|
|
5545 DEFVAR_BOOL ("debug-on-next-call", &debug_on_next_call /*
|
|
|
5546 Non-nil means enter debugger before next `eval', `apply' or `funcall'.
|
|
|
5547 */ );
|
|
|
5548
|
|
|
5549 DEFVAR_LISP ("debugger", &Vdebugger /*
|
|
|
5550 Function to call to invoke debugger.
|
|
|
5551 If due to frame exit, args are `exit' and the value being returned;
|
|
|
5552 this function's value will be returned instead of that.
|
|
|
5553 If due to error, args are `error' and a list of the args to `signal'.
|
|
|
5554 If due to `apply' or `funcall' entry, one arg, `lambda'.
|
|
|
5555 If due to `eval' entry, one arg, t.
|
|
|
5556 */ );
|
|
|
5557 Vdebugger = Qnil;
|
|
|
5558
|
|
|
5559 staticpro (&Vpending_warnings);
|
|
|
5560 Vpending_warnings = Qnil;
|
|
452
|
5561 dump_add_root_object (&Vpending_warnings_tail);
|
|
428
|
5562 Vpending_warnings_tail = Qnil;
|
|
|
5563
|
|
793
|
5564 DEFVAR_LISP ("log-warning-minimum-level", &Vlog_warning_minimum_level);
|
|
|
5565 Vlog_warning_minimum_level = Qinfo;
|
|
|
5566
|
|
428
|
5567 staticpro (&Vautoload_queue);
|
|
|
5568 Vautoload_queue = Qnil;
|
|
|
5569
|
|
|
5570 staticpro (&Vcondition_handlers);
|
|
|
5571
|
|
|
5572 staticpro (&Vcurrent_warning_class);
|
|
|
5573 Vcurrent_warning_class = Qnil;
|
|
|
5574
|
|
793
|
5575 staticpro (&Vcurrent_warning_level);
|
|
|
5576 Vcurrent_warning_level = Qnil;
|
|
|
5577
|
|
428
|
5578 staticpro (&Vcurrent_error_state);
|
|
|
5579 Vcurrent_error_state = Qnil; /* errors as normal */
|
|
771
|
5580 }
|
