|
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.
|
|
2421
|
4 Copyright (C) 2000, 2001, 2002, 2003, 2004 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
|
|
853
|
25 /* Authorship:
|
|
|
26
|
|
|
27 Based on code from pre-release FSF 19, c. 1991.
|
|
|
28 Some work by Richard Mlynarik long ago (c. 1993?) --
|
|
|
29 added call-with-condition-handler; synch. up to released FSF 19.7
|
|
|
30 for lemacs 19.8. some signal changes.
|
|
|
31 Various work by Ben Wing, 1995-1996:
|
|
|
32 added all stuff dealing with trapping errors, suspended-errors, etc.
|
|
|
33 added most Fsignal front ends.
|
|
|
34 added warning code.
|
|
|
35 reworked the Fsignal code and synched the rest up to FSF 19.30.
|
|
|
36 Some changes by Martin Buchholz c. 1999?
|
|
|
37 e.g. PRIMITIVE_FUNCALL macros.
|
|
|
38 New call_trapping_problems code and large comments below
|
|
|
39 by Ben Wing, Mar-Apr 2000.
|
|
|
40 */
|
|
|
41
|
|
|
42 /* This file has been Mule-ized. */
|
|
|
43
|
|
|
44 /* What is in this file?
|
|
|
45
|
|
|
46 This file contains the engine for the ELisp interpreter in XEmacs.
|
|
|
47 The engine does the actual work of implementing function calls,
|
|
|
48 form evaluation, non-local exits (catch, throw, signal,
|
|
|
49 condition-case, call-with-condition-handler), unwind-protects,
|
|
|
50 dynamic bindings, let constructs, backtraces, etc. You might say
|
|
|
51 that this module is the very heart of XEmacs, and everything else
|
|
|
52 in XEmacs is merely an auxiliary module implementing some specific
|
|
|
53 functionality that may be called from the heart at an appropriate
|
|
|
54 time.
|
|
|
55
|
|
|
56 The only exception is the alloc.c module, which implements the
|
|
|
57 framework upon which this module (eval.c) works. alloc.c works
|
|
|
58 with creating the actual Lisp objects themselves and garbage
|
|
1960
|
59 collecting them as necessary, presenting a nice, high-level
|
|
853
|
60 interface for object creation, deletion, access, and modification.
|
|
|
61
|
|
|
62 The only other exception that could be cited is the event-handling
|
|
|
63 module in event-stream.c. From its perspective, it is also the
|
|
|
64 heart of XEmacs, and controls exactly what gets done at what time.
|
|
|
65 From its perspective, eval.c is merely one of the auxiliary modules
|
|
|
66 out there that can be invoked by event-stream.c.
|
|
|
67
|
|
|
68 Although the event-stream-centric view is a convenient fiction that
|
|
|
69 makes sense particularly from the user's perspective and from the
|
|
|
70 perspective of time, the engine-centric view is actually closest to
|
|
|
71 the truth, because anywhere within the event-stream module, you are
|
|
|
72 still somewhere in a Lisp backtrace, and event-loops are begun by
|
|
|
73 functions such as `command-loop-1', a Lisp function.
|
|
|
74
|
|
|
75 As the Lisp engine is doing its thing, it maintains the state of
|
|
1960
|
76 the engine primarily in five list-like items, which are:
|
|
853
|
77
|
|
|
78 -- the backtrace list
|
|
|
79 -- the catchtag list
|
|
|
80 -- the condition-handler list
|
|
|
81 -- the specbind list
|
|
|
82 -- the GCPRO list.
|
|
|
83
|
|
|
84 These are described in detail in the next comment.
|
|
|
85
|
|
|
86 --ben
|
|
|
87 */
|
|
|
88
|
|
|
89 /* Note that there are five separate lists used to maintain state in
|
|
|
90 the evaluator. All of them conceptually are stacks (last-in,
|
|
|
91 first-out). All non-local exits happen ultimately through the
|
|
|
92 catch/throw mechanism, which uses one of the five lists (the
|
|
|
93 catchtag list) and records the current state of the others in each
|
|
|
94 frame of the list (some other information is recorded and restored
|
|
|
95 as well, such as the current eval depth), so that all the state of
|
|
|
96 the evaluator is restored properly when a non-local exit occurs.
|
|
|
97 (Note that the current state of the condition-handler list is not
|
|
|
98 recorded in the catchtag list. Instead, when a condition-case or
|
|
|
99 call-with-condition-handler is set up, it installs an
|
|
|
100 unwind-protect on the specbind list to restore the appropriate
|
|
|
101 setting for the condition-handler list. During the course of
|
|
|
102 handling the non-local exit, all entries on the specbind list that
|
|
|
103 are past the location stored in the catch frame are "unwound"
|
|
|
104 (i.e. variable bindings are restored and unwind-protects are
|
|
|
105 executed), so the condition-handler list gets reset properly.
|
|
|
106
|
|
|
107 The five lists are
|
|
|
108
|
|
|
109 1. The backtrace list, which is chained through `struct backtrace's
|
|
|
110 declared in the stack frames of various primitives, and keeps
|
|
|
111 track of all Lisp function call entries and exits.
|
|
|
112 2. The catchtag list, which is chained through `struct catchtag's
|
|
|
113 declared in the stack frames of internal_catch and condition_case_1,
|
|
|
114 and keeps track of information needed to reset the internal state
|
|
|
115 of the evaluator to the state that was current when the catch or
|
|
|
116 condition-case were established, in the event of a non-local exit.
|
|
|
117 3. The condition-handler list, which is a simple Lisp list with new
|
|
|
118 entries consed onto the front of the list. It records condition-cases
|
|
|
119 and call-with-condition-handlers established either from C or from
|
|
|
120 Lisp. Unlike with the other lists (but similar to everything else
|
|
|
121 of a similar nature in the rest of the C and Lisp code), it takes care
|
|
|
122 of restoring itself appropriately in the event of a non-local exit
|
|
|
123 through the use of the unwind-protect mechanism.
|
|
|
124 4. The specbind list, which is a contiguous array of `struct specbinding's,
|
|
|
125 expanded as necessary using realloc(). It holds dynamic variable
|
|
|
126 bindings (the only kind we currently have in ELisp) and unwind-protects.
|
|
|
127 5. The GCPRO list, which is chained through `struct gcpro's declared in
|
|
|
128 the stack frames of any functions that need to GC-protect Lisp_Objects
|
|
|
129 declared on the stack. This is one of the most fragile areas of the
|
|
|
130 entire scheme -- you must not forget to UNGCPRO at the end of your
|
|
|
131 function, you must make sure you GCPRO in many circumstances you don't
|
|
|
132 think you have to, etc. See the internals manual for more information
|
|
|
133 about this.
|
|
|
134
|
|
|
135 --ben
|
|
|
136 */
|
|
|
137
|
|
428
|
138 #include <config.h>
|
|
|
139 #include "lisp.h"
|
|
|
140
|
|
|
141 #include "commands.h"
|
|
|
142 #include "backtrace.h"
|
|
|
143 #include "bytecode.h"
|
|
|
144 #include "buffer.h"
|
|
872
|
145 #include "console-impl.h"
|
|
853
|
146 #include "device.h"
|
|
|
147 #include "frame.h"
|
|
|
148 #include "lstream.h"
|
|
428
|
149 #include "opaque.h"
|
|
1292
|
150 #include "profile.h"
|
|
853
|
151 #include "window.h"
|
|
428
|
152
|
|
|
153 struct backtrace *backtrace_list;
|
|
|
154
|
|
|
155 /* Macros for calling subrs with an argument list whose length is only
|
|
|
156 known at runtime. See EXFUN and DEFUN for similar hackery. */
|
|
|
157
|
|
|
158 #define AV_0(av)
|
|
|
159 #define AV_1(av) av[0]
|
|
|
160 #define AV_2(av) AV_1(av), av[1]
|
|
|
161 #define AV_3(av) AV_2(av), av[2]
|
|
|
162 #define AV_4(av) AV_3(av), av[3]
|
|
|
163 #define AV_5(av) AV_4(av), av[4]
|
|
|
164 #define AV_6(av) AV_5(av), av[5]
|
|
|
165 #define AV_7(av) AV_6(av), av[6]
|
|
|
166 #define AV_8(av) AV_7(av), av[7]
|
|
|
167
|
|
|
168 #define PRIMITIVE_FUNCALL_1(fn, av, ac) \
|
|
444
|
169 (((Lisp_Object (*)(EXFUN_##ac)) (fn)) (AV_##ac (av)))
|
|
428
|
170
|
|
|
171 /* If subrs take more than 8 arguments, more cases need to be added
|
|
|
172 to this switch. (But wait - don't do it - if you really need
|
|
|
173 a SUBR with more than 8 arguments, use max_args == MANY.
|
|
853
|
174 Or better, considering using a property list as one of your args.
|
|
428
|
175 See the DEFUN macro in lisp.h) */
|
|
|
176 #define PRIMITIVE_FUNCALL(rv, fn, av, ac) do { \
|
|
|
177 void (*PF_fn)(void) = (void (*)(void)) fn; \
|
|
|
178 Lisp_Object *PF_av = (av); \
|
|
|
179 switch (ac) \
|
|
|
180 { \
|
|
436
|
181 default:rv = PRIMITIVE_FUNCALL_1(PF_fn, PF_av, 0); break; \
|
|
428
|
182 case 1: rv = PRIMITIVE_FUNCALL_1(PF_fn, PF_av, 1); break; \
|
|
|
183 case 2: rv = PRIMITIVE_FUNCALL_1(PF_fn, PF_av, 2); break; \
|
|
|
184 case 3: rv = PRIMITIVE_FUNCALL_1(PF_fn, PF_av, 3); break; \
|
|
|
185 case 4: rv = PRIMITIVE_FUNCALL_1(PF_fn, PF_av, 4); break; \
|
|
|
186 case 5: rv = PRIMITIVE_FUNCALL_1(PF_fn, PF_av, 5); break; \
|
|
|
187 case 6: rv = PRIMITIVE_FUNCALL_1(PF_fn, PF_av, 6); break; \
|
|
|
188 case 7: rv = PRIMITIVE_FUNCALL_1(PF_fn, PF_av, 7); break; \
|
|
|
189 case 8: rv = PRIMITIVE_FUNCALL_1(PF_fn, PF_av, 8); break; \
|
|
|
190 } \
|
|
|
191 } while (0)
|
|
|
192
|
|
|
193 #define FUNCALL_SUBR(rv, subr, av, ac) \
|
|
|
194 PRIMITIVE_FUNCALL (rv, subr_function (subr), av, ac);
|
|
|
195
|
|
|
196
|
|
|
197 /* This is the list of current catches (and also condition-cases).
|
|
853
|
198 This is a stack: the most recent catch is at the head of the list.
|
|
|
199 The list is threaded through the stack frames of the C functions
|
|
|
200 that set up the catches; this is similar to the way the GCPRO list
|
|
|
201 is handled, but different from the condition-handler list (which is
|
|
|
202 a simple Lisp list) and the specbind stack, which is a contiguous
|
|
|
203 array of `struct specbinding's, grown (using realloc()) as
|
|
|
204 necessary. (Note that all four of these lists behave as a stacks.)
|
|
|
205
|
|
3025
|
206 Catches are created by declaring a `struct catchtag' locally,
|
|
853
|
207 filling the .TAG field in with the tag, and doing a setjmp() on
|
|
|
208 .JMP. Fthrow() will store the value passed to it in .VAL and
|
|
|
209 longjmp() back to .JMP, back to the function that established the
|
|
|
210 catch. This will always be either internal_catch() (catches
|
|
|
211 established internally or through `catch') or condition_case_1
|
|
|
212 (condition-cases established internally or through
|
|
|
213 `condition-case').
|
|
428
|
214
|
|
|
215 The catchtag also records the current position in the
|
|
|
216 call stack (stored in BACKTRACE_LIST), the current position
|
|
|
217 in the specpdl stack (used for variable bindings and
|
|
|
218 unwind-protects), the value of LISP_EVAL_DEPTH, and the
|
|
|
219 current position in the GCPRO stack. All of these are
|
|
|
220 restored by Fthrow().
|
|
853
|
221 */
|
|
428
|
222
|
|
|
223 struct catchtag *catchlist;
|
|
|
224
|
|
853
|
225 /* A special tag that can be used internally from C code to catch
|
|
|
226 every attempt to throw past this level. */
|
|
|
227 Lisp_Object Vcatch_everything_tag;
|
|
|
228
|
|
428
|
229 Lisp_Object Qautoload, Qmacro, Qexit;
|
|
|
230 Lisp_Object Qinteractive, Qcommandp, Qdefun, Qprogn, Qvalues;
|
|
|
231 Lisp_Object Vquit_flag, Vinhibit_quit;
|
|
|
232 Lisp_Object Qand_rest, Qand_optional;
|
|
|
233 Lisp_Object Qdebug_on_error, Qstack_trace_on_error;
|
|
|
234 Lisp_Object Qdebug_on_signal, Qstack_trace_on_signal;
|
|
|
235 Lisp_Object Qdebugger;
|
|
|
236 Lisp_Object Qinhibit_quit;
|
|
887
|
237 Lisp_Object Qfinalize_list;
|
|
428
|
238 Lisp_Object Qrun_hooks;
|
|
|
239 Lisp_Object Qsetq;
|
|
|
240 Lisp_Object Qdisplay_warning;
|
|
|
241 Lisp_Object Vpending_warnings, Vpending_warnings_tail;
|
|
|
242 Lisp_Object Qif;
|
|
|
243
|
|
853
|
244 /* Flags specifying which operations are currently inhibited. */
|
|
|
245 int inhibit_flags;
|
|
|
246
|
|
|
247 /* Buffers, frames, windows, devices, and consoles created since most
|
|
|
248 recent active
|
|
|
249 call_trapping_problems (INHIBIT_EXISTING_PERMANENT_DISPLAY_OBJECT_DELETION).
|
|
|
250 */
|
|
|
251 Lisp_Object Vdeletable_permanent_display_objects;
|
|
|
252
|
|
|
253 /* Buffers created since most recent active
|
|
|
254 call_trapping_problems (INHIBIT_EXISTING_BUFFER_TEXT_MODIFICATION). */
|
|
|
255 Lisp_Object Vmodifiable_buffers;
|
|
793
|
256
|
|
|
257 /* Minimum level at which warnings are logged. Below this, they're ignored
|
|
|
258 entirely -- not even generated. */
|
|
|
259 Lisp_Object Vlog_warning_minimum_level;
|
|
|
260
|
|
428
|
261 /* Non-nil means record all fset's and provide's, to be undone
|
|
|
262 if the file being autoloaded is not fully loaded.
|
|
|
263 They are recorded by being consed onto the front of Vautoload_queue:
|
|
|
264 (FUN . ODEF) for a defun, (OFEATURES . nil) for a provide. */
|
|
|
265 Lisp_Object Vautoload_queue;
|
|
|
266
|
|
|
267 /* Current number of specbindings allocated in specpdl. */
|
|
|
268 int specpdl_size;
|
|
|
269
|
|
|
270 /* Pointer to beginning of specpdl. */
|
|
|
271 struct specbinding *specpdl;
|
|
|
272
|
|
|
273 /* Pointer to first unused element in specpdl. */
|
|
|
274 struct specbinding *specpdl_ptr;
|
|
|
275
|
|
|
276 /* specpdl_ptr - specpdl */
|
|
|
277 int specpdl_depth_counter;
|
|
|
278
|
|
|
279 /* Maximum size allowed for specpdl allocation */
|
|
458
|
280 Fixnum max_specpdl_size;
|
|
428
|
281
|
|
|
282 /* Depth in Lisp evaluations and function calls. */
|
|
1292
|
283 int lisp_eval_depth;
|
|
428
|
284
|
|
|
285 /* Maximum allowed depth in Lisp evaluations and function calls. */
|
|
458
|
286 Fixnum max_lisp_eval_depth;
|
|
428
|
287
|
|
|
288 /* Nonzero means enter debugger before next function call */
|
|
|
289 static int debug_on_next_call;
|
|
|
290
|
|
1292
|
291 int backtrace_with_internal_sections;
|
|
|
292
|
|
428
|
293 /* List of conditions (non-nil atom means all) which cause a backtrace
|
|
|
294 if an error is handled by the command loop's error handler. */
|
|
|
295 Lisp_Object Vstack_trace_on_error;
|
|
|
296
|
|
|
297 /* List of conditions (non-nil atom means all) which enter the debugger
|
|
|
298 if an error is handled by the command loop's error handler. */
|
|
|
299 Lisp_Object Vdebug_on_error;
|
|
|
300
|
|
|
301 /* List of conditions and regexps specifying error messages which
|
|
|
302 do not enter the debugger even if Vdebug_on_error says they should. */
|
|
|
303 Lisp_Object Vdebug_ignored_errors;
|
|
|
304
|
|
|
305 /* List of conditions (non-nil atom means all) which cause a backtrace
|
|
|
306 if any error is signalled. */
|
|
|
307 Lisp_Object Vstack_trace_on_signal;
|
|
|
308
|
|
|
309 /* List of conditions (non-nil atom means all) which enter the debugger
|
|
|
310 if any error is signalled. */
|
|
|
311 Lisp_Object Vdebug_on_signal;
|
|
|
312
|
|
|
313 /* Nonzero means enter debugger if a quit signal
|
|
|
314 is handled by the command loop's error handler.
|
|
|
315
|
|
|
316 From lisp, this is a boolean variable and may have the values 0 and 1.
|
|
|
317 But, eval.c temporarily uses the second bit of this variable to indicate
|
|
|
318 that a critical_quit is in progress. The second bit is reset immediately
|
|
|
319 after it is processed in signal_call_debugger(). */
|
|
|
320 int debug_on_quit;
|
|
|
321
|
|
|
322 #if 0 /* FSFmacs */
|
|
|
323 /* entering_debugger is basically equivalent */
|
|
|
324 /* The value of num_nonmacro_input_chars as of the last time we
|
|
|
325 started to enter the debugger. If we decide to enter the debugger
|
|
|
326 again when this is still equal to num_nonmacro_input_chars, then we
|
|
|
327 know that the debugger itself has an error, and we should just
|
|
|
328 signal the error instead of entering an infinite loop of debugger
|
|
|
329 invocations. */
|
|
|
330 int when_entered_debugger;
|
|
|
331 #endif
|
|
|
332
|
|
|
333 /* Nonzero means we are trying to enter the debugger.
|
|
|
334 This is to prevent recursive attempts.
|
|
|
335 Cleared by the debugger calling Fbacktrace */
|
|
|
336 static int entering_debugger;
|
|
|
337
|
|
|
338 /* Function to call to invoke the debugger */
|
|
|
339 Lisp_Object Vdebugger;
|
|
|
340
|
|
853
|
341 /* List of condition handlers currently in effect.
|
|
|
342 The elements of this lists were at one point in the past
|
|
|
343 threaded through the stack frames of Fcondition_case and
|
|
|
344 related functions, but now are stored separately in a normal
|
|
|
345 stack. When an error is signaled (by calling Fsignal, below),
|
|
|
346 this list is searched for an element that applies.
|
|
428
|
347
|
|
|
348 Each element of this list is one of the following:
|
|
|
349
|
|
853
|
350 -- A list of a handler function and possibly args to pass to the
|
|
|
351 function. This is a handler established with the Lisp primitive
|
|
|
352 `call-with-condition-handler' or related C function
|
|
|
353 call_with_condition_handler():
|
|
|
354
|
|
|
355 If the handler function is an opaque ptr object, it is a handler
|
|
|
356 that was established in C using call_with_condition_handler(),
|
|
|
357 and the contents of the object are a function pointer which takes
|
|
|
358 three arguments, the signal name and signal data (same arguments
|
|
|
359 passed to `signal') and a third Lisp_Object argument, specified
|
|
|
360 in the call to call_with_condition_handler() and stored as the
|
|
|
361 second element of the list containing the handler functionl.
|
|
|
362
|
|
|
363 If the handler function is a regular Lisp_Object, it is a handler
|
|
|
364 that was established using `call-with-condition-handler'.
|
|
|
365 Currently there are no more arguments in the list containing the
|
|
|
366 handler function, and only one argument is passed to the handler
|
|
|
367 function: a cons of the signal name and signal data arguments
|
|
|
368 passed to `signal'.
|
|
|
369
|
|
|
370 -- A list whose car is Qunbound and whose cdr is Qt. This is a
|
|
|
371 special condition-case handler established by C code with
|
|
|
372 condition_case_1(). All errors are trapped; the debugger is not
|
|
|
373 invoked even if `debug-on-error' was set.
|
|
|
374
|
|
|
375 -- A list whose car is Qunbound and whose cdr is Qerror. This is a
|
|
|
376 special condition-case handler established by C code with
|
|
|
377 condition_case_1(). It is like Qt except that the debugger is
|
|
|
378 invoked normally if it is called for.
|
|
|
379
|
|
|
380 -- A list whose car is Qunbound and whose cdr is a list of lists
|
|
|
381 (CONDITION-NAME BODY ...) exactly as in `condition-case'. This is
|
|
|
382 a normal `condition-case' handler.
|
|
|
383
|
|
|
384 Note that in all cases *except* the first, there is a corresponding
|
|
|
385 catch, whose TAG is the value of Vcondition_handlers just after the
|
|
|
386 handler data just described is pushed onto it. The reason is that
|
|
|
387 `condition-case' handlers need to throw back to the place where the
|
|
|
388 handler was installed before invoking it, while
|
|
|
389 `call-with-condition-handler' handlers are invoked in the
|
|
|
390 environment that `signal' was invoked in. */
|
|
|
391
|
|
|
392
|
|
428
|
393 static Lisp_Object Vcondition_handlers;
|
|
|
394
|
|
853
|
395 /* I think we should keep this enabled all the time, not just when
|
|
|
396 error checking is enabled, because if one of these puppies pops up,
|
|
|
397 it will trash the stack if not caught, making it that much harder to
|
|
|
398 debug. It doesn't cause speed loss. */
|
|
442
|
399 #define DEFEND_AGAINST_THROW_RECURSION
|
|
|
400
|
|
|
401 #ifdef DEFEND_AGAINST_THROW_RECURSION
|
|
428
|
402 /* Used for error catching purposes by throw_or_bomb_out */
|
|
|
403 static int throw_level;
|
|
442
|
404 #endif
|
|
|
405
|
|
1123
|
406 static int warning_will_be_discarded (Lisp_Object level);
|
|
2532
|
407 static Lisp_Object maybe_get_trapping_problems_backtrace (void);
|
|
1123
|
408
|
|
428
|
409
|
|
|
410 /************************************************************************/
|
|
|
411 /* The subr object type */
|
|
|
412 /************************************************************************/
|
|
|
413
|
|
|
414 static void
|
|
2286
|
415 print_subr (Lisp_Object obj, Lisp_Object printcharfun, int UNUSED (escapeflag))
|
|
428
|
416 {
|
|
|
417 Lisp_Subr *subr = XSUBR (obj);
|
|
867
|
418 const CIbyte *header =
|
|
428
|
419 (subr->max_args == UNEVALLED) ? "#<special-form " : "#<subr ";
|
|
867
|
420 const CIbyte *name = subr_name (subr);
|
|
|
421 const CIbyte *trailer = subr->prompt ? " (interactive)>" : ">";
|
|
428
|
422
|
|
|
423 if (print_readably)
|
|
563
|
424 printing_unreadable_object ("%s%s%s", header, name, trailer);
|
|
428
|
425
|
|
826
|
426 write_c_string (printcharfun, header);
|
|
|
427 write_c_string (printcharfun, name);
|
|
|
428 write_c_string (printcharfun, trailer);
|
|
428
|
429 }
|
|
|
430
|
|
1204
|
431 static const struct memory_description subr_description[] = {
|
|
2551
|
432 { XD_DOC_STRING, offsetof (Lisp_Subr, doc), 0, { 0 }, XD_FLAG_NO_KKCC },
|
|
428
|
433 { XD_END }
|
|
|
434 };
|
|
|
435
|
|
938
|
436 DEFINE_BASIC_LRECORD_IMPLEMENTATION ("subr", subr,
|
|
|
437 1, /*dumpable-flag*/
|
|
|
438 0, print_subr, 0, 0, 0,
|
|
|
439 subr_description,
|
|
|
440 Lisp_Subr);
|
|
428
|
441
|
|
|
442 /************************************************************************/
|
|
|
443 /* Entering the debugger */
|
|
|
444 /************************************************************************/
|
|
|
445
|
|
853
|
446 static Lisp_Object
|
|
|
447 current_warning_level (void)
|
|
|
448 {
|
|
|
449 if (inhibit_flags & ISSUE_WARNINGS_AT_DEBUG_LEVEL)
|
|
|
450 return Qdebug;
|
|
|
451 else
|
|
|
452 return Qwarning;
|
|
|
453 }
|
|
|
454
|
|
428
|
455 /* Actually call the debugger. ARG is a list of args that will be
|
|
|
456 passed to the debugger function, as follows;
|
|
|
457
|
|
|
458 If due to frame exit, args are `exit' and the value being returned;
|
|
|
459 this function's value will be returned instead of that.
|
|
|
460 If due to error, args are `error' and a list of the args to `signal'.
|
|
|
461 If due to `apply' or `funcall' entry, one arg, `lambda'.
|
|
|
462 If due to `eval' entry, one arg, t.
|
|
|
463
|
|
|
464 */
|
|
|
465
|
|
|
466 static Lisp_Object
|
|
|
467 call_debugger_259 (Lisp_Object arg)
|
|
|
468 {
|
|
|
469 return apply1 (Vdebugger, arg);
|
|
|
470 }
|
|
|
471
|
|
|
472 /* Call the debugger, doing some encapsulation. We make sure we have
|
|
|
473 some room on the eval and specpdl stacks, and bind entering_debugger
|
|
|
474 to 1 during this call. This is used to trap errors that may occur
|
|
|
475 when entering the debugger (e.g. the value of `debugger' is invalid),
|
|
|
476 so that the debugger will not be recursively entered if debug-on-error
|
|
|
477 is set. (Otherwise, XEmacs would infinitely recurse, attempting to
|
|
|
478 enter the debugger.) entering_debugger gets reset to 0 as soon
|
|
|
479 as a backtrace is displayed, so that further errors can indeed be
|
|
|
480 handled normally.
|
|
|
481
|
|
3025
|
482 We also establish a catch for `debugger'. If the debugger function
|
|
428
|
483 throws to this instead of returning a value, it means that the user
|
|
|
484 pressed 'c' (pretend like the debugger was never entered). The
|
|
|
485 function then returns Qunbound. (If the user pressed 'r', for
|
|
|
486 return a value, then the debugger function returns normally with
|
|
|
487 this value.)
|
|
|
488
|
|
|
489 The difference between 'c' and 'r' is as follows:
|
|
|
490
|
|
|
491 debug-on-call:
|
|
|
492 No difference. The call proceeds as normal.
|
|
|
493 debug-on-exit:
|
|
|
494 With 'r', the specified value is returned as the function's
|
|
|
495 return value. With 'c', the value that would normally be
|
|
|
496 returned is returned.
|
|
|
497 signal:
|
|
|
498 With 'r', the specified value is returned as the return
|
|
|
499 value of `signal'. (This is the only time that `signal'
|
|
|
500 can return, instead of making a non-local exit.) With `c',
|
|
|
501 `signal' will continue looking for handlers as if the
|
|
|
502 debugger was never entered, and will probably end up
|
|
|
503 throwing to a handler or to top-level.
|
|
|
504 */
|
|
|
505
|
|
|
506 static Lisp_Object
|
|
|
507 call_debugger (Lisp_Object arg)
|
|
|
508 {
|
|
|
509 int threw;
|
|
|
510 Lisp_Object val;
|
|
|
511 int speccount;
|
|
|
512
|
|
853
|
513 debug_on_next_call = 0;
|
|
|
514
|
|
|
515 if (inhibit_flags & INHIBIT_ENTERING_DEBUGGER)
|
|
|
516 {
|
|
|
517 if (!(inhibit_flags & INHIBIT_WARNING_ISSUE))
|
|
|
518 warn_when_safe
|
|
|
519 (Qdebugger, current_warning_level (),
|
|
|
520 "Unable to enter debugger within critical section");
|
|
|
521 return Qunbound;
|
|
|
522 }
|
|
|
523
|
|
428
|
524 if (lisp_eval_depth + 20 > max_lisp_eval_depth)
|
|
|
525 max_lisp_eval_depth = lisp_eval_depth + 20;
|
|
|
526 if (specpdl_size + 40 > max_specpdl_size)
|
|
|
527 max_specpdl_size = specpdl_size + 40;
|
|
853
|
528
|
|
|
529 speccount = internal_bind_int (&entering_debugger, 1);
|
|
2532
|
530 val = internal_catch (Qdebugger, call_debugger_259, arg, &threw, 0, 0);
|
|
428
|
531
|
|
771
|
532 return unbind_to_1 (speccount, ((threw)
|
|
428
|
533 ? Qunbound /* Not returning a value */
|
|
|
534 : val));
|
|
|
535 }
|
|
|
536
|
|
|
537 /* Called when debug-on-exit behavior is called for. Enter the debugger
|
|
|
538 with the appropriate args for this. VAL is the exit value that is
|
|
|
539 about to be returned. */
|
|
|
540
|
|
|
541 static Lisp_Object
|
|
|
542 do_debug_on_exit (Lisp_Object val)
|
|
|
543 {
|
|
|
544 /* This is falsified by call_debugger */
|
|
|
545 Lisp_Object v = call_debugger (list2 (Qexit, val));
|
|
|
546
|
|
|
547 return !UNBOUNDP (v) ? v : val;
|
|
|
548 }
|
|
|
549
|
|
|
550 /* Called when debug-on-call behavior is called for. Enter the debugger
|
|
|
551 with the appropriate args for this. VAL is either t for a call
|
|
3025
|
552 through `eval' or `lambda' for a call through `funcall'.
|
|
428
|
553
|
|
|
554 #### The differentiation here between EVAL and FUNCALL is bogus.
|
|
|
555 FUNCALL can be defined as
|
|
|
556
|
|
|
557 (defmacro func (fun &rest args)
|
|
|
558 (cons (eval fun) args))
|
|
|
559
|
|
|
560 and should be treated as such.
|
|
|
561 */
|
|
|
562
|
|
|
563 static void
|
|
|
564 do_debug_on_call (Lisp_Object code)
|
|
|
565 {
|
|
|
566 debug_on_next_call = 0;
|
|
|
567 backtrace_list->debug_on_exit = 1;
|
|
|
568 call_debugger (list1 (code));
|
|
|
569 }
|
|
|
570
|
|
|
571 /* LIST is the value of one of the variables `debug-on-error',
|
|
|
572 `debug-on-signal', `stack-trace-on-error', or `stack-trace-on-signal',
|
|
|
573 and CONDITIONS is the list of error conditions associated with
|
|
|
574 the error being signalled. This returns non-nil if LIST
|
|
|
575 matches CONDITIONS. (A nil value for LIST does not match
|
|
|
576 CONDITIONS. A non-list value for LIST does match CONDITIONS.
|
|
|
577 A list matches CONDITIONS when one of the symbols in LIST is the
|
|
|
578 same as one of the symbols in CONDITIONS.) */
|
|
|
579
|
|
|
580 static int
|
|
|
581 wants_debugger (Lisp_Object list, Lisp_Object conditions)
|
|
|
582 {
|
|
|
583 if (NILP (list))
|
|
|
584 return 0;
|
|
|
585 if (! CONSP (list))
|
|
|
586 return 1;
|
|
|
587
|
|
|
588 while (CONSP (conditions))
|
|
|
589 {
|
|
2552
|
590 Lisp_Object curr, tail;
|
|
|
591 curr = XCAR (conditions);
|
|
428
|
592 for (tail = list; CONSP (tail); tail = XCDR (tail))
|
|
2552
|
593 if (EQ (XCAR (tail), curr))
|
|
428
|
594 return 1;
|
|
|
595 conditions = XCDR (conditions);
|
|
|
596 }
|
|
|
597 return 0;
|
|
|
598 }
|
|
|
599
|
|
|
600
|
|
|
601 /* Return 1 if an error with condition-symbols CONDITIONS,
|
|
|
602 and described by SIGNAL-DATA, should skip the debugger
|
|
|
603 according to debugger-ignore-errors. */
|
|
|
604
|
|
|
605 static int
|
|
|
606 skip_debugger (Lisp_Object conditions, Lisp_Object data)
|
|
|
607 {
|
|
|
608 /* This function can GC */
|
|
|
609 Lisp_Object tail;
|
|
|
610 int first_string = 1;
|
|
|
611 Lisp_Object error_message = Qnil;
|
|
|
612
|
|
|
613 for (tail = Vdebug_ignored_errors; CONSP (tail); tail = XCDR (tail))
|
|
|
614 {
|
|
|
615 if (STRINGP (XCAR (tail)))
|
|
|
616 {
|
|
|
617 if (first_string)
|
|
|
618 {
|
|
|
619 error_message = Ferror_message_string (data);
|
|
|
620 first_string = 0;
|
|
|
621 }
|
|
|
622 if (fast_lisp_string_match (XCAR (tail), error_message) >= 0)
|
|
|
623 return 1;
|
|
|
624 }
|
|
|
625 else
|
|
|
626 {
|
|
|
627 Lisp_Object contail;
|
|
|
628
|
|
|
629 for (contail = conditions; CONSP (contail); contail = XCDR (contail))
|
|
|
630 if (EQ (XCAR (tail), XCAR (contail)))
|
|
|
631 return 1;
|
|
|
632 }
|
|
|
633 }
|
|
|
634
|
|
|
635 return 0;
|
|
|
636 }
|
|
|
637
|
|
|
638 /* Actually generate a backtrace on STREAM. */
|
|
|
639
|
|
|
640 static Lisp_Object
|
|
|
641 backtrace_259 (Lisp_Object stream)
|
|
|
642 {
|
|
|
643 return Fbacktrace (stream, Qt);
|
|
|
644 }
|
|
|
645
|
|
1130
|
646 #ifdef DEBUG_XEMACS
|
|
|
647
|
|
|
648 static void
|
|
|
649 trace_out_and_die (Lisp_Object err)
|
|
|
650 {
|
|
|
651 Fdisplay_error (err, Qt);
|
|
|
652 backtrace_259 (Qnil);
|
|
|
653 stderr_out ("XEmacs exiting to debugger.\n");
|
|
|
654 Fforce_debugging_signal (Qt);
|
|
|
655 /* Unlikely to be reached */
|
|
|
656 }
|
|
|
657
|
|
|
658 #endif
|
|
|
659
|
|
428
|
660 /* An error was signaled. Maybe call the debugger, if the `debug-on-error'
|
|
|
661 etc. variables call for this. CONDITIONS is the list of conditions
|
|
|
662 associated with the error being signalled. SIG is the actual error
|
|
|
663 being signalled, and DATA is the associated data (these are exactly
|
|
|
664 the same as the arguments to `signal'). ACTIVE_HANDLERS is the
|
|
|
665 list of error handlers that are to be put in place while the debugger
|
|
|
666 is called. This is generally the remaining handlers that are
|
|
|
667 outside of the innermost handler trapping this error. This way,
|
|
|
668 if the same error occurs inside of the debugger, you usually don't get
|
|
|
669 the debugger entered recursively.
|
|
|
670
|
|
|
671 This function returns Qunbound if it didn't call the debugger or if
|
|
|
672 the user asked (through 'c') that XEmacs should pretend like the
|
|
|
673 debugger was never entered. Otherwise, it returns the value
|
|
|
674 that the user specified with `r'. (Note that much of the time,
|
|
|
675 the user will abort with C-], and we will never have a chance to
|
|
|
676 return anything at all.)
|
|
|
677
|
|
|
678 SIGNAL_VARS_ONLY means we should only look at debug-on-signal
|
|
|
679 and stack-trace-on-signal to control whether we do anything.
|
|
|
680 This is so that debug-on-error doesn't make handled errors
|
|
|
681 cause the debugger to get invoked.
|
|
|
682
|
|
|
683 STACK_TRACE_DISPLAYED and DEBUGGER_ENTERED are used so that
|
|
|
684 those functions aren't done more than once in a single `signal'
|
|
|
685 session. */
|
|
|
686
|
|
|
687 static Lisp_Object
|
|
|
688 signal_call_debugger (Lisp_Object conditions,
|
|
|
689 Lisp_Object sig, Lisp_Object data,
|
|
|
690 Lisp_Object active_handlers,
|
|
|
691 int signal_vars_only,
|
|
|
692 int *stack_trace_displayed,
|
|
|
693 int *debugger_entered)
|
|
|
694 {
|
|
853
|
695 #ifdef PIGS_FLY_AND_ALL_C_CODE_CAN_HANDLE_GC_OCCURRING_ALMOST_ANYWHERE
|
|
428
|
696 /* This function can GC */
|
|
853
|
697 #else /* reality check */
|
|
|
698 /* This function cannot GC because it inhibits GC during its operation */
|
|
|
699 #endif
|
|
|
700
|
|
428
|
701 Lisp_Object val = Qunbound;
|
|
|
702 Lisp_Object all_handlers = Vcondition_handlers;
|
|
|
703 Lisp_Object temp_data = Qnil;
|
|
853
|
704 int outer_speccount = specpdl_depth();
|
|
|
705 int speccount;
|
|
|
706
|
|
|
707 #ifdef PIGS_FLY_AND_ALL_C_CODE_CAN_HANDLE_GC_OCCURRING_ALMOST_ANYWHERE
|
|
428
|
708 struct gcpro gcpro1, gcpro2;
|
|
|
709 GCPRO2 (all_handlers, temp_data);
|
|
853
|
710 #else
|
|
|
711 begin_gc_forbidden ();
|
|
|
712 #endif
|
|
|
713
|
|
|
714 speccount = specpdl_depth();
|
|
428
|
715
|
|
|
716 Vcondition_handlers = active_handlers;
|
|
|
717
|
|
|
718 temp_data = Fcons (sig, data); /* needed for skip_debugger */
|
|
|
719
|
|
|
720 if (!entering_debugger && !*stack_trace_displayed && !signal_vars_only
|
|
|
721 && wants_debugger (Vstack_trace_on_error, conditions)
|
|
|
722 && !skip_debugger (conditions, temp_data))
|
|
|
723 {
|
|
|
724 specbind (Qdebug_on_error, Qnil);
|
|
|
725 specbind (Qstack_trace_on_error, Qnil);
|
|
|
726 specbind (Qdebug_on_signal, Qnil);
|
|
|
727 specbind (Qstack_trace_on_signal, Qnil);
|
|
|
728
|
|
442
|
729 if (!noninteractive)
|
|
|
730 internal_with_output_to_temp_buffer (build_string ("*Backtrace*"),
|
|
|
731 backtrace_259,
|
|
|
732 Qnil,
|
|
|
733 Qnil);
|
|
|
734 else /* in batch mode, we want this going to stderr. */
|
|
|
735 backtrace_259 (Qnil);
|
|
771
|
736 unbind_to (speccount);
|
|
428
|
737 *stack_trace_displayed = 1;
|
|
|
738 }
|
|
|
739
|
|
|
740 if (!entering_debugger && !*debugger_entered && !signal_vars_only
|
|
|
741 && (EQ (sig, Qquit)
|
|
|
742 ? debug_on_quit
|
|
|
743 : wants_debugger (Vdebug_on_error, conditions))
|
|
|
744 && !skip_debugger (conditions, temp_data))
|
|
|
745 {
|
|
|
746 debug_on_quit &= ~2; /* reset critical bit */
|
|
1123
|
747
|
|
428
|
748 specbind (Qdebug_on_error, Qnil);
|
|
|
749 specbind (Qstack_trace_on_error, Qnil);
|
|
|
750 specbind (Qdebug_on_signal, Qnil);
|
|
|
751 specbind (Qstack_trace_on_signal, Qnil);
|
|
|
752
|
|
1130
|
753 #ifdef DEBUG_XEMACS
|
|
|
754 if (noninteractive)
|
|
|
755 trace_out_and_die (Fcons (sig, data));
|
|
|
756 #endif
|
|
|
757
|
|
428
|
758 val = call_debugger (list2 (Qerror, (Fcons (sig, data))));
|
|
853
|
759 unbind_to (speccount);
|
|
428
|
760 *debugger_entered = 1;
|
|
|
761 }
|
|
|
762
|
|
|
763 if (!entering_debugger && !*stack_trace_displayed
|
|
|
764 && wants_debugger (Vstack_trace_on_signal, conditions))
|
|
|
765 {
|
|
|
766 specbind (Qdebug_on_error, Qnil);
|
|
|
767 specbind (Qstack_trace_on_error, Qnil);
|
|
|
768 specbind (Qdebug_on_signal, Qnil);
|
|
|
769 specbind (Qstack_trace_on_signal, Qnil);
|
|
|
770
|
|
442
|
771 if (!noninteractive)
|
|
|
772 internal_with_output_to_temp_buffer (build_string ("*Backtrace*"),
|
|
|
773 backtrace_259,
|
|
|
774 Qnil,
|
|
|
775 Qnil);
|
|
|
776 else /* in batch mode, we want this going to stderr. */
|
|
|
777 backtrace_259 (Qnil);
|
|
771
|
778 unbind_to (speccount);
|
|
428
|
779 *stack_trace_displayed = 1;
|
|
|
780 }
|
|
|
781
|
|
|
782 if (!entering_debugger && !*debugger_entered
|
|
|
783 && (EQ (sig, Qquit)
|
|
|
784 ? debug_on_quit
|
|
|
785 : wants_debugger (Vdebug_on_signal, conditions)))
|
|
|
786 {
|
|
|
787 debug_on_quit &= ~2; /* reset critical bit */
|
|
1123
|
788
|
|
428
|
789 specbind (Qdebug_on_error, Qnil);
|
|
|
790 specbind (Qstack_trace_on_error, Qnil);
|
|
|
791 specbind (Qdebug_on_signal, Qnil);
|
|
|
792 specbind (Qstack_trace_on_signal, Qnil);
|
|
|
793
|
|
1130
|
794 #ifdef DEBUG_XEMACS
|
|
|
795 if (noninteractive)
|
|
|
796 trace_out_and_die (Fcons (sig, data));
|
|
|
797 #endif
|
|
|
798
|
|
428
|
799 val = call_debugger (list2 (Qerror, (Fcons (sig, data))));
|
|
|
800 *debugger_entered = 1;
|
|
|
801 }
|
|
|
802
|
|
853
|
803 #ifdef PIGS_FLY_AND_ALL_C_CODE_CAN_HANDLE_GC_OCCURRING_ALMOST_ANYWHERE
|
|
428
|
804 UNGCPRO;
|
|
853
|
805 #endif
|
|
428
|
806 Vcondition_handlers = all_handlers;
|
|
853
|
807 return unbind_to_1 (outer_speccount, val);
|
|
428
|
808 }
|
|
|
809
|
|
|
810
|
|
|
811 /************************************************************************/
|
|
|
812 /* The basic special forms */
|
|
|
813 /************************************************************************/
|
|
|
814
|
|
|
815 /* Except for Fprogn(), the basic special forms below are only called
|
|
|
816 from interpreted code. The byte compiler turns them into bytecodes. */
|
|
|
817
|
|
|
818 DEFUN ("or", For, 0, UNEVALLED, 0, /*
|
|
|
819 Eval args until one of them yields non-nil, then return that value.
|
|
|
820 The remaining args are not evalled at all.
|
|
|
821 If all args return nil, return nil.
|
|
|
822 */
|
|
|
823 (args))
|
|
|
824 {
|
|
|
825 /* This function can GC */
|
|
442
|
826 REGISTER Lisp_Object val;
|
|
428
|
827
|
|
|
828 LIST_LOOP_2 (arg, args)
|
|
|
829 {
|
|
|
830 if (!NILP (val = Feval (arg)))
|
|
|
831 return val;
|
|
|
832 }
|
|
|
833
|
|
|
834 return Qnil;
|
|
|
835 }
|
|
|
836
|
|
|
837 DEFUN ("and", Fand, 0, UNEVALLED, 0, /*
|
|
|
838 Eval args until one of them yields nil, then return nil.
|
|
|
839 The remaining args are not evalled at all.
|
|
|
840 If no arg yields nil, return the last arg's value.
|
|
|
841 */
|
|
|
842 (args))
|
|
|
843 {
|
|
|
844 /* This function can GC */
|
|
442
|
845 REGISTER Lisp_Object val = Qt;
|
|
428
|
846
|
|
|
847 LIST_LOOP_2 (arg, args)
|
|
|
848 {
|
|
|
849 if (NILP (val = Feval (arg)))
|
|
|
850 return val;
|
|
|
851 }
|
|
|
852
|
|
|
853 return val;
|
|
|
854 }
|
|
|
855
|
|
|
856 DEFUN ("if", Fif, 2, UNEVALLED, 0, /*
|
|
|
857 \(if COND THEN ELSE...): if COND yields non-nil, do THEN, else do ELSE...
|
|
|
858 Returns the value of THEN or the value of the last of the ELSE's.
|
|
|
859 THEN must be one expression, but ELSE... can be zero or more expressions.
|
|
|
860 If COND yields nil, and there are no ELSE's, the value is nil.
|
|
|
861 */
|
|
|
862 (args))
|
|
|
863 {
|
|
|
864 /* This function can GC */
|
|
|
865 Lisp_Object condition = XCAR (args);
|
|
|
866 Lisp_Object then_form = XCAR (XCDR (args));
|
|
|
867 Lisp_Object else_forms = XCDR (XCDR (args));
|
|
|
868
|
|
|
869 if (!NILP (Feval (condition)))
|
|
|
870 return Feval (then_form);
|
|
|
871 else
|
|
|
872 return Fprogn (else_forms);
|
|
|
873 }
|
|
|
874
|
|
|
875 /* Macros `when' and `unless' are trivially defined in Lisp,
|
|
|
876 but it helps for bootstrapping to have them ALWAYS defined. */
|
|
|
877
|
|
|
878 DEFUN ("when", Fwhen, 1, MANY, 0, /*
|
|
|
879 \(when COND BODY...): if COND yields non-nil, do BODY, else return nil.
|
|
|
880 BODY can be zero or more expressions. If BODY is nil, return nil.
|
|
|
881 */
|
|
|
882 (int nargs, Lisp_Object *args))
|
|
|
883 {
|
|
|
884 Lisp_Object cond = args[0];
|
|
|
885 Lisp_Object body;
|
|
853
|
886
|
|
428
|
887 switch (nargs)
|
|
|
888 {
|
|
|
889 case 1: body = Qnil; break;
|
|
|
890 case 2: body = args[1]; break;
|
|
|
891 default: body = Fcons (Qprogn, Flist (nargs-1, args+1)); break;
|
|
|
892 }
|
|
|
893
|
|
|
894 return list3 (Qif, cond, body);
|
|
|
895 }
|
|
|
896
|
|
|
897 DEFUN ("unless", Funless, 1, MANY, 0, /*
|
|
|
898 \(unless COND BODY...): if COND yields nil, do BODY, else return nil.
|
|
|
899 BODY can be zero or more expressions. If BODY is nil, return nil.
|
|
|
900 */
|
|
|
901 (int nargs, Lisp_Object *args))
|
|
|
902 {
|
|
|
903 Lisp_Object cond = args[0];
|
|
|
904 Lisp_Object body = Flist (nargs-1, args+1);
|
|
|
905 return Fcons (Qif, Fcons (cond, Fcons (Qnil, body)));
|
|
|
906 }
|
|
|
907
|
|
|
908 DEFUN ("cond", Fcond, 0, UNEVALLED, 0, /*
|
|
444
|
909 \(cond CLAUSES...): try each clause until one succeeds.
|
|
428
|
910 Each clause looks like (CONDITION BODY...). CONDITION is evaluated
|
|
|
911 and, if the value is non-nil, this clause succeeds:
|
|
|
912 then the expressions in BODY are evaluated and the last one's
|
|
|
913 value is the value of the cond-form.
|
|
|
914 If no clause succeeds, cond returns nil.
|
|
|
915 If a clause has one element, as in (CONDITION),
|
|
|
916 CONDITION's value if non-nil is returned from the cond-form.
|
|
|
917 */
|
|
|
918 (args))
|
|
|
919 {
|
|
|
920 /* This function can GC */
|
|
442
|
921 REGISTER Lisp_Object val;
|
|
428
|
922
|
|
|
923 LIST_LOOP_2 (clause, args)
|
|
|
924 {
|
|
|
925 CHECK_CONS (clause);
|
|
|
926 if (!NILP (val = Feval (XCAR (clause))))
|
|
|
927 {
|
|
|
928 if (!NILP (clause = XCDR (clause)))
|
|
|
929 {
|
|
|
930 CHECK_TRUE_LIST (clause);
|
|
|
931 val = Fprogn (clause);
|
|
|
932 }
|
|
|
933 return val;
|
|
|
934 }
|
|
|
935 }
|
|
|
936
|
|
|
937 return Qnil;
|
|
|
938 }
|
|
|
939
|
|
|
940 DEFUN ("progn", Fprogn, 0, UNEVALLED, 0, /*
|
|
|
941 \(progn BODY...): eval BODY forms sequentially and return value of last one.
|
|
|
942 */
|
|
|
943 (args))
|
|
|
944 {
|
|
|
945 /* This function can GC */
|
|
|
946 /* Caller must provide a true list in ARGS */
|
|
442
|
947 REGISTER Lisp_Object val = Qnil;
|
|
428
|
948 struct gcpro gcpro1;
|
|
|
949
|
|
|
950 GCPRO1 (args);
|
|
|
951
|
|
|
952 {
|
|
|
953 LIST_LOOP_2 (form, args)
|
|
|
954 val = Feval (form);
|
|
|
955 }
|
|
|
956
|
|
|
957 UNGCPRO;
|
|
|
958 return val;
|
|
|
959 }
|
|
|
960
|
|
|
961 /* Fprog1() is the canonical example of a function that must GCPRO a
|
|
|
962 Lisp_Object across calls to Feval(). */
|
|
|
963
|
|
|
964 DEFUN ("prog1", Fprog1, 1, UNEVALLED, 0, /*
|
|
|
965 Similar to `progn', but the value of the first form is returned.
|
|
|
966 \(prog1 FIRST BODY...): All the arguments are evaluated sequentially.
|
|
|
967 The value of FIRST is saved during evaluation of the remaining args,
|
|
|
968 whose values are discarded.
|
|
|
969 */
|
|
|
970 (args))
|
|
|
971 {
|
|
|
972 /* This function can GC */
|
|
1849
|
973 Lisp_Object val;
|
|
428
|
974 struct gcpro gcpro1;
|
|
|
975
|
|
|
976 val = Feval (XCAR (args));
|
|
|
977
|
|
|
978 GCPRO1 (val);
|
|
|
979
|
|
|
980 {
|
|
|
981 LIST_LOOP_2 (form, XCDR (args))
|
|
|
982 Feval (form);
|
|
|
983 }
|
|
|
984
|
|
|
985 UNGCPRO;
|
|
|
986 return val;
|
|
|
987 }
|
|
|
988
|
|
|
989 DEFUN ("prog2", Fprog2, 2, UNEVALLED, 0, /*
|
|
|
990 Similar to `progn', but the value of the second form is returned.
|
|
|
991 \(prog2 FIRST SECOND BODY...): All the arguments are evaluated sequentially.
|
|
|
992 The value of SECOND is saved during evaluation of the remaining args,
|
|
|
993 whose values are discarded.
|
|
|
994 */
|
|
|
995 (args))
|
|
|
996 {
|
|
|
997 /* This function can GC */
|
|
1849
|
998 Lisp_Object val;
|
|
428
|
999 struct gcpro gcpro1;
|
|
|
1000
|
|
|
1001 Feval (XCAR (args));
|
|
|
1002 args = XCDR (args);
|
|
|
1003 val = Feval (XCAR (args));
|
|
|
1004 args = XCDR (args);
|
|
|
1005
|
|
|
1006 GCPRO1 (val);
|
|
|
1007
|
|
442
|
1008 {
|
|
|
1009 LIST_LOOP_2 (form, args)
|
|
|
1010 Feval (form);
|
|
|
1011 }
|
|
428
|
1012
|
|
|
1013 UNGCPRO;
|
|
|
1014 return val;
|
|
|
1015 }
|
|
|
1016
|
|
|
1017 DEFUN ("let*", FletX, 1, UNEVALLED, 0, /*
|
|
|
1018 \(let* VARLIST BODY...): bind variables according to VARLIST then eval BODY.
|
|
|
1019 The value of the last form in BODY is returned.
|
|
|
1020 Each element of VARLIST is a symbol (which is bound to nil)
|
|
|
1021 or a list (SYMBOL VALUEFORM) (which binds SYMBOL to the value of VALUEFORM).
|
|
|
1022 Each VALUEFORM can refer to the symbols already bound by this VARLIST.
|
|
|
1023 */
|
|
|
1024 (args))
|
|
|
1025 {
|
|
|
1026 /* This function can GC */
|
|
|
1027 Lisp_Object varlist = XCAR (args);
|
|
|
1028 Lisp_Object body = XCDR (args);
|
|
|
1029 int speccount = specpdl_depth();
|
|
|
1030
|
|
|
1031 EXTERNAL_LIST_LOOP_3 (var, varlist, tail)
|
|
|
1032 {
|
|
|
1033 Lisp_Object symbol, value, tem;
|
|
|
1034 if (SYMBOLP (var))
|
|
|
1035 symbol = var, value = Qnil;
|
|
|
1036 else
|
|
|
1037 {
|
|
|
1038 CHECK_CONS (var);
|
|
|
1039 symbol = XCAR (var);
|
|
|
1040 tem = XCDR (var);
|
|
|
1041 if (NILP (tem))
|
|
|
1042 value = Qnil;
|
|
|
1043 else
|
|
|
1044 {
|
|
|
1045 CHECK_CONS (tem);
|
|
|
1046 value = Feval (XCAR (tem));
|
|
|
1047 if (!NILP (XCDR (tem)))
|
|
563
|
1048 sferror
|
|
428
|
1049 ("`let' bindings can have only one value-form", var);
|
|
|
1050 }
|
|
|
1051 }
|
|
|
1052 specbind (symbol, value);
|
|
|
1053 }
|
|
771
|
1054 return unbind_to_1 (speccount, Fprogn (body));
|
|
428
|
1055 }
|
|
|
1056
|
|
|
1057 DEFUN ("let", Flet, 1, UNEVALLED, 0, /*
|
|
|
1058 \(let VARLIST BODY...): bind variables according to VARLIST then eval BODY.
|
|
|
1059 The value of the last form in BODY is returned.
|
|
|
1060 Each element of VARLIST is a symbol (which is bound to nil)
|
|
|
1061 or a list (SYMBOL VALUEFORM) (which binds SYMBOL to the value of VALUEFORM).
|
|
|
1062 All the VALUEFORMs are evalled before any symbols are bound.
|
|
|
1063 */
|
|
|
1064 (args))
|
|
|
1065 {
|
|
|
1066 /* This function can GC */
|
|
|
1067 Lisp_Object varlist = XCAR (args);
|
|
|
1068 Lisp_Object body = XCDR (args);
|
|
|
1069 int speccount = specpdl_depth();
|
|
|
1070 Lisp_Object *temps;
|
|
|
1071 int idx;
|
|
|
1072 struct gcpro gcpro1;
|
|
|
1073
|
|
|
1074 /* Make space to hold the values to give the bound variables. */
|
|
|
1075 {
|
|
|
1076 int varcount;
|
|
|
1077 GET_EXTERNAL_LIST_LENGTH (varlist, varcount);
|
|
|
1078 temps = alloca_array (Lisp_Object, varcount);
|
|
|
1079 }
|
|
|
1080
|
|
|
1081 /* Compute the values and store them in `temps' */
|
|
|
1082 GCPRO1 (*temps);
|
|
|
1083 gcpro1.nvars = 0;
|
|
|
1084
|
|
|
1085 idx = 0;
|
|
442
|
1086 {
|
|
|
1087 LIST_LOOP_2 (var, varlist)
|
|
|
1088 {
|
|
|
1089 Lisp_Object *value = &temps[idx++];
|
|
|
1090 if (SYMBOLP (var))
|
|
|
1091 *value = Qnil;
|
|
|
1092 else
|
|
|
1093 {
|
|
|
1094 Lisp_Object tem;
|
|
|
1095 CHECK_CONS (var);
|
|
|
1096 tem = XCDR (var);
|
|
|
1097 if (NILP (tem))
|
|
|
1098 *value = Qnil;
|
|
|
1099 else
|
|
|
1100 {
|
|
|
1101 CHECK_CONS (tem);
|
|
|
1102 *value = Feval (XCAR (tem));
|
|
|
1103 gcpro1.nvars = idx;
|
|
|
1104
|
|
|
1105 if (!NILP (XCDR (tem)))
|
|
563
|
1106 sferror
|
|
442
|
1107 ("`let' bindings can have only one value-form", var);
|
|
|
1108 }
|
|
|
1109 }
|
|
|
1110 }
|
|
|
1111 }
|
|
428
|
1112
|
|
|
1113 idx = 0;
|
|
442
|
1114 {
|
|
|
1115 LIST_LOOP_2 (var, varlist)
|
|
|
1116 {
|
|
|
1117 specbind (SYMBOLP (var) ? var : XCAR (var), temps[idx++]);
|
|
|
1118 }
|
|
|
1119 }
|
|
428
|
1120
|
|
|
1121 UNGCPRO;
|
|
|
1122
|
|
771
|
1123 return unbind_to_1 (speccount, Fprogn (body));
|
|
428
|
1124 }
|
|
|
1125
|
|
|
1126 DEFUN ("while", Fwhile, 1, UNEVALLED, 0, /*
|
|
|
1127 \(while TEST BODY...): if TEST yields non-nil, eval BODY... and repeat.
|
|
|
1128 The order of execution is thus TEST, BODY, TEST, BODY and so on
|
|
|
1129 until TEST returns nil.
|
|
|
1130 */
|
|
|
1131 (args))
|
|
|
1132 {
|
|
|
1133 /* This function can GC */
|
|
|
1134 Lisp_Object test = XCAR (args);
|
|
|
1135 Lisp_Object body = XCDR (args);
|
|
|
1136
|
|
|
1137 while (!NILP (Feval (test)))
|
|
|
1138 {
|
|
|
1139 QUIT;
|
|
|
1140 Fprogn (body);
|
|
|
1141 }
|
|
|
1142
|
|
|
1143 return Qnil;
|
|
|
1144 }
|
|
|
1145
|
|
|
1146 DEFUN ("setq", Fsetq, 0, UNEVALLED, 0, /*
|
|
|
1147 \(setq SYM VAL SYM VAL ...): set each SYM to the value of its VAL.
|
|
|
1148 The symbols SYM are variables; they are literal (not evaluated).
|
|
|
1149 The values VAL are expressions; they are evaluated.
|
|
|
1150 Thus, (setq x (1+ y)) sets `x' to the value of `(1+ y)'.
|
|
|
1151 The second VAL is not computed until after the first SYM is set, and so on;
|
|
|
1152 each VAL can use the new value of variables set earlier in the `setq'.
|
|
|
1153 The return value of the `setq' form is the value of the last VAL.
|
|
|
1154 */
|
|
|
1155 (args))
|
|
|
1156 {
|
|
|
1157 /* This function can GC */
|
|
|
1158 int nargs;
|
|
2421
|
1159 Lisp_Object retval = Qnil;
|
|
428
|
1160
|
|
|
1161 GET_LIST_LENGTH (args, nargs);
|
|
|
1162
|
|
|
1163 if (nargs & 1) /* Odd number of arguments? */
|
|
|
1164 Fsignal (Qwrong_number_of_arguments, list2 (Qsetq, make_int (nargs)));
|
|
|
1165
|
|
2421
|
1166 GC_PROPERTY_LIST_LOOP_3 (symbol, val, args)
|
|
428
|
1167 {
|
|
|
1168 val = Feval (val);
|
|
|
1169 Fset (symbol, val);
|
|
2421
|
1170 retval = val;
|
|
428
|
1171 }
|
|
|
1172
|
|
2421
|
1173 END_GC_PROPERTY_LIST_LOOP (symbol);
|
|
|
1174
|
|
|
1175 return retval;
|
|
428
|
1176 }
|
|
|
1177
|
|
|
1178 DEFUN ("quote", Fquote, 1, UNEVALLED, 0, /*
|
|
|
1179 Return the argument, without evaluating it. `(quote x)' yields `x'.
|
|
3794
|
1180
|
|
3842
|
1181 `quote' differs from `function' in that it is a hint that an expression is
|
|
|
1182 data, not a function. In particular, under some circumstances the byte
|
|
|
1183 compiler will compile an expression quoted with `function', but it will
|
|
|
1184 never do so for an expression quoted with `quote'. These issues are most
|
|
|
1185 important for lambda expressions (see `lambda').
|
|
|
1186
|
|
|
1187 There is an alternative, more readable, reader syntax for `quote': a Lisp
|
|
|
1188 object preceded by `''. Thus, `'x' is equivalent to `(quote x)', in all
|
|
|
1189 contexts. A print function may use either. Internally the expression is
|
|
|
1190 represented as `(quote x)').
|
|
428
|
1191 */
|
|
|
1192 (args))
|
|
|
1193 {
|
|
|
1194 return XCAR (args);
|
|
|
1195 }
|
|
|
1196
|
|
|
1197 DEFUN ("function", Ffunction, 1, UNEVALLED, 0, /*
|
|
3842
|
1198 Return the argument, without evaluating it. `(function x)' yields `x'.
|
|
|
1199
|
|
|
1200 `function' differs from `quote' in that it is a hint that an expression is
|
|
|
1201 a function, not data. In particular, under some circumstances the byte
|
|
|
1202 compiler will compile an expression quoted with `function', but it will
|
|
|
1203 never do so for an expression quoted with `quote'. However, the byte
|
|
|
1204 compiler will not compile an expression buried in a data structure such as
|
|
|
1205 a vector or a list which is not syntactically a function. These issues are
|
|
|
1206 most important for lambda expressions (see `lambda').
|
|
|
1207
|
|
|
1208 There is an alternative, more readable, reader syntax for `function': a Lisp
|
|
|
1209 object preceded by `#''. Thus, #'x is equivalent to (function x), in all
|
|
|
1210 contexts. A print function may use either. Internally the expression is
|
|
|
1211 represented as `(function x)').
|
|
428
|
1212 */
|
|
|
1213 (args))
|
|
|
1214 {
|
|
|
1215 return XCAR (args);
|
|
|
1216 }
|
|
|
1217
|
|
|
1218
|
|
|
1219 /************************************************************************/
|
|
|
1220 /* Defining functions/variables */
|
|
|
1221 /************************************************************************/
|
|
|
1222 static Lisp_Object
|
|
|
1223 define_function (Lisp_Object name, Lisp_Object defn)
|
|
|
1224 {
|
|
|
1225 Ffset (name, defn);
|
|
|
1226 LOADHIST_ATTACH (name);
|
|
|
1227 return name;
|
|
|
1228 }
|
|
|
1229
|
|
|
1230 DEFUN ("defun", Fdefun, 2, UNEVALLED, 0, /*
|
|
|
1231 \(defun NAME ARGLIST [DOCSTRING] BODY...): define NAME as a function.
|
|
|
1232 The definition is (lambda ARGLIST [DOCSTRING] BODY...).
|
|
|
1233 See also the function `interactive'.
|
|
|
1234 */
|
|
|
1235 (args))
|
|
|
1236 {
|
|
|
1237 /* This function can GC */
|
|
|
1238 return define_function (XCAR (args),
|
|
|
1239 Fcons (Qlambda, XCDR (args)));
|
|
|
1240 }
|
|
|
1241
|
|
|
1242 DEFUN ("defmacro", Fdefmacro, 2, UNEVALLED, 0, /*
|
|
|
1243 \(defmacro NAME ARGLIST [DOCSTRING] BODY...): define NAME as a macro.
|
|
|
1244 The definition is (macro lambda ARGLIST [DOCSTRING] BODY...).
|
|
|
1245 When the macro is called, as in (NAME ARGS...),
|
|
|
1246 the function (lambda ARGLIST BODY...) is applied to
|
|
|
1247 the list ARGS... as it appears in the expression,
|
|
|
1248 and the result should be a form to be evaluated instead of the original.
|
|
|
1249 */
|
|
|
1250 (args))
|
|
|
1251 {
|
|
|
1252 /* This function can GC */
|
|
|
1253 return define_function (XCAR (args),
|
|
|
1254 Fcons (Qmacro, Fcons (Qlambda, XCDR (args))));
|
|
|
1255 }
|
|
|
1256
|
|
|
1257 DEFUN ("defvar", Fdefvar, 1, UNEVALLED, 0, /*
|
|
|
1258 \(defvar SYMBOL INITVALUE DOCSTRING): define SYMBOL as a variable.
|
|
|
1259 You are not required to define a variable in order to use it,
|
|
|
1260 but the definition can supply documentation and an initial value
|
|
|
1261 in a way that tags can recognize.
|
|
|
1262
|
|
|
1263 INITVALUE is evaluated, and used to set SYMBOL, only if SYMBOL's value is
|
|
|
1264 void. (However, when you evaluate a defvar interactively, it acts like a
|
|
|
1265 defconst: SYMBOL's value is always set regardless of whether it's currently
|
|
|
1266 void.)
|
|
|
1267 If SYMBOL is buffer-local, its default value is what is set;
|
|
|
1268 buffer-local values are not affected.
|
|
|
1269 INITVALUE and DOCSTRING are optional.
|
|
|
1270 If DOCSTRING starts with *, this variable is identified as a user option.
|
|
442
|
1271 This means that M-x set-variable recognizes it.
|
|
428
|
1272 If INITVALUE is missing, SYMBOL's value is not set.
|
|
|
1273
|
|
|
1274 In lisp-interaction-mode defvar is treated as defconst.
|
|
|
1275 */
|
|
|
1276 (args))
|
|
|
1277 {
|
|
|
1278 /* This function can GC */
|
|
|
1279 Lisp_Object sym = XCAR (args);
|
|
|
1280
|
|
|
1281 if (!NILP (args = XCDR (args)))
|
|
|
1282 {
|
|
|
1283 Lisp_Object val = XCAR (args);
|
|
|
1284
|
|
|
1285 if (NILP (Fdefault_boundp (sym)))
|
|
|
1286 {
|
|
|
1287 struct gcpro gcpro1;
|
|
|
1288 GCPRO1 (val);
|
|
|
1289 val = Feval (val);
|
|
|
1290 Fset_default (sym, val);
|
|
|
1291 UNGCPRO;
|
|
|
1292 }
|
|
|
1293
|
|
|
1294 if (!NILP (args = XCDR (args)))
|
|
|
1295 {
|
|
|
1296 Lisp_Object doc = XCAR (args);
|
|
|
1297 Fput (sym, Qvariable_documentation, doc);
|
|
|
1298 if (!NILP (args = XCDR (args)))
|
|
563
|
1299 signal_error (Qwrong_number_of_arguments, "too many arguments", Qunbound);
|
|
428
|
1300 }
|
|
|
1301 }
|
|
|
1302
|
|
|
1303 #ifdef I18N3
|
|
|
1304 if (!NILP (Vfile_domain))
|
|
|
1305 Fput (sym, Qvariable_domain, Vfile_domain);
|
|
|
1306 #endif
|
|
|
1307
|
|
|
1308 LOADHIST_ATTACH (sym);
|
|
|
1309 return sym;
|
|
|
1310 }
|
|
|
1311
|
|
|
1312 DEFUN ("defconst", Fdefconst, 2, UNEVALLED, 0, /*
|
|
|
1313 \(defconst SYMBOL INITVALUE DOCSTRING): define SYMBOL as a constant
|
|
|
1314 variable.
|
|
|
1315 The intent is that programs do not change this value, but users may.
|
|
|
1316 Always sets the value of SYMBOL to the result of evalling INITVALUE.
|
|
|
1317 If SYMBOL is buffer-local, its default value is what is set;
|
|
|
1318 buffer-local values are not affected.
|
|
|
1319 DOCSTRING is optional.
|
|
|
1320 If DOCSTRING starts with *, this variable is identified as a user option.
|
|
442
|
1321 This means that M-x set-variable recognizes it.
|
|
428
|
1322
|
|
|
1323 Note: do not use `defconst' for user options in libraries that are not
|
|
|
1324 normally loaded, since it is useful for users to be able to specify
|
|
|
1325 their own values for such variables before loading the library.
|
|
|
1326 Since `defconst' unconditionally assigns the variable,
|
|
|
1327 it would override the user's choice.
|
|
|
1328 */
|
|
|
1329 (args))
|
|
|
1330 {
|
|
|
1331 /* This function can GC */
|
|
|
1332 Lisp_Object sym = XCAR (args);
|
|
|
1333 Lisp_Object val = Feval (XCAR (args = XCDR (args)));
|
|
|
1334 struct gcpro gcpro1;
|
|
|
1335
|
|
|
1336 GCPRO1 (val);
|
|
|
1337
|
|
|
1338 Fset_default (sym, val);
|
|
|
1339
|
|
|
1340 UNGCPRO;
|
|
|
1341
|
|
|
1342 if (!NILP (args = XCDR (args)))
|
|
|
1343 {
|
|
|
1344 Lisp_Object doc = XCAR (args);
|
|
|
1345 Fput (sym, Qvariable_documentation, doc);
|
|
|
1346 if (!NILP (args = XCDR (args)))
|
|
563
|
1347 signal_error (Qwrong_number_of_arguments, "too many arguments", Qunbound);
|
|
428
|
1348 }
|
|
|
1349
|
|
|
1350 #ifdef I18N3
|
|
|
1351 if (!NILP (Vfile_domain))
|
|
|
1352 Fput (sym, Qvariable_domain, Vfile_domain);
|
|
|
1353 #endif
|
|
|
1354
|
|
|
1355 LOADHIST_ATTACH (sym);
|
|
|
1356 return sym;
|
|
|
1357 }
|
|
|
1358
|
|
|
1359 DEFUN ("user-variable-p", Fuser_variable_p, 1, 1, 0, /*
|
|
|
1360 Return t if VARIABLE is intended to be set and modified by users.
|
|
|
1361 \(The alternative is a variable used internally in a Lisp program.)
|
|
|
1362 Determined by whether the first character of the documentation
|
|
|
1363 for the variable is `*'.
|
|
|
1364 */
|
|
|
1365 (variable))
|
|
|
1366 {
|
|
|
1367 Lisp_Object documentation = Fget (variable, Qvariable_documentation, Qnil);
|
|
|
1368
|
|
|
1369 return
|
|
|
1370 ((INTP (documentation) && XINT (documentation) < 0) ||
|
|
|
1371
|
|
|
1372 (STRINGP (documentation) &&
|
|
826
|
1373 (string_byte (documentation, 0) == '*')) ||
|
|
428
|
1374
|
|
|
1375 /* If (STRING . INTEGER), a negative integer means a user variable. */
|
|
|
1376 (CONSP (documentation)
|
|
|
1377 && STRINGP (XCAR (documentation))
|
|
|
1378 && INTP (XCDR (documentation))
|
|
|
1379 && XINT (XCDR (documentation)) < 0)) ?
|
|
|
1380 Qt : Qnil;
|
|
|
1381 }
|
|
|
1382
|
|
|
1383 DEFUN ("macroexpand-internal", Fmacroexpand_internal, 1, 2, 0, /*
|
|
|
1384 Return result of expanding macros at top level of FORM.
|
|
|
1385 If FORM is not a macro call, it is returned unchanged.
|
|
|
1386 Otherwise, the macro is expanded and the expansion is considered
|
|
|
1387 in place of FORM. When a non-macro-call results, it is returned.
|
|
|
1388
|
|
442
|
1389 The second optional arg ENVIRONMENT specifies an environment of macro
|
|
428
|
1390 definitions to shadow the loaded ones for use in file byte-compilation.
|
|
|
1391 */
|
|
442
|
1392 (form, environment))
|
|
428
|
1393 {
|
|
|
1394 /* This function can GC */
|
|
|
1395 /* With cleanups from Hallvard Furuseth. */
|
|
|
1396 REGISTER Lisp_Object expander, sym, def, tem;
|
|
|
1397
|
|
|
1398 while (1)
|
|
|
1399 {
|
|
|
1400 /* Come back here each time we expand a macro call,
|
|
|
1401 in case it expands into another macro call. */
|
|
|
1402 if (!CONSP (form))
|
|
|
1403 break;
|
|
|
1404 /* Set SYM, give DEF and TEM right values in case SYM is not a symbol. */
|
|
|
1405 def = sym = XCAR (form);
|
|
|
1406 tem = Qnil;
|
|
|
1407 /* Trace symbols aliases to other symbols
|
|
|
1408 until we get a symbol that is not an alias. */
|
|
|
1409 while (SYMBOLP (def))
|
|
|
1410 {
|
|
|
1411 QUIT;
|
|
|
1412 sym = def;
|
|
442
|
1413 tem = Fassq (sym, environment);
|
|
428
|
1414 if (NILP (tem))
|
|
|
1415 {
|
|
|
1416 def = XSYMBOL (sym)->function;
|
|
|
1417 if (!UNBOUNDP (def))
|
|
|
1418 continue;
|
|
|
1419 }
|
|
|
1420 break;
|
|
|
1421 }
|
|
442
|
1422 /* Right now TEM is the result from SYM in ENVIRONMENT,
|
|
428
|
1423 and if TEM is nil then DEF is SYM's function definition. */
|
|
|
1424 if (NILP (tem))
|
|
|
1425 {
|
|
442
|
1426 /* SYM is not mentioned in ENVIRONMENT.
|
|
428
|
1427 Look at its function definition. */
|
|
|
1428 if (UNBOUNDP (def)
|
|
|
1429 || !CONSP (def))
|
|
|
1430 /* Not defined or definition not suitable */
|
|
|
1431 break;
|
|
|
1432 if (EQ (XCAR (def), Qautoload))
|
|
|
1433 {
|
|
|
1434 /* Autoloading function: will it be a macro when loaded? */
|
|
|
1435 tem = Felt (def, make_int (4));
|
|
|
1436 if (EQ (tem, Qt) || EQ (tem, Qmacro))
|
|
|
1437 {
|
|
|
1438 /* Yes, load it and try again. */
|
|
970
|
1439 /* do_autoload GCPROs both arguments */
|
|
428
|
1440 do_autoload (def, sym);
|
|
|
1441 continue;
|
|
|
1442 }
|
|
|
1443 else
|
|
|
1444 break;
|
|
|
1445 }
|
|
|
1446 else if (!EQ (XCAR (def), Qmacro))
|
|
|
1447 break;
|
|
|
1448 else expander = XCDR (def);
|
|
|
1449 }
|
|
|
1450 else
|
|
|
1451 {
|
|
|
1452 expander = XCDR (tem);
|
|
|
1453 if (NILP (expander))
|
|
|
1454 break;
|
|
|
1455 }
|
|
|
1456 form = apply1 (expander, XCDR (form));
|
|
|
1457 }
|
|
|
1458 return form;
|
|
|
1459 }
|
|
|
1460
|
|
|
1461
|
|
|
1462 /************************************************************************/
|
|
|
1463 /* Non-local exits */
|
|
|
1464 /************************************************************************/
|
|
|
1465
|
|
1318
|
1466 #ifdef ERROR_CHECK_TRAPPING_PROBLEMS
|
|
|
1467
|
|
|
1468 int
|
|
|
1469 proper_redisplay_wrapping_in_place (void)
|
|
|
1470 {
|
|
|
1471 return !in_display
|
|
|
1472 || ((get_inhibit_flags () & INTERNAL_INHIBIT_ERRORS)
|
|
|
1473 && (get_inhibit_flags () & INTERNAL_INHIBIT_THROWS));
|
|
|
1474 }
|
|
|
1475
|
|
|
1476 static void
|
|
|
1477 check_proper_critical_section_nonlocal_exit_protection (void)
|
|
|
1478 {
|
|
|
1479 assert_with_message
|
|
|
1480 (proper_redisplay_wrapping_in_place (),
|
|
|
1481 "Attempted non-local exit from within redisplay without being properly wrapped");
|
|
|
1482 }
|
|
|
1483
|
|
|
1484 static void
|
|
|
1485 check_proper_critical_section_lisp_protection (void)
|
|
|
1486 {
|
|
|
1487 assert_with_message
|
|
|
1488 (proper_redisplay_wrapping_in_place (),
|
|
|
1489 "Attempt to call Lisp code from within redisplay without being properly wrapped");
|
|
|
1490 }
|
|
|
1491
|
|
|
1492 #endif /* ERROR_CHECK_TRAPPING_PROBLEMS */
|
|
|
1493
|
|
428
|
1494 DEFUN ("catch", Fcatch, 1, UNEVALLED, 0, /*
|
|
|
1495 \(catch TAG BODY...): eval BODY allowing nonlocal exits using `throw'.
|
|
|
1496 TAG is evalled to get the tag to use. Then the BODY is executed.
|
|
3577
|
1497 Within BODY, (throw TAG VAL) with same (`eq') tag exits BODY and this `catch'.
|
|
428
|
1498 If no throw happens, `catch' returns the value of the last BODY form.
|
|
|
1499 If a throw happens, it specifies the value to return from `catch'.
|
|
|
1500 */
|
|
|
1501 (args))
|
|
|
1502 {
|
|
|
1503 /* This function can GC */
|
|
|
1504 Lisp_Object tag = Feval (XCAR (args));
|
|
|
1505 Lisp_Object body = XCDR (args);
|
|
2532
|
1506 return internal_catch (tag, Fprogn, body, 0, 0, 0);
|
|
428
|
1507 }
|
|
|
1508
|
|
|
1509 /* Set up a catch, then call C function FUNC on argument ARG.
|
|
|
1510 FUNC should return a Lisp_Object.
|
|
|
1511 This is how catches are done from within C code. */
|
|
|
1512
|
|
|
1513 Lisp_Object
|
|
|
1514 internal_catch (Lisp_Object tag,
|
|
|
1515 Lisp_Object (*func) (Lisp_Object arg),
|
|
|
1516 Lisp_Object arg,
|
|
853
|
1517 int * volatile threw,
|
|
2532
|
1518 Lisp_Object * volatile thrown_tag,
|
|
|
1519 Lisp_Object * volatile backtrace_before_throw)
|
|
428
|
1520 {
|
|
|
1521 /* This structure is made part of the chain `catchlist'. */
|
|
|
1522 struct catchtag c;
|
|
|
1523
|
|
|
1524 /* Fill in the components of c, and put it on the list. */
|
|
|
1525 c.next = catchlist;
|
|
|
1526 c.tag = tag;
|
|
853
|
1527 c.actual_tag = Qnil;
|
|
2532
|
1528 c.backtrace = Qnil;
|
|
428
|
1529 c.val = Qnil;
|
|
|
1530 c.backlist = backtrace_list;
|
|
|
1531 #if 0 /* FSFmacs */
|
|
|
1532 /* #### */
|
|
|
1533 c.handlerlist = handlerlist;
|
|
|
1534 #endif
|
|
|
1535 c.lisp_eval_depth = lisp_eval_depth;
|
|
|
1536 c.pdlcount = specpdl_depth();
|
|
|
1537 #if 0 /* FSFmacs */
|
|
|
1538 c.poll_suppress_count = async_timer_suppress_count;
|
|
|
1539 #endif
|
|
|
1540 c.gcpro = gcprolist;
|
|
|
1541 catchlist = &c;
|
|
|
1542
|
|
|
1543 /* Call FUNC. */
|
|
|
1544 if (SETJMP (c.jmp))
|
|
|
1545 {
|
|
|
1546 /* Throw works by a longjmp that comes right here. */
|
|
|
1547 if (threw) *threw = 1;
|
|
853
|
1548 if (thrown_tag) *thrown_tag = c.actual_tag;
|
|
2532
|
1549 if (backtrace_before_throw) *backtrace_before_throw = c.backtrace;
|
|
428
|
1550 return c.val;
|
|
|
1551 }
|
|
|
1552 c.val = (*func) (arg);
|
|
|
1553 if (threw) *threw = 0;
|
|
853
|
1554 if (thrown_tag) *thrown_tag = Qnil;
|
|
428
|
1555 catchlist = c.next;
|
|
853
|
1556 check_catchlist_sanity ();
|
|
428
|
1557 return c.val;
|
|
|
1558 }
|
|
|
1559
|
|
|
1560
|
|
|
1561 /* Unwind the specbind, catch, and handler stacks back to CATCH, and
|
|
|
1562 jump to that CATCH, returning VALUE as the value of that catch.
|
|
|
1563
|
|
2297
|
1564 This is the guts of Fthrow and Fsignal; they differ only in the
|
|
|
1565 way they choose the catch tag to throw to. A catch tag for a
|
|
428
|
1566 condition-case form has a TAG of Qnil.
|
|
|
1567
|
|
|
1568 Before each catch is discarded, unbind all special bindings and
|
|
|
1569 execute all unwind-protect clauses made above that catch. Unwind
|
|
|
1570 the handler stack as we go, so that the proper handlers are in
|
|
|
1571 effect for each unwind-protect clause we run. At the end, restore
|
|
|
1572 some static info saved in CATCH, and longjmp to the location
|
|
|
1573 specified in the
|
|
|
1574
|
|
|
1575 This is used for correct unwinding in Fthrow and Fsignal. */
|
|
|
1576
|
|
2268
|
1577 static DECLARE_DOESNT_RETURN (unwind_to_catch (struct catchtag *, Lisp_Object,
|
|
|
1578 Lisp_Object));
|
|
|
1579
|
|
|
1580 static DOESNT_RETURN
|
|
853
|
1581 unwind_to_catch (struct catchtag *c, Lisp_Object val, Lisp_Object tag)
|
|
428
|
1582 {
|
|
|
1583 REGISTER int last_time;
|
|
|
1584
|
|
|
1585 /* Unwind the specbind, catch, and handler stacks back to CATCH
|
|
|
1586 Before each catch is discarded, unbind all special bindings
|
|
|
1587 and execute all unwind-protect clauses made above that catch.
|
|
|
1588 At the end, restore some static info saved in CATCH,
|
|
|
1589 and longjmp to the location specified.
|
|
|
1590 */
|
|
|
1591
|
|
|
1592 /* Save the value somewhere it will be GC'ed.
|
|
|
1593 (Can't overwrite tag slot because an unwind-protect may
|
|
|
1594 want to throw to this same tag, which isn't yet invalid.) */
|
|
|
1595 c->val = val;
|
|
853
|
1596 c->actual_tag = tag;
|
|
428
|
1597
|
|
|
1598 #if 0 /* FSFmacs */
|
|
|
1599 /* Restore the polling-suppression count. */
|
|
|
1600 set_poll_suppress_count (catch->poll_suppress_count);
|
|
|
1601 #endif
|
|
|
1602
|
|
617
|
1603 #if 1
|
|
428
|
1604 do
|
|
|
1605 {
|
|
|
1606 last_time = catchlist == c;
|
|
|
1607
|
|
|
1608 /* Unwind the specpdl stack, and then restore the proper set of
|
|
|
1609 handlers. */
|
|
771
|
1610 unbind_to (catchlist->pdlcount);
|
|
428
|
1611 catchlist = catchlist->next;
|
|
853
|
1612 check_catchlist_sanity ();
|
|
428
|
1613 }
|
|
|
1614 while (! last_time);
|
|
617
|
1615 #else
|
|
|
1616 /* Former XEmacs code. This is definitely not as correct because
|
|
|
1617 there may be a number of catches we're unwinding, and a number
|
|
|
1618 of unwind-protects in the process. By not undoing the catches till
|
|
|
1619 the end, there may be invalid catches still current. (This would
|
|
|
1620 be a particular problem with code like this:
|
|
|
1621
|
|
|
1622 (catch 'foo
|
|
|
1623 (call-some-code-which-does...
|
|
|
1624 (catch 'bar
|
|
|
1625 (unwind-protect
|
|
|
1626 (call-some-code-which-does...
|
|
|
1627 (catch 'bar
|
|
|
1628 (call-some-code-which-does...
|
|
|
1629 (throw 'foo nil))))
|
|
|
1630 (throw 'bar nil)))))
|
|
|
1631
|
|
|
1632 This would try to throw to the inner (catch 'bar)!
|
|
|
1633
|
|
|
1634 --ben
|
|
|
1635 */
|
|
428
|
1636 /* Unwind the specpdl stack */
|
|
771
|
1637 unbind_to (c->pdlcount);
|
|
428
|
1638 catchlist = c->next;
|
|
853
|
1639 check_catchlist_sanity ();
|
|
617
|
1640 #endif /* Former code */
|
|
428
|
1641
|
|
1204
|
1642 UNWIND_GCPRO_TO (c->gcpro);
|
|
1292
|
1643 if (profiling_active)
|
|
|
1644 {
|
|
|
1645 while (backtrace_list != c->backlist)
|
|
|
1646 {
|
|
|
1647 profile_record_unwind (backtrace_list);
|
|
|
1648 backtrace_list = backtrace_list->next;
|
|
|
1649 }
|
|
|
1650 }
|
|
|
1651 else
|
|
|
1652 backtrace_list = c->backlist;
|
|
428
|
1653 lisp_eval_depth = c->lisp_eval_depth;
|
|
|
1654
|
|
442
|
1655 #ifdef DEFEND_AGAINST_THROW_RECURSION
|
|
428
|
1656 throw_level = 0;
|
|
|
1657 #endif
|
|
|
1658 LONGJMP (c->jmp, 1);
|
|
|
1659 }
|
|
|
1660
|
|
2268
|
1661 static DECLARE_DOESNT_RETURN (throw_or_bomb_out (Lisp_Object, Lisp_Object, int,
|
|
|
1662 Lisp_Object, Lisp_Object));
|
|
|
1663
|
|
428
|
1664 static DOESNT_RETURN
|
|
|
1665 throw_or_bomb_out (Lisp_Object tag, Lisp_Object val, int bomb_out_p,
|
|
|
1666 Lisp_Object sig, Lisp_Object data)
|
|
|
1667 {
|
|
442
|
1668 #ifdef DEFEND_AGAINST_THROW_RECURSION
|
|
428
|
1669 /* die if we recurse more than is reasonable */
|
|
|
1670 if (++throw_level > 20)
|
|
2500
|
1671 ABORT ();
|
|
428
|
1672 #endif
|
|
|
1673
|
|
1318
|
1674 #ifdef ERROR_CHECK_TRAPPING_PROBLEMS
|
|
1123
|
1675 check_proper_critical_section_nonlocal_exit_protection ();
|
|
1318
|
1676 #endif
|
|
1123
|
1677
|
|
428
|
1678 /* If bomb_out_p is t, this is being called from Fsignal as a
|
|
|
1679 "last resort" when there is no handler for this error and
|
|
|
1680 the debugger couldn't be invoked, so we are throwing to
|
|
3025
|
1681 `top-level'. If this tag doesn't exist (happens during the
|
|
428
|
1682 initialization stages) we would get in an infinite recursive
|
|
|
1683 Fsignal/Fthrow loop, so instead we bomb out to the
|
|
|
1684 really-early-error-handler.
|
|
|
1685
|
|
|
1686 Note that in fact the only time that the "last resort"
|
|
3025
|
1687 occurs is when there's no catch for `top-level' -- the
|
|
|
1688 `top-level' catch and the catch-all error handler are
|
|
428
|
1689 established at the same time, in initial_command_loop/
|
|
|
1690 top_level_1.
|
|
|
1691
|
|
853
|
1692 [[#### Fix this horrifitude!]]
|
|
|
1693
|
|
|
1694 I don't think this is horrifitude, just defensive programming. --ben
|
|
428
|
1695 */
|
|
|
1696
|
|
|
1697 while (1)
|
|
|
1698 {
|
|
|
1699 REGISTER struct catchtag *c;
|
|
|
1700
|
|
|
1701 #if 0 /* FSFmacs */
|
|
|
1702 if (!NILP (tag)) /* #### */
|
|
|
1703 #endif
|
|
|
1704 for (c = catchlist; c; c = c->next)
|
|
|
1705 {
|
|
2532
|
1706 if (EQ (c->tag, Vcatch_everything_tag))
|
|
|
1707 c->backtrace = maybe_get_trapping_problems_backtrace ();
|
|
853
|
1708 if (EQ (c->tag, tag) || EQ (c->tag, Vcatch_everything_tag))
|
|
|
1709 unwind_to_catch (c, val, tag);
|
|
428
|
1710 }
|
|
|
1711 if (!bomb_out_p)
|
|
|
1712 tag = Fsignal (Qno_catch, list2 (tag, val));
|
|
|
1713 else
|
|
|
1714 call1 (Qreally_early_error_handler, Fcons (sig, data));
|
|
|
1715 }
|
|
|
1716 }
|
|
|
1717
|
|
|
1718 /* See above, where CATCHLIST is defined, for a description of how
|
|
|
1719 Fthrow() works.
|
|
|
1720
|
|
|
1721 Fthrow() is also called by Fsignal(), to do a non-local jump
|
|
|
1722 back to the appropriate condition-case handler after (maybe)
|
|
|
1723 the debugger is entered. In that case, TAG is the value
|
|
|
1724 of Vcondition_handlers that was in place just after the
|
|
|
1725 condition-case handler was set up. The car of this will be
|
|
|
1726 some data referring to the handler: Its car will be Qunbound
|
|
|
1727 (thus, this tag can never be generated by Lisp code), and
|
|
|
1728 its CDR will be the HANDLERS argument to condition_case_1()
|
|
|
1729 (either Qerror, Qt, or a list of handlers as in `condition-case').
|
|
|
1730 This works fine because Fthrow() does not care what TAG was
|
|
|
1731 passed to it: it just looks up the catch list for something
|
|
|
1732 that is EQ() to TAG. When it finds it, it will longjmp()
|
|
|
1733 back to the place that established the catch (in this case,
|
|
|
1734 condition_case_1). See below for more info.
|
|
|
1735 */
|
|
|
1736
|
|
2268
|
1737 DEFUN_NORETURN ("throw", Fthrow, 2, 2, 0, /*
|
|
444
|
1738 Throw to the catch for TAG and return VALUE from it.
|
|
2297
|
1739 Both TAG and VALUE are evalled. Tags are the same iff they are `eq'.
|
|
428
|
1740 */
|
|
444
|
1741 (tag, value))
|
|
|
1742 {
|
|
|
1743 throw_or_bomb_out (tag, value, 0, Qnil, Qnil); /* Doesn't return */
|
|
2268
|
1744 RETURN_NOT_REACHED (Qnil);
|
|
428
|
1745 }
|
|
|
1746
|
|
|
1747 DEFUN ("unwind-protect", Funwind_protect, 1, UNEVALLED, 0, /*
|
|
|
1748 Do BODYFORM, protecting with UNWINDFORMS.
|
|
|
1749 Usage looks like (unwind-protect BODYFORM UNWINDFORMS...).
|
|
|
1750 If BODYFORM completes normally, its value is returned
|
|
|
1751 after executing the UNWINDFORMS.
|
|
|
1752 If BODYFORM exits nonlocally, the UNWINDFORMS are executed anyway.
|
|
|
1753 */
|
|
|
1754 (args))
|
|
|
1755 {
|
|
|
1756 /* This function can GC */
|
|
|
1757 int speccount = specpdl_depth();
|
|
|
1758
|
|
|
1759 record_unwind_protect (Fprogn, XCDR (args));
|
|
771
|
1760 return unbind_to_1 (speccount, Feval (XCAR (args)));
|
|
428
|
1761 }
|
|
|
1762
|
|
|
1763
|
|
|
1764 /************************************************************************/
|
|
1292
|
1765 /* Trapping errors */
|
|
428
|
1766 /************************************************************************/
|
|
|
1767
|
|
|
1768 static Lisp_Object
|
|
|
1769 condition_bind_unwind (Lisp_Object loser)
|
|
|
1770 {
|
|
617
|
1771 /* There is no problem freeing stuff here like there is in
|
|
|
1772 condition_case_unwind(), because there are no outside pointers
|
|
|
1773 (like the tag below in the catchlist) pointing to the objects. */
|
|
853
|
1774
|
|
428
|
1775 /* ((handler-fun . handler-args) ... other handlers) */
|
|
|
1776 Lisp_Object tem = XCAR (loser);
|
|
853
|
1777 int first = 1;
|
|
428
|
1778
|
|
|
1779 while (CONSP (tem))
|
|
|
1780 {
|
|
853
|
1781 Lisp_Object victim = tem;
|
|
|
1782 if (first && OPAQUE_PTRP (XCAR (victim)))
|
|
|
1783 free_opaque_ptr (XCAR (victim));
|
|
|
1784 first = 0;
|
|
|
1785 tem = XCDR (victim);
|
|
428
|
1786 free_cons (victim);
|
|
|
1787 }
|
|
|
1788
|
|
|
1789 if (EQ (loser, Vcondition_handlers)) /* may have been rebound to some tail */
|
|
853
|
1790 Vcondition_handlers = XCDR (loser);
|
|
|
1791
|
|
|
1792 free_cons (loser);
|
|
428
|
1793 return Qnil;
|
|
|
1794 }
|
|
|
1795
|
|
|
1796 static Lisp_Object
|
|
|
1797 condition_case_unwind (Lisp_Object loser)
|
|
|
1798 {
|
|
|
1799 /* ((<unbound> . clauses) ... other handlers */
|
|
617
|
1800 /* NO! Doing this now leaves the tag deleted in a still-active
|
|
|
1801 catch. With the recent changes to unwind_to_catch(), the
|
|
|
1802 evil situation might not happen any more; it certainly could
|
|
|
1803 happen before because it did. But it's very precarious to rely
|
|
|
1804 on something like this. #### Instead we should rewrite, adopting
|
|
|
1805 the FSF's mechanism with a struct handler instead of
|
|
|
1806 Vcondition_handlers; then we have NO Lisp-object structures used
|
|
|
1807 to hold all of the values, and there's no possibility either of
|
|
|
1808 crashes from freeing objects too quickly, or objects not getting
|
|
|
1809 freed and hanging around till the next GC.
|
|
|
1810
|
|
|
1811 In practice, the extra consing here should not matter because
|
|
|
1812 it only happens when we throw past the condition-case, which almost
|
|
|
1813 always is the result of an error. Most of the time, there will be
|
|
|
1814 no error, and we will free the objects below in the main function.
|
|
|
1815
|
|
|
1816 --ben
|
|
|
1817
|
|
|
1818 DO NOT DO: free_cons (XCAR (loser));
|
|
|
1819 */
|
|
|
1820
|
|
428
|
1821 if (EQ (loser, Vcondition_handlers)) /* may have been rebound to some tail */
|
|
617
|
1822 Vcondition_handlers = XCDR (loser);
|
|
|
1823
|
|
|
1824 /* DO NOT DO: free_cons (loser); */
|
|
428
|
1825 return Qnil;
|
|
|
1826 }
|
|
|
1827
|
|
|
1828 /* Split out from condition_case_3 so that primitive C callers
|
|
|
1829 don't have to cons up a lisp handler form to be evaluated. */
|
|
|
1830
|
|
|
1831 /* Call a function BFUN of one argument BARG, trapping errors as
|
|
|
1832 specified by HANDLERS. If no error occurs that is indicated by
|
|
|
1833 HANDLERS as something to be caught, the return value of this
|
|
|
1834 function is the return value from BFUN. If such an error does
|
|
|
1835 occur, HFUN is called, and its return value becomes the
|
|
|
1836 return value of condition_case_1(). The second argument passed
|
|
|
1837 to HFUN will always be HARG. The first argument depends on
|
|
|
1838 HANDLERS:
|
|
|
1839
|
|
|
1840 If HANDLERS is Qt, all errors (this includes QUIT, but not
|
|
|
1841 non-local exits with `throw') cause HFUN to be invoked, and VAL
|
|
|
1842 (the first argument to HFUN) is a cons (SIG . DATA) of the
|
|
|
1843 arguments passed to `signal'. The debugger is not invoked even if
|
|
|
1844 `debug-on-error' was set.
|
|
|
1845
|
|
|
1846 A HANDLERS value of Qerror is the same as Qt except that the
|
|
|
1847 debugger is invoked if `debug-on-error' was set.
|
|
|
1848
|
|
|
1849 Otherwise, HANDLERS should be a list of lists (CONDITION-NAME BODY ...)
|
|
|
1850 exactly as in `condition-case', and errors will be trapped
|
|
|
1851 as indicated in HANDLERS. VAL (the first argument to HFUN) will
|
|
|
1852 be a cons whose car is the cons (SIG . DATA) and whose CDR is the
|
|
|
1853 list (BODY ...) from the appropriate slot in HANDLERS.
|
|
|
1854
|
|
|
1855 This function pushes HANDLERS onto the front of Vcondition_handlers
|
|
|
1856 (actually with a Qunbound marker as well -- see Fthrow() above
|
|
|
1857 for why), establishes a catch whose tag is this new value of
|
|
|
1858 Vcondition_handlers, and calls BFUN. When Fsignal() is called,
|
|
|
1859 it calls Fthrow(), setting TAG to this same new value of
|
|
|
1860 Vcondition_handlers and setting VAL to the same thing that will
|
|
|
1861 be passed to HFUN, as above. Fthrow() longjmp()s back to the
|
|
|
1862 jump point we just established, and we in turn just call the
|
|
|
1863 HFUN and return its value.
|
|
|
1864
|
|
|
1865 For a real condition-case, HFUN will always be
|
|
|
1866 run_condition_case_handlers() and HARG is the argument VAR
|
|
|
1867 to condition-case. That function just binds VAR to the cons
|
|
|
1868 (SIG . DATA) that is the CAR of VAL, and calls the handler
|
|
|
1869 (BODY ...) that is the CDR of VAL. Note that before calling
|
|
|
1870 Fthrow(), Fsignal() restored Vcondition_handlers to the value
|
|
|
1871 it had *before* condition_case_1() was called. This maintains
|
|
|
1872 consistency (so that the state of things at exit of
|
|
|
1873 condition_case_1() is the same as at entry), and implies
|
|
|
1874 that the handler can signal the same error again (possibly
|
|
|
1875 after processing of its own), without getting in an infinite
|
|
|
1876 loop. */
|
|
|
1877
|
|
|
1878 Lisp_Object
|
|
|
1879 condition_case_1 (Lisp_Object handlers,
|
|
|
1880 Lisp_Object (*bfun) (Lisp_Object barg),
|
|
|
1881 Lisp_Object barg,
|
|
|
1882 Lisp_Object (*hfun) (Lisp_Object val, Lisp_Object harg),
|
|
|
1883 Lisp_Object harg)
|
|
|
1884 {
|
|
|
1885 int speccount = specpdl_depth();
|
|
|
1886 struct catchtag c;
|
|
617
|
1887 struct gcpro gcpro1, gcpro2, gcpro3;
|
|
428
|
1888
|
|
|
1889 #if 0 /* FSFmacs */
|
|
|
1890 c.tag = Qnil;
|
|
|
1891 #else
|
|
|
1892 /* Do consing now so out-of-memory error happens up front */
|
|
|
1893 /* (unbound . stuff) is a special condition-case kludge marker
|
|
|
1894 which is known specially by Fsignal.
|
|
617
|
1895 [[ This is an abomination, but to fix it would require either
|
|
428
|
1896 making condition_case cons (a union of the conditions of the clauses)
|
|
617
|
1897 or changing the byte-compiler output (no thanks).]]
|
|
|
1898
|
|
|
1899 The above comment is clearly wrong. FSF does not do it this way
|
|
|
1900 and did not change the byte-compiler output. Instead they use a
|
|
|
1901 `struct handler' to hold the various values (in place of our
|
|
|
1902 Vcondition_handlers) and chain them together, with pointers from
|
|
|
1903 the `struct catchtag' to the `struct handler'. We should perhaps
|
|
|
1904 consider moving to something similar, but not before I merge my
|
|
|
1905 stderr-proc workspace, which contains changes to these
|
|
|
1906 functions. --ben */
|
|
428
|
1907 c.tag = noseeum_cons (noseeum_cons (Qunbound, handlers),
|
|
|
1908 Vcondition_handlers);
|
|
|
1909 #endif
|
|
|
1910 c.val = Qnil;
|
|
853
|
1911 c.actual_tag = Qnil;
|
|
2532
|
1912 c.backtrace = Qnil;
|
|
428
|
1913 c.backlist = backtrace_list;
|
|
|
1914 #if 0 /* FSFmacs */
|
|
|
1915 /* #### */
|
|
|
1916 c.handlerlist = handlerlist;
|
|
|
1917 #endif
|
|
|
1918 c.lisp_eval_depth = lisp_eval_depth;
|
|
|
1919 c.pdlcount = specpdl_depth();
|
|
|
1920 #if 0 /* FSFmacs */
|
|
|
1921 c.poll_suppress_count = async_timer_suppress_count;
|
|
|
1922 #endif
|
|
|
1923 c.gcpro = gcprolist;
|
|
|
1924 /* #### FSFmacs does the following statement *after* the setjmp(). */
|
|
|
1925 c.next = catchlist;
|
|
|
1926
|
|
|
1927 if (SETJMP (c.jmp))
|
|
|
1928 {
|
|
|
1929 /* throw does ungcpro, etc */
|
|
|
1930 return (*hfun) (c.val, harg);
|
|
|
1931 }
|
|
|
1932
|
|
|
1933 record_unwind_protect (condition_case_unwind, c.tag);
|
|
|
1934
|
|
|
1935 catchlist = &c;
|
|
|
1936 #if 0 /* FSFmacs */
|
|
|
1937 h.handler = handlers;
|
|
|
1938 h.var = Qnil;
|
|
|
1939 h.next = handlerlist;
|
|
|
1940 h.tag = &c;
|
|
|
1941 handlerlist = &h;
|
|
|
1942 #else
|
|
|
1943 Vcondition_handlers = c.tag;
|
|
|
1944 #endif
|
|
|
1945 GCPRO1 (harg); /* Somebody has to gc-protect */
|
|
|
1946 c.val = ((*bfun) (barg));
|
|
|
1947 UNGCPRO;
|
|
617
|
1948
|
|
|
1949 /* Once we change `catchlist' below, the stuff in c will not be GCPRO'd. */
|
|
|
1950 GCPRO3 (harg, c.val, c.tag);
|
|
|
1951
|
|
428
|
1952 catchlist = c.next;
|
|
853
|
1953 check_catchlist_sanity ();
|
|
617
|
1954 /* Note: The unbind also resets Vcondition_handlers. Maybe we should
|
|
|
1955 delete this here. */
|
|
428
|
1956 Vcondition_handlers = XCDR (c.tag);
|
|
771
|
1957 unbind_to (speccount);
|
|
617
|
1958
|
|
|
1959 UNGCPRO;
|
|
|
1960 /* free the conses *after* the unbind, because the unbind will run
|
|
|
1961 condition_case_unwind above. */
|
|
853
|
1962 free_cons (XCAR (c.tag));
|
|
|
1963 free_cons (c.tag);
|
|
617
|
1964 return c.val;
|
|
428
|
1965 }
|
|
|
1966
|
|
|
1967 static Lisp_Object
|
|
|
1968 run_condition_case_handlers (Lisp_Object val, Lisp_Object var)
|
|
|
1969 {
|
|
|
1970 /* This function can GC */
|
|
|
1971 #if 0 /* FSFmacs */
|
|
|
1972 if (!NILP (h.var))
|
|
|
1973 specbind (h.var, c.val);
|
|
|
1974 val = Fprogn (Fcdr (h.chosen_clause));
|
|
|
1975
|
|
|
1976 /* Note that this just undoes the binding of h.var; whoever
|
|
|
1977 longjmp()ed to us unwound the stack to c.pdlcount before
|
|
|
1978 throwing. */
|
|
771
|
1979 unbind_to (c.pdlcount);
|
|
428
|
1980 return val;
|
|
|
1981 #else
|
|
|
1982 int speccount;
|
|
|
1983
|
|
|
1984 CHECK_TRUE_LIST (val);
|
|
|
1985 if (NILP (var))
|
|
|
1986 return Fprogn (Fcdr (val)); /* tail call */
|
|
|
1987
|
|
|
1988 speccount = specpdl_depth();
|
|
|
1989 specbind (var, Fcar (val));
|
|
|
1990 val = Fprogn (Fcdr (val));
|
|
771
|
1991 return unbind_to_1 (speccount, val);
|
|
428
|
1992 #endif
|
|
|
1993 }
|
|
|
1994
|
|
|
1995 /* Here for bytecode to call non-consfully. This is exactly like
|
|
|
1996 condition-case except that it takes three arguments rather
|
|
|
1997 than a single list of arguments. */
|
|
|
1998 Lisp_Object
|
|
|
1999 condition_case_3 (Lisp_Object bodyform, Lisp_Object var, Lisp_Object handlers)
|
|
|
2000 {
|
|
|
2001 /* This function can GC */
|
|
|
2002 EXTERNAL_LIST_LOOP_2 (handler, handlers)
|
|
|
2003 {
|
|
|
2004 if (NILP (handler))
|
|
|
2005 ;
|
|
|
2006 else if (CONSP (handler))
|
|
|
2007 {
|
|
|
2008 Lisp_Object conditions = XCAR (handler);
|
|
|
2009 /* CONDITIONS must a condition name or a list of condition names */
|
|
|
2010 if (SYMBOLP (conditions))
|
|
|
2011 ;
|
|
|
2012 else
|
|
|
2013 {
|
|
|
2014 EXTERNAL_LIST_LOOP_2 (condition, conditions)
|
|
|
2015 if (!SYMBOLP (condition))
|
|
|
2016 goto invalid_condition_handler;
|
|
|
2017 }
|
|
|
2018 }
|
|
|
2019 else
|
|
|
2020 {
|
|
|
2021 invalid_condition_handler:
|
|
563
|
2022 sferror ("Invalid condition handler", handler);
|
|
428
|
2023 }
|
|
|
2024 }
|
|
|
2025
|
|
|
2026 CHECK_SYMBOL (var);
|
|
|
2027
|
|
|
2028 return condition_case_1 (handlers,
|
|
|
2029 Feval, bodyform,
|
|
|
2030 run_condition_case_handlers,
|
|
|
2031 var);
|
|
|
2032 }
|
|
|
2033
|
|
|
2034 DEFUN ("condition-case", Fcondition_case, 2, UNEVALLED, 0, /*
|
|
|
2035 Regain control when an error is signalled.
|
|
|
2036 Usage looks like (condition-case VAR BODYFORM HANDLERS...).
|
|
|
2037 Executes BODYFORM and returns its value if no error happens.
|
|
|
2038 Each element of HANDLERS looks like (CONDITION-NAME BODY...)
|
|
|
2039 where the BODY is made of Lisp expressions.
|
|
|
2040
|
|
771
|
2041 A typical usage of `condition-case' looks like this:
|
|
|
2042
|
|
|
2043 (condition-case nil
|
|
|
2044 ;; you need a progn here if you want more than one statement ...
|
|
|
2045 (progn
|
|
|
2046 (do-something)
|
|
|
2047 (do-something-else))
|
|
|
2048 (error
|
|
|
2049 (issue-warning-or)
|
|
|
2050 ;; but strangely, you don't need one here.
|
|
|
2051 (return-a-value-etc)
|
|
|
2052 ))
|
|
|
2053
|
|
428
|
2054 A handler is applicable to an error if CONDITION-NAME is one of the
|
|
|
2055 error's condition names. If an error happens, the first applicable
|
|
|
2056 handler is run. As a special case, a CONDITION-NAME of t matches
|
|
|
2057 all errors, even those without the `error' condition name on them
|
|
|
2058 \(e.g. `quit').
|
|
|
2059
|
|
|
2060 The car of a handler may be a list of condition names
|
|
|
2061 instead of a single condition name.
|
|
|
2062
|
|
|
2063 When a handler handles an error,
|
|
|
2064 control returns to the condition-case and the handler BODY... is executed
|
|
|
2065 with VAR bound to (SIGNALED-CONDITIONS . SIGNAL-DATA).
|
|
|
2066 VAR may be nil; then you do not get access to the signal information.
|
|
|
2067
|
|
|
2068 The value of the last BODY form is returned from the condition-case.
|
|
|
2069 See also the function `signal' for more info.
|
|
|
2070
|
|
|
2071 Note that at the time the condition handler is invoked, the Lisp stack
|
|
|
2072 and the current catches, condition-cases, and bindings have all been
|
|
|
2073 popped back to the state they were in just before the call to
|
|
|
2074 `condition-case'. This means that resignalling the error from
|
|
|
2075 within the handler will not result in an infinite loop.
|
|
|
2076
|
|
|
2077 If you want to establish an error handler that is called with the
|
|
|
2078 Lisp stack, bindings, etc. as they were when `signal' was called,
|
|
|
2079 rather than when the handler was set, use `call-with-condition-handler'.
|
|
|
2080 */
|
|
|
2081 (args))
|
|
|
2082 {
|
|
|
2083 /* This function can GC */
|
|
|
2084 Lisp_Object var = XCAR (args);
|
|
|
2085 Lisp_Object bodyform = XCAR (XCDR (args));
|
|
|
2086 Lisp_Object handlers = XCDR (XCDR (args));
|
|
|
2087 return condition_case_3 (bodyform, var, handlers);
|
|
|
2088 }
|
|
|
2089
|
|
|
2090 DEFUN ("call-with-condition-handler", Fcall_with_condition_handler, 2, MANY, 0, /*
|
|
|
2091 Regain control when an error is signalled, without popping the stack.
|
|
|
2092 Usage looks like (call-with-condition-handler HANDLER FUNCTION &rest ARGS).
|
|
|
2093 This function is similar to `condition-case', but the handler is invoked
|
|
|
2094 with the same environment (Lisp stack, bindings, catches, condition-cases)
|
|
|
2095 that was current when `signal' was called, rather than when the handler
|
|
|
2096 was established.
|
|
|
2097
|
|
|
2098 HANDLER should be a function of one argument, which is a cons of the args
|
|
|
2099 \(SIG . DATA) that were passed to `signal'. It is invoked whenever
|
|
|
2100 `signal' is called (this differs from `condition-case', which allows
|
|
|
2101 you to specify which errors are trapped). If the handler function
|
|
|
2102 returns, `signal' continues as if the handler were never invoked.
|
|
|
2103 \(It continues to look for handlers established earlier than this one,
|
|
|
2104 and invokes the standard error-handler if none is found.)
|
|
|
2105 */
|
|
|
2106 (int nargs, Lisp_Object *args)) /* Note! Args side-effected! */
|
|
|
2107 {
|
|
|
2108 /* This function can GC */
|
|
|
2109 int speccount = specpdl_depth();
|
|
|
2110 Lisp_Object tem;
|
|
|
2111
|
|
853
|
2112 tem = Ffunction_max_args (args[0]);
|
|
|
2113 if (! (XINT (Ffunction_min_args (args[0])) <= 1
|
|
|
2114 && (NILP (tem) || 1 <= XINT (tem))))
|
|
|
2115 invalid_argument ("Must be function of one argument", args[0]);
|
|
|
2116
|
|
|
2117 /* (handler-fun . handler-args) but currently there are no handler-args */
|
|
428
|
2118 tem = noseeum_cons (list1 (args[0]), Vcondition_handlers);
|
|
|
2119 record_unwind_protect (condition_bind_unwind, tem);
|
|
|
2120 Vcondition_handlers = tem;
|
|
|
2121
|
|
|
2122 /* Caller should have GC-protected args */
|
|
771
|
2123 return unbind_to_1 (speccount, Ffuncall (nargs - 1, args + 1));
|
|
428
|
2124 }
|
|
|
2125
|
|
853
|
2126 /* This is the C version of the above function. It calls FUN, passing it
|
|
|
2127 ARG, first setting up HANDLER to catch signals in the environment in
|
|
|
2128 which they were signalled. (HANDLER is only invoked if there was no
|
|
|
2129 handler (either from condition-case or call-with-condition-handler) set
|
|
|
2130 later on that handled the signal; therefore, this is a real error.
|
|
|
2131
|
|
|
2132 HANDLER is invoked with three arguments: the ERROR-SYMBOL and DATA as
|
|
|
2133 passed to `signal', and HANDLER_ARG. Originally I made HANDLER_ARG and
|
|
|
2134 ARG be void * to facilitate passing structures, but I changed to
|
|
|
2135 Lisp_Objects because all the other C interfaces to catch/condition-case/etc.
|
|
|
2136 take Lisp_Objects, and it is easy enough to use make_opaque_ptr() et al.
|
|
|
2137 to convert between Lisp_Objects and structure pointers. */
|
|
|
2138
|
|
|
2139 Lisp_Object
|
|
|
2140 call_with_condition_handler (Lisp_Object (*handler) (Lisp_Object, Lisp_Object,
|
|
|
2141 Lisp_Object),
|
|
|
2142 Lisp_Object handler_arg,
|
|
|
2143 Lisp_Object (*fun) (Lisp_Object),
|
|
|
2144 Lisp_Object arg)
|
|
|
2145 {
|
|
|
2146 /* This function can GC */
|
|
1111
|
2147 int speccount = specpdl_depth ();
|
|
853
|
2148 Lisp_Object tem;
|
|
|
2149
|
|
|
2150 /* ((handler-fun . (handler-arg . nil)) ... ) */
|
|
1111
|
2151 tem = noseeum_cons (noseeum_cons (make_opaque_ptr ((void *) handler),
|
|
853
|
2152 noseeum_cons (handler_arg, Qnil)),
|
|
|
2153 Vcondition_handlers);
|
|
|
2154 record_unwind_protect (condition_bind_unwind, tem);
|
|
|
2155 Vcondition_handlers = tem;
|
|
|
2156
|
|
|
2157 return unbind_to_1 (speccount, (*fun) (arg));
|
|
|
2158 }
|
|
|
2159
|
|
428
|
2160 static int
|
|
|
2161 condition_type_p (Lisp_Object type, Lisp_Object conditions)
|
|
|
2162 {
|
|
|
2163 if (EQ (type, Qt))
|
|
|
2164 /* (condition-case c # (t c)) catches -all- signals
|
|
|
2165 * Use with caution! */
|
|
|
2166 return 1;
|
|
|
2167
|
|
|
2168 if (SYMBOLP (type))
|
|
|
2169 return !NILP (Fmemq (type, conditions));
|
|
|
2170
|
|
|
2171 for (; CONSP (type); type = XCDR (type))
|
|
|
2172 if (!NILP (Fmemq (XCAR (type), conditions)))
|
|
|
2173 return 1;
|
|
|
2174
|
|
|
2175 return 0;
|
|
|
2176 }
|
|
|
2177
|
|
|
2178 static Lisp_Object
|
|
|
2179 return_from_signal (Lisp_Object value)
|
|
|
2180 {
|
|
|
2181 #if 1
|
|
|
2182 /* Most callers are not prepared to handle gc if this
|
|
|
2183 returns. So, since this feature is not very useful,
|
|
|
2184 take it out. */
|
|
|
2185 /* Have called debugger; return value to signaller */
|
|
|
2186 return value;
|
|
|
2187 #else /* But the reality is that that stinks, because: */
|
|
|
2188 /* GACK!!! Really want some way for debug-on-quit errors
|
|
|
2189 to be continuable!! */
|
|
563
|
2190 signal_error (Qunimplemented,
|
|
|
2191 "Returning a value from an error is no longer supported",
|
|
|
2192 Qunbound);
|
|
428
|
2193 #endif
|
|
|
2194 }
|
|
|
2195
|
|
|
2196
|
|
|
2197 /************************************************************************/
|
|
|
2198 /* the workhorse error-signaling function */
|
|
|
2199 /************************************************************************/
|
|
|
2200
|
|
853
|
2201 /* This exists only for debugging purposes, as a place to put a breakpoint
|
|
|
2202 that won't get signalled for errors occurring when
|
|
|
2203 call_with_suspended_errors() was invoked. */
|
|
|
2204
|
|
872
|
2205 /* Don't make static or it might be compiled away */
|
|
|
2206 void signal_1 (void);
|
|
|
2207
|
|
|
2208 void
|
|
853
|
2209 signal_1 (void)
|
|
|
2210 {
|
|
|
2211 }
|
|
|
2212
|
|
428
|
2213 /* #### This function has not been synched with FSF. It diverges
|
|
|
2214 significantly. */
|
|
|
2215
|
|
853
|
2216 /* The simplest external error function: it would be called
|
|
|
2217 signal_continuable_error() in the terminology below, but it's
|
|
|
2218 Lisp-callable. */
|
|
|
2219
|
|
|
2220 DEFUN ("signal", Fsignal, 2, 2, 0, /*
|
|
|
2221 Signal a continuable error. Args are ERROR-SYMBOL, and associated DATA.
|
|
|
2222 An error symbol is a symbol defined using `define-error'.
|
|
|
2223 DATA should be a list. Its elements are printed as part of the error message.
|
|
|
2224 If the signal is handled, DATA is made available to the handler.
|
|
|
2225 See also the function `signal-error', and the functions to handle errors:
|
|
|
2226 `condition-case' and `call-with-condition-handler'.
|
|
|
2227
|
|
|
2228 Note that this function can return, if the debugger is invoked and the
|
|
|
2229 user invokes the "return from signal" option.
|
|
|
2230 */
|
|
|
2231 (error_symbol, data))
|
|
428
|
2232 {
|
|
|
2233 /* This function can GC */
|
|
853
|
2234 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
|
|
|
2235 Lisp_Object conditions = Qnil;
|
|
|
2236 Lisp_Object handlers = Qnil;
|
|
428
|
2237 /* signal_call_debugger() could get called more than once
|
|
|
2238 (once when a call-with-condition-handler is about to
|
|
|
2239 be dealt with, and another when a condition-case handler
|
|
|
2240 is about to be invoked). So make sure the debugger and/or
|
|
|
2241 stack trace aren't done more than once. */
|
|
|
2242 int stack_trace_displayed = 0;
|
|
|
2243 int debugger_entered = 0;
|
|
853
|
2244
|
|
|
2245 /* Fsignal() is one of these functions that's called all the time
|
|
|
2246 with newly-created Lisp objects. We allow this; but we must GC-
|
|
|
2247 protect the objects because all sorts of weird stuff could
|
|
|
2248 happen. */
|
|
|
2249
|
|
|
2250 GCPRO4 (conditions, handlers, error_symbol, data);
|
|
|
2251
|
|
|
2252 if (!(inhibit_flags & CALL_WITH_SUSPENDED_ERRORS))
|
|
|
2253 signal_1 ();
|
|
428
|
2254
|
|
|
2255 if (!initialized)
|
|
|
2256 {
|
|
|
2257 /* who knows how much has been initialized? Safest bet is
|
|
|
2258 just to bomb out immediately. */
|
|
771
|
2259 stderr_out ("Error before initialization is complete!\n");
|
|
2500
|
2260 ABORT ();
|
|
428
|
2261 }
|
|
|
2262
|
|
3092
|
2263 #ifndef NEW_GC
|
|
1123
|
2264 assert (!gc_in_progress);
|
|
3092
|
2265 #endif /* not NEW_GC */
|
|
1123
|
2266
|
|
|
2267 /* We abort if in_display and we are not protected, as garbage
|
|
|
2268 collections and non-local exits will invariably be fatal, but in
|
|
|
2269 messy, difficult-to-debug ways. See enter_redisplay_critical_section().
|
|
|
2270 */
|
|
|
2271
|
|
1318
|
2272 #ifdef ERROR_CHECK_TRAPPING_PROBLEMS
|
|
1123
|
2273 check_proper_critical_section_nonlocal_exit_protection ();
|
|
1318
|
2274 #endif
|
|
428
|
2275
|
|
853
|
2276 conditions = Fget (error_symbol, Qerror_conditions, Qnil);
|
|
428
|
2277
|
|
|
2278 for (handlers = Vcondition_handlers;
|
|
|
2279 CONSP (handlers);
|
|
|
2280 handlers = XCDR (handlers))
|
|
|
2281 {
|
|
|
2282 Lisp_Object handler_fun = XCAR (XCAR (handlers));
|
|
|
2283 Lisp_Object handler_data = XCDR (XCAR (handlers));
|
|
|
2284 Lisp_Object outer_handlers = XCDR (handlers);
|
|
|
2285
|
|
|
2286 if (!UNBOUNDP (handler_fun))
|
|
|
2287 {
|
|
|
2288 /* call-with-condition-handler */
|
|
|
2289 Lisp_Object tem;
|
|
|
2290 Lisp_Object all_handlers = Vcondition_handlers;
|
|
|
2291 struct gcpro ngcpro1;
|
|
|
2292 NGCPRO1 (all_handlers);
|
|
|
2293 Vcondition_handlers = outer_handlers;
|
|
|
2294
|
|
853
|
2295 tem = signal_call_debugger (conditions, error_symbol, data,
|
|
428
|
2296 outer_handlers, 1,
|
|
|
2297 &stack_trace_displayed,
|
|
|
2298 &debugger_entered);
|
|
|
2299 if (!UNBOUNDP (tem))
|
|
|
2300 RETURN_NUNGCPRO (return_from_signal (tem));
|
|
|
2301
|
|
853
|
2302 if (OPAQUE_PTRP (handler_fun))
|
|
|
2303 {
|
|
|
2304 if (NILP (handler_data))
|
|
|
2305 {
|
|
|
2306 Lisp_Object (*hfun) (Lisp_Object, Lisp_Object) =
|
|
|
2307 (Lisp_Object (*) (Lisp_Object, Lisp_Object))
|
|
|
2308 (get_opaque_ptr (handler_fun));
|
|
|
2309
|
|
|
2310 tem = (*hfun) (error_symbol, data);
|
|
|
2311 }
|
|
|
2312 else
|
|
|
2313 {
|
|
|
2314 Lisp_Object (*hfun) (Lisp_Object, Lisp_Object, Lisp_Object) =
|
|
|
2315 (Lisp_Object (*) (Lisp_Object, Lisp_Object, Lisp_Object))
|
|
|
2316 (get_opaque_ptr (handler_fun));
|
|
|
2317
|
|
|
2318 assert (NILP (XCDR (handler_data)));
|
|
|
2319 tem = (*hfun) (error_symbol, data, XCAR (handler_data));
|
|
|
2320 }
|
|
|
2321 }
|
|
|
2322 else
|
|
|
2323 {
|
|
|
2324 tem = Fcons (error_symbol, data);
|
|
|
2325 if (NILP (handler_data))
|
|
|
2326 tem = call1 (handler_fun, tem);
|
|
|
2327 else
|
|
|
2328 {
|
|
|
2329 /* (This code won't be used (for now?).) */
|
|
|
2330 struct gcpro nngcpro1;
|
|
|
2331 Lisp_Object args[3];
|
|
|
2332 NNGCPRO1 (args[0]);
|
|
|
2333 nngcpro1.nvars = 3;
|
|
|
2334 args[0] = handler_fun;
|
|
|
2335 args[1] = tem;
|
|
|
2336 args[2] = handler_data;
|
|
|
2337 nngcpro1.var = args;
|
|
|
2338 tem = Fapply (3, args);
|
|
|
2339 NNUNGCPRO;
|
|
|
2340 }
|
|
|
2341 }
|
|
428
|
2342 NUNGCPRO;
|
|
|
2343 #if 0
|
|
|
2344 if (!EQ (tem, Qsignal))
|
|
|
2345 return return_from_signal (tem);
|
|
|
2346 #endif
|
|
|
2347 /* If handler didn't throw, try another handler */
|
|
|
2348 Vcondition_handlers = all_handlers;
|
|
|
2349 }
|
|
|
2350
|
|
|
2351 /* It's a condition-case handler */
|
|
|
2352
|
|
|
2353 /* t is used by handlers for all conditions, set up by C code.
|
|
|
2354 * debugger is not called even if debug_on_error */
|
|
|
2355 else if (EQ (handler_data, Qt))
|
|
|
2356 {
|
|
|
2357 UNGCPRO;
|
|
853
|
2358 return Fthrow (handlers, Fcons (error_symbol, data));
|
|
428
|
2359 }
|
|
|
2360 /* `error' is used similarly to the way `t' is used, but in
|
|
|
2361 addition it invokes the debugger if debug_on_error.
|
|
|
2362 This is normally used for the outer command-loop error
|
|
|
2363 handler. */
|
|
|
2364 else if (EQ (handler_data, Qerror))
|
|
|
2365 {
|
|
853
|
2366 Lisp_Object tem = signal_call_debugger (conditions, error_symbol,
|
|
|
2367 data,
|
|
428
|
2368 outer_handlers, 0,
|
|
|
2369 &stack_trace_displayed,
|
|
|
2370 &debugger_entered);
|
|
|
2371
|
|
|
2372 UNGCPRO;
|
|
|
2373 if (!UNBOUNDP (tem))
|
|
|
2374 return return_from_signal (tem);
|
|
|
2375
|
|
853
|
2376 tem = Fcons (error_symbol, data);
|
|
428
|
2377 return Fthrow (handlers, tem);
|
|
|
2378 }
|
|
|
2379 else
|
|
|
2380 {
|
|
|
2381 /* handler established by real (Lisp) condition-case */
|
|
|
2382 Lisp_Object h;
|
|
|
2383
|
|
|
2384 for (h = handler_data; CONSP (h); h = Fcdr (h))
|
|
|
2385 {
|
|
|
2386 Lisp_Object clause = Fcar (h);
|
|
|
2387 Lisp_Object tem = Fcar (clause);
|
|
|
2388
|
|
|
2389 if (condition_type_p (tem, conditions))
|
|
|
2390 {
|
|
853
|
2391 tem = signal_call_debugger (conditions, error_symbol, data,
|
|
428
|
2392 outer_handlers, 1,
|
|
|
2393 &stack_trace_displayed,
|
|
|
2394 &debugger_entered);
|
|
|
2395 UNGCPRO;
|
|
|
2396 if (!UNBOUNDP (tem))
|
|
|
2397 return return_from_signal (tem);
|
|
|
2398
|
|
|
2399 /* Doesn't return */
|
|
853
|
2400 tem = Fcons (Fcons (error_symbol, data), Fcdr (clause));
|
|
428
|
2401 return Fthrow (handlers, tem);
|
|
|
2402 }
|
|
|
2403 }
|
|
|
2404 }
|
|
|
2405 }
|
|
|
2406
|
|
|
2407 /* If no handler is present now, try to run the debugger,
|
|
|
2408 and if that fails, throw to top level.
|
|
|
2409
|
|
|
2410 #### The only time that no handler is present is during
|
|
|
2411 temacs or perhaps very early in XEmacs. In both cases,
|
|
3025
|
2412 there is no `top-level' catch. (That's why the
|
|
428
|
2413 "bomb-out" hack was added.)
|
|
|
2414
|
|
853
|
2415 [[#### Fix this horrifitude!]]
|
|
|
2416
|
|
|
2417 I don't think this is horrifitude, but just defensive coding. --ben */
|
|
|
2418
|
|
|
2419 signal_call_debugger (conditions, error_symbol, data, Qnil, 0,
|
|
428
|
2420 &stack_trace_displayed,
|
|
|
2421 &debugger_entered);
|
|
|
2422 UNGCPRO;
|
|
853
|
2423 throw_or_bomb_out (Qtop_level, Qt, 1, error_symbol,
|
|
|
2424 data); /* Doesn't return */
|
|
2268
|
2425 RETURN_NOT_REACHED (Qnil);
|
|
428
|
2426 }
|
|
|
2427
|
|
|
2428 /****************** Error functions class 1 ******************/
|
|
|
2429
|
|
|
2430 /* Class 1: General functions that signal an error.
|
|
|
2431 These functions take an error type and a list of associated error
|
|
|
2432 data. */
|
|
|
2433
|
|
853
|
2434 /* No signal_continuable_error_1(); it's called Fsignal(). */
|
|
428
|
2435
|
|
|
2436 /* Signal a non-continuable error. */
|
|
|
2437
|
|
|
2438 DOESNT_RETURN
|
|
563
|
2439 signal_error_1 (Lisp_Object sig, Lisp_Object data)
|
|
428
|
2440 {
|
|
|
2441 for (;;)
|
|
|
2442 Fsignal (sig, data);
|
|
|
2443 }
|
|
853
|
2444
|
|
|
2445 #ifdef ERROR_CHECK_CATCH
|
|
|
2446
|
|
|
2447 void
|
|
|
2448 check_catchlist_sanity (void)
|
|
|
2449 {
|
|
|
2450 #if 0
|
|
|
2451 /* vou me tomar no cu! i just masked andy's missing-unbind
|
|
|
2452 bug! */
|
|
442
|
2453 struct catchtag *c;
|
|
|
2454 int found_error_tag = 0;
|
|
|
2455
|
|
|
2456 for (c = catchlist; c; c = c->next)
|
|
|
2457 {
|
|
|
2458 if (EQ (c->tag, Qunbound_suspended_errors_tag))
|
|
|
2459 {
|
|
|
2460 found_error_tag = 1;
|
|
|
2461 break;
|
|
|
2462 }
|
|
|
2463 }
|
|
|
2464
|
|
|
2465 assert (found_error_tag || NILP (Vcurrent_error_state));
|
|
853
|
2466 #endif /* vou me tomar no cul */
|
|
|
2467 }
|
|
|
2468
|
|
|
2469 void
|
|
|
2470 check_specbind_stack_sanity (void)
|
|
|
2471 {
|
|
|
2472 }
|
|
|
2473
|
|
|
2474 #endif /* ERROR_CHECK_CATCH */
|
|
428
|
2475
|
|
|
2476 /* Signal a non-continuable error or display a warning or do nothing,
|
|
|
2477 according to ERRB. CLASS is the class of warning and should
|
|
|
2478 refer to what sort of operation is being done (e.g. Qtoolbar,
|
|
|
2479 Qresource, etc.). */
|
|
|
2480
|
|
|
2481 void
|
|
1204
|
2482 maybe_signal_error_1 (Lisp_Object sig, Lisp_Object data, Lisp_Object class_,
|
|
578
|
2483 Error_Behavior errb)
|
|
428
|
2484 {
|
|
|
2485 if (ERRB_EQ (errb, ERROR_ME_NOT))
|
|
|
2486 return;
|
|
793
|
2487 else if (ERRB_EQ (errb, ERROR_ME_DEBUG_WARN))
|
|
1204
|
2488 warn_when_safe_lispobj (class_, Qdebug, Fcons (sig, data));
|
|
428
|
2489 else if (ERRB_EQ (errb, ERROR_ME_WARN))
|
|
1204
|
2490 warn_when_safe_lispobj (class_, Qwarning, Fcons (sig, data));
|
|
428
|
2491 else
|
|
|
2492 for (;;)
|
|
|
2493 Fsignal (sig, data);
|
|
|
2494 }
|
|
|
2495
|
|
|
2496 /* Signal a continuable error or display a warning or do nothing,
|
|
|
2497 according to ERRB. */
|
|
|
2498
|
|
|
2499 Lisp_Object
|
|
563
|
2500 maybe_signal_continuable_error_1 (Lisp_Object sig, Lisp_Object data,
|
|
1204
|
2501 Lisp_Object class_, Error_Behavior errb)
|
|
428
|
2502 {
|
|
|
2503 if (ERRB_EQ (errb, ERROR_ME_NOT))
|
|
|
2504 return Qnil;
|
|
793
|
2505 else if (ERRB_EQ (errb, ERROR_ME_DEBUG_WARN))
|
|
|
2506 {
|
|
1204
|
2507 warn_when_safe_lispobj (class_, Qdebug, Fcons (sig, data));
|
|
793
|
2508 return Qnil;
|
|
|
2509 }
|
|
428
|
2510 else if (ERRB_EQ (errb, ERROR_ME_WARN))
|
|
|
2511 {
|
|
1204
|
2512 warn_when_safe_lispobj (class_, Qwarning, Fcons (sig, data));
|
|
428
|
2513 return Qnil;
|
|
|
2514 }
|
|
|
2515 else
|
|
|
2516 return Fsignal (sig, data);
|
|
|
2517 }
|
|
|
2518
|
|
|
2519
|
|
|
2520 /****************** Error functions class 2 ******************/
|
|
|
2521
|
|
563
|
2522 /* Class 2: Signal an error with a string and an associated object.
|
|
|
2523 Normally these functions are used to attach one associated object,
|
|
|
2524 but to attach no objects, specify Qunbound for FROB, and for more
|
|
|
2525 than one object, make a list of the objects with Qunbound as the
|
|
|
2526 first element. (If you have specifically two objects to attach,
|
|
|
2527 consider using the function in class 3 below.) These functions
|
|
|
2528 signal an error of a specified type, whose data is one or more
|
|
|
2529 objects (usually two), a string the related Lisp object(s)
|
|
|
2530 specified as FROB. */
|
|
|
2531
|
|
|
2532 /* Out of REASON and FROB, return a list of elements suitable for passing
|
|
|
2533 to signal_error_1(). */
|
|
|
2534
|
|
|
2535 Lisp_Object
|
|
867
|
2536 build_error_data (const CIbyte *reason, Lisp_Object frob)
|
|
563
|
2537 {
|
|
|
2538 if (EQ (frob, Qunbound))
|
|
|
2539 frob = Qnil;
|
|
|
2540 else if (CONSP (frob) && EQ (XCAR (frob), Qunbound))
|
|
|
2541 frob = XCDR (frob);
|
|
|
2542 else
|
|
|
2543 frob = list1 (frob);
|
|
|
2544 if (!reason)
|
|
|
2545 return frob;
|
|
|
2546 else
|
|
771
|
2547 return Fcons (build_msg_string (reason), frob);
|
|
563
|
2548 }
|
|
|
2549
|
|
|
2550 DOESNT_RETURN
|
|
867
|
2551 signal_error (Lisp_Object type, const CIbyte *reason, Lisp_Object frob)
|
|
563
|
2552 {
|
|
|
2553 signal_error_1 (type, build_error_data (reason, frob));
|
|
|
2554 }
|
|
|
2555
|
|
|
2556 void
|
|
867
|
2557 maybe_signal_error (Lisp_Object type, const CIbyte *reason,
|
|
1204
|
2558 Lisp_Object frob, Lisp_Object class_,
|
|
578
|
2559 Error_Behavior errb)
|
|
563
|
2560 {
|
|
|
2561 /* Optimization: */
|
|
|
2562 if (ERRB_EQ (errb, ERROR_ME_NOT))
|
|
|
2563 return;
|
|
1204
|
2564 maybe_signal_error_1 (type, build_error_data (reason, frob), class_, errb);
|
|
563
|
2565 }
|
|
|
2566
|
|
|
2567 Lisp_Object
|
|
867
|
2568 signal_continuable_error (Lisp_Object type, const CIbyte *reason,
|
|
563
|
2569 Lisp_Object frob)
|
|
|
2570 {
|
|
|
2571 return Fsignal (type, build_error_data (reason, frob));
|
|
|
2572 }
|
|
|
2573
|
|
|
2574 Lisp_Object
|
|
867
|
2575 maybe_signal_continuable_error (Lisp_Object type, const CIbyte *reason,
|
|
1204
|
2576 Lisp_Object frob, Lisp_Object class_,
|
|
578
|
2577 Error_Behavior errb)
|
|
563
|
2578 {
|
|
|
2579 /* Optimization: */
|
|
|
2580 if (ERRB_EQ (errb, ERROR_ME_NOT))
|
|
|
2581 return Qnil;
|
|
|
2582 return maybe_signal_continuable_error_1 (type,
|
|
|
2583 build_error_data (reason, frob),
|
|
1204
|
2584 class_, errb);
|
|
563
|
2585 }
|
|
|
2586
|
|
|
2587
|
|
|
2588 /****************** Error functions class 3 ******************/
|
|
|
2589
|
|
|
2590 /* Class 3: Signal an error with a string and two associated objects.
|
|
|
2591 These functions signal an error of a specified type, whose data
|
|
|
2592 is three objects, a string and two related Lisp objects.
|
|
|
2593 (The equivalent could be accomplished using the class 2 functions,
|
|
|
2594 but these are more convenient in this particular case.) */
|
|
|
2595
|
|
|
2596 DOESNT_RETURN
|
|
867
|
2597 signal_error_2 (Lisp_Object type, const CIbyte *reason,
|
|
563
|
2598 Lisp_Object frob0, Lisp_Object frob1)
|
|
|
2599 {
|
|
771
|
2600 signal_error_1 (type, list3 (build_msg_string (reason), frob0,
|
|
563
|
2601 frob1));
|
|
|
2602 }
|
|
|
2603
|
|
|
2604 void
|
|
867
|
2605 maybe_signal_error_2 (Lisp_Object type, const CIbyte *reason,
|
|
563
|
2606 Lisp_Object frob0, Lisp_Object frob1,
|
|
1204
|
2607 Lisp_Object class_, Error_Behavior errb)
|
|
563
|
2608 {
|
|
|
2609 /* Optimization: */
|
|
|
2610 if (ERRB_EQ (errb, ERROR_ME_NOT))
|
|
|
2611 return;
|
|
771
|
2612 maybe_signal_error_1 (type, list3 (build_msg_string (reason), frob0,
|
|
1204
|
2613 frob1), class_, errb);
|
|
563
|
2614 }
|
|
|
2615
|
|
|
2616 Lisp_Object
|
|
867
|
2617 signal_continuable_error_2 (Lisp_Object type, const CIbyte *reason,
|
|
563
|
2618 Lisp_Object frob0, Lisp_Object frob1)
|
|
|
2619 {
|
|
771
|
2620 return Fsignal (type, list3 (build_msg_string (reason), frob0,
|
|
563
|
2621 frob1));
|
|
|
2622 }
|
|
|
2623
|
|
|
2624 Lisp_Object
|
|
867
|
2625 maybe_signal_continuable_error_2 (Lisp_Object type, const CIbyte *reason,
|
|
563
|
2626 Lisp_Object frob0, Lisp_Object frob1,
|
|
1204
|
2627 Lisp_Object class_, Error_Behavior errb)
|
|
563
|
2628 {
|
|
|
2629 /* Optimization: */
|
|
|
2630 if (ERRB_EQ (errb, ERROR_ME_NOT))
|
|
|
2631 return Qnil;
|
|
|
2632 return maybe_signal_continuable_error_1
|
|
771
|
2633 (type, list3 (build_msg_string (reason), frob0, frob1),
|
|
1204
|
2634 class_, errb);
|
|
563
|
2635 }
|
|
|
2636
|
|
|
2637
|
|
|
2638 /****************** Error functions class 4 ******************/
|
|
|
2639
|
|
|
2640 /* Class 4: Printf-like functions that signal an error.
|
|
442
|
2641 These functions signal an error of a specified type, whose data
|
|
428
|
2642 is a single string, created using the arguments. */
|
|
|
2643
|
|
|
2644 DOESNT_RETURN
|
|
867
|
2645 signal_ferror (Lisp_Object type, const CIbyte *fmt, ...)
|
|
442
|
2646 {
|
|
|
2647 Lisp_Object obj;
|
|
|
2648 va_list args;
|
|
|
2649
|
|
|
2650 va_start (args, fmt);
|
|
771
|
2651 obj = emacs_vsprintf_string (CGETTEXT (fmt), args);
|
|
442
|
2652 va_end (args);
|
|
|
2653
|
|
|
2654 /* Fsignal GC-protects its args */
|
|
563
|
2655 signal_error (type, 0, obj);
|
|
442
|
2656 }
|
|
|
2657
|
|
|
2658 void
|
|
1204
|
2659 maybe_signal_ferror (Lisp_Object type, Lisp_Object class_, Error_Behavior errb,
|
|
867
|
2660 const CIbyte *fmt, ...)
|
|
442
|
2661 {
|
|
|
2662 Lisp_Object obj;
|
|
|
2663 va_list args;
|
|
|
2664
|
|
|
2665 /* Optimization: */
|
|
|
2666 if (ERRB_EQ (errb, ERROR_ME_NOT))
|
|
|
2667 return;
|
|
|
2668
|
|
|
2669 va_start (args, fmt);
|
|
771
|
2670 obj = emacs_vsprintf_string (CGETTEXT (fmt), args);
|
|
442
|
2671 va_end (args);
|
|
|
2672
|
|
|
2673 /* Fsignal GC-protects its args */
|
|
1204
|
2674 maybe_signal_error (type, 0, obj, class_, errb);
|
|
442
|
2675 }
|
|
|
2676
|
|
|
2677 Lisp_Object
|
|
867
|
2678 signal_continuable_ferror (Lisp_Object type, const CIbyte *fmt, ...)
|
|
428
|
2679 {
|
|
|
2680 Lisp_Object obj;
|
|
|
2681 va_list args;
|
|
|
2682
|
|
|
2683 va_start (args, fmt);
|
|
771
|
2684 obj = emacs_vsprintf_string (CGETTEXT (fmt), args);
|
|
442
|
2685 va_end (args);
|
|
|
2686
|
|
|
2687 /* Fsignal GC-protects its args */
|
|
|
2688 return Fsignal (type, list1 (obj));
|
|
|
2689 }
|
|
|
2690
|
|
|
2691 Lisp_Object
|
|
1204
|
2692 maybe_signal_continuable_ferror (Lisp_Object type, Lisp_Object class_,
|
|
867
|
2693 Error_Behavior errb, const CIbyte *fmt, ...)
|
|
442
|
2694 {
|
|
|
2695 Lisp_Object obj;
|
|
|
2696 va_list args;
|
|
|
2697
|
|
|
2698 /* Optimization: */
|
|
|
2699 if (ERRB_EQ (errb, ERROR_ME_NOT))
|
|
|
2700 return Qnil;
|
|
|
2701
|
|
|
2702 va_start (args, fmt);
|
|
771
|
2703 obj = emacs_vsprintf_string (CGETTEXT (fmt), args);
|
|
442
|
2704 va_end (args);
|
|
|
2705
|
|
|
2706 /* Fsignal GC-protects its args */
|
|
1204
|
2707 return maybe_signal_continuable_error (type, 0, obj, class_, errb);
|
|
442
|
2708 }
|
|
|
2709
|
|
|
2710
|
|
|
2711 /****************** Error functions class 5 ******************/
|
|
|
2712
|
|
563
|
2713 /* Class 5: Printf-like functions that signal an error.
|
|
442
|
2714 These functions signal an error of a specified type, whose data
|
|
563
|
2715 is a one or more objects, a string (created using the arguments)
|
|
|
2716 and additional Lisp objects specified in FROB. (The syntax of FROB
|
|
|
2717 is the same as for class 2.)
|
|
|
2718
|
|
|
2719 There is no need for a class 6 because you can always attach 2
|
|
|
2720 objects using class 5 (for FROB, specify a list with three
|
|
|
2721 elements, the first of which is Qunbound), and these functions are
|
|
|
2722 not commonly used.
|
|
|
2723 */
|
|
442
|
2724
|
|
|
2725 DOESNT_RETURN
|
|
867
|
2726 signal_ferror_with_frob (Lisp_Object type, Lisp_Object frob, const CIbyte *fmt,
|
|
563
|
2727 ...)
|
|
442
|
2728 {
|
|
|
2729 Lisp_Object obj;
|
|
|
2730 va_list args;
|
|
|
2731
|
|
|
2732 va_start (args, fmt);
|
|
771
|
2733 obj = emacs_vsprintf_string (CGETTEXT (fmt), args);
|
|
442
|
2734 va_end (args);
|
|
|
2735
|
|
|
2736 /* Fsignal GC-protects its args */
|
|
563
|
2737 signal_error_1 (type, Fcons (obj, build_error_data (0, frob)));
|
|
442
|
2738 }
|
|
|
2739
|
|
|
2740 void
|
|
563
|
2741 maybe_signal_ferror_with_frob (Lisp_Object type, Lisp_Object frob,
|
|
1204
|
2742 Lisp_Object class_, Error_Behavior errb,
|
|
867
|
2743 const CIbyte *fmt, ...)
|
|
442
|
2744 {
|
|
|
2745 Lisp_Object obj;
|
|
|
2746 va_list args;
|
|
|
2747
|
|
|
2748 /* Optimization: */
|
|
|
2749 if (ERRB_EQ (errb, ERROR_ME_NOT))
|
|
|
2750 return;
|
|
|
2751
|
|
|
2752 va_start (args, fmt);
|
|
771
|
2753 obj = emacs_vsprintf_string (CGETTEXT (fmt), args);
|
|
428
|
2754 va_end (args);
|
|
|
2755
|
|
|
2756 /* Fsignal GC-protects its args */
|
|
1204
|
2757 maybe_signal_error_1 (type, Fcons (obj, build_error_data (0, frob)), class_,
|
|
563
|
2758 errb);
|
|
428
|
2759 }
|
|
|
2760
|
|
|
2761 Lisp_Object
|
|
563
|
2762 signal_continuable_ferror_with_frob (Lisp_Object type, Lisp_Object frob,
|
|
867
|
2763 const CIbyte *fmt, ...)
|
|
428
|
2764 {
|
|
|
2765 Lisp_Object obj;
|
|
|
2766 va_list args;
|
|
|
2767
|
|
|
2768 va_start (args, fmt);
|
|
771
|
2769 obj = emacs_vsprintf_string (CGETTEXT (fmt), args);
|
|
428
|
2770 va_end (args);
|
|
|
2771
|
|
|
2772 /* Fsignal GC-protects its args */
|
|
563
|
2773 return Fsignal (type, Fcons (obj, build_error_data (0, frob)));
|
|
428
|
2774 }
|
|
|
2775
|
|
|
2776 Lisp_Object
|
|
563
|
2777 maybe_signal_continuable_ferror_with_frob (Lisp_Object type, Lisp_Object frob,
|
|
1204
|
2778 Lisp_Object class_,
|
|
578
|
2779 Error_Behavior errb,
|
|
867
|
2780 const CIbyte *fmt, ...)
|
|
428
|
2781 {
|
|
|
2782 Lisp_Object obj;
|
|
|
2783 va_list args;
|
|
|
2784
|
|
|
2785 /* Optimization: */
|
|
|
2786 if (ERRB_EQ (errb, ERROR_ME_NOT))
|
|
|
2787 return Qnil;
|
|
|
2788
|
|
|
2789 va_start (args, fmt);
|
|
771
|
2790 obj = emacs_vsprintf_string (CGETTEXT (fmt), args);
|
|
428
|
2791 va_end (args);
|
|
|
2792
|
|
|
2793 /* Fsignal GC-protects its args */
|
|
563
|
2794 return maybe_signal_continuable_error_1 (type,
|
|
|
2795 Fcons (obj,
|
|
|
2796 build_error_data (0, frob)),
|
|
1204
|
2797 class_, errb);
|
|
428
|
2798 }
|
|
|
2799
|
|
|
2800
|
|
|
2801 /* This is what the QUIT macro calls to signal a quit */
|
|
|
2802 void
|
|
|
2803 signal_quit (void)
|
|
|
2804 {
|
|
853
|
2805 /* This function cannot GC. GC is prohibited because most callers do
|
|
|
2806 not expect GC occurring in QUIT. Remove this if/when that gets fixed.
|
|
|
2807 --ben */
|
|
|
2808
|
|
|
2809 int count;
|
|
|
2810
|
|
428
|
2811 if (EQ (Vquit_flag, Qcritical))
|
|
|
2812 debug_on_quit |= 2; /* set critical bit. */
|
|
|
2813 Vquit_flag = Qnil;
|
|
853
|
2814 count = begin_gc_forbidden ();
|
|
428
|
2815 /* note that this is continuable. */
|
|
|
2816 Fsignal (Qquit, Qnil);
|
|
853
|
2817 unbind_to (count);
|
|
428
|
2818 }
|
|
|
2819
|
|
|
2820
|
|
563
|
2821 /************************ convenience error functions ***********************/
|
|
|
2822
|
|
436
|
2823 Lisp_Object
|
|
428
|
2824 signal_void_function_error (Lisp_Object function)
|
|
|
2825 {
|
|
436
|
2826 return Fsignal (Qvoid_function, list1 (function));
|
|
428
|
2827 }
|
|
|
2828
|
|
436
|
2829 Lisp_Object
|
|
428
|
2830 signal_invalid_function_error (Lisp_Object function)
|
|
|
2831 {
|
|
436
|
2832 return Fsignal (Qinvalid_function, list1 (function));
|
|
428
|
2833 }
|
|
|
2834
|
|
436
|
2835 Lisp_Object
|
|
428
|
2836 signal_wrong_number_of_arguments_error (Lisp_Object function, int nargs)
|
|
|
2837 {
|
|
436
|
2838 return Fsignal (Qwrong_number_of_arguments,
|
|
|
2839 list2 (function, make_int (nargs)));
|
|
428
|
2840 }
|
|
|
2841
|
|
|
2842 /* Used in list traversal macros for efficiency. */
|
|
436
|
2843 DOESNT_RETURN
|
|
428
|
2844 signal_malformed_list_error (Lisp_Object list)
|
|
|
2845 {
|
|
563
|
2846 signal_error (Qmalformed_list, 0, list);
|
|
428
|
2847 }
|
|
|
2848
|
|
436
|
2849 DOESNT_RETURN
|
|
428
|
2850 signal_malformed_property_list_error (Lisp_Object list)
|
|
|
2851 {
|
|
563
|
2852 signal_error (Qmalformed_property_list, 0, list);
|
|
428
|
2853 }
|
|
|
2854
|
|
436
|
2855 DOESNT_RETURN
|
|
428
|
2856 signal_circular_list_error (Lisp_Object list)
|
|
|
2857 {
|
|
563
|
2858 signal_error (Qcircular_list, 0, list);
|
|
428
|
2859 }
|
|
|
2860
|
|
436
|
2861 DOESNT_RETURN
|
|
428
|
2862 signal_circular_property_list_error (Lisp_Object list)
|
|
|
2863 {
|
|
563
|
2864 signal_error (Qcircular_property_list, 0, list);
|
|
428
|
2865 }
|
|
442
|
2866
|
|
2267
|
2867 /* Called from within emacs_doprnt_1, so REASON is not formatted. */
|
|
442
|
2868 DOESNT_RETURN
|
|
867
|
2869 syntax_error (const CIbyte *reason, Lisp_Object frob)
|
|
442
|
2870 {
|
|
563
|
2871 signal_error (Qsyntax_error, reason, frob);
|
|
442
|
2872 }
|
|
|
2873
|
|
|
2874 DOESNT_RETURN
|
|
867
|
2875 syntax_error_2 (const CIbyte *reason, Lisp_Object frob1, Lisp_Object frob2)
|
|
442
|
2876 {
|
|
563
|
2877 signal_error_2 (Qsyntax_error, reason, frob1, frob2);
|
|
|
2878 }
|
|
|
2879
|
|
|
2880 void
|
|
867
|
2881 maybe_syntax_error (const CIbyte *reason, Lisp_Object frob,
|
|
1204
|
2882 Lisp_Object class_, Error_Behavior errb)
|
|
|
2883 {
|
|
|
2884 maybe_signal_error (Qsyntax_error, reason, frob, class_, errb);
|
|
563
|
2885 }
|
|
|
2886
|
|
|
2887 DOESNT_RETURN
|
|
867
|
2888 sferror (const CIbyte *reason, Lisp_Object frob)
|
|
563
|
2889 {
|
|
|
2890 signal_error (Qstructure_formation_error, reason, frob);
|
|
|
2891 }
|
|
|
2892
|
|
|
2893 DOESNT_RETURN
|
|
867
|
2894 sferror_2 (const CIbyte *reason, Lisp_Object frob1, Lisp_Object frob2)
|
|
563
|
2895 {
|
|
|
2896 signal_error_2 (Qstructure_formation_error, reason, frob1, frob2);
|
|
|
2897 }
|
|
|
2898
|
|
|
2899 void
|
|
867
|
2900 maybe_sferror (const CIbyte *reason, Lisp_Object frob,
|
|
1204
|
2901 Lisp_Object class_, Error_Behavior errb)
|
|
|
2902 {
|
|
|
2903 maybe_signal_error (Qstructure_formation_error, reason, frob, class_, errb);
|
|
442
|
2904 }
|
|
|
2905
|
|
|
2906 DOESNT_RETURN
|
|
867
|
2907 invalid_argument (const CIbyte *reason, Lisp_Object frob)
|
|
442
|
2908 {
|
|
563
|
2909 signal_error (Qinvalid_argument, reason, frob);
|
|
442
|
2910 }
|
|
|
2911
|
|
|
2912 DOESNT_RETURN
|
|
867
|
2913 invalid_argument_2 (const CIbyte *reason, Lisp_Object frob1,
|
|
609
|
2914 Lisp_Object frob2)
|
|
442
|
2915 {
|
|
563
|
2916 signal_error_2 (Qinvalid_argument, reason, frob1, frob2);
|
|
|
2917 }
|
|
|
2918
|
|
|
2919 void
|
|
867
|
2920 maybe_invalid_argument (const CIbyte *reason, Lisp_Object frob,
|
|
1204
|
2921 Lisp_Object class_, Error_Behavior errb)
|
|
|
2922 {
|
|
|
2923 maybe_signal_error (Qinvalid_argument, reason, frob, class_, errb);
|
|
563
|
2924 }
|
|
|
2925
|
|
|
2926 DOESNT_RETURN
|
|
867
|
2927 invalid_constant (const CIbyte *reason, Lisp_Object frob)
|
|
563
|
2928 {
|
|
|
2929 signal_error (Qinvalid_constant, reason, frob);
|
|
|
2930 }
|
|
|
2931
|
|
|
2932 DOESNT_RETURN
|
|
867
|
2933 invalid_constant_2 (const CIbyte *reason, Lisp_Object frob1,
|
|
609
|
2934 Lisp_Object frob2)
|
|
563
|
2935 {
|
|
|
2936 signal_error_2 (Qinvalid_constant, reason, frob1, frob2);
|
|
|
2937 }
|
|
|
2938
|
|
|
2939 void
|
|
867
|
2940 maybe_invalid_constant (const CIbyte *reason, Lisp_Object frob,
|
|
1204
|
2941 Lisp_Object class_, Error_Behavior errb)
|
|
|
2942 {
|
|
|
2943 maybe_signal_error (Qinvalid_constant, reason, frob, class_, errb);
|
|
442
|
2944 }
|
|
|
2945
|
|
|
2946 DOESNT_RETURN
|
|
867
|
2947 invalid_operation (const CIbyte *reason, Lisp_Object frob)
|
|
442
|
2948 {
|
|
563
|
2949 signal_error (Qinvalid_operation, reason, frob);
|
|
442
|
2950 }
|
|
|
2951
|
|
|
2952 DOESNT_RETURN
|
|
867
|
2953 invalid_operation_2 (const CIbyte *reason, Lisp_Object frob1,
|
|
609
|
2954 Lisp_Object frob2)
|
|
442
|
2955 {
|
|
563
|
2956 signal_error_2 (Qinvalid_operation, reason, frob1, frob2);
|
|
|
2957 }
|
|
|
2958
|
|
|
2959 void
|
|
867
|
2960 maybe_invalid_operation (const CIbyte *reason, Lisp_Object frob,
|
|
1204
|
2961 Lisp_Object class_, Error_Behavior errb)
|
|
|
2962 {
|
|
|
2963 maybe_signal_error (Qinvalid_operation, reason, frob, class_, errb);
|
|
442
|
2964 }
|
|
|
2965
|
|
|
2966 DOESNT_RETURN
|
|
867
|
2967 invalid_change (const CIbyte *reason, Lisp_Object frob)
|
|
442
|
2968 {
|
|
563
|
2969 signal_error (Qinvalid_change, reason, frob);
|
|
442
|
2970 }
|
|
|
2971
|
|
|
2972 DOESNT_RETURN
|
|
867
|
2973 invalid_change_2 (const CIbyte *reason, Lisp_Object frob1, Lisp_Object frob2)
|
|
442
|
2974 {
|
|
563
|
2975 signal_error_2 (Qinvalid_change, reason, frob1, frob2);
|
|
|
2976 }
|
|
|
2977
|
|
|
2978 void
|
|
867
|
2979 maybe_invalid_change (const CIbyte *reason, Lisp_Object frob,
|
|
1204
|
2980 Lisp_Object class_, Error_Behavior errb)
|
|
|
2981 {
|
|
|
2982 maybe_signal_error (Qinvalid_change, reason, frob, class_, errb);
|
|
563
|
2983 }
|
|
|
2984
|
|
|
2985 DOESNT_RETURN
|
|
867
|
2986 invalid_state (const CIbyte *reason, Lisp_Object frob)
|
|
563
|
2987 {
|
|
|
2988 signal_error (Qinvalid_state, reason, frob);
|
|
|
2989 }
|
|
|
2990
|
|
|
2991 DOESNT_RETURN
|
|
867
|
2992 invalid_state_2 (const CIbyte *reason, Lisp_Object frob1, Lisp_Object frob2)
|
|
563
|
2993 {
|
|
|
2994 signal_error_2 (Qinvalid_state, reason, frob1, frob2);
|
|
|
2995 }
|
|
|
2996
|
|
|
2997 void
|
|
867
|
2998 maybe_invalid_state (const CIbyte *reason, Lisp_Object frob,
|
|
1204
|
2999 Lisp_Object class_, Error_Behavior errb)
|
|
|
3000 {
|
|
|
3001 maybe_signal_error (Qinvalid_state, reason, frob, class_, errb);
|
|
563
|
3002 }
|
|
|
3003
|
|
|
3004 DOESNT_RETURN
|
|
867
|
3005 wtaerror (const CIbyte *reason, Lisp_Object frob)
|
|
563
|
3006 {
|
|
|
3007 signal_error (Qwrong_type_argument, reason, frob);
|
|
|
3008 }
|
|
|
3009
|
|
|
3010 DOESNT_RETURN
|
|
867
|
3011 stack_overflow (const CIbyte *reason, Lisp_Object frob)
|
|
563
|
3012 {
|
|
|
3013 signal_error (Qstack_overflow, reason, frob);
|
|
|
3014 }
|
|
|
3015
|
|
|
3016 DOESNT_RETURN
|
|
867
|
3017 out_of_memory (const CIbyte *reason, Lisp_Object frob)
|
|
563
|
3018 {
|
|
|
3019 signal_error (Qout_of_memory, reason, frob);
|
|
|
3020 }
|
|
|
3021
|
|
|
3022 DOESNT_RETURN
|
|
867
|
3023 printing_unreadable_object (const CIbyte *fmt, ...)
|
|
563
|
3024 {
|
|
|
3025 Lisp_Object obj;
|
|
|
3026 va_list args;
|
|
|
3027
|
|
|
3028 va_start (args, fmt);
|
|
771
|
3029 obj = emacs_vsprintf_string (CGETTEXT (fmt), args);
|
|
563
|
3030 va_end (args);
|
|
|
3031
|
|
|
3032 /* Fsignal GC-protects its args */
|
|
|
3033 signal_error (Qprinting_unreadable_object, 0, obj);
|
|
442
|
3034 }
|
|
|
3035
|
|
428
|
3036
|
|
|
3037 /************************************************************************/
|
|
|
3038 /* User commands */
|
|
|
3039 /************************************************************************/
|
|
|
3040
|
|
|
3041 DEFUN ("commandp", Fcommandp, 1, 1, 0, /*
|
|
|
3042 Return t if FUNCTION makes provisions for interactive calling.
|
|
|
3043 This means it contains a description for how to read arguments to give it.
|
|
|
3044 The value is nil for an invalid function or a symbol with no function
|
|
|
3045 definition.
|
|
|
3046
|
|
|
3047 Interactively callable functions include
|
|
|
3048
|
|
|
3049 -- strings and vectors (treated as keyboard macros)
|
|
|
3050 -- lambda-expressions that contain a top-level call to `interactive'
|
|
|
3051 -- autoload definitions made by `autoload' with non-nil fourth argument
|
|
|
3052 (i.e. the interactive flag)
|
|
|
3053 -- compiled-function objects with a non-nil `compiled-function-interactive'
|
|
|
3054 value
|
|
|
3055 -- subrs (built-in functions) that are interactively callable
|
|
|
3056
|
|
|
3057 Also, a symbol satisfies `commandp' if its function definition does so.
|
|
|
3058 */
|
|
|
3059 (function))
|
|
|
3060 {
|
|
|
3061 Lisp_Object fun = indirect_function (function, 0);
|
|
|
3062
|
|
|
3063 if (COMPILED_FUNCTIONP (fun))
|
|
|
3064 return XCOMPILED_FUNCTION (fun)->flags.interactivep ? Qt : Qnil;
|
|
|
3065
|
|
|
3066 /* Lists may represent commands. */
|
|
|
3067 if (CONSP (fun))
|
|
|
3068 {
|
|
|
3069 Lisp_Object funcar = XCAR (fun);
|
|
|
3070 if (EQ (funcar, Qlambda))
|
|
|
3071 return Fassq (Qinteractive, Fcdr (Fcdr (fun)));
|
|
|
3072 if (EQ (funcar, Qautoload))
|
|
|
3073 return Fcar (Fcdr (Fcdr (Fcdr (fun))));
|
|
|
3074 else
|
|
|
3075 return Qnil;
|
|
|
3076 }
|
|
|
3077
|
|
|
3078 /* Emacs primitives are interactive if their DEFUN specifies an
|
|
|
3079 interactive spec. */
|
|
|
3080 if (SUBRP (fun))
|
|
|
3081 return XSUBR (fun)->prompt ? Qt : Qnil;
|
|
|
3082
|
|
|
3083 /* Strings and vectors are keyboard macros. */
|
|
|
3084 if (VECTORP (fun) || STRINGP (fun))
|
|
|
3085 return Qt;
|
|
|
3086
|
|
|
3087 /* Everything else (including Qunbound) is not a command. */
|
|
|
3088 return Qnil;
|
|
|
3089 }
|
|
|
3090
|
|
|
3091 DEFUN ("command-execute", Fcommand_execute, 1, 3, 0, /*
|
|
|
3092 Execute CMD as an editor command.
|
|
|
3093 CMD must be an object that satisfies the `commandp' predicate.
|
|
|
3094 Optional second arg RECORD-FLAG is as in `call-interactively'.
|
|
|
3095 The argument KEYS specifies the value to use instead of (this-command-keys)
|
|
|
3096 when reading the arguments.
|
|
|
3097 */
|
|
444
|
3098 (cmd, record_flag, keys))
|
|
428
|
3099 {
|
|
|
3100 /* This function can GC */
|
|
|
3101 Lisp_Object prefixarg;
|
|
|
3102 Lisp_Object final = cmd;
|
|
4162
|
3103 PROFILE_DECLARE();
|
|
428
|
3104 struct console *con = XCONSOLE (Vselected_console);
|
|
|
3105
|
|
|
3106 prefixarg = con->prefix_arg;
|
|
|
3107 con->prefix_arg = Qnil;
|
|
|
3108 Vcurrent_prefix_arg = prefixarg;
|
|
|
3109 debug_on_next_call = 0; /* #### from FSFmacs; correct? */
|
|
|
3110
|
|
|
3111 if (SYMBOLP (cmd) && !NILP (Fget (cmd, Qdisabled, Qnil)))
|
|
733
|
3112 return run_hook (Qdisabled_command_hook);
|
|
428
|
3113
|
|
|
3114 for (;;)
|
|
|
3115 {
|
|
|
3116 final = indirect_function (cmd, 1);
|
|
|
3117 if (CONSP (final) && EQ (Fcar (final), Qautoload))
|
|
970
|
3118 {
|
|
|
3119 /* do_autoload GCPROs both arguments */
|
|
|
3120 do_autoload (final, cmd);
|
|
|
3121 }
|
|
428
|
3122 else
|
|
|
3123 break;
|
|
|
3124 }
|
|
|
3125
|
|
|
3126 if (CONSP (final) || SUBRP (final) || COMPILED_FUNCTIONP (final))
|
|
|
3127 {
|
|
|
3128 backtrace.function = &Qcall_interactively;
|
|
|
3129 backtrace.args = &cmd;
|
|
|
3130 backtrace.nargs = 1;
|
|
|
3131 backtrace.evalargs = 0;
|
|
1292
|
3132 backtrace.pdlcount = specpdl_depth ();
|
|
428
|
3133 backtrace.debug_on_exit = 0;
|
|
1292
|
3134 backtrace.function_being_called = 0;
|
|
428
|
3135 PUSH_BACKTRACE (backtrace);
|
|
|
3136
|
|
1292
|
3137 PROFILE_ENTER_FUNCTION ();
|
|
444
|
3138 final = Fcall_interactively (cmd, record_flag, keys);
|
|
1292
|
3139 PROFILE_EXIT_FUNCTION ();
|
|
428
|
3140
|
|
|
3141 POP_BACKTRACE (backtrace);
|
|
|
3142 return final;
|
|
|
3143 }
|
|
|
3144 else if (STRINGP (final) || VECTORP (final))
|
|
|
3145 {
|
|
|
3146 return Fexecute_kbd_macro (final, prefixarg);
|
|
|
3147 }
|
|
|
3148 else
|
|
|
3149 {
|
|
|
3150 Fsignal (Qwrong_type_argument,
|
|
|
3151 Fcons (Qcommandp,
|
|
|
3152 (EQ (cmd, final)
|
|
|
3153 ? list1 (cmd)
|
|
|
3154 : list2 (cmd, final))));
|
|
|
3155 return Qnil;
|
|
|
3156 }
|
|
|
3157 }
|
|
|
3158
|
|
|
3159 DEFUN ("interactive-p", Finteractive_p, 0, 0, 0, /*
|
|
|
3160 Return t if function in which this appears was called interactively.
|
|
|
3161 This means that the function was called with call-interactively (which
|
|
|
3162 includes being called as the binding of a key)
|
|
|
3163 and input is currently coming from the keyboard (not in keyboard macro).
|
|
|
3164 */
|
|
|
3165 ())
|
|
|
3166 {
|
|
|
3167 REGISTER struct backtrace *btp;
|
|
|
3168 REGISTER Lisp_Object fun;
|
|
|
3169
|
|
|
3170 if (!INTERACTIVE)
|
|
|
3171 return Qnil;
|
|
|
3172
|
|
|
3173 /* Unless the object was compiled, skip the frame of interactive-p itself
|
|
|
3174 (if interpreted) or the frame of byte-code (if called from a compiled
|
|
|
3175 function). Note that *btp->function may be a symbol pointing at a
|
|
|
3176 compiled function. */
|
|
|
3177 btp = backtrace_list;
|
|
|
3178
|
|
|
3179 #if 0 /* FSFmacs */
|
|
|
3180
|
|
|
3181 /* #### FSFmacs does the following instead. I can't figure
|
|
|
3182 out which one is more correct. */
|
|
|
3183 /* If this isn't a byte-compiled function, there may be a frame at
|
|
|
3184 the top for Finteractive_p itself. If so, skip it. */
|
|
|
3185 fun = Findirect_function (*btp->function);
|
|
|
3186 if (SUBRP (fun) && XSUBR (fun) == &Sinteractive_p)
|
|
|
3187 btp = btp->next;
|
|
|
3188
|
|
|
3189 /* If we're running an Emacs 18-style byte-compiled function, there
|
|
|
3190 may be a frame for Fbyte_code. Now, given the strictest
|
|
|
3191 definition, this function isn't really being called
|
|
|
3192 interactively, but because that's the way Emacs 18 always builds
|
|
|
3193 byte-compiled functions, we'll accept it for now. */
|
|
|
3194 if (EQ (*btp->function, Qbyte_code))
|
|
|
3195 btp = btp->next;
|
|
|
3196
|
|
|
3197 /* If this isn't a byte-compiled function, then we may now be
|
|
|
3198 looking at several frames for special forms. Skip past them. */
|
|
|
3199 while (btp &&
|
|
|
3200 btp->nargs == UNEVALLED)
|
|
|
3201 btp = btp->next;
|
|
|
3202
|
|
|
3203 #else
|
|
|
3204
|
|
|
3205 if (! (COMPILED_FUNCTIONP (Findirect_function (*btp->function))))
|
|
|
3206 btp = btp->next;
|
|
|
3207 for (;
|
|
|
3208 btp && (btp->nargs == UNEVALLED
|
|
|
3209 || EQ (*btp->function, Qbyte_code));
|
|
|
3210 btp = btp->next)
|
|
|
3211 {}
|
|
|
3212 /* btp now points at the frame of the innermost function
|
|
|
3213 that DOES eval its args.
|
|
|
3214 If it is a built-in function (such as load or eval-region)
|
|
|
3215 return nil. */
|
|
|
3216 /* Beats me why this is necessary, but it is */
|
|
|
3217 if (btp && EQ (*btp->function, Qcall_interactively))
|
|
|
3218 return Qt;
|
|
|
3219
|
|
|
3220 #endif
|
|
|
3221
|
|
|
3222 fun = Findirect_function (*btp->function);
|
|
|
3223 if (SUBRP (fun))
|
|
|
3224 return Qnil;
|
|
|
3225 /* btp points to the frame of a Lisp function that called interactive-p.
|
|
|
3226 Return t if that function was called interactively. */
|
|
|
3227 if (btp && btp->next && EQ (*btp->next->function, Qcall_interactively))
|
|
|
3228 return Qt;
|
|
|
3229 return Qnil;
|
|
|
3230 }
|
|
|
3231
|
|
|
3232
|
|
|
3233 /************************************************************************/
|
|
|
3234 /* Autoloading */
|
|
|
3235 /************************************************************************/
|
|
|
3236
|
|
|
3237 DEFUN ("autoload", Fautoload, 2, 5, 0, /*
|
|
444
|
3238 Define FUNCTION to autoload from FILENAME.
|
|
|
3239 FUNCTION is a symbol; FILENAME is a file name string to pass to `load'.
|
|
|
3240 The remaining optional arguments provide additional info about the
|
|
|
3241 real definition.
|
|
|
3242 DOCSTRING is documentation for FUNCTION.
|
|
|
3243 INTERACTIVE, if non-nil, says FUNCTION can be called interactively.
|
|
|
3244 TYPE indicates the type of the object:
|
|
428
|
3245 nil or omitted says FUNCTION is a function,
|
|
|
3246 `keymap' says FUNCTION is really a keymap, and
|
|
|
3247 `macro' or t says FUNCTION is really a macro.
|
|
444
|
3248 If FUNCTION already has a non-void function definition that is not an
|
|
|
3249 autoload object, this function does nothing and returns nil.
|
|
428
|
3250 */
|
|
444
|
3251 (function, filename, docstring, interactive, type))
|
|
428
|
3252 {
|
|
|
3253 /* This function can GC */
|
|
|
3254 CHECK_SYMBOL (function);
|
|
444
|
3255 CHECK_STRING (filename);
|
|
428
|
3256
|
|
|
3257 /* If function is defined and not as an autoload, don't override */
|
|
|
3258 {
|
|
|
3259 Lisp_Object f = XSYMBOL (function)->function;
|
|
|
3260 if (!UNBOUNDP (f) && !(CONSP (f) && EQ (XCAR (f), Qautoload)))
|
|
|
3261 return Qnil;
|
|
|
3262 }
|
|
|
3263
|
|
|
3264 if (purify_flag)
|
|
|
3265 {
|
|
|
3266 /* Attempt to avoid consing identical (string=) pure strings. */
|
|
444
|
3267 filename = Fsymbol_name (Fintern (filename, Qnil));
|
|
428
|
3268 }
|
|
440
|
3269
|
|
444
|
3270 return Ffset (function, Fcons (Qautoload, list4 (filename,
|
|
428
|
3271 docstring,
|
|
|
3272 interactive,
|
|
|
3273 type)));
|
|
|
3274 }
|
|
|
3275
|
|
|
3276 Lisp_Object
|
|
|
3277 un_autoload (Lisp_Object oldqueue)
|
|
|
3278 {
|
|
|
3279 /* This function can GC */
|
|
|
3280 REGISTER Lisp_Object queue, first, second;
|
|
|
3281
|
|
|
3282 /* Queue to unwind is current value of Vautoload_queue.
|
|
|
3283 oldqueue is the shadowed value to leave in Vautoload_queue. */
|
|
|
3284 queue = Vautoload_queue;
|
|
|
3285 Vautoload_queue = oldqueue;
|
|
|
3286 while (CONSP (queue))
|
|
|
3287 {
|
|
|
3288 first = XCAR (queue);
|
|
|
3289 second = Fcdr (first);
|
|
|
3290 first = Fcar (first);
|
|
|
3291 if (NILP (second))
|
|
|
3292 Vfeatures = first;
|
|
|
3293 else
|
|
|
3294 Ffset (first, second);
|
|
|
3295 queue = Fcdr (queue);
|
|
|
3296 }
|
|
|
3297 return Qnil;
|
|
|
3298 }
|
|
|
3299
|
|
970
|
3300 /* do_autoload GCPROs both arguments */
|
|
428
|
3301 void
|
|
|
3302 do_autoload (Lisp_Object fundef,
|
|
|
3303 Lisp_Object funname)
|
|
|
3304 {
|
|
|
3305 /* This function can GC */
|
|
|
3306 int speccount = specpdl_depth();
|
|
|
3307 Lisp_Object fun = funname;
|
|
970
|
3308 struct gcpro gcpro1, gcpro2, gcpro3;
|
|
428
|
3309
|
|
|
3310 CHECK_SYMBOL (funname);
|
|
970
|
3311 GCPRO3 (fundef, funname, fun);
|
|
428
|
3312
|
|
|
3313 /* Value saved here is to be restored into Vautoload_queue */
|
|
|
3314 record_unwind_protect (un_autoload, Vautoload_queue);
|
|
|
3315 Vautoload_queue = Qt;
|
|
|
3316 call4 (Qload, Fcar (Fcdr (fundef)), Qnil, noninteractive ? Qt : Qnil, Qnil);
|
|
|
3317
|
|
|
3318 {
|
|
|
3319 Lisp_Object queue;
|
|
|
3320
|
|
|
3321 /* Save the old autoloads, in case we ever do an unload. */
|
|
|
3322 for (queue = Vautoload_queue; CONSP (queue); queue = XCDR (queue))
|
|
|
3323 {
|
|
|
3324 Lisp_Object first = XCAR (queue);
|
|
|
3325 Lisp_Object second = Fcdr (first);
|
|
|
3326
|
|
|
3327 first = Fcar (first);
|
|
|
3328
|
|
|
3329 /* Note: This test is subtle. The cdr of an autoload-queue entry
|
|
|
3330 may be an atom if the autoload entry was generated by a defalias
|
|
|
3331 or fset. */
|
|
|
3332 if (CONSP (second))
|
|
|
3333 Fput (first, Qautoload, (XCDR (second)));
|
|
|
3334 }
|
|
|
3335 }
|
|
|
3336
|
|
|
3337 /* Once loading finishes, don't undo it. */
|
|
|
3338 Vautoload_queue = Qt;
|
|
771
|
3339 unbind_to (speccount);
|
|
428
|
3340
|
|
|
3341 fun = indirect_function (fun, 0);
|
|
|
3342
|
|
|
3343 #if 0 /* FSFmacs */
|
|
|
3344 if (!NILP (Fequal (fun, fundef)))
|
|
|
3345 #else
|
|
|
3346 if (UNBOUNDP (fun)
|
|
|
3347 || (CONSP (fun)
|
|
|
3348 && EQ (XCAR (fun), Qautoload)))
|
|
|
3349 #endif
|
|
563
|
3350 invalid_state ("Autoloading failed to define function", funname);
|
|
428
|
3351 UNGCPRO;
|
|
|
3352 }
|
|
|
3353
|
|
|
3354
|
|
|
3355 /************************************************************************/
|
|
|
3356 /* eval, funcall, apply */
|
|
|
3357 /************************************************************************/
|
|
|
3358
|
|
814
|
3359 /* NOTE: If you are hearing the endless complaint that function calls in
|
|
|
3360 elisp are extremely slow, it just isn't true any more! The stuff below
|
|
|
3361 -- in particular, the calling of subrs and compiled functions, the most
|
|
|
3362 common cases -- has been highly optimized. There isn't a whole lot left
|
|
|
3363 to do to squeeze more speed out except by switching to lexical
|
|
|
3364 variables, which would eliminate the specbind loop. (But the real gain
|
|
|
3365 from lexical variables would come from better optimization -- with
|
|
|
3366 dynamic binding, you have the constant problem that any function call
|
|
|
3367 that you haven't explicitly proven to be side-effect-free might
|
|
|
3368 potentially side effect your local variables, which makes optimization
|
|
|
3369 extremely difficult when there are function calls anywhere in a chunk of
|
|
|
3370 code to be optimized. Even worse, you don't know that *your* local
|
|
|
3371 variables aren't side-effecting an outer function's local variables, so
|
|
|
3372 it's impossible to optimize away almost *any* variable assignment.) */
|
|
|
3373
|
|
428
|
3374 static Lisp_Object funcall_lambda (Lisp_Object fun,
|
|
442
|
3375 int nargs, Lisp_Object args[]);
|
|
428
|
3376 static int in_warnings;
|
|
|
3377
|
|
|
3378
|
|
814
|
3379 void handle_compiled_function_with_and_rest (Lisp_Compiled_Function *f,
|
|
|
3380 int nargs,
|
|
|
3381 Lisp_Object args[]);
|
|
|
3382
|
|
|
3383 /* The theory behind making this a separate function is to shrink
|
|
|
3384 funcall_compiled_function() so as to increase the likelihood of a cache
|
|
|
3385 hit in the L1 cache -- &rest processing is not going to be fast anyway.
|
|
|
3386 The idea is the same as with execute_rare_opcode() in bytecode.c. We
|
|
|
3387 make this non-static to ensure the compiler doesn't inline it. */
|
|
|
3388
|
|
|
3389 void
|
|
|
3390 handle_compiled_function_with_and_rest (Lisp_Compiled_Function *f, int nargs,
|
|
|
3391 Lisp_Object args[])
|
|
|
3392 {
|
|
|
3393 REGISTER int i = 0;
|
|
|
3394 int max_non_rest_args = f->args_in_array - 1;
|
|
|
3395 int bindargs = min (nargs, max_non_rest_args);
|
|
|
3396
|
|
|
3397 for (i = 0; i < bindargs; i++)
|
|
3092
|
3398 #ifdef NEW_GC
|
|
|
3399 SPECBIND_FAST_UNSAFE (XCOMPILED_FUNCTION_ARGS_DATA (f->arguments)[i],
|
|
|
3400 args[i]);
|
|
|
3401 #else /* not NEW_GC */
|
|
814
|
3402 SPECBIND_FAST_UNSAFE (f->args[i], args[i]);
|
|
3092
|
3403 #endif /* not NEW_GC */
|
|
814
|
3404 for (i = bindargs; i < max_non_rest_args; i++)
|
|
3092
|
3405 #ifdef NEW_GC
|
|
|
3406 SPECBIND_FAST_UNSAFE (XCOMPILED_FUNCTION_ARGS_DATA (f->arguments)[i],
|
|
|
3407 Qnil);
|
|
|
3408 #else /* not NEW_GC */
|
|
814
|
3409 SPECBIND_FAST_UNSAFE (f->args[i], Qnil);
|
|
3092
|
3410 #endif /* not NEW_GC */
|
|
|
3411 #ifdef NEW_GC
|
|
|
3412 SPECBIND_FAST_UNSAFE
|
|
|
3413 (XCOMPILED_FUNCTION_ARGS_DATA (f->arguments)[max_non_rest_args],
|
|
|
3414 nargs > max_non_rest_args ?
|
|
|
3415 Flist (nargs - max_non_rest_args, &args[max_non_rest_args]) :
|
|
|
3416 Qnil);
|
|
|
3417 #else /* not NEW_GC */
|
|
814
|
3418 SPECBIND_FAST_UNSAFE
|
|
|
3419 (f->args[max_non_rest_args],
|
|
|
3420 nargs > max_non_rest_args ?
|
|
|
3421 Flist (nargs - max_non_rest_args, &args[max_non_rest_args]) :
|
|
|
3422 Qnil);
|
|
3092
|
3423 #endif /* not NEW_GC */
|
|
814
|
3424 }
|
|
|
3425
|
|
|
3426 /* Apply compiled-function object FUN to the NARGS evaluated arguments
|
|
|
3427 in ARGS, and return the result of evaluation. */
|
|
|
3428 inline static Lisp_Object
|
|
|
3429 funcall_compiled_function (Lisp_Object fun, int nargs, Lisp_Object args[])
|
|
|
3430 {
|
|
|
3431 /* This function can GC */
|
|
|
3432 int speccount = specpdl_depth();
|
|
|
3433 REGISTER int i = 0;
|
|
|
3434 Lisp_Compiled_Function *f = XCOMPILED_FUNCTION (fun);
|
|
|
3435
|
|
|
3436 if (!OPAQUEP (f->instructions))
|
|
|
3437 /* Lazily munge the instructions into a more efficient form */
|
|
|
3438 optimize_compiled_function (fun);
|
|
|
3439
|
|
|
3440 /* optimize_compiled_function() guaranteed that f->specpdl_depth is
|
|
|
3441 the required space on the specbinding stack for binding the args
|
|
|
3442 and local variables of fun. So just reserve it once. */
|
|
|
3443 SPECPDL_RESERVE (f->specpdl_depth);
|
|
|
3444
|
|
|
3445 if (nargs == f->max_args) /* Optimize for the common case -- no unspecified
|
|
|
3446 optional arguments. */
|
|
|
3447 {
|
|
|
3448 #if 1
|
|
|
3449 for (i = 0; i < nargs; i++)
|
|
3092
|
3450 #ifdef NEW_GC
|
|
|
3451 SPECBIND_FAST_UNSAFE (XCOMPILED_FUNCTION_ARGS_DATA (f->arguments)[i],
|
|
|
3452 args[i]);
|
|
|
3453 #else /* not NEW_GC */
|
|
814
|
3454 SPECBIND_FAST_UNSAFE (f->args[i], args[i]);
|
|
3092
|
3455 #endif /* not NEW_GC */
|
|
814
|
3456 #else
|
|
|
3457 /* Here's an alternate way to write the loop that tries to further
|
|
|
3458 optimize funcalls for functions with few arguments by partially
|
|
|
3459 unrolling the loop. It's not clear whether this is a win since it
|
|
|
3460 increases the size of the function and the possibility of L1 cache
|
|
|
3461 misses. (Microsoft VC++ 6 with /O2 /G5 generates 0x90 == 144 bytes
|
|
|
3462 per SPECBIND_FAST_UNSAFE().) Tests under VC++ 6, running the byte
|
|
|
3463 compiler repeatedly and looking at the total time, show very
|
|
|
3464 little difference between the simple loop above, the unrolled code
|
|
|
3465 below, and a "partly unrolled" solution with only cases 0-2 below
|
|
|
3466 instead of 0-4. Therefore, I'm keeping it at the simple loop
|
|
|
3467 because it's smaller. */
|
|
|
3468 switch (nargs)
|
|
|
3469 {
|
|
|
3470 default:
|
|
|
3471 for (i = nargs - 1; i >= 4; i--)
|
|
|
3472 SPECBIND_FAST_UNSAFE (f->args[i], args[i]);
|
|
|
3473 case 4: SPECBIND_FAST_UNSAFE (f->args[3], args[3]);
|
|
|
3474 case 3: SPECBIND_FAST_UNSAFE (f->args[2], args[2]);
|
|
|
3475 case 2: SPECBIND_FAST_UNSAFE (f->args[1], args[1]);
|
|
|
3476 case 1: SPECBIND_FAST_UNSAFE (f->args[0], args[0]);
|
|
|
3477 case 0: break;
|
|
|
3478 }
|
|
|
3479 #endif
|
|
|
3480 }
|
|
|
3481 else if (nargs < f->min_args)
|
|
|
3482 goto wrong_number_of_arguments;
|
|
|
3483 else if (nargs < f->max_args)
|
|
|
3484 {
|
|
|
3485 for (i = 0; i < nargs; i++)
|
|
3092
|
3486 #ifdef NEW_GC
|
|
|
3487 SPECBIND_FAST_UNSAFE (XCOMPILED_FUNCTION_ARGS_DATA (f->arguments)[i],
|
|
|
3488 args[i]);
|
|
|
3489 #else /* not NEW_GC */
|
|
814
|
3490 SPECBIND_FAST_UNSAFE (f->args[i], args[i]);
|
|
3092
|
3491 #endif /* not NEW_GC */
|
|
814
|
3492 for (i = nargs; i < f->max_args; i++)
|
|
3092
|
3493 #ifdef NEW_GC
|
|
|
3494 SPECBIND_FAST_UNSAFE (XCOMPILED_FUNCTION_ARGS_DATA (f->arguments)[i],
|
|
|
3495 Qnil);
|
|
|
3496 #else /* not NEW_GC */
|
|
814
|
3497 SPECBIND_FAST_UNSAFE (f->args[i], Qnil);
|
|
3092
|
3498 #endif /* not NEW_GC */
|
|
814
|
3499 }
|
|
|
3500 else if (f->max_args == MANY)
|
|
|
3501 handle_compiled_function_with_and_rest (f, nargs, args);
|
|
|
3502 else
|
|
|
3503 {
|
|
|
3504 wrong_number_of_arguments:
|
|
|
3505 /* The actual printed compiled_function object is incomprehensible.
|
|
|
3506 Check the backtrace to see if we can get a more meaningful symbol. */
|
|
|
3507 if (EQ (fun, indirect_function (*backtrace_list->function, 0)))
|
|
|
3508 fun = *backtrace_list->function;
|
|
|
3509 return Fsignal (Qwrong_number_of_arguments,
|
|
|
3510 list2 (fun, make_int (nargs)));
|
|
|
3511 }
|
|
|
3512
|
|
|
3513 {
|
|
|
3514 Lisp_Object value =
|
|
|
3515 execute_optimized_program ((Opbyte *) XOPAQUE_DATA (f->instructions),
|
|
|
3516 f->stack_depth,
|
|
|
3517 XVECTOR_DATA (f->constants));
|
|
|
3518
|
|
|
3519 /* The attempt to optimize this by only unbinding variables failed
|
|
|
3520 because using buffer-local variables as function parameters
|
|
|
3521 leads to specpdl_ptr->func != 0 */
|
|
|
3522 /* UNBIND_TO_GCPRO_VARIABLES_ONLY (speccount, value); */
|
|
|
3523 UNBIND_TO_GCPRO (speccount, value);
|
|
|
3524 return value;
|
|
|
3525 }
|
|
|
3526 }
|
|
|
3527
|
|
428
|
3528 DEFUN ("eval", Feval, 1, 1, 0, /*
|
|
|
3529 Evaluate FORM and return its value.
|
|
|
3530 */
|
|
|
3531 (form))
|
|
|
3532 {
|
|
|
3533 /* This function can GC */
|
|
|
3534 Lisp_Object fun, val, original_fun, original_args;
|
|
|
3535 int nargs;
|
|
4162
|
3536 PROFILE_DECLARE();
|
|
428
|
3537
|
|
1318
|
3538 #ifdef ERROR_CHECK_TRAPPING_PROBLEMS
|
|
|
3539 check_proper_critical_section_lisp_protection ();
|
|
|
3540 #endif
|
|
|
3541
|
|
3989
|
3542 if (!CONSP (form))
|
|
|
3543 {
|
|
|
3544 if (SYMBOLP (form))
|
|
|
3545 {
|
|
|
3546 return Fsymbol_value (form);
|
|
|
3547 }
|
|
|
3548
|
|
|
3549 return form;
|
|
|
3550 }
|
|
|
3551
|
|
428
|
3552 /* I think this is a pretty safe place to call Lisp code, don't you? */
|
|
853
|
3553 while (!in_warnings && !NILP (Vpending_warnings)
|
|
|
3554 /* well, perhaps not so safe after all! */
|
|
|
3555 && !(inhibit_flags & INHIBIT_ANY_CHANGE_AFFECTING_REDISPLAY))
|
|
428
|
3556 {
|
|
|
3557 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
|
|
1204
|
3558 Lisp_Object this_warning_cons, this_warning, class_, level, messij;
|
|
853
|
3559 int speccount = internal_bind_int (&in_warnings, 1);
|
|
|
3560
|
|
428
|
3561 this_warning_cons = Vpending_warnings;
|
|
|
3562 this_warning = XCAR (this_warning_cons);
|
|
|
3563 /* in case an error occurs in the warn function, at least
|
|
|
3564 it won't happen infinitely */
|
|
|
3565 Vpending_warnings = XCDR (Vpending_warnings);
|
|
853
|
3566 free_cons (this_warning_cons);
|
|
1204
|
3567 class_ = XCAR (this_warning);
|
|
428
|
3568 level = XCAR (XCDR (this_warning));
|
|
|
3569 messij = XCAR (XCDR (XCDR (this_warning)));
|
|
|
3570 free_list (this_warning);
|
|
|
3571
|
|
|
3572 if (NILP (Vpending_warnings))
|
|
|
3573 Vpending_warnings_tail = Qnil; /* perhaps not strictly necessary,
|
|
|
3574 but safer */
|
|
|
3575
|
|
1204
|
3576 GCPRO4 (form, class_, level, messij);
|
|
428
|
3577 if (!STRINGP (messij))
|
|
|
3578 messij = Fprin1_to_string (messij, Qnil);
|
|
1204
|
3579 call3 (Qdisplay_warning, class_, messij, level);
|
|
428
|
3580 UNGCPRO;
|
|
771
|
3581 unbind_to (speccount);
|
|
428
|
3582 }
|
|
|
3583
|
|
|
3584 QUIT;
|
|
814
|
3585 if (need_to_garbage_collect)
|
|
428
|
3586 {
|
|
|
3587 struct gcpro gcpro1;
|
|
|
3588 GCPRO1 (form);
|
|
3092
|
3589 #ifdef NEW_GC
|
|
|
3590 gc_incremental ();
|
|
|
3591 #else /* not NEW_GC */
|
|
428
|
3592 garbage_collect_1 ();
|
|
3092
|
3593 #endif /* not NEW_GC */
|
|
428
|
3594 UNGCPRO;
|
|
|
3595 }
|
|
|
3596
|
|
|
3597 if (++lisp_eval_depth > max_lisp_eval_depth)
|
|
|
3598 {
|
|
|
3599 if (max_lisp_eval_depth < 100)
|
|
|
3600 max_lisp_eval_depth = 100;
|
|
|
3601 if (lisp_eval_depth > max_lisp_eval_depth)
|
|
563
|
3602 stack_overflow ("Lisp nesting exceeds `max-lisp-eval-depth'",
|
|
|
3603 Qunbound);
|
|
428
|
3604 }
|
|
|
3605
|
|
|
3606 /* We guaranteed CONSP (form) above */
|
|
|
3607 original_fun = XCAR (form);
|
|
|
3608 original_args = XCDR (form);
|
|
|
3609
|
|
|
3610 GET_EXTERNAL_LIST_LENGTH (original_args, nargs);
|
|
|
3611
|
|
|
3612 backtrace.pdlcount = specpdl_depth();
|
|
|
3613 backtrace.function = &original_fun; /* This also protects them from gc */
|
|
|
3614 backtrace.args = &original_args;
|
|
|
3615 backtrace.nargs = UNEVALLED;
|
|
|
3616 backtrace.evalargs = 1;
|
|
|
3617 backtrace.debug_on_exit = 0;
|
|
1292
|
3618 backtrace.function_being_called = 0;
|
|
428
|
3619 PUSH_BACKTRACE (backtrace);
|
|
|
3620
|
|
|
3621 if (debug_on_next_call)
|
|
|
3622 do_debug_on_call (Qt);
|
|
|
3623
|
|
|
3624 /* At this point, only original_fun and original_args
|
|
|
3625 have values that will be used below. */
|
|
|
3626 retry:
|
|
3989
|
3627 /* Optimise for no indirection. */
|
|
|
3628 fun = original_fun;
|
|
|
3629 if (SYMBOLP (fun) && !EQ (fun, Qunbound)
|
|
|
3630 && (fun = XSYMBOL (fun)->function, SYMBOLP (fun)))
|
|
|
3631 {
|
|
|
3632 fun = indirect_function(original_fun, 1);
|
|
|
3633 }
|
|
428
|
3634
|
|
|
3635 if (SUBRP (fun))
|
|
|
3636 {
|
|
|
3637 Lisp_Subr *subr = XSUBR (fun);
|
|
|
3638 int max_args = subr->max_args;
|
|
|
3639
|
|
|
3640 if (nargs < subr->min_args)
|
|
|
3641 goto wrong_number_of_arguments;
|
|
|
3642
|
|
|
3643 if (max_args == UNEVALLED) /* Optimize for the common case */
|
|
|
3644 {
|
|
|
3645 backtrace.evalargs = 0;
|
|
1292
|
3646 PROFILE_ENTER_FUNCTION ();
|
|
428
|
3647 val = (((Lisp_Object (*) (Lisp_Object)) subr_function (subr))
|
|
|
3648 (original_args));
|
|
1292
|
3649 PROFILE_EXIT_FUNCTION ();
|
|
428
|
3650 }
|
|
|
3651 else if (nargs <= max_args)
|
|
|
3652 {
|
|
|
3653 struct gcpro gcpro1;
|
|
|
3654 Lisp_Object args[SUBR_MAX_ARGS];
|
|
|
3655 REGISTER Lisp_Object *p = args;
|
|
|
3656
|
|
|
3657 GCPRO1 (args[0]);
|
|
|
3658 gcpro1.nvars = 0;
|
|
|
3659
|
|
|
3660 {
|
|
|
3661 LIST_LOOP_2 (arg, original_args)
|
|
|
3662 {
|
|
|
3663 *p++ = Feval (arg);
|
|
|
3664 gcpro1.nvars++;
|
|
|
3665 }
|
|
|
3666 }
|
|
|
3667
|
|
|
3668 /* &optional args default to nil. */
|
|
|
3669 while (p - args < max_args)
|
|
|
3670 *p++ = Qnil;
|
|
|
3671
|
|
|
3672 backtrace.args = args;
|
|
|
3673 backtrace.nargs = nargs;
|
|
|
3674
|
|
1292
|
3675 PROFILE_ENTER_FUNCTION ();
|
|
428
|
3676 FUNCALL_SUBR (val, subr, args, max_args);
|
|
1292
|
3677 PROFILE_EXIT_FUNCTION ();
|
|
428
|
3678
|
|
|
3679 UNGCPRO;
|
|
|
3680 }
|
|
|
3681 else if (max_args == MANY)
|
|
|
3682 {
|
|
|
3683 /* Pass a vector of evaluated arguments */
|
|
|
3684 struct gcpro gcpro1;
|
|
|
3685 Lisp_Object *args = alloca_array (Lisp_Object, nargs);
|
|
|
3686 REGISTER Lisp_Object *p = args;
|
|
|
3687
|
|
|
3688 GCPRO1 (args[0]);
|
|
|
3689 gcpro1.nvars = 0;
|
|
|
3690
|
|
|
3691 {
|
|
|
3692 LIST_LOOP_2 (arg, original_args)
|
|
|
3693 {
|
|
|
3694 *p++ = Feval (arg);
|
|
|
3695 gcpro1.nvars++;
|
|
|
3696 }
|
|
|
3697 }
|
|
|
3698
|
|
|
3699 backtrace.args = args;
|
|
|
3700 backtrace.nargs = nargs;
|
|
|
3701
|
|
1292
|
3702 PROFILE_ENTER_FUNCTION ();
|
|
428
|
3703 val = (((Lisp_Object (*) (int, Lisp_Object *)) subr_function (subr))
|
|
|
3704 (nargs, args));
|
|
1292
|
3705 PROFILE_EXIT_FUNCTION ();
|
|
428
|
3706
|
|
|
3707 UNGCPRO;
|
|
|
3708 }
|
|
|
3709 else
|
|
|
3710 {
|
|
|
3711 wrong_number_of_arguments:
|
|
440
|
3712 val = signal_wrong_number_of_arguments_error (original_fun, nargs);
|
|
428
|
3713 }
|
|
|
3714 }
|
|
|
3715 else if (COMPILED_FUNCTIONP (fun))
|
|
|
3716 {
|
|
|
3717 struct gcpro gcpro1;
|
|
|
3718 Lisp_Object *args = alloca_array (Lisp_Object, nargs);
|
|
|
3719 REGISTER Lisp_Object *p = args;
|
|
|
3720
|
|
|
3721 GCPRO1 (args[0]);
|
|
|
3722 gcpro1.nvars = 0;
|
|
|
3723
|
|
|
3724 {
|
|
|
3725 LIST_LOOP_2 (arg, original_args)
|
|
|
3726 {
|
|
|
3727 *p++ = Feval (arg);
|
|
|
3728 gcpro1.nvars++;
|
|
|
3729 }
|
|
|
3730 }
|
|
|
3731
|
|
|
3732 backtrace.args = args;
|
|
|
3733 backtrace.nargs = nargs;
|
|
|
3734 backtrace.evalargs = 0;
|
|
|
3735
|
|
1292
|
3736 PROFILE_ENTER_FUNCTION ();
|
|
428
|
3737 val = funcall_compiled_function (fun, nargs, args);
|
|
1292
|
3738 PROFILE_EXIT_FUNCTION ();
|
|
428
|
3739
|
|
|
3740 /* Do the debug-on-exit now, while args is still GCPROed. */
|
|
|
3741 if (backtrace.debug_on_exit)
|
|
|
3742 val = do_debug_on_exit (val);
|
|
|
3743 /* Don't do it again when we return to eval. */
|
|
|
3744 backtrace.debug_on_exit = 0;
|
|
|
3745
|
|
|
3746 UNGCPRO;
|
|
|
3747 }
|
|
|
3748 else if (CONSP (fun))
|
|
|
3749 {
|
|
|
3750 Lisp_Object funcar = XCAR (fun);
|
|
|
3751
|
|
|
3752 if (EQ (funcar, Qautoload))
|
|
|
3753 {
|
|
970
|
3754 /* do_autoload GCPROs both arguments */
|
|
428
|
3755 do_autoload (fun, original_fun);
|
|
|
3756 goto retry;
|
|
|
3757 }
|
|
|
3758 else if (EQ (funcar, Qmacro))
|
|
|
3759 {
|
|
1292
|
3760 PROFILE_ENTER_FUNCTION ();
|
|
428
|
3761 val = Feval (apply1 (XCDR (fun), original_args));
|
|
1292
|
3762 PROFILE_EXIT_FUNCTION ();
|
|
428
|
3763 }
|
|
|
3764 else if (EQ (funcar, Qlambda))
|
|
|
3765 {
|
|
|
3766 struct gcpro gcpro1;
|
|
|
3767 Lisp_Object *args = alloca_array (Lisp_Object, nargs);
|
|
|
3768 REGISTER Lisp_Object *p = args;
|
|
|
3769
|
|
|
3770 GCPRO1 (args[0]);
|
|
|
3771 gcpro1.nvars = 0;
|
|
|
3772
|
|
|
3773 {
|
|
|
3774 LIST_LOOP_2 (arg, original_args)
|
|
|
3775 {
|
|
|
3776 *p++ = Feval (arg);
|
|
|
3777 gcpro1.nvars++;
|
|
|
3778 }
|
|
|
3779 }
|
|
|
3780
|
|
|
3781 UNGCPRO;
|
|
|
3782
|
|
|
3783 backtrace.args = args; /* this also GCPROs `args' */
|
|
|
3784 backtrace.nargs = nargs;
|
|
|
3785 backtrace.evalargs = 0;
|
|
|
3786
|
|
1292
|
3787 PROFILE_ENTER_FUNCTION ();
|
|
428
|
3788 val = funcall_lambda (fun, nargs, args);
|
|
1292
|
3789 PROFILE_EXIT_FUNCTION ();
|
|
428
|
3790
|
|
|
3791 /* Do the debug-on-exit now, while args is still GCPROed. */
|
|
|
3792 if (backtrace.debug_on_exit)
|
|
|
3793 val = do_debug_on_exit (val);
|
|
|
3794 /* Don't do it again when we return to eval. */
|
|
|
3795 backtrace.debug_on_exit = 0;
|
|
|
3796 }
|
|
|
3797 else
|
|
|
3798 {
|
|
|
3799 goto invalid_function;
|
|
|
3800 }
|
|
|
3801 }
|
|
4104
|
3802 else if (UNBOUNDP (fun))
|
|
|
3803 {
|
|
|
3804 val = signal_void_function_error (original_fun);
|
|
|
3805 }
|
|
|
3806 else /* ! (SUBRP (fun) || COMPILED_FUNCTIONP (fun) || CONSP (fun)
|
|
|
3807 UNBOUNDP (fun)) */
|
|
428
|
3808 {
|
|
|
3809 invalid_function:
|
|
436
|
3810 val = signal_invalid_function_error (fun);
|
|
428
|
3811 }
|
|
|
3812
|
|
|
3813 lisp_eval_depth--;
|
|
|
3814 if (backtrace.debug_on_exit)
|
|
|
3815 val = do_debug_on_exit (val);
|
|
|
3816 POP_BACKTRACE (backtrace);
|
|
|
3817 return val;
|
|
|
3818 }
|
|
|
3819
|
|
|
3820
|
|
1111
|
3821
|
|
|
3822 static void
|
|
|
3823 run_post_gc_hook (void)
|
|
|
3824 {
|
|
|
3825 Lisp_Object args[2];
|
|
|
3826
|
|
|
3827 args[0] = Qpost_gc_hook;
|
|
|
3828 args[1] = Fcons (Fcons (Qfinalize_list, zap_finalize_list ()), Qnil);
|
|
|
3829
|
|
|
3830 run_hook_with_args_trapping_problems
|
|
1333
|
3831 (Qgarbage_collecting, 2, args, RUN_HOOKS_TO_COMPLETION,
|
|
1111
|
3832 INHIBIT_QUIT | NO_INHIBIT_ERRORS);
|
|
|
3833 }
|
|
|
3834
|
|
428
|
3835 DEFUN ("funcall", Ffuncall, 1, MANY, 0, /*
|
|
|
3836 Call first argument as a function, passing the remaining arguments to it.
|
|
|
3837 Thus, (funcall 'cons 'x 'y) returns (x . y).
|
|
|
3838 */
|
|
|
3839 (int nargs, Lisp_Object *args))
|
|
|
3840 {
|
|
|
3841 /* This function can GC */
|
|
|
3842 Lisp_Object fun;
|
|
|
3843 Lisp_Object val;
|
|
4162
|
3844 PROFILE_DECLARE();
|
|
428
|
3845 int fun_nargs = nargs - 1;
|
|
|
3846 Lisp_Object *fun_args = args + 1;
|
|
|
3847
|
|
1318
|
3848 /* QUIT will check for proper redisplay wrapping */
|
|
|
3849
|
|
428
|
3850 QUIT;
|
|
851
|
3851
|
|
|
3852 if (funcall_allocation_flag)
|
|
|
3853 {
|
|
|
3854 if (need_to_garbage_collect)
|
|
|
3855 /* Callers should gcpro lexpr args */
|
|
3092
|
3856 #ifdef NEW_GC
|
|
|
3857 gc_incremental ();
|
|
|
3858 #else /* not NEW_GC */
|
|
851
|
3859 garbage_collect_1 ();
|
|
3092
|
3860 #endif /* not NEW_GC */
|
|
851
|
3861 if (need_to_check_c_alloca)
|
|
|
3862 {
|
|
|
3863 if (++funcall_alloca_count >= MAX_FUNCALLS_BETWEEN_ALLOCA_CLEANUP)
|
|
|
3864 {
|
|
|
3865 xemacs_c_alloca (0);
|
|
|
3866 funcall_alloca_count = 0;
|
|
|
3867 }
|
|
|
3868 }
|
|
887
|
3869 if (need_to_signal_post_gc)
|
|
|
3870 {
|
|
|
3871 need_to_signal_post_gc = 0;
|
|
1111
|
3872 recompute_funcall_allocation_flag ();
|
|
3263
|
3873 #ifdef NEW_GC
|
|
|
3874 run_finalizers ();
|
|
|
3875 #endif /* NEW_GC */
|
|
1111
|
3876 run_post_gc_hook ();
|
|
887
|
3877 }
|
|
851
|
3878 }
|
|
428
|
3879
|
|
|
3880 if (++lisp_eval_depth > max_lisp_eval_depth)
|
|
|
3881 {
|
|
|
3882 if (max_lisp_eval_depth < 100)
|
|
|
3883 max_lisp_eval_depth = 100;
|
|
|
3884 if (lisp_eval_depth > max_lisp_eval_depth)
|
|
563
|
3885 stack_overflow ("Lisp nesting exceeds `max-lisp-eval-depth'",
|
|
|
3886 Qunbound);
|
|
428
|
3887 }
|
|
|
3888
|
|
1292
|
3889 backtrace.pdlcount = specpdl_depth ();
|
|
428
|
3890 backtrace.function = &args[0];
|
|
|
3891 backtrace.args = fun_args;
|
|
|
3892 backtrace.nargs = fun_nargs;
|
|
|
3893 backtrace.evalargs = 0;
|
|
|
3894 backtrace.debug_on_exit = 0;
|
|
1292
|
3895 backtrace.function_being_called = 0;
|
|
428
|
3896 PUSH_BACKTRACE (backtrace);
|
|
|
3897
|
|
|
3898 if (debug_on_next_call)
|
|
|
3899 do_debug_on_call (Qlambda);
|
|
|
3900
|
|
|
3901 retry:
|
|
|
3902
|
|
|
3903 fun = args[0];
|
|
|
3904
|
|
|
3905 /* We could call indirect_function directly, but profiling shows
|
|
|
3906 this is worth optimizing by partially unrolling the loop. */
|
|
|
3907 if (SYMBOLP (fun))
|
|
|
3908 {
|
|
|
3909 fun = XSYMBOL (fun)->function;
|
|
|
3910 if (SYMBOLP (fun))
|
|
|
3911 {
|
|
|
3912 fun = XSYMBOL (fun)->function;
|
|
|
3913 if (SYMBOLP (fun))
|
|
|
3914 fun = indirect_function (fun, 1);
|
|
|
3915 }
|
|
|
3916 }
|
|
|
3917
|
|
|
3918 if (SUBRP (fun))
|
|
|
3919 {
|
|
|
3920 Lisp_Subr *subr = XSUBR (fun);
|
|
|
3921 int max_args = subr->max_args;
|
|
|
3922 Lisp_Object spacious_args[SUBR_MAX_ARGS];
|
|
|
3923
|
|
|
3924 if (fun_nargs == max_args) /* Optimize for the common case */
|
|
|
3925 {
|
|
|
3926 funcall_subr:
|
|
1292
|
3927 PROFILE_ENTER_FUNCTION ();
|
|
428
|
3928 FUNCALL_SUBR (val, subr, fun_args, max_args);
|
|
1292
|
3929 PROFILE_EXIT_FUNCTION ();
|
|
428
|
3930 }
|
|
436
|
3931 else if (fun_nargs < subr->min_args)
|
|
|
3932 {
|
|
|
3933 goto wrong_number_of_arguments;
|
|
|
3934 }
|
|
428
|
3935 else if (fun_nargs < max_args)
|
|
|
3936 {
|
|
|
3937 Lisp_Object *p = spacious_args;
|
|
|
3938
|
|
|
3939 /* Default optionals to nil */
|
|
|
3940 while (fun_nargs--)
|
|
|
3941 *p++ = *fun_args++;
|
|
|
3942 while (p - spacious_args < max_args)
|
|
|
3943 *p++ = Qnil;
|
|
|
3944
|
|
|
3945 fun_args = spacious_args;
|
|
|
3946 goto funcall_subr;
|
|
|
3947 }
|
|
|
3948 else if (max_args == MANY)
|
|
|
3949 {
|
|
1292
|
3950 PROFILE_ENTER_FUNCTION ();
|
|
436
|
3951 val = SUBR_FUNCTION (subr, MANY) (fun_nargs, fun_args);
|
|
1292
|
3952 PROFILE_EXIT_FUNCTION ();
|
|
428
|
3953 }
|
|
|
3954 else if (max_args == UNEVALLED) /* Can't funcall a special form */
|
|
|
3955 {
|
|
|
3956 goto invalid_function;
|
|
|
3957 }
|
|
|
3958 else
|
|
|
3959 {
|
|
|
3960 wrong_number_of_arguments:
|
|
436
|
3961 val = signal_wrong_number_of_arguments_error (fun, fun_nargs);
|
|
428
|
3962 }
|
|
|
3963 }
|
|
|
3964 else if (COMPILED_FUNCTIONP (fun))
|
|
|
3965 {
|
|
1292
|
3966 PROFILE_ENTER_FUNCTION ();
|
|
428
|
3967 val = funcall_compiled_function (fun, fun_nargs, fun_args);
|
|
1292
|
3968 PROFILE_EXIT_FUNCTION ();
|
|
428
|
3969 }
|
|
|
3970 else if (CONSP (fun))
|
|
|
3971 {
|
|
|
3972 Lisp_Object funcar = XCAR (fun);
|
|
|
3973
|
|
|
3974 if (EQ (funcar, Qlambda))
|
|
|
3975 {
|
|
1292
|
3976 PROFILE_ENTER_FUNCTION ();
|
|
428
|
3977 val = funcall_lambda (fun, fun_nargs, fun_args);
|
|
1292
|
3978 PROFILE_EXIT_FUNCTION ();
|
|
428
|
3979 }
|
|
|
3980 else if (EQ (funcar, Qautoload))
|
|
|
3981 {
|
|
970
|
3982 /* do_autoload GCPROs both arguments */
|
|
428
|
3983 do_autoload (fun, args[0]);
|
|
|
3984 goto retry;
|
|
|
3985 }
|
|
|
3986 else /* Can't funcall a macro */
|
|
|
3987 {
|
|
|
3988 goto invalid_function;
|
|
|
3989 }
|
|
|
3990 }
|
|
|
3991 else if (UNBOUNDP (fun))
|
|
|
3992 {
|
|
436
|
3993 val = signal_void_function_error (args[0]);
|
|
428
|
3994 }
|
|
|
3995 else
|
|
|
3996 {
|
|
|
3997 invalid_function:
|
|
436
|
3998 val = signal_invalid_function_error (fun);
|
|
428
|
3999 }
|
|
|
4000
|
|
|
4001 lisp_eval_depth--;
|
|
|
4002 if (backtrace.debug_on_exit)
|
|
|
4003 val = do_debug_on_exit (val);
|
|
|
4004 POP_BACKTRACE (backtrace);
|
|
|
4005 return val;
|
|
|
4006 }
|
|
|
4007
|
|
|
4008 DEFUN ("functionp", Ffunctionp, 1, 1, 0, /*
|
|
|
4009 Return t if OBJECT can be called as a function, else nil.
|
|
|
4010 A function is an object that can be applied to arguments,
|
|
|
4011 using for example `funcall' or `apply'.
|
|
|
4012 */
|
|
|
4013 (object))
|
|
|
4014 {
|
|
|
4015 if (SYMBOLP (object))
|
|
|
4016 object = indirect_function (object, 0);
|
|
|
4017
|
|
919
|
4018 if (COMPILED_FUNCTIONP (object) || SUBRP (object))
|
|
|
4019 return Qt;
|
|
|
4020 if (CONSP (object))
|
|
|
4021 {
|
|
|
4022 Lisp_Object car = XCAR (object);
|
|
|
4023 if (EQ (car, Qlambda))
|
|
|
4024 return Qt;
|
|
|
4025 if (EQ (car, Qautoload)
|
|
|
4026 && NILP (Fcar_safe (Fcdr_safe (Fcdr_safe (Fcdr_safe (XCDR (object)))))))
|
|
|
4027 return Qt;
|
|
|
4028 }
|
|
|
4029 return Qnil;
|
|
428
|
4030 }
|
|
|
4031
|
|
|
4032 static Lisp_Object
|
|
|
4033 function_argcount (Lisp_Object function, int function_min_args_p)
|
|
|
4034 {
|
|
|
4035 Lisp_Object orig_function = function;
|
|
|
4036 Lisp_Object arglist;
|
|
|
4037
|
|
|
4038 retry:
|
|
|
4039
|
|
|
4040 if (SYMBOLP (function))
|
|
|
4041 function = indirect_function (function, 1);
|
|
|
4042
|
|
|
4043 if (SUBRP (function))
|
|
|
4044 {
|
|
442
|
4045 /* Using return with the ?: operator tickles a DEC CC compiler bug. */
|
|
|
4046 if (function_min_args_p)
|
|
|
4047 return Fsubr_min_args (function);
|
|
|
4048 else
|
|
|
4049 return Fsubr_max_args (function);
|
|
428
|
4050 }
|
|
|
4051 else if (COMPILED_FUNCTIONP (function))
|
|
|
4052 {
|
|
814
|
4053 Lisp_Compiled_Function *f = XCOMPILED_FUNCTION (function);
|
|
|
4054
|
|
1737
|
4055 if (!OPAQUEP (f->instructions))
|
|
|
4056 /* Lazily munge the instructions into a more efficient form */
|
|
|
4057 /* Needed to set max_args */
|
|
|
4058 optimize_compiled_function (function);
|
|
|
4059
|
|
814
|
4060 if (function_min_args_p)
|
|
|
4061 return make_int (f->min_args);
|
|
|
4062 else if (f->max_args == MANY)
|
|
|
4063 return Qnil;
|
|
|
4064 else
|
|
|
4065 return make_int (f->max_args);
|
|
428
|
4066 }
|
|
|
4067 else if (CONSP (function))
|
|
|
4068 {
|
|
|
4069 Lisp_Object funcar = XCAR (function);
|
|
|
4070
|
|
|
4071 if (EQ (funcar, Qmacro))
|
|
|
4072 {
|
|
|
4073 function = XCDR (function);
|
|
|
4074 goto retry;
|
|
|
4075 }
|
|
|
4076 else if (EQ (funcar, Qautoload))
|
|
|
4077 {
|
|
970
|
4078 /* do_autoload GCPROs both arguments */
|
|
428
|
4079 do_autoload (function, orig_function);
|
|
442
|
4080 function = orig_function;
|
|
428
|
4081 goto retry;
|
|
|
4082 }
|
|
|
4083 else if (EQ (funcar, Qlambda))
|
|
|
4084 {
|
|
|
4085 arglist = Fcar (XCDR (function));
|
|
|
4086 }
|
|
|
4087 else
|
|
|
4088 {
|
|
|
4089 goto invalid_function;
|
|
|
4090 }
|
|
|
4091 }
|
|
|
4092 else
|
|
|
4093 {
|
|
|
4094 invalid_function:
|
|
442
|
4095 return signal_invalid_function_error (orig_function);
|
|
428
|
4096 }
|
|
|
4097
|
|
|
4098 {
|
|
|
4099 int argcount = 0;
|
|
|
4100
|
|
|
4101 EXTERNAL_LIST_LOOP_2 (arg, arglist)
|
|
|
4102 {
|
|
|
4103 if (EQ (arg, Qand_optional))
|
|
|
4104 {
|
|
|
4105 if (function_min_args_p)
|
|
|
4106 break;
|
|
|
4107 }
|
|
|
4108 else if (EQ (arg, Qand_rest))
|
|
|
4109 {
|
|
|
4110 if (function_min_args_p)
|
|
|
4111 break;
|
|
|
4112 else
|
|
|
4113 return Qnil;
|
|
|
4114 }
|
|
|
4115 else
|
|
|
4116 {
|
|
|
4117 argcount++;
|
|
|
4118 }
|
|
|
4119 }
|
|
|
4120
|
|
|
4121 return make_int (argcount);
|
|
|
4122 }
|
|
|
4123 }
|
|
|
4124
|
|
|
4125 DEFUN ("function-min-args", Ffunction_min_args, 1, 1, 0, /*
|
|
617
|
4126 Return the minimum number of arguments a function may be called with.
|
|
428
|
4127 The function may be any form that can be passed to `funcall',
|
|
|
4128 any special form, or any macro.
|
|
853
|
4129
|
|
|
4130 To check if a function can be called with a specified number of
|
|
|
4131 arguments, use `function-allows-args'.
|
|
428
|
4132 */
|
|
|
4133 (function))
|
|
|
4134 {
|
|
|
4135 return function_argcount (function, 1);
|
|
|
4136 }
|
|
|
4137
|
|
|
4138 DEFUN ("function-max-args", Ffunction_max_args, 1, 1, 0, /*
|
|
617
|
4139 Return the maximum number of arguments a function may be called with.
|
|
428
|
4140 The function may be any form that can be passed to `funcall',
|
|
|
4141 any special form, or any macro.
|
|
|
4142 If the function takes an arbitrary number of arguments or is
|
|
|
4143 a built-in special form, nil is returned.
|
|
853
|
4144
|
|
|
4145 To check if a function can be called with a specified number of
|
|
|
4146 arguments, use `function-allows-args'.
|
|
428
|
4147 */
|
|
|
4148 (function))
|
|
|
4149 {
|
|
|
4150 return function_argcount (function, 0);
|
|
|
4151 }
|
|
|
4152
|
|
|
4153
|
|
|
4154 DEFUN ("apply", Fapply, 2, MANY, 0, /*
|
|
|
4155 Call FUNCTION with the remaining args, using the last arg as a list of args.
|
|
|
4156 Thus, (apply '+ 1 2 '(3 4)) returns 10.
|
|
|
4157 */
|
|
|
4158 (int nargs, Lisp_Object *args))
|
|
|
4159 {
|
|
|
4160 /* This function can GC */
|
|
|
4161 Lisp_Object fun = args[0];
|
|
|
4162 Lisp_Object spread_arg = args [nargs - 1];
|
|
|
4163 int numargs;
|
|
|
4164 int funcall_nargs;
|
|
|
4165
|
|
|
4166 GET_EXTERNAL_LIST_LENGTH (spread_arg, numargs);
|
|
|
4167
|
|
|
4168 if (numargs == 0)
|
|
|
4169 /* (apply foo 0 1 '()) */
|
|
|
4170 return Ffuncall (nargs - 1, args);
|
|
|
4171 else if (numargs == 1)
|
|
|
4172 {
|
|
|
4173 /* (apply foo 0 1 '(2)) */
|
|
|
4174 args [nargs - 1] = XCAR (spread_arg);
|
|
|
4175 return Ffuncall (nargs, args);
|
|
|
4176 }
|
|
|
4177
|
|
|
4178 /* -1 for function, -1 for spread arg */
|
|
|
4179 numargs = nargs - 2 + numargs;
|
|
|
4180 /* +1 for function */
|
|
|
4181 funcall_nargs = 1 + numargs;
|
|
|
4182
|
|
|
4183 if (SYMBOLP (fun))
|
|
|
4184 fun = indirect_function (fun, 0);
|
|
|
4185
|
|
|
4186 if (SUBRP (fun))
|
|
|
4187 {
|
|
|
4188 Lisp_Subr *subr = XSUBR (fun);
|
|
|
4189 int max_args = subr->max_args;
|
|
|
4190
|
|
|
4191 if (numargs < subr->min_args
|
|
|
4192 || (max_args >= 0 && max_args < numargs))
|
|
|
4193 {
|
|
|
4194 /* Let funcall get the error */
|
|
|
4195 }
|
|
|
4196 else if (max_args > numargs)
|
|
|
4197 {
|
|
|
4198 /* Avoid having funcall cons up yet another new vector of arguments
|
|
|
4199 by explicitly supplying nil's for optional values */
|
|
|
4200 funcall_nargs += (max_args - numargs);
|
|
|
4201 }
|
|
|
4202 }
|
|
|
4203 else if (UNBOUNDP (fun))
|
|
|
4204 {
|
|
|
4205 /* Let funcall get the error */
|
|
|
4206 fun = args[0];
|
|
|
4207 }
|
|
|
4208
|
|
|
4209 {
|
|
|
4210 REGISTER int i;
|
|
|
4211 Lisp_Object *funcall_args = alloca_array (Lisp_Object, funcall_nargs);
|
|
|
4212 struct gcpro gcpro1;
|
|
|
4213
|
|
|
4214 GCPRO1 (*funcall_args);
|
|
|
4215 gcpro1.nvars = funcall_nargs;
|
|
|
4216
|
|
|
4217 /* Copy in the unspread args */
|
|
|
4218 memcpy (funcall_args, args, (nargs - 1) * sizeof (Lisp_Object));
|
|
|
4219 /* Spread the last arg we got. Its first element goes in
|
|
|
4220 the slot that it used to occupy, hence this value of I. */
|
|
|
4221 for (i = nargs - 1;
|
|
|
4222 !NILP (spread_arg); /* i < 1 + numargs */
|
|
|
4223 i++, spread_arg = XCDR (spread_arg))
|
|
|
4224 {
|
|
|
4225 funcall_args [i] = XCAR (spread_arg);
|
|
|
4226 }
|
|
|
4227 /* Supply nil for optional args (to subrs) */
|
|
|
4228 for (; i < funcall_nargs; i++)
|
|
|
4229 funcall_args[i] = Qnil;
|
|
|
4230
|
|
|
4231
|
|
|
4232 RETURN_UNGCPRO (Ffuncall (funcall_nargs, funcall_args));
|
|
|
4233 }
|
|
|
4234 }
|
|
|
4235
|
|
|
4236
|
|
|
4237 /* Apply lambda list FUN to the NARGS evaluated arguments in ARGS and
|
|
|
4238 return the result of evaluation. */
|
|
|
4239
|
|
|
4240 static Lisp_Object
|
|
|
4241 funcall_lambda (Lisp_Object fun, int nargs, Lisp_Object args[])
|
|
|
4242 {
|
|
|
4243 /* This function can GC */
|
|
442
|
4244 Lisp_Object arglist, body, tail;
|
|
428
|
4245 int speccount = specpdl_depth();
|
|
|
4246 REGISTER int i = 0;
|
|
|
4247
|
|
|
4248 tail = XCDR (fun);
|
|
|
4249
|
|
|
4250 if (!CONSP (tail))
|
|
|
4251 goto invalid_function;
|
|
|
4252
|
|
|
4253 arglist = XCAR (tail);
|
|
|
4254 body = XCDR (tail);
|
|
|
4255
|
|
|
4256 {
|
|
|
4257 int optional = 0, rest = 0;
|
|
|
4258
|
|
442
|
4259 EXTERNAL_LIST_LOOP_2 (symbol, arglist)
|
|
428
|
4260 {
|
|
|
4261 if (!SYMBOLP (symbol))
|
|
|
4262 goto invalid_function;
|
|
|
4263 if (EQ (symbol, Qand_rest))
|
|
|
4264 rest = 1;
|
|
|
4265 else if (EQ (symbol, Qand_optional))
|
|
|
4266 optional = 1;
|
|
|
4267 else if (rest)
|
|
|
4268 {
|
|
|
4269 specbind (symbol, Flist (nargs - i, &args[i]));
|
|
|
4270 i = nargs;
|
|
|
4271 }
|
|
|
4272 else if (i < nargs)
|
|
|
4273 specbind (symbol, args[i++]);
|
|
|
4274 else if (!optional)
|
|
|
4275 goto wrong_number_of_arguments;
|
|
|
4276 else
|
|
|
4277 specbind (symbol, Qnil);
|
|
|
4278 }
|
|
|
4279 }
|
|
|
4280
|
|
|
4281 if (i < nargs)
|
|
|
4282 goto wrong_number_of_arguments;
|
|
|
4283
|
|
771
|
4284 return unbind_to_1 (speccount, Fprogn (body));
|
|
428
|
4285
|
|
|
4286 wrong_number_of_arguments:
|
|
436
|
4287 return signal_wrong_number_of_arguments_error (fun, nargs);
|
|
428
|
4288
|
|
|
4289 invalid_function:
|
|
436
|
4290 return signal_invalid_function_error (fun);
|
|
428
|
4291 }
|
|
|
4292
|
|
|
4293
|
|
|
4294 /************************************************************************/
|
|
|
4295 /* Run hook variables in various ways. */
|
|
|
4296 /************************************************************************/
|
|
|
4297
|
|
|
4298 DEFUN ("run-hooks", Frun_hooks, 1, MANY, 0, /*
|
|
|
4299 Run each hook in HOOKS. Major mode functions use this.
|
|
|
4300 Each argument should be a symbol, a hook variable.
|
|
|
4301 These symbols are processed in the order specified.
|
|
|
4302 If a hook symbol has a non-nil value, that value may be a function
|
|
|
4303 or a list of functions to be called to run the hook.
|
|
|
4304 If the value is a function, it is called with no arguments.
|
|
|
4305 If it is a list, the elements are called, in order, with no arguments.
|
|
|
4306
|
|
|
4307 To make a hook variable buffer-local, use `make-local-hook',
|
|
|
4308 not `make-local-variable'.
|
|
|
4309 */
|
|
|
4310 (int nargs, Lisp_Object *args))
|
|
|
4311 {
|
|
|
4312 REGISTER int i;
|
|
|
4313
|
|
|
4314 for (i = 0; i < nargs; i++)
|
|
|
4315 run_hook_with_args (1, args + i, RUN_HOOKS_TO_COMPLETION);
|
|
|
4316
|
|
|
4317 return Qnil;
|
|
|
4318 }
|
|
|
4319
|
|
|
4320 DEFUN ("run-hook-with-args", Frun_hook_with_args, 1, MANY, 0, /*
|
|
|
4321 Run HOOK with the specified arguments ARGS.
|
|
|
4322 HOOK should be a symbol, a hook variable. If HOOK has a non-nil
|
|
|
4323 value, that value may be a function or a list of functions to be
|
|
|
4324 called to run the hook. If the value is a function, it is called with
|
|
|
4325 the given arguments and its return value is returned. If it is a list
|
|
|
4326 of functions, those functions are called, in order,
|
|
|
4327 with the given arguments ARGS.
|
|
444
|
4328 It is best not to depend on the value returned by `run-hook-with-args',
|
|
428
|
4329 as that may change.
|
|
|
4330
|
|
|
4331 To make a hook variable buffer-local, use `make-local-hook',
|
|
|
4332 not `make-local-variable'.
|
|
|
4333 */
|
|
|
4334 (int nargs, Lisp_Object *args))
|
|
|
4335 {
|
|
|
4336 return run_hook_with_args (nargs, args, RUN_HOOKS_TO_COMPLETION);
|
|
|
4337 }
|
|
|
4338
|
|
|
4339 DEFUN ("run-hook-with-args-until-success", Frun_hook_with_args_until_success, 1, MANY, 0, /*
|
|
|
4340 Run HOOK with the specified arguments ARGS.
|
|
|
4341 HOOK should be a symbol, a hook variable. Its value should
|
|
|
4342 be a list of functions. We call those functions, one by one,
|
|
|
4343 passing arguments ARGS to each of them, until one of them
|
|
|
4344 returns a non-nil value. Then we return that value.
|
|
|
4345 If all the functions return nil, we return nil.
|
|
|
4346
|
|
|
4347 To make a hook variable buffer-local, use `make-local-hook',
|
|
|
4348 not `make-local-variable'.
|
|
|
4349 */
|
|
|
4350 (int nargs, Lisp_Object *args))
|
|
|
4351 {
|
|
|
4352 return run_hook_with_args (nargs, args, RUN_HOOKS_UNTIL_SUCCESS);
|
|
|
4353 }
|
|
|
4354
|
|
|
4355 DEFUN ("run-hook-with-args-until-failure", Frun_hook_with_args_until_failure, 1, MANY, 0, /*
|
|
|
4356 Run HOOK with the specified arguments ARGS.
|
|
|
4357 HOOK should be a symbol, a hook variable. Its value should
|
|
|
4358 be a list of functions. We call those functions, one by one,
|
|
|
4359 passing arguments ARGS to each of them, until one of them
|
|
|
4360 returns nil. Then we return nil.
|
|
|
4361 If all the functions return non-nil, we return non-nil.
|
|
|
4362
|
|
|
4363 To make a hook variable buffer-local, use `make-local-hook',
|
|
|
4364 not `make-local-variable'.
|
|
|
4365 */
|
|
|
4366 (int nargs, Lisp_Object *args))
|
|
|
4367 {
|
|
|
4368 return run_hook_with_args (nargs, args, RUN_HOOKS_UNTIL_FAILURE);
|
|
|
4369 }
|
|
|
4370
|
|
|
4371 /* ARGS[0] should be a hook symbol.
|
|
|
4372 Call each of the functions in the hook value, passing each of them
|
|
|
4373 as arguments all the rest of ARGS (all NARGS - 1 elements).
|
|
|
4374 COND specifies a condition to test after each call
|
|
|
4375 to decide whether to stop.
|
|
|
4376 The caller (or its caller, etc) must gcpro all of ARGS,
|
|
|
4377 except that it isn't necessary to gcpro ARGS[0]. */
|
|
|
4378
|
|
|
4379 Lisp_Object
|
|
|
4380 run_hook_with_args_in_buffer (struct buffer *buf, int nargs, Lisp_Object *args,
|
|
|
4381 enum run_hooks_condition cond)
|
|
|
4382 {
|
|
|
4383 Lisp_Object sym, val, ret;
|
|
|
4384
|
|
|
4385 if (!initialized || preparing_for_armageddon)
|
|
|
4386 /* We need to bail out of here pronto. */
|
|
|
4387 return Qnil;
|
|
|
4388
|
|
3092
|
4389 #ifndef NEW_GC
|
|
428
|
4390 /* Whenever gc_in_progress is true, preparing_for_armageddon
|
|
|
4391 will also be true unless something is really hosed. */
|
|
|
4392 assert (!gc_in_progress);
|
|
3092
|
4393 #endif /* not NEW_GC */
|
|
428
|
4394
|
|
|
4395 sym = args[0];
|
|
771
|
4396 val = symbol_value_in_buffer (sym, wrap_buffer (buf));
|
|
428
|
4397 ret = (cond == RUN_HOOKS_UNTIL_FAILURE ? Qt : Qnil);
|
|
|
4398
|
|
|
4399 if (UNBOUNDP (val) || NILP (val))
|
|
|
4400 return ret;
|
|
|
4401 else if (!CONSP (val) || EQ (XCAR (val), Qlambda))
|
|
|
4402 {
|
|
|
4403 args[0] = val;
|
|
|
4404 return Ffuncall (nargs, args);
|
|
|
4405 }
|
|
|
4406 else
|
|
|
4407 {
|
|
|
4408 struct gcpro gcpro1, gcpro2, gcpro3;
|
|
|
4409 Lisp_Object globals = Qnil;
|
|
|
4410 GCPRO3 (sym, val, globals);
|
|
|
4411
|
|
|
4412 for (;
|
|
|
4413 CONSP (val) && ((cond == RUN_HOOKS_TO_COMPLETION)
|
|
|
4414 || (cond == RUN_HOOKS_UNTIL_SUCCESS ? NILP (ret)
|
|
|
4415 : !NILP (ret)));
|
|
|
4416 val = XCDR (val))
|
|
|
4417 {
|
|
|
4418 if (EQ (XCAR (val), Qt))
|
|
|
4419 {
|
|
|
4420 /* t indicates this hook has a local binding;
|
|
|
4421 it means to run the global binding too. */
|
|
|
4422 globals = Fdefault_value (sym);
|
|
|
4423
|
|
|
4424 if ((! CONSP (globals) || EQ (XCAR (globals), Qlambda)) &&
|
|
|
4425 ! NILP (globals))
|
|
|
4426 {
|
|
|
4427 args[0] = globals;
|
|
|
4428 ret = Ffuncall (nargs, args);
|
|
|
4429 }
|
|
|
4430 else
|
|
|
4431 {
|
|
|
4432 for (;
|
|
|
4433 CONSP (globals) && ((cond == RUN_HOOKS_TO_COMPLETION)
|
|
|
4434 || (cond == RUN_HOOKS_UNTIL_SUCCESS
|
|
|
4435 ? NILP (ret)
|
|
|
4436 : !NILP (ret)));
|
|
|
4437 globals = XCDR (globals))
|
|
|
4438 {
|
|
|
4439 args[0] = XCAR (globals);
|
|
|
4440 /* In a global value, t should not occur. If it does, we
|
|
|
4441 must ignore it to avoid an endless loop. */
|
|
|
4442 if (!EQ (args[0], Qt))
|
|
|
4443 ret = Ffuncall (nargs, args);
|
|
|
4444 }
|
|
|
4445 }
|
|
|
4446 }
|
|
|
4447 else
|
|
|
4448 {
|
|
|
4449 args[0] = XCAR (val);
|
|
|
4450 ret = Ffuncall (nargs, args);
|
|
|
4451 }
|
|
|
4452 }
|
|
|
4453
|
|
|
4454 UNGCPRO;
|
|
|
4455 return ret;
|
|
|
4456 }
|
|
|
4457 }
|
|
|
4458
|
|
|
4459 Lisp_Object
|
|
|
4460 run_hook_with_args (int nargs, Lisp_Object *args,
|
|
|
4461 enum run_hooks_condition cond)
|
|
|
4462 {
|
|
|
4463 return run_hook_with_args_in_buffer (current_buffer, nargs, args, cond);
|
|
|
4464 }
|
|
|
4465
|
|
|
4466 #if 0
|
|
|
4467
|
|
853
|
4468 /* From FSF 19.30, not currently used; seems like a big kludge. */
|
|
428
|
4469
|
|
|
4470 /* Run a hook symbol ARGS[0], but use FUNLIST instead of the actual
|
|
|
4471 present value of that symbol.
|
|
|
4472 Call each element of FUNLIST,
|
|
|
4473 passing each of them the rest of ARGS.
|
|
|
4474 The caller (or its caller, etc) must gcpro all of ARGS,
|
|
|
4475 except that it isn't necessary to gcpro ARGS[0]. */
|
|
|
4476
|
|
|
4477 Lisp_Object
|
|
|
4478 run_hook_list_with_args (Lisp_Object funlist, int nargs, Lisp_Object *args)
|
|
|
4479 {
|
|
853
|
4480 omitted;
|
|
428
|
4481 }
|
|
|
4482
|
|
|
4483 #endif /* 0 */
|
|
|
4484
|
|
|
4485 void
|
|
|
4486 va_run_hook_with_args (Lisp_Object hook_var, int nargs, ...)
|
|
|
4487 {
|
|
|
4488 /* This function can GC */
|
|
|
4489 struct gcpro gcpro1;
|
|
|
4490 int i;
|
|
|
4491 va_list vargs;
|
|
|
4492 Lisp_Object *funcall_args = alloca_array (Lisp_Object, 1 + nargs);
|
|
|
4493
|
|
|
4494 va_start (vargs, nargs);
|
|
|
4495 funcall_args[0] = hook_var;
|
|
|
4496 for (i = 0; i < nargs; i++)
|
|
|
4497 funcall_args[i + 1] = va_arg (vargs, Lisp_Object);
|
|
|
4498 va_end (vargs);
|
|
|
4499
|
|
|
4500 GCPRO1 (*funcall_args);
|
|
|
4501 gcpro1.nvars = nargs + 1;
|
|
|
4502 run_hook_with_args (nargs + 1, funcall_args, RUN_HOOKS_TO_COMPLETION);
|
|
|
4503 UNGCPRO;
|
|
|
4504 }
|
|
|
4505
|
|
|
4506 void
|
|
|
4507 va_run_hook_with_args_in_buffer (struct buffer *buf, Lisp_Object hook_var,
|
|
|
4508 int nargs, ...)
|
|
|
4509 {
|
|
|
4510 /* This function can GC */
|
|
|
4511 struct gcpro gcpro1;
|
|
|
4512 int i;
|
|
|
4513 va_list vargs;
|
|
|
4514 Lisp_Object *funcall_args = alloca_array (Lisp_Object, 1 + nargs);
|
|
|
4515
|
|
|
4516 va_start (vargs, nargs);
|
|
|
4517 funcall_args[0] = hook_var;
|
|
|
4518 for (i = 0; i < nargs; i++)
|
|
|
4519 funcall_args[i + 1] = va_arg (vargs, Lisp_Object);
|
|
|
4520 va_end (vargs);
|
|
|
4521
|
|
|
4522 GCPRO1 (*funcall_args);
|
|
|
4523 gcpro1.nvars = nargs + 1;
|
|
|
4524 run_hook_with_args_in_buffer (buf, nargs + 1, funcall_args,
|
|
|
4525 RUN_HOOKS_TO_COMPLETION);
|
|
|
4526 UNGCPRO;
|
|
|
4527 }
|
|
|
4528
|
|
|
4529 Lisp_Object
|
|
|
4530 run_hook (Lisp_Object hook)
|
|
|
4531 {
|
|
853
|
4532 return run_hook_with_args (1, &hook, RUN_HOOKS_TO_COMPLETION);
|
|
428
|
4533 }
|
|
|
4534
|
|
|
4535
|
|
|
4536 /************************************************************************/
|
|
|
4537 /* Front-ends to eval, funcall, apply */
|
|
|
4538 /************************************************************************/
|
|
|
4539
|
|
|
4540 /* Apply fn to arg */
|
|
|
4541 Lisp_Object
|
|
|
4542 apply1 (Lisp_Object fn, Lisp_Object arg)
|
|
|
4543 {
|
|
|
4544 /* This function can GC */
|
|
|
4545 struct gcpro gcpro1;
|
|
|
4546 Lisp_Object args[2];
|
|
|
4547
|
|
|
4548 if (NILP (arg))
|
|
|
4549 return Ffuncall (1, &fn);
|
|
|
4550 GCPRO1 (args[0]);
|
|
|
4551 gcpro1.nvars = 2;
|
|
|
4552 args[0] = fn;
|
|
|
4553 args[1] = arg;
|
|
|
4554 RETURN_UNGCPRO (Fapply (2, args));
|
|
|
4555 }
|
|
|
4556
|
|
|
4557 /* Call function fn on no arguments */
|
|
|
4558 Lisp_Object
|
|
|
4559 call0 (Lisp_Object fn)
|
|
|
4560 {
|
|
|
4561 /* This function can GC */
|
|
|
4562 struct gcpro gcpro1;
|
|
|
4563
|
|
|
4564 GCPRO1 (fn);
|
|
|
4565 RETURN_UNGCPRO (Ffuncall (1, &fn));
|
|
|
4566 }
|
|
|
4567
|
|
|
4568 /* Call function fn with argument arg0 */
|
|
|
4569 Lisp_Object
|
|
|
4570 call1 (Lisp_Object fn,
|
|
|
4571 Lisp_Object arg0)
|
|
|
4572 {
|
|
|
4573 /* This function can GC */
|
|
|
4574 struct gcpro gcpro1;
|
|
|
4575 Lisp_Object args[2];
|
|
|
4576 args[0] = fn;
|
|
|
4577 args[1] = arg0;
|
|
|
4578 GCPRO1 (args[0]);
|
|
|
4579 gcpro1.nvars = 2;
|
|
|
4580 RETURN_UNGCPRO (Ffuncall (2, args));
|
|
|
4581 }
|
|
|
4582
|
|
|
4583 /* Call function fn with arguments arg0, arg1 */
|
|
|
4584 Lisp_Object
|
|
|
4585 call2 (Lisp_Object fn,
|
|
|
4586 Lisp_Object arg0, Lisp_Object arg1)
|
|
|
4587 {
|
|
|
4588 /* This function can GC */
|
|
|
4589 struct gcpro gcpro1;
|
|
|
4590 Lisp_Object args[3];
|
|
|
4591 args[0] = fn;
|
|
|
4592 args[1] = arg0;
|
|
|
4593 args[2] = arg1;
|
|
|
4594 GCPRO1 (args[0]);
|
|
|
4595 gcpro1.nvars = 3;
|
|
|
4596 RETURN_UNGCPRO (Ffuncall (3, args));
|
|
|
4597 }
|
|
|
4598
|
|
|
4599 /* Call function fn with arguments arg0, arg1, arg2 */
|
|
|
4600 Lisp_Object
|
|
|
4601 call3 (Lisp_Object fn,
|
|
|
4602 Lisp_Object arg0, Lisp_Object arg1, Lisp_Object arg2)
|
|
|
4603 {
|
|
|
4604 /* This function can GC */
|
|
|
4605 struct gcpro gcpro1;
|
|
|
4606 Lisp_Object args[4];
|
|
|
4607 args[0] = fn;
|
|
|
4608 args[1] = arg0;
|
|
|
4609 args[2] = arg1;
|
|
|
4610 args[3] = arg2;
|
|
|
4611 GCPRO1 (args[0]);
|
|
|
4612 gcpro1.nvars = 4;
|
|
|
4613 RETURN_UNGCPRO (Ffuncall (4, args));
|
|
|
4614 }
|
|
|
4615
|
|
|
4616 /* Call function fn with arguments arg0, arg1, arg2, arg3 */
|
|
|
4617 Lisp_Object
|
|
|
4618 call4 (Lisp_Object fn,
|
|
|
4619 Lisp_Object arg0, Lisp_Object arg1, Lisp_Object arg2,
|
|
|
4620 Lisp_Object arg3)
|
|
|
4621 {
|
|
|
4622 /* This function can GC */
|
|
|
4623 struct gcpro gcpro1;
|
|
|
4624 Lisp_Object args[5];
|
|
|
4625 args[0] = fn;
|
|
|
4626 args[1] = arg0;
|
|
|
4627 args[2] = arg1;
|
|
|
4628 args[3] = arg2;
|
|
|
4629 args[4] = arg3;
|
|
|
4630 GCPRO1 (args[0]);
|
|
|
4631 gcpro1.nvars = 5;
|
|
|
4632 RETURN_UNGCPRO (Ffuncall (5, args));
|
|
|
4633 }
|
|
|
4634
|
|
|
4635 /* Call function fn with arguments arg0, arg1, arg2, arg3, arg4 */
|
|
|
4636 Lisp_Object
|
|
|
4637 call5 (Lisp_Object fn,
|
|
|
4638 Lisp_Object arg0, Lisp_Object arg1, Lisp_Object arg2,
|
|
|
4639 Lisp_Object arg3, Lisp_Object arg4)
|
|
|
4640 {
|
|
|
4641 /* This function can GC */
|
|
|
4642 struct gcpro gcpro1;
|
|
|
4643 Lisp_Object args[6];
|
|
|
4644 args[0] = fn;
|
|
|
4645 args[1] = arg0;
|
|
|
4646 args[2] = arg1;
|
|
|
4647 args[3] = arg2;
|
|
|
4648 args[4] = arg3;
|
|
|
4649 args[5] = arg4;
|
|
|
4650 GCPRO1 (args[0]);
|
|
|
4651 gcpro1.nvars = 6;
|
|
|
4652 RETURN_UNGCPRO (Ffuncall (6, args));
|
|
|
4653 }
|
|
|
4654
|
|
|
4655 Lisp_Object
|
|
|
4656 call6 (Lisp_Object fn,
|
|
|
4657 Lisp_Object arg0, Lisp_Object arg1, Lisp_Object arg2,
|
|
|
4658 Lisp_Object arg3, Lisp_Object arg4, Lisp_Object arg5)
|
|
|
4659 {
|
|
|
4660 /* This function can GC */
|
|
|
4661 struct gcpro gcpro1;
|
|
|
4662 Lisp_Object args[7];
|
|
|
4663 args[0] = fn;
|
|
|
4664 args[1] = arg0;
|
|
|
4665 args[2] = arg1;
|
|
|
4666 args[3] = arg2;
|
|
|
4667 args[4] = arg3;
|
|
|
4668 args[5] = arg4;
|
|
|
4669 args[6] = arg5;
|
|
|
4670 GCPRO1 (args[0]);
|
|
|
4671 gcpro1.nvars = 7;
|
|
|
4672 RETURN_UNGCPRO (Ffuncall (7, args));
|
|
|
4673 }
|
|
|
4674
|
|
|
4675 Lisp_Object
|
|
|
4676 call7 (Lisp_Object fn,
|
|
|
4677 Lisp_Object arg0, Lisp_Object arg1, Lisp_Object arg2,
|
|
|
4678 Lisp_Object arg3, Lisp_Object arg4, Lisp_Object arg5,
|
|
|
4679 Lisp_Object arg6)
|
|
|
4680 {
|
|
|
4681 /* This function can GC */
|
|
|
4682 struct gcpro gcpro1;
|
|
|
4683 Lisp_Object args[8];
|
|
|
4684 args[0] = fn;
|
|
|
4685 args[1] = arg0;
|
|
|
4686 args[2] = arg1;
|
|
|
4687 args[3] = arg2;
|
|
|
4688 args[4] = arg3;
|
|
|
4689 args[5] = arg4;
|
|
|
4690 args[6] = arg5;
|
|
|
4691 args[7] = arg6;
|
|
|
4692 GCPRO1 (args[0]);
|
|
|
4693 gcpro1.nvars = 8;
|
|
|
4694 RETURN_UNGCPRO (Ffuncall (8, args));
|
|
|
4695 }
|
|
|
4696
|
|
|
4697 Lisp_Object
|
|
|
4698 call8 (Lisp_Object fn,
|
|
|
4699 Lisp_Object arg0, Lisp_Object arg1, Lisp_Object arg2,
|
|
|
4700 Lisp_Object arg3, Lisp_Object arg4, Lisp_Object arg5,
|
|
|
4701 Lisp_Object arg6, Lisp_Object arg7)
|
|
|
4702 {
|
|
|
4703 /* This function can GC */
|
|
|
4704 struct gcpro gcpro1;
|
|
|
4705 Lisp_Object args[9];
|
|
|
4706 args[0] = fn;
|
|
|
4707 args[1] = arg0;
|
|
|
4708 args[2] = arg1;
|
|
|
4709 args[3] = arg2;
|
|
|
4710 args[4] = arg3;
|
|
|
4711 args[5] = arg4;
|
|
|
4712 args[6] = arg5;
|
|
|
4713 args[7] = arg6;
|
|
|
4714 args[8] = arg7;
|
|
|
4715 GCPRO1 (args[0]);
|
|
|
4716 gcpro1.nvars = 9;
|
|
|
4717 RETURN_UNGCPRO (Ffuncall (9, args));
|
|
|
4718 }
|
|
|
4719
|
|
|
4720 Lisp_Object
|
|
|
4721 call0_in_buffer (struct buffer *buf, Lisp_Object fn)
|
|
|
4722 {
|
|
|
4723 if (current_buffer == buf)
|
|
|
4724 return call0 (fn);
|
|
|
4725 else
|
|
|
4726 {
|
|
|
4727 Lisp_Object val;
|
|
|
4728 int speccount = specpdl_depth();
|
|
|
4729 record_unwind_protect (Fset_buffer, Fcurrent_buffer ());
|
|
|
4730 set_buffer_internal (buf);
|
|
|
4731 val = call0 (fn);
|
|
771
|
4732 unbind_to (speccount);
|
|
428
|
4733 return val;
|
|
|
4734 }
|
|
|
4735 }
|
|
|
4736
|
|
|
4737 Lisp_Object
|
|
|
4738 call1_in_buffer (struct buffer *buf, Lisp_Object fn,
|
|
|
4739 Lisp_Object arg0)
|
|
|
4740 {
|
|
|
4741 if (current_buffer == buf)
|
|
|
4742 return call1 (fn, arg0);
|
|
|
4743 else
|
|
|
4744 {
|
|
|
4745 Lisp_Object val;
|
|
|
4746 int speccount = specpdl_depth();
|
|
|
4747 record_unwind_protect (Fset_buffer, Fcurrent_buffer ());
|
|
|
4748 set_buffer_internal (buf);
|
|
|
4749 val = call1 (fn, arg0);
|
|
771
|
4750 unbind_to (speccount);
|
|
428
|
4751 return val;
|
|
|
4752 }
|
|
|
4753 }
|
|
|
4754
|
|
|
4755 Lisp_Object
|
|
|
4756 call2_in_buffer (struct buffer *buf, Lisp_Object fn,
|
|
|
4757 Lisp_Object arg0, Lisp_Object arg1)
|
|
|
4758 {
|
|
|
4759 if (current_buffer == buf)
|
|
|
4760 return call2 (fn, arg0, arg1);
|
|
|
4761 else
|
|
|
4762 {
|
|
|
4763 Lisp_Object val;
|
|
|
4764 int speccount = specpdl_depth();
|
|
|
4765 record_unwind_protect (Fset_buffer, Fcurrent_buffer ());
|
|
|
4766 set_buffer_internal (buf);
|
|
|
4767 val = call2 (fn, arg0, arg1);
|
|
771
|
4768 unbind_to (speccount);
|
|
428
|
4769 return val;
|
|
|
4770 }
|
|
|
4771 }
|
|
|
4772
|
|
|
4773 Lisp_Object
|
|
|
4774 call3_in_buffer (struct buffer *buf, Lisp_Object fn,
|
|
|
4775 Lisp_Object arg0, Lisp_Object arg1, Lisp_Object arg2)
|
|
|
4776 {
|
|
|
4777 if (current_buffer == buf)
|
|
|
4778 return call3 (fn, arg0, arg1, arg2);
|
|
|
4779 else
|
|
|
4780 {
|
|
|
4781 Lisp_Object val;
|
|
|
4782 int speccount = specpdl_depth();
|
|
|
4783 record_unwind_protect (Fset_buffer, Fcurrent_buffer ());
|
|
|
4784 set_buffer_internal (buf);
|
|
|
4785 val = call3 (fn, arg0, arg1, arg2);
|
|
771
|
4786 unbind_to (speccount);
|
|
428
|
4787 return val;
|
|
|
4788 }
|
|
|
4789 }
|
|
|
4790
|
|
|
4791 Lisp_Object
|
|
|
4792 call4_in_buffer (struct buffer *buf, Lisp_Object fn,
|
|
|
4793 Lisp_Object arg0, Lisp_Object arg1, Lisp_Object arg2,
|
|
|
4794 Lisp_Object arg3)
|
|
|
4795 {
|
|
|
4796 if (current_buffer == buf)
|
|
|
4797 return call4 (fn, arg0, arg1, arg2, arg3);
|
|
|
4798 else
|
|
|
4799 {
|
|
|
4800 Lisp_Object val;
|
|
|
4801 int speccount = specpdl_depth();
|
|
|
4802 record_unwind_protect (Fset_buffer, Fcurrent_buffer ());
|
|
|
4803 set_buffer_internal (buf);
|
|
|
4804 val = call4 (fn, arg0, arg1, arg2, arg3);
|
|
771
|
4805 unbind_to (speccount);
|
|
428
|
4806 return val;
|
|
|
4807 }
|
|
|
4808 }
|
|
|
4809
|
|
|
4810 Lisp_Object
|
|
|
4811 eval_in_buffer (struct buffer *buf, Lisp_Object form)
|
|
|
4812 {
|
|
|
4813 if (current_buffer == buf)
|
|
|
4814 return Feval (form);
|
|
|
4815 else
|
|
|
4816 {
|
|
|
4817 Lisp_Object val;
|
|
|
4818 int speccount = specpdl_depth();
|
|
|
4819 record_unwind_protect (Fset_buffer, Fcurrent_buffer ());
|
|
|
4820 set_buffer_internal (buf);
|
|
|
4821 val = Feval (form);
|
|
771
|
4822 unbind_to (speccount);
|
|
428
|
4823 return val;
|
|
|
4824 }
|
|
|
4825 }
|
|
|
4826
|
|
|
4827
|
|
|
4828 /************************************************************************/
|
|
|
4829 /* Error-catching front-ends to eval, funcall, apply */
|
|
|
4830 /************************************************************************/
|
|
|
4831
|
|
853
|
4832 int
|
|
|
4833 get_inhibit_flags (void)
|
|
|
4834 {
|
|
|
4835 return inhibit_flags;
|
|
|
4836 }
|
|
|
4837
|
|
|
4838 void
|
|
2286
|
4839 check_allowed_operation (int what, Lisp_Object obj, Lisp_Object UNUSED (prop))
|
|
853
|
4840 {
|
|
|
4841 if (inhibit_flags & INHIBIT_EXISTING_BUFFER_TEXT_MODIFICATION)
|
|
|
4842 {
|
|
|
4843 if (what == OPERATION_MODIFY_BUFFER_TEXT && BUFFERP (obj)
|
|
|
4844 && NILP (memq_no_quit (obj, Vmodifiable_buffers)))
|
|
|
4845 invalid_change
|
|
|
4846 ("Modification of this buffer not currently permitted", obj);
|
|
|
4847 }
|
|
|
4848 if (inhibit_flags & INHIBIT_EXISTING_PERMANENT_DISPLAY_OBJECT_DELETION)
|
|
|
4849 {
|
|
|
4850 if (what == OPERATION_DELETE_OBJECT
|
|
|
4851 && (BUFFERP (obj) || WINDOWP (obj) || FRAMEP (obj) || DEVICEP (obj)
|
|
|
4852 || CONSOLEP (obj))
|
|
|
4853 && NILP (memq_no_quit (obj, Vdeletable_permanent_display_objects)))
|
|
|
4854 invalid_change
|
|
|
4855 ("Deletion of this object not currently permitted", obj);
|
|
|
4856 }
|
|
|
4857 }
|
|
|
4858
|
|
|
4859 void
|
|
|
4860 note_object_created (Lisp_Object obj)
|
|
|
4861 {
|
|
|
4862 if (inhibit_flags & INHIBIT_EXISTING_BUFFER_TEXT_MODIFICATION)
|
|
|
4863 {
|
|
|
4864 if (BUFFERP (obj))
|
|
|
4865 Vmodifiable_buffers = Fcons (obj, Vmodifiable_buffers);
|
|
|
4866 }
|
|
|
4867 if (inhibit_flags & INHIBIT_EXISTING_PERMANENT_DISPLAY_OBJECT_DELETION)
|
|
|
4868 {
|
|
|
4869 if (BUFFERP (obj) || WINDOWP (obj) || FRAMEP (obj) || DEVICEP (obj)
|
|
|
4870 || CONSOLEP (obj))
|
|
|
4871 Vdeletable_permanent_display_objects =
|
|
|
4872 Fcons (obj, Vdeletable_permanent_display_objects);
|
|
|
4873 }
|
|
|
4874 }
|
|
|
4875
|
|
|
4876 void
|
|
|
4877 note_object_deleted (Lisp_Object obj)
|
|
|
4878 {
|
|
|
4879 if (inhibit_flags & INHIBIT_EXISTING_BUFFER_TEXT_MODIFICATION)
|
|
|
4880 {
|
|
|
4881 if (BUFFERP (obj))
|
|
|
4882 Vmodifiable_buffers = delq_no_quit (obj, Vmodifiable_buffers);
|
|
|
4883 }
|
|
|
4884 if (inhibit_flags & INHIBIT_EXISTING_PERMANENT_DISPLAY_OBJECT_DELETION)
|
|
|
4885 {
|
|
|
4886 if (BUFFERP (obj) || WINDOWP (obj) || FRAMEP (obj) || DEVICEP (obj)
|
|
|
4887 || CONSOLEP (obj))
|
|
|
4888 Vdeletable_permanent_display_objects =
|
|
|
4889 delq_no_quit (obj, Vdeletable_permanent_display_objects);
|
|
|
4890 }
|
|
|
4891 }
|
|
|
4892
|
|
|
4893 struct call_trapping_problems
|
|
|
4894 {
|
|
|
4895 Lisp_Object catchtag;
|
|
|
4896 Lisp_Object error_conditions;
|
|
|
4897 Lisp_Object data;
|
|
|
4898 Lisp_Object backtrace;
|
|
|
4899 Lisp_Object warning_class;
|
|
|
4900
|
|
867
|
4901 const CIbyte *warning_string;
|
|
853
|
4902 Lisp_Object (*fun) (void *);
|
|
|
4903 void *arg;
|
|
|
4904 };
|
|
428
|
4905
|
|
2532
|
4906 static Lisp_Object
|
|
|
4907 maybe_get_trapping_problems_backtrace (void)
|
|
|
4908 {
|
|
|
4909 Lisp_Object backtrace;
|
|
853
|
4910
|
|
1123
|
4911 if (!(inhibit_flags & INHIBIT_WARNING_ISSUE)
|
|
2532
|
4912 && !warning_will_be_discarded (current_warning_level ()))
|
|
428
|
4913 {
|
|
1333
|
4914 struct gcpro gcpro1;
|
|
|
4915 Lisp_Object lstream = Qnil;
|
|
|
4916 int speccount = specpdl_depth ();
|
|
|
4917
|
|
853
|
4918 /* We're no longer protected against errors or quit here, so at
|
|
|
4919 least let's temporarily inhibit quit. We definitely do not
|
|
|
4920 want to inhibit quit during the calling of the function
|
|
|
4921 itself!!!!!!!!!!! */
|
|
|
4922
|
|
|
4923 specbind (Qinhibit_quit, Qt);
|
|
|
4924
|
|
|
4925 GCPRO1 (lstream);
|
|
|
4926 lstream = make_resizing_buffer_output_stream ();
|
|
|
4927 Fbacktrace (lstream, Qt);
|
|
|
4928 Lstream_flush (XLSTREAM (lstream));
|
|
2532
|
4929 backtrace = resizing_buffer_to_lisp_string (XLSTREAM (lstream));
|
|
853
|
4930 Lstream_delete (XLSTREAM (lstream));
|
|
|
4931 UNGCPRO;
|
|
|
4932
|
|
|
4933 unbind_to (speccount);
|
|
428
|
4934 }
|
|
853
|
4935 else
|
|
2532
|
4936 backtrace = Qnil;
|
|
|
4937
|
|
|
4938 return backtrace;
|
|
|
4939 }
|
|
|
4940
|
|
|
4941 static DECLARE_DOESNT_RETURN_TYPE
|
|
|
4942 (Lisp_Object, flagged_a_squirmer (Lisp_Object, Lisp_Object, Lisp_Object));
|
|
|
4943
|
|
|
4944 static DOESNT_RETURN_TYPE (Lisp_Object)
|
|
|
4945 flagged_a_squirmer (Lisp_Object error_conditions, Lisp_Object data,
|
|
|
4946 Lisp_Object opaque)
|
|
|
4947 {
|
|
|
4948 struct call_trapping_problems *p =
|
|
|
4949 (struct call_trapping_problems *) get_opaque_ptr (opaque);
|
|
|
4950
|
|
|
4951 if (!EQ (error_conditions, Qquit))
|
|
|
4952 p->backtrace = maybe_get_trapping_problems_backtrace ();
|
|
|
4953 else
|
|
853
|
4954 p->backtrace = Qnil;
|
|
|
4955 p->error_conditions = error_conditions;
|
|
|
4956 p->data = data;
|
|
|
4957
|
|
|
4958 Fthrow (p->catchtag, Qnil);
|
|
2268
|
4959 RETURN_NOT_REACHED (Qnil);
|
|
853
|
4960 }
|
|
|
4961
|
|
|
4962 static Lisp_Object
|
|
|
4963 call_trapping_problems_2 (Lisp_Object opaque)
|
|
|
4964 {
|
|
|
4965 struct call_trapping_problems *p =
|
|
|
4966 (struct call_trapping_problems *) get_opaque_ptr (opaque);
|
|
|
4967
|
|
|
4968 return (p->fun) (p->arg);
|
|
428
|
4969 }
|
|
|
4970
|
|
|
4971 static Lisp_Object
|
|
853
|
4972 call_trapping_problems_1 (Lisp_Object opaque)
|
|
|
4973 {
|
|
|
4974 return call_with_condition_handler (flagged_a_squirmer, opaque,
|
|
|
4975 call_trapping_problems_2, opaque);
|
|
|
4976 }
|
|
|
4977
|
|
1333
|
4978 static void
|
|
|
4979 issue_call_trapping_problems_warning (Lisp_Object warning_class,
|
|
|
4980 const CIbyte *warning_string,
|
|
|
4981 struct call_trapping_problems_result *p)
|
|
|
4982 {
|
|
|
4983 if (!warning_will_be_discarded (current_warning_level ()))
|
|
|
4984 {
|
|
|
4985 int depth = specpdl_depth ();
|
|
|
4986
|
|
|
4987 /* We're no longer protected against errors or quit here, so at
|
|
|
4988 least let's temporarily inhibit quit. */
|
|
|
4989 specbind (Qinhibit_quit, Qt);
|
|
|
4990
|
|
|
4991 if (p->caught_throw)
|
|
|
4992 {
|
|
|
4993 Lisp_Object errstr =
|
|
|
4994 emacs_sprintf_string_lisp
|
|
2532
|
4995 ("%s: Attempt to throw outside of function:"
|
|
|
4996 "To catch `%s' with value `%s'\n\nBacktrace follows:\n\n%s",
|
|
2725
|
4997 Qnil, 4,
|
|
1333
|
4998 build_msg_string (warning_string ? warning_string : "error"),
|
|
2532
|
4999 p->thrown_tag, p->thrown_value, p->backtrace);
|
|
1333
|
5000 warn_when_safe_lispobj (Qerror, current_warning_level (), errstr);
|
|
|
5001 }
|
|
2421
|
5002 else if (p->caught_error && !EQ (p->error_conditions, Qquit))
|
|
1333
|
5003 {
|
|
|
5004 Lisp_Object errstr;
|
|
|
5005 /* #### This should call
|
|
|
5006 (with-output-to-string (display-error (cons error_conditions
|
|
|
5007 data))
|
|
|
5008 but that stuff is all in Lisp currently. */
|
|
|
5009 errstr =
|
|
|
5010 emacs_sprintf_string_lisp
|
|
|
5011 ("%s: (%s %s)\n\nBacktrace follows:\n\n%s",
|
|
|
5012 Qnil, 4,
|
|
|
5013 build_msg_string (warning_string ? warning_string : "error"),
|
|
|
5014 p->error_conditions, p->data, p->backtrace);
|
|
|
5015
|
|
|
5016 warn_when_safe_lispobj (warning_class, current_warning_level (),
|
|
|
5017 errstr);
|
|
|
5018 }
|
|
|
5019
|
|
|
5020 unbind_to (depth);
|
|
|
5021 }
|
|
|
5022 }
|
|
|
5023
|
|
1318
|
5024 /* Turn on the trapping flags in FLAGS -- see call_trapping_problems().
|
|
|
5025 This cannot handle INTERNAL_INHIBIT_THROWS() or INTERNAL_INHIBIT_ERRORS
|
|
|
5026 (because they ultimately boil down to a setjmp()!) -- you must directly
|
|
|
5027 use call_trapping_problems() for that. Turn the flags off with
|
|
|
5028 unbind_to(). Returns the "canonicalized" flags (particularly in the
|
|
|
5029 case of INHIBIT_ANY_CHANGE_AFFECTING_REDISPLAY, which is shorthand for
|
|
|
5030 various other flags). */
|
|
|
5031
|
|
|
5032 int
|
|
|
5033 set_trapping_problems_flags (int flags)
|
|
|
5034 {
|
|
|
5035 int new_inhibit_flags;
|
|
|
5036
|
|
|
5037 if (flags & INHIBIT_ANY_CHANGE_AFFECTING_REDISPLAY)
|
|
|
5038 flags |= INHIBIT_EXISTING_PERMANENT_DISPLAY_OBJECT_DELETION
|
|
|
5039 | INHIBIT_EXISTING_BUFFER_TEXT_MODIFICATION
|
|
|
5040 | INHIBIT_ENTERING_DEBUGGER
|
|
|
5041 | INHIBIT_WARNING_ISSUE
|
|
|
5042 | INHIBIT_GC;
|
|
|
5043
|
|
|
5044 new_inhibit_flags = inhibit_flags | flags;
|
|
|
5045 if (new_inhibit_flags != inhibit_flags)
|
|
|
5046 internal_bind_int (&inhibit_flags, new_inhibit_flags);
|
|
|
5047
|
|
|
5048 if (flags & INHIBIT_QUIT)
|
|
|
5049 specbind (Qinhibit_quit, Qt);
|
|
|
5050
|
|
|
5051 if (flags & UNINHIBIT_QUIT)
|
|
|
5052 begin_do_check_for_quit ();
|
|
|
5053
|
|
|
5054 if (flags & INHIBIT_GC)
|
|
|
5055 begin_gc_forbidden ();
|
|
|
5056
|
|
|
5057 /* #### If we have nested calls to call_trapping_problems(), and the
|
|
|
5058 inner one creates some buffers/etc., should the outer one be able
|
|
|
5059 to delete them? I think so, but it means we need to combine rather
|
|
|
5060 than just reset the value. */
|
|
|
5061 if (flags & INHIBIT_EXISTING_PERMANENT_DISPLAY_OBJECT_DELETION)
|
|
|
5062 internal_bind_lisp_object (&Vdeletable_permanent_display_objects, Qnil);
|
|
|
5063
|
|
|
5064 if (flags & INHIBIT_EXISTING_BUFFER_TEXT_MODIFICATION)
|
|
|
5065 internal_bind_lisp_object (&Vmodifiable_buffers, Qnil);
|
|
|
5066
|
|
|
5067 return flags;
|
|
|
5068 }
|
|
|
5069
|
|
853
|
5070 /* This is equivalent to (*fun) (arg), except that various conditions
|
|
|
5071 can be trapped or inhibited, according to FLAGS.
|
|
|
5072
|
|
|
5073 If FLAGS does not contain NO_INHIBIT_ERRORS, when an error occurs,
|
|
|
5074 the error is caught and a warning is issued, specifying the
|
|
|
5075 specific error that occurred and a backtrace. In that case,
|
|
|
5076 WARNING_STRING should be given, and will be printed at the
|
|
|
5077 beginning of the error to indicate where the error occurred.
|
|
|
5078
|
|
|
5079 If FLAGS does not contain NO_INHIBIT_THROWS, all attempts to
|
|
|
5080 `throw' out of the function being called are trapped, and a warning
|
|
|
5081 issued. (Again, WARNING_STRING should be given.)
|
|
|
5082
|
|
2367
|
5083 If FLAGS contains INHIBIT_WARNING_ISSUE, no warnings are issued;
|
|
853
|
5084 this applies to recursive invocations of call_trapping_problems, too.
|
|
|
5085
|
|
1333
|
5086 If FLAGS contains POSTPONE_WARNING_ISSUE, no warnings are issued;
|
|
|
5087 but values useful for generating a warning are still computed (in
|
|
|
5088 particular, the backtrace), so that the calling function can issue
|
|
|
5089 a warning.
|
|
|
5090
|
|
853
|
5091 If FLAGS contains ISSUE_WARNINGS_AT_DEBUG_LEVEL, warnings will be
|
|
|
5092 issued, but at level `debug', which normally is below the minimum
|
|
|
5093 specified by `log-warning-minimum-level', meaning such warnings will
|
|
|
5094 be ignored entirely. The user can change this variable, however,
|
|
|
5095 to see the warnings.)
|
|
|
5096
|
|
|
5097 Note: If neither of NO_INHIBIT_THROWS or NO_INHIBIT_ERRORS is
|
|
|
5098 given, you are *guaranteed* that there will be no non-local exits
|
|
|
5099 out of this function.
|
|
|
5100
|
|
|
5101 If FLAGS contains INHIBIT_QUIT, QUIT using C-g is inhibited. (This
|
|
|
5102 is *rarely* a good idea. Unless you use NO_INHIBIT_ERRORS, QUIT is
|
|
|
5103 automatically caught as well, and treated as an error; you can
|
|
|
5104 check for this using EQ (problems->error_conditions, Qquit).
|
|
|
5105
|
|
|
5106 If FLAGS contains UNINHIBIT_QUIT, QUIT checking will be explicitly
|
|
|
5107 turned on. (It will abort the code being called, but will still be
|
|
|
5108 trapped and reported as an error, unless NO_INHIBIT_ERRORS is
|
|
|
5109 given.) This is useful when QUIT checking has been turned off by a
|
|
|
5110 higher-level caller.
|
|
|
5111
|
|
|
5112 If FLAGS contains INHIBIT_GC, garbage collection is inhibited.
|
|
1123
|
5113 This is useful for Lisp called within redisplay, for example.
|
|
853
|
5114
|
|
|
5115 If FLAGS contains INHIBIT_EXISTING_PERMANENT_DISPLAY_OBJECT_DELETION,
|
|
|
5116 Lisp code is not allowed to delete any window, buffers, frames, devices,
|
|
|
5117 or consoles that were already in existence at the time this function
|
|
|
5118 was called. (However, it's perfectly legal for code to create a new
|
|
|
5119 buffer and then delete it.)
|
|
|
5120
|
|
|
5121 #### It might be useful to have a flag that inhibits deletion of a
|
|
|
5122 specific permanent display object and everything it's attached to
|
|
|
5123 (e.g. a window, and the buffer, frame, device, and console it's
|
|
|
5124 attached to.
|
|
|
5125
|
|
|
5126 If FLAGS contains INHIBIT_EXISTING_BUFFER_TEXT_MODIFICATION, Lisp
|
|
|
5127 code is not allowed to modify the text of any buffers that were
|
|
|
5128 already in existence at the time this function was called.
|
|
|
5129 (However, it's perfectly legal for code to create a new buffer and
|
|
|
5130 then modify its text.)
|
|
|
5131
|
|
|
5132 [These last two flags are implemented using global variables
|
|
|
5133 Vdeletable_permanent_display_objects and Vmodifiable_buffers,
|
|
|
5134 which keep track of a list of all buffers or permanent display
|
|
|
5135 objects created since the last time one of these flags was set.
|
|
|
5136 The code that deletes buffers, etc. and modifies buffers checks
|
|
|
5137
|
|
|
5138 (1) if the corresponding flag is set (through the global variable
|
|
|
5139 inhibit_flags or its accessor function get_inhibit_flags()), and
|
|
|
5140
|
|
|
5141 (2) if the object to be modified or deleted is not in the
|
|
|
5142 appropriate list.
|
|
|
5143
|
|
|
5144 If so, it signals an error.
|
|
|
5145
|
|
|
5146 Recursive calls to call_trapping_problems() are allowed. In
|
|
|
5147 the case of the two flags mentioned above, the current values
|
|
|
5148 of the global variables are stored in an unwind-protect, and
|
|
|
5149 they're reset to nil.]
|
|
|
5150
|
|
|
5151 If FLAGS contains INHIBIT_ENTERING_DEBUGGER, the debugger will not
|
|
|
5152 be entered if an error occurs inside the Lisp code being called,
|
|
|
5153 even when the user has requested an error. In such case, a warning
|
|
|
5154 is issued stating that access to the debugger is denied, unless
|
|
|
5155 INHIBIT_WARNING_ISSUE has also been supplied. This is useful when
|
|
|
5156 calling Lisp code inside redisplay, in menu callbacks, etc. because
|
|
|
5157 in such cases either the display is in an inconsistent state or
|
|
|
5158 doing window operations is explicitly forbidden by the OS, and the
|
|
|
5159 debugger would causes visual changes on the screen and might create
|
|
|
5160 another frame.
|
|
|
5161
|
|
|
5162 If FLAGS contains INHIBIT_ANY_CHANGE_AFFECTING_REDISPLAY, no
|
|
|
5163 changes of any sort to extents, faces, glyphs, buffer text,
|
|
|
5164 specifiers relating to display, other variables relating to
|
|
|
5165 display, splitting, deleting, or resizing windows or frames,
|
|
|
5166 deleting buffers, windows, frames, devices, or consoles, etc. is
|
|
|
5167 allowed. This is for things called absolutely in the middle of
|
|
|
5168 redisplay, which expects things to be *exactly* the same after the
|
|
|
5169 call as before. This isn't completely implemented and needs to be
|
|
|
5170 thought out some more to determine exactly what its semantics are.
|
|
|
5171 For the moment, turning on this flag also turns on
|
|
|
5172
|
|
|
5173 INHIBIT_EXISTING_PERMANENT_DISPLAY_OBJECT_DELETION
|
|
|
5174 INHIBIT_EXISTING_BUFFER_TEXT_MODIFICATION
|
|
|
5175 INHIBIT_ENTERING_DEBUGGER
|
|
|
5176 INHIBIT_WARNING_ISSUE
|
|
|
5177 INHIBIT_GC
|
|
|
5178
|
|
|
5179 #### The following five flags are defined, but unimplemented:
|
|
|
5180
|
|
|
5181 #define INHIBIT_EXISTING_CODING_SYSTEM_DELETION (1<<6)
|
|
|
5182 #define INHIBIT_EXISTING_CHARSET_DELETION (1<<7)
|
|
|
5183 #define INHIBIT_PERMANENT_DISPLAY_OBJECT_CREATION (1<<8)
|
|
|
5184 #define INHIBIT_CODING_SYSTEM_CREATION (1<<9)
|
|
|
5185 #define INHIBIT_CHARSET_CREATION (1<<10)
|
|
|
5186
|
|
|
5187 FLAGS containing CALL_WITH_SUSPENDED_ERRORS is a sign that
|
|
|
5188 call_with_suspended_errors() was invoked. This exists only for
|
|
|
5189 debugging purposes -- often we want to break when a signal happens,
|
|
|
5190 but ignore signals from call_with_suspended_errors(), because they
|
|
|
5191 occur often and for legitimate reasons.
|
|
|
5192
|
|
|
5193 If PROBLEM is non-zero, it should be a pointer to a structure into
|
|
|
5194 which exact information about any occurring problems (either an
|
|
|
5195 error or an attempted throw past this boundary).
|
|
|
5196
|
|
|
5197 If a problem occurred and aborted operation (error, quit, or
|
|
|
5198 invalid throw), Qunbound is returned. Otherwise the return value
|
|
|
5199 from the call to (*fun) (arg) is returned. */
|
|
|
5200
|
|
|
5201 Lisp_Object
|
|
|
5202 call_trapping_problems (Lisp_Object warning_class,
|
|
867
|
5203 const CIbyte *warning_string,
|
|
853
|
5204 int flags,
|
|
|
5205 struct call_trapping_problems_result *problem,
|
|
|
5206 Lisp_Object (*fun) (void *),
|
|
|
5207 void *arg)
|
|
|
5208 {
|
|
1318
|
5209 int speccount = specpdl_depth ();
|
|
853
|
5210 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5;
|
|
|
5211 struct call_trapping_problems package;
|
|
1333
|
5212 struct call_trapping_problems_result real_problem;
|
|
2532
|
5213 Lisp_Object opaque, thrown_tag, tem, thrown_backtrace;
|
|
853
|
5214 int thrown = 0;
|
|
|
5215
|
|
|
5216 assert (SYMBOLP (warning_class)); /* sanity-check */
|
|
|
5217 assert (!NILP (warning_class));
|
|
|
5218
|
|
|
5219 flags ^= INTERNAL_INHIBIT_ERRORS | INTERNAL_INHIBIT_THROWS;
|
|
|
5220
|
|
|
5221 package.warning_class = warning_class;
|
|
|
5222 package.warning_string = warning_string;
|
|
|
5223 package.fun = fun;
|
|
|
5224 package.arg = arg;
|
|
|
5225 package.catchtag =
|
|
|
5226 flags & INTERNAL_INHIBIT_THROWS ? Vcatch_everything_tag :
|
|
|
5227 flags & INTERNAL_INHIBIT_ERRORS ? make_opaque_ptr (0) :
|
|
|
5228 Qnil;
|
|
|
5229 package.error_conditions = Qnil;
|
|
|
5230 package.data = Qnil;
|
|
|
5231 package.backtrace = Qnil;
|
|
|
5232
|
|
1318
|
5233 flags = set_trapping_problems_flags (flags);
|
|
853
|
5234
|
|
|
5235 if (flags & (INTERNAL_INHIBIT_THROWS | INTERNAL_INHIBIT_ERRORS))
|
|
|
5236 opaque = make_opaque_ptr (&package);
|
|
|
5237 else
|
|
|
5238 opaque = Qnil;
|
|
|
5239
|
|
|
5240 GCPRO5 (package.catchtag, package.error_conditions, package.data,
|
|
|
5241 package.backtrace, opaque);
|
|
|
5242
|
|
|
5243 if (flags & INTERNAL_INHIBIT_ERRORS)
|
|
|
5244 /* We need a catch so that our condition-handler can throw back here
|
|
|
5245 after printing the warning. (We print the warning in the stack
|
|
|
5246 context of the error, so we can get a backtrace.) */
|
|
|
5247 tem = internal_catch (package.catchtag, call_trapping_problems_1, opaque,
|
|
2532
|
5248 &thrown, &thrown_tag, &thrown_backtrace);
|
|
853
|
5249 else if (flags & INTERNAL_INHIBIT_THROWS)
|
|
|
5250 /* We skip over the first wrapper, which traps errors. */
|
|
|
5251 tem = internal_catch (package.catchtag, call_trapping_problems_2, opaque,
|
|
2532
|
5252 &thrown, &thrown_tag, &thrown_backtrace);
|
|
853
|
5253 else
|
|
|
5254 /* Nothing special. */
|
|
|
5255 tem = (fun) (arg);
|
|
|
5256
|
|
1333
|
5257 if (!problem)
|
|
|
5258 problem = &real_problem;
|
|
|
5259
|
|
|
5260 if (!thrown)
|
|
853
|
5261 {
|
|
1333
|
5262 problem->caught_error = 0;
|
|
|
5263 problem->caught_throw = 0;
|
|
|
5264 problem->error_conditions = Qnil;
|
|
|
5265 problem->data = Qnil;
|
|
|
5266 problem->backtrace = Qnil;
|
|
|
5267 problem->thrown_tag = Qnil;
|
|
|
5268 problem->thrown_value = Qnil;
|
|
853
|
5269 }
|
|
1333
|
5270 else if (EQ (thrown_tag, package.catchtag))
|
|
853
|
5271 {
|
|
1333
|
5272 problem->caught_error = 1;
|
|
|
5273 problem->caught_throw = 0;
|
|
|
5274 problem->error_conditions = package.error_conditions;
|
|
|
5275 problem->data = package.data;
|
|
|
5276 problem->backtrace = package.backtrace;
|
|
|
5277 problem->thrown_tag = Qnil;
|
|
|
5278 problem->thrown_value = Qnil;
|
|
853
|
5279 }
|
|
1333
|
5280 else
|
|
|
5281 {
|
|
|
5282 problem->caught_error = 0;
|
|
|
5283 problem->caught_throw = 1;
|
|
|
5284 problem->error_conditions = Qnil;
|
|
|
5285 problem->data = Qnil;
|
|
2532
|
5286 problem->backtrace = thrown_backtrace;
|
|
1333
|
5287 problem->thrown_tag = thrown_tag;
|
|
|
5288 problem->thrown_value = tem;
|
|
|
5289 }
|
|
|
5290
|
|
|
5291 if (!(flags & INHIBIT_WARNING_ISSUE) && !(flags & POSTPONE_WARNING_ISSUE))
|
|
|
5292 issue_call_trapping_problems_warning (warning_class, warning_string,
|
|
|
5293 problem);
|
|
853
|
5294
|
|
|
5295 if (!NILP (package.catchtag) &&
|
|
|
5296 !EQ (package.catchtag, Vcatch_everything_tag))
|
|
|
5297 free_opaque_ptr (package.catchtag);
|
|
|
5298
|
|
|
5299 if (!NILP (opaque))
|
|
|
5300 free_opaque_ptr (opaque);
|
|
|
5301
|
|
|
5302 unbind_to (speccount);
|
|
|
5303 RETURN_UNGCPRO (thrown ? Qunbound : tem);
|
|
|
5304 }
|
|
|
5305
|
|
|
5306 struct va_call_trapping_problems
|
|
|
5307 {
|
|
|
5308 lisp_fn_t fun;
|
|
|
5309 int nargs;
|
|
|
5310 Lisp_Object *args;
|
|
|
5311 };
|
|
|
5312
|
|
|
5313 static Lisp_Object
|
|
|
5314 va_call_trapping_problems_1 (void *ai_mi_madre)
|
|
|
5315 {
|
|
|
5316 struct va_call_trapping_problems *ai_no_corrida =
|
|
|
5317 (struct va_call_trapping_problems *) ai_mi_madre;
|
|
|
5318 Lisp_Object pegar_no_bumbum;
|
|
|
5319
|
|
|
5320 PRIMITIVE_FUNCALL (pegar_no_bumbum, ai_no_corrida->fun,
|
|
|
5321 ai_no_corrida->args, ai_no_corrida->nargs);
|
|
|
5322 return pegar_no_bumbum;
|
|
|
5323 }
|
|
|
5324
|
|
|
5325 /* #### document me. */
|
|
|
5326
|
|
|
5327 Lisp_Object
|
|
|
5328 va_call_trapping_problems (Lisp_Object warning_class,
|
|
867
|
5329 const CIbyte *warning_string,
|
|
853
|
5330 int flags,
|
|
|
5331 struct call_trapping_problems_result *problem,
|
|
|
5332 lisp_fn_t fun, int nargs, ...)
|
|
|
5333 {
|
|
|
5334 va_list vargs;
|
|
|
5335 Lisp_Object args[20];
|
|
|
5336 int i;
|
|
|
5337 struct va_call_trapping_problems fazer_invocacao_atrapalhando_problemas;
|
|
|
5338 struct gcpro gcpro1;
|
|
|
5339
|
|
|
5340 assert (nargs >= 0 && nargs < 20);
|
|
|
5341
|
|
|
5342 va_start (vargs, nargs);
|
|
|
5343 for (i = 0; i < nargs; i++)
|
|
|
5344 args[i] = va_arg (vargs, Lisp_Object);
|
|
|
5345 va_end (vargs);
|
|
|
5346
|
|
|
5347 fazer_invocacao_atrapalhando_problemas.fun = fun;
|
|
|
5348 fazer_invocacao_atrapalhando_problemas.nargs = nargs;
|
|
|
5349 fazer_invocacao_atrapalhando_problemas.args = args;
|
|
|
5350
|
|
|
5351 GCPRO1_ARRAY (args, nargs);
|
|
|
5352 RETURN_UNGCPRO
|
|
|
5353 (call_trapping_problems
|
|
|
5354 (warning_class, warning_string, flags, problem,
|
|
|
5355 va_call_trapping_problems_1, &fazer_invocacao_atrapalhando_problemas));
|
|
|
5356 }
|
|
|
5357
|
|
|
5358 /* this is an older interface, barely different from
|
|
|
5359 va_call_trapping_problems.
|
|
|
5360
|
|
|
5361 #### eliminate this or at least merge the ERROR_BEHAVIOR stuff into
|
|
|
5362 va_call_trapping_problems(). */
|
|
|
5363
|
|
|
5364 Lisp_Object
|
|
|
5365 call_with_suspended_errors (lisp_fn_t fun, Lisp_Object retval,
|
|
1204
|
5366 Lisp_Object class_, Error_Behavior errb,
|
|
853
|
5367 int nargs, ...)
|
|
|
5368 {
|
|
|
5369 va_list vargs;
|
|
|
5370 Lisp_Object args[20];
|
|
|
5371 int i;
|
|
|
5372 struct va_call_trapping_problems fazer_invocacao_atrapalhando_problemas;
|
|
|
5373 int flags;
|
|
|
5374 struct gcpro gcpro1;
|
|
|
5375
|
|
1204
|
5376 assert (SYMBOLP (class_)); /* sanity-check */
|
|
|
5377 assert (!NILP (class_));
|
|
853
|
5378 assert (nargs >= 0 && nargs < 20);
|
|
|
5379
|
|
|
5380 va_start (vargs, nargs);
|
|
|
5381 for (i = 0; i < nargs; i++)
|
|
|
5382 args[i] = va_arg (vargs, Lisp_Object);
|
|
|
5383 va_end (vargs);
|
|
|
5384
|
|
|
5385 /* If error-checking is not disabled, just call the function. */
|
|
|
5386
|
|
|
5387 if (ERRB_EQ (errb, ERROR_ME))
|
|
|
5388 {
|
|
|
5389 Lisp_Object val;
|
|
|
5390 PRIMITIVE_FUNCALL (val, fun, args, nargs);
|
|
|
5391 return val;
|
|
|
5392 }
|
|
|
5393
|
|
|
5394 if (ERRB_EQ (errb, ERROR_ME_NOT)) /* person wants no warnings */
|
|
|
5395 flags = INHIBIT_WARNING_ISSUE | INHIBIT_ENTERING_DEBUGGER;
|
|
|
5396 else if (ERRB_EQ (errb, ERROR_ME_DEBUG_WARN))
|
|
|
5397 flags = ISSUE_WARNINGS_AT_DEBUG_LEVEL | INHIBIT_ENTERING_DEBUGGER;
|
|
|
5398 else
|
|
|
5399 {
|
|
|
5400 assert (ERRB_EQ (errb, ERROR_ME_WARN));
|
|
|
5401 flags = INHIBIT_ENTERING_DEBUGGER;
|
|
|
5402 }
|
|
|
5403
|
|
|
5404 flags |= CALL_WITH_SUSPENDED_ERRORS;
|
|
|
5405
|
|
|
5406 fazer_invocacao_atrapalhando_problemas.fun = fun;
|
|
|
5407 fazer_invocacao_atrapalhando_problemas.nargs = nargs;
|
|
|
5408 fazer_invocacao_atrapalhando_problemas.args = args;
|
|
|
5409
|
|
|
5410 GCPRO1_ARRAY (args, nargs);
|
|
|
5411 {
|
|
|
5412 Lisp_Object its_way_too_goddamn_late =
|
|
|
5413 call_trapping_problems
|
|
1204
|
5414 (class_, 0, flags, 0, va_call_trapping_problems_1,
|
|
853
|
5415 &fazer_invocacao_atrapalhando_problemas);
|
|
|
5416 UNGCPRO;
|
|
|
5417 if (UNBOUNDP (its_way_too_goddamn_late))
|
|
|
5418 return retval;
|
|
|
5419 else
|
|
|
5420 return its_way_too_goddamn_late;
|
|
|
5421 }
|
|
|
5422 }
|
|
|
5423
|
|
|
5424 struct calln_trapping_problems
|
|
|
5425 {
|
|
|
5426 int nargs;
|
|
|
5427 Lisp_Object *args;
|
|
|
5428 };
|
|
|
5429
|
|
|
5430 static Lisp_Object
|
|
|
5431 calln_trapping_problems_1 (void *puta)
|
|
|
5432 {
|
|
|
5433 struct calln_trapping_problems *p = (struct calln_trapping_problems *) puta;
|
|
|
5434
|
|
|
5435 return Ffuncall (p->nargs, p->args);
|
|
428
|
5436 }
|
|
|
5437
|
|
|
5438 static Lisp_Object
|
|
853
|
5439 calln_trapping_problems (Lisp_Object warning_class,
|
|
867
|
5440 const CIbyte *warning_string, int flags,
|
|
853
|
5441 struct call_trapping_problems_result *problem,
|
|
|
5442 int nargs, Lisp_Object *args)
|
|
|
5443 {
|
|
|
5444 struct calln_trapping_problems foo;
|
|
|
5445 struct gcpro gcpro1;
|
|
|
5446
|
|
|
5447 if (SYMBOLP (args[0]))
|
|
|
5448 {
|
|
|
5449 Lisp_Object tem = XSYMBOL (args[0])->function;
|
|
|
5450 if (NILP (tem) || UNBOUNDP (tem))
|
|
|
5451 {
|
|
|
5452 if (problem)
|
|
|
5453 {
|
|
|
5454 problem->caught_error = 0;
|
|
|
5455 problem->caught_throw = 0;
|
|
|
5456 problem->error_conditions = Qnil;
|
|
|
5457 problem->data = Qnil;
|
|
|
5458 problem->backtrace = Qnil;
|
|
|
5459 problem->thrown_tag = Qnil;
|
|
|
5460 problem->thrown_value = Qnil;
|
|
|
5461 }
|
|
|
5462 return Qnil;
|
|
|
5463 }
|
|
|
5464 }
|
|
|
5465
|
|
|
5466 foo.nargs = nargs;
|
|
|
5467 foo.args = args;
|
|
|
5468
|
|
|
5469 GCPRO1_ARRAY (args, nargs);
|
|
|
5470 RETURN_UNGCPRO (call_trapping_problems (warning_class, warning_string,
|
|
|
5471 flags, problem,
|
|
|
5472 calln_trapping_problems_1,
|
|
|
5473 &foo));
|
|
|
5474 }
|
|
|
5475
|
|
|
5476 /* #### fix these functions to follow the calling convention of
|
|
|
5477 call_trapping_problems! */
|
|
|
5478
|
|
|
5479 Lisp_Object
|
|
867
|
5480 call0_trapping_problems (const CIbyte *warning_string, Lisp_Object function,
|
|
853
|
5481 int flags)
|
|
|
5482 {
|
|
|
5483 return calln_trapping_problems (Qerror, warning_string, flags, 0, 1,
|
|
|
5484 &function);
|
|
428
|
5485 }
|
|
|
5486
|
|
|
5487 Lisp_Object
|
|
867
|
5488 call1_trapping_problems (const CIbyte *warning_string, Lisp_Object function,
|
|
853
|
5489 Lisp_Object object, int flags)
|
|
|
5490 {
|
|
|
5491 Lisp_Object args[2];
|
|
|
5492
|
|
|
5493 args[0] = function;
|
|
|
5494 args[1] = object;
|
|
|
5495
|
|
|
5496 return calln_trapping_problems (Qerror, warning_string, flags, 0, 2,
|
|
|
5497 args);
|
|
|
5498 }
|
|
|
5499
|
|
|
5500 Lisp_Object
|
|
867
|
5501 call2_trapping_problems (const CIbyte *warning_string, Lisp_Object function,
|
|
853
|
5502 Lisp_Object object1, Lisp_Object object2,
|
|
|
5503 int flags)
|
|
|
5504 {
|
|
|
5505 Lisp_Object args[3];
|
|
|
5506
|
|
|
5507 args[0] = function;
|
|
|
5508 args[1] = object1;
|
|
|
5509 args[2] = object2;
|
|
|
5510
|
|
|
5511 return calln_trapping_problems (Qerror, warning_string, flags, 0, 3,
|
|
|
5512 args);
|
|
|
5513 }
|
|
|
5514
|
|
|
5515 Lisp_Object
|
|
867
|
5516 call3_trapping_problems (const CIbyte *warning_string, Lisp_Object function,
|
|
853
|
5517 Lisp_Object object1, Lisp_Object object2,
|
|
|
5518 Lisp_Object object3, int flags)
|
|
|
5519 {
|
|
|
5520 Lisp_Object args[4];
|
|
|
5521
|
|
|
5522 args[0] = function;
|
|
|
5523 args[1] = object1;
|
|
|
5524 args[2] = object2;
|
|
|
5525 args[3] = object3;
|
|
|
5526
|
|
|
5527 return calln_trapping_problems (Qerror, warning_string, flags, 0, 4,
|
|
|
5528 args);
|
|
|
5529 }
|
|
|
5530
|
|
|
5531 Lisp_Object
|
|
867
|
5532 call4_trapping_problems (const CIbyte *warning_string, Lisp_Object function,
|
|
853
|
5533 Lisp_Object object1, Lisp_Object object2,
|
|
|
5534 Lisp_Object object3, Lisp_Object object4,
|
|
|
5535 int flags)
|
|
|
5536 {
|
|
|
5537 Lisp_Object args[5];
|
|
|
5538
|
|
|
5539 args[0] = function;
|
|
|
5540 args[1] = object1;
|
|
|
5541 args[2] = object2;
|
|
|
5542 args[3] = object3;
|
|
|
5543 args[4] = object4;
|
|
|
5544
|
|
|
5545 return calln_trapping_problems (Qerror, warning_string, flags, 0, 5,
|
|
|
5546 args);
|
|
|
5547 }
|
|
|
5548
|
|
|
5549 Lisp_Object
|
|
867
|
5550 call5_trapping_problems (const CIbyte *warning_string, Lisp_Object function,
|
|
853
|
5551 Lisp_Object object1, Lisp_Object object2,
|
|
|
5552 Lisp_Object object3, Lisp_Object object4,
|
|
|
5553 Lisp_Object object5, int flags)
|
|
|
5554 {
|
|
|
5555 Lisp_Object args[6];
|
|
|
5556
|
|
|
5557 args[0] = function;
|
|
|
5558 args[1] = object1;
|
|
|
5559 args[2] = object2;
|
|
|
5560 args[3] = object3;
|
|
|
5561 args[4] = object4;
|
|
|
5562 args[5] = object5;
|
|
|
5563
|
|
|
5564 return calln_trapping_problems (Qerror, warning_string, flags, 0, 6,
|
|
|
5565 args);
|
|
|
5566 }
|
|
|
5567
|
|
|
5568 struct eval_in_buffer_trapping_problems
|
|
|
5569 {
|
|
|
5570 struct buffer *buf;
|
|
|
5571 Lisp_Object form;
|
|
|
5572 };
|
|
|
5573
|
|
|
5574 static Lisp_Object
|
|
|
5575 eval_in_buffer_trapping_problems_1 (void *arg)
|
|
|
5576 {
|
|
|
5577 struct eval_in_buffer_trapping_problems *p =
|
|
|
5578 (struct eval_in_buffer_trapping_problems *) arg;
|
|
|
5579
|
|
|
5580 return eval_in_buffer (p->buf, p->form);
|
|
|
5581 }
|
|
|
5582
|
|
|
5583 /* #### fix these functions to follow the calling convention of
|
|
|
5584 call_trapping_problems! */
|
|
|
5585
|
|
|
5586 Lisp_Object
|
|
867
|
5587 eval_in_buffer_trapping_problems (const CIbyte *warning_string,
|
|
853
|
5588 struct buffer *buf, Lisp_Object form,
|
|
|
5589 int flags)
|
|
|
5590 {
|
|
|
5591 struct eval_in_buffer_trapping_problems p;
|
|
|
5592 Lisp_Object buffer = wrap_buffer (buf);
|
|
428
|
5593 struct gcpro gcpro1, gcpro2;
|
|
|
5594
|
|
853
|
5595 GCPRO2 (buffer, form);
|
|
|
5596 p.buf = buf;
|
|
|
5597 p.form = form;
|
|
|
5598 RETURN_UNGCPRO (call_trapping_problems (Qerror, warning_string, flags, 0,
|
|
|
5599 eval_in_buffer_trapping_problems_1,
|
|
|
5600 &p));
|
|
|
5601 }
|
|
|
5602
|
|
|
5603 Lisp_Object
|
|
1333
|
5604 run_hook_trapping_problems (Lisp_Object warning_class,
|
|
853
|
5605 Lisp_Object hook_symbol,
|
|
|
5606 int flags)
|
|
|
5607 {
|
|
1333
|
5608 return run_hook_with_args_trapping_problems (warning_class, 1, &hook_symbol,
|
|
853
|
5609 RUN_HOOKS_TO_COMPLETION,
|
|
|
5610 flags);
|
|
428
|
5611 }
|
|
|
5612
|
|
|
5613 static Lisp_Object
|
|
853
|
5614 safe_run_hook_trapping_problems_1 (void *puta)
|
|
|
5615 {
|
|
|
5616 Lisp_Object hook = VOID_TO_LISP (puta);
|
|
|
5617
|
|
|
5618 run_hook (hook);
|
|
428
|
5619 return Qnil;
|
|
|
5620 }
|
|
|
5621
|
|
853
|
5622 /* Same as run_hook_trapping_problems() but also set the hook to nil
|
|
|
5623 if an error occurs (but not a quit). */
|
|
|
5624
|
|
428
|
5625 Lisp_Object
|
|
1333
|
5626 safe_run_hook_trapping_problems (Lisp_Object warning_class,
|
|
|
5627 Lisp_Object hook_symbol, int flags)
|
|
853
|
5628 {
|
|
428
|
5629 Lisp_Object tem;
|
|
853
|
5630 struct gcpro gcpro1, gcpro2;
|
|
|
5631 struct call_trapping_problems_result prob;
|
|
428
|
5632
|
|
|
5633 if (!initialized || preparing_for_armageddon)
|
|
|
5634 return Qnil;
|
|
|
5635 tem = find_symbol_value (hook_symbol);
|
|
|
5636 if (NILP (tem) || UNBOUNDP (tem))
|
|
|
5637 return Qnil;
|
|
|
5638
|
|
853
|
5639 GCPRO2 (hook_symbol, tem);
|
|
1333
|
5640 tem = call_trapping_problems (Qerror, NULL,
|
|
|
5641 flags | POSTPONE_WARNING_ISSUE,
|
|
853
|
5642 &prob,
|
|
|
5643 safe_run_hook_trapping_problems_1,
|
|
|
5644 LISP_TO_VOID (hook_symbol));
|
|
1333
|
5645 {
|
|
|
5646 Lisp_Object hook_name = XSYMBOL_NAME (hook_symbol);
|
|
|
5647 Ibyte *hook_str = XSTRING_DATA (hook_name);
|
|
|
5648 Ibyte *err = alloca_ibytes (XSTRING_LENGTH (hook_name) + 100);
|
|
|
5649
|
|
|
5650 if (prob.caught_throw || (prob.caught_error && !EQ (prob.error_conditions,
|
|
|
5651 Qquit)))
|
|
|
5652 {
|
|
|
5653 Fset (hook_symbol, Qnil);
|
|
|
5654 qxesprintf (err, "Error in `%s' (resetting to nil)", hook_str);
|
|
|
5655 }
|
|
|
5656 else
|
|
|
5657 qxesprintf (err, "Quit in `%s'", hook_str);
|
|
|
5658
|
|
|
5659
|
|
|
5660 issue_call_trapping_problems_warning (warning_class, (CIbyte *) err,
|
|
|
5661 &prob);
|
|
|
5662 }
|
|
|
5663
|
|
|
5664 UNGCPRO;
|
|
|
5665 return tem;
|
|
853
|
5666 }
|
|
|
5667
|
|
|
5668 struct run_hook_with_args_in_buffer_trapping_problems
|
|
|
5669 {
|
|
|
5670 struct buffer *buf;
|
|
|
5671 int nargs;
|
|
|
5672 Lisp_Object *args;
|
|
|
5673 enum run_hooks_condition cond;
|
|
|
5674 };
|
|
|
5675
|
|
|
5676 static Lisp_Object
|
|
|
5677 run_hook_with_args_in_buffer_trapping_problems_1 (void *puta)
|
|
|
5678 {
|
|
|
5679 struct run_hook_with_args_in_buffer_trapping_problems *porra =
|
|
|
5680 (struct run_hook_with_args_in_buffer_trapping_problems *) puta;
|
|
|
5681
|
|
|
5682 return run_hook_with_args_in_buffer (porra->buf, porra->nargs, porra->args,
|
|
|
5683 porra->cond);
|
|
|
5684 }
|
|
|
5685
|
|
|
5686 /* #### fix these functions to follow the calling convention of
|
|
|
5687 call_trapping_problems! */
|
|
428
|
5688
|
|
|
5689 Lisp_Object
|
|
1333
|
5690 run_hook_with_args_in_buffer_trapping_problems (Lisp_Object warning_class,
|
|
853
|
5691 struct buffer *buf, int nargs,
|
|
|
5692 Lisp_Object *args,
|
|
|
5693 enum run_hooks_condition cond,
|
|
|
5694 int flags)
|
|
|
5695 {
|
|
|
5696 Lisp_Object sym, val, ret;
|
|
|
5697 struct run_hook_with_args_in_buffer_trapping_problems diversity_and_distrust;
|
|
428
|
5698 struct gcpro gcpro1;
|
|
1333
|
5699 Lisp_Object hook_name;
|
|
|
5700 Ibyte *hook_str;
|
|
|
5701 Ibyte *err;
|
|
428
|
5702
|
|
|
5703 if (!initialized || preparing_for_armageddon)
|
|
853
|
5704 /* We need to bail out of here pronto. */
|
|
428
|
5705 return Qnil;
|
|
|
5706
|
|
853
|
5707 GCPRO1_ARRAY (args, nargs);
|
|
|
5708
|
|
|
5709 sym = args[0];
|
|
|
5710 val = symbol_value_in_buffer (sym, wrap_buffer (buf));
|
|
|
5711 ret = (cond == RUN_HOOKS_UNTIL_FAILURE ? Qt : Qnil);
|
|
|
5712
|
|
|
5713 if (UNBOUNDP (val) || NILP (val))
|
|
|
5714 RETURN_UNGCPRO (ret);
|
|
|
5715
|
|
|
5716 diversity_and_distrust.buf = buf;
|
|
|
5717 diversity_and_distrust.nargs = nargs;
|
|
|
5718 diversity_and_distrust.args = args;
|
|
|
5719 diversity_and_distrust.cond = cond;
|
|
|
5720
|
|
1333
|
5721 hook_name = XSYMBOL_NAME (args[0]);
|
|
|
5722 hook_str = XSTRING_DATA (hook_name);
|
|
|
5723 err = alloca_ibytes (XSTRING_LENGTH (hook_name) + 100);
|
|
|
5724 qxesprintf (err, "Error in `%s'", hook_str);
|
|
853
|
5725 RETURN_UNGCPRO
|
|
|
5726 (call_trapping_problems
|
|
1333
|
5727 (warning_class, (CIbyte *) err, flags, 0,
|
|
853
|
5728 run_hook_with_args_in_buffer_trapping_problems_1,
|
|
|
5729 &diversity_and_distrust));
|
|
428
|
5730 }
|
|
|
5731
|
|
|
5732 Lisp_Object
|
|
1333
|
5733 run_hook_with_args_trapping_problems (Lisp_Object warning_class,
|
|
853
|
5734 int nargs,
|
|
|
5735 Lisp_Object *args,
|
|
|
5736 enum run_hooks_condition cond,
|
|
|
5737 int flags)
|
|
|
5738 {
|
|
|
5739 return run_hook_with_args_in_buffer_trapping_problems
|
|
1333
|
5740 (warning_class, current_buffer, nargs, args, cond, flags);
|
|
428
|
5741 }
|
|
|
5742
|
|
|
5743 Lisp_Object
|
|
1333
|
5744 va_run_hook_with_args_trapping_problems (Lisp_Object warning_class,
|
|
853
|
5745 Lisp_Object hook_var,
|
|
|
5746 int nargs, ...)
|
|
|
5747 {
|
|
|
5748 /* This function can GC */
|
|
|
5749 struct gcpro gcpro1;
|
|
|
5750 int i;
|
|
|
5751 va_list vargs;
|
|
|
5752 Lisp_Object *funcall_args = alloca_array (Lisp_Object, 1 + nargs);
|
|
|
5753 int flags;
|
|
|
5754
|
|
|
5755 va_start (vargs, nargs);
|
|
|
5756 funcall_args[0] = hook_var;
|
|
|
5757 for (i = 0; i < nargs; i++)
|
|
|
5758 funcall_args[i + 1] = va_arg (vargs, Lisp_Object);
|
|
|
5759 flags = va_arg (vargs, int);
|
|
|
5760 va_end (vargs);
|
|
|
5761
|
|
|
5762 GCPRO1_ARRAY (funcall_args, nargs + 1);
|
|
|
5763 RETURN_UNGCPRO (run_hook_with_args_in_buffer_trapping_problems
|
|
1333
|
5764 (warning_class, current_buffer, nargs + 1, funcall_args,
|
|
853
|
5765 RUN_HOOKS_TO_COMPLETION, flags));
|
|
428
|
5766 }
|
|
|
5767
|
|
|
5768 Lisp_Object
|
|
1333
|
5769 va_run_hook_with_args_in_buffer_trapping_problems (Lisp_Object warning_class,
|
|
853
|
5770 struct buffer *buf,
|
|
|
5771 Lisp_Object hook_var,
|
|
|
5772 int nargs, ...)
|
|
|
5773 {
|
|
|
5774 /* This function can GC */
|
|
|
5775 struct gcpro gcpro1;
|
|
|
5776 int i;
|
|
|
5777 va_list vargs;
|
|
|
5778 Lisp_Object *funcall_args = alloca_array (Lisp_Object, 1 + nargs);
|
|
|
5779 int flags;
|
|
|
5780
|
|
|
5781 va_start (vargs, nargs);
|
|
|
5782 funcall_args[0] = hook_var;
|
|
|
5783 for (i = 0; i < nargs; i++)
|
|
|
5784 funcall_args[i + 1] = va_arg (vargs, Lisp_Object);
|
|
|
5785 flags = va_arg (vargs, int);
|
|
|
5786 va_end (vargs);
|
|
|
5787
|
|
|
5788 GCPRO1_ARRAY (funcall_args, nargs + 1);
|
|
|
5789 RETURN_UNGCPRO (run_hook_with_args_in_buffer_trapping_problems
|
|
1333
|
5790 (warning_class, buf, nargs + 1, funcall_args,
|
|
853
|
5791 RUN_HOOKS_TO_COMPLETION, flags));
|
|
428
|
5792 }
|
|
|
5793
|
|
|
5794
|
|
|
5795 /************************************************************************/
|
|
|
5796 /* The special binding stack */
|
|
771
|
5797 /* Most C code should simply use specbind() and unbind_to_1(). */
|
|
428
|
5798 /* When performance is critical, use the macros in backtrace.h. */
|
|
|
5799 /************************************************************************/
|
|
|
5800
|
|
|
5801 #define min_max_specpdl_size 400
|
|
|
5802
|
|
|
5803 void
|
|
647
|
5804 grow_specpdl (EMACS_INT reserved)
|
|
|
5805 {
|
|
|
5806 EMACS_INT size_needed = specpdl_depth() + reserved;
|
|
428
|
5807 if (size_needed >= max_specpdl_size)
|
|
|
5808 {
|
|
|
5809 if (max_specpdl_size < min_max_specpdl_size)
|
|
|
5810 max_specpdl_size = min_max_specpdl_size;
|
|
|
5811 if (size_needed >= max_specpdl_size)
|
|
|
5812 {
|
|
1951
|
5813 /* Leave room for some specpdl in the debugger. */
|
|
|
5814 max_specpdl_size = size_needed + 100;
|
|
|
5815 if (max_specpdl_size > specpdl_size)
|
|
|
5816 {
|
|
|
5817 specpdl_size = max_specpdl_size;
|
|
|
5818 XREALLOC_ARRAY (specpdl, struct specbinding, specpdl_size);
|
|
|
5819 specpdl_ptr = specpdl + specpdl_depth();
|
|
|
5820 }
|
|
563
|
5821 signal_continuable_error
|
|
|
5822 (Qstack_overflow,
|
|
|
5823 "Variable binding depth exceeds max-specpdl-size", Qunbound);
|
|
428
|
5824 }
|
|
|
5825 }
|
|
|
5826 while (specpdl_size < size_needed)
|
|
|
5827 {
|
|
|
5828 specpdl_size *= 2;
|
|
|
5829 if (specpdl_size > max_specpdl_size)
|
|
|
5830 specpdl_size = max_specpdl_size;
|
|
|
5831 }
|
|
|
5832 XREALLOC_ARRAY (specpdl, struct specbinding, specpdl_size);
|
|
|
5833 specpdl_ptr = specpdl + specpdl_depth();
|
|
853
|
5834 check_specbind_stack_sanity ();
|
|
428
|
5835 }
|
|
|
5836
|
|
|
5837
|
|
|
5838 /* Handle unbinding buffer-local variables */
|
|
|
5839 static Lisp_Object
|
|
|
5840 specbind_unwind_local (Lisp_Object ovalue)
|
|
|
5841 {
|
|
|
5842 Lisp_Object current = Fcurrent_buffer ();
|
|
|
5843 Lisp_Object symbol = specpdl_ptr->symbol;
|
|
853
|
5844 Lisp_Object victim = ovalue;
|
|
|
5845 Lisp_Object buf = get_buffer (XCAR (victim), 0);
|
|
|
5846 ovalue = XCDR (victim);
|
|
428
|
5847
|
|
|
5848 free_cons (victim);
|
|
|
5849
|
|
|
5850 if (NILP (buf))
|
|
|
5851 {
|
|
|
5852 /* Deleted buffer -- do nothing */
|
|
|
5853 }
|
|
|
5854 else if (symbol_value_buffer_local_info (symbol, XBUFFER (buf)) == 0)
|
|
|
5855 {
|
|
|
5856 /* Was buffer-local when binding was made, now no longer is.
|
|
|
5857 * (kill-local-variable can do this.)
|
|
|
5858 * Do nothing in this case.
|
|
|
5859 */
|
|
|
5860 }
|
|
|
5861 else if (EQ (buf, current))
|
|
|
5862 Fset (symbol, ovalue);
|
|
|
5863 else
|
|
|
5864 {
|
|
|
5865 /* Urk! Somebody switched buffers */
|
|
|
5866 struct gcpro gcpro1;
|
|
|
5867 GCPRO1 (current);
|
|
|
5868 Fset_buffer (buf);
|
|
|
5869 Fset (symbol, ovalue);
|
|
|
5870 Fset_buffer (current);
|
|
|
5871 UNGCPRO;
|
|
|
5872 }
|
|
|
5873 return symbol;
|
|
|
5874 }
|
|
|
5875
|
|
|
5876 static Lisp_Object
|
|
|
5877 specbind_unwind_wasnt_local (Lisp_Object buffer)
|
|
|
5878 {
|
|
|
5879 Lisp_Object current = Fcurrent_buffer ();
|
|
|
5880 Lisp_Object symbol = specpdl_ptr->symbol;
|
|
|
5881
|
|
|
5882 buffer = get_buffer (buffer, 0);
|
|
|
5883 if (NILP (buffer))
|
|
|
5884 {
|
|
|
5885 /* Deleted buffer -- do nothing */
|
|
|
5886 }
|
|
|
5887 else if (symbol_value_buffer_local_info (symbol, XBUFFER (buffer)) == 0)
|
|
|
5888 {
|
|
|
5889 /* Was buffer-local when binding was made, now no longer is.
|
|
|
5890 * (kill-local-variable can do this.)
|
|
|
5891 * Do nothing in this case.
|
|
|
5892 */
|
|
|
5893 }
|
|
|
5894 else if (EQ (buffer, current))
|
|
|
5895 Fkill_local_variable (symbol);
|
|
|
5896 else
|
|
|
5897 {
|
|
|
5898 /* Urk! Somebody switched buffers */
|
|
|
5899 struct gcpro gcpro1;
|
|
|
5900 GCPRO1 (current);
|
|
|
5901 Fset_buffer (buffer);
|
|
|
5902 Fkill_local_variable (symbol);
|
|
|
5903 Fset_buffer (current);
|
|
|
5904 UNGCPRO;
|
|
|
5905 }
|
|
|
5906 return symbol;
|
|
|
5907 }
|
|
|
5908
|
|
|
5909
|
|
|
5910 void
|
|
|
5911 specbind (Lisp_Object symbol, Lisp_Object value)
|
|
|
5912 {
|
|
|
5913 SPECBIND (symbol, value);
|
|
853
|
5914
|
|
|
5915 check_specbind_stack_sanity ();
|
|
428
|
5916 }
|
|
|
5917
|
|
|
5918 void
|
|
|
5919 specbind_magic (Lisp_Object symbol, Lisp_Object value)
|
|
|
5920 {
|
|
|
5921 int buffer_local =
|
|
|
5922 symbol_value_buffer_local_info (symbol, current_buffer);
|
|
|
5923
|
|
|
5924 if (buffer_local == 0)
|
|
|
5925 {
|
|
|
5926 specpdl_ptr->old_value = find_symbol_value (symbol);
|
|
771
|
5927 specpdl_ptr->func = 0; /* Handled specially by unbind_to_1 */
|
|
428
|
5928 }
|
|
|
5929 else if (buffer_local > 0)
|
|
|
5930 {
|
|
|
5931 /* Already buffer-local */
|
|
|
5932 specpdl_ptr->old_value = noseeum_cons (Fcurrent_buffer (),
|
|
|
5933 find_symbol_value (symbol));
|
|
|
5934 specpdl_ptr->func = specbind_unwind_local;
|
|
|
5935 }
|
|
|
5936 else
|
|
|
5937 {
|
|
|
5938 /* About to become buffer-local */
|
|
|
5939 specpdl_ptr->old_value = Fcurrent_buffer ();
|
|
|
5940 specpdl_ptr->func = specbind_unwind_wasnt_local;
|
|
|
5941 }
|
|
|
5942
|
|
|
5943 specpdl_ptr->symbol = symbol;
|
|
|
5944 specpdl_ptr++;
|
|
|
5945 specpdl_depth_counter++;
|
|
|
5946
|
|
|
5947 Fset (symbol, value);
|
|
853
|
5948
|
|
|
5949 check_specbind_stack_sanity ();
|
|
428
|
5950 }
|
|
|
5951
|
|
771
|
5952 /* Record an unwind-protect -- FUNCTION will be called with ARG no matter
|
|
|
5953 whether a normal or non-local exit occurs. (You need to call unbind_to_1()
|
|
|
5954 before your function returns normally, passing in the integer returned
|
|
|
5955 by this function.) Note: As long as the unwind-protect exists, ARG is
|
|
|
5956 automatically GCPRO'd. The return value from FUNCTION is completely
|
|
|
5957 ignored. #### We should eliminate it entirely. */
|
|
|
5958
|
|
|
5959 int
|
|
428
|
5960 record_unwind_protect (Lisp_Object (*function) (Lisp_Object arg),
|
|
|
5961 Lisp_Object arg)
|
|
|
5962 {
|
|
|
5963 SPECPDL_RESERVE (1);
|
|
|
5964 specpdl_ptr->func = function;
|
|
|
5965 specpdl_ptr->symbol = Qnil;
|
|
|
5966 specpdl_ptr->old_value = arg;
|
|
|
5967 specpdl_ptr++;
|
|
|
5968 specpdl_depth_counter++;
|
|
853
|
5969 check_specbind_stack_sanity ();
|
|
771
|
5970 return specpdl_depth_counter - 1;
|
|
|
5971 }
|
|
|
5972
|
|
|
5973 static Lisp_Object
|
|
802
|
5974 restore_lisp_object (Lisp_Object cons)
|
|
|
5975 {
|
|
|
5976 Lisp_Object opaque = XCAR (cons);
|
|
|
5977 Lisp_Object *addr = (Lisp_Object *) get_opaque_ptr (opaque);
|
|
|
5978 *addr = XCDR (cons);
|
|
|
5979 free_opaque_ptr (opaque);
|
|
853
|
5980 free_cons (cons);
|
|
802
|
5981 return Qnil;
|
|
|
5982 }
|
|
|
5983
|
|
|
5984 /* Establish an unwind-protect which will restore the Lisp_Object pointed to
|
|
|
5985 by ADDR with the value VAL. */
|
|
814
|
5986 static int
|
|
802
|
5987 record_unwind_protect_restoring_lisp_object (Lisp_Object *addr,
|
|
|
5988 Lisp_Object val)
|
|
|
5989 {
|
|
|
5990 Lisp_Object opaque = make_opaque_ptr (addr);
|
|
|
5991 return record_unwind_protect (restore_lisp_object,
|
|
|
5992 noseeum_cons (opaque, val));
|
|
|
5993 }
|
|
|
5994
|
|
|
5995 /* Similar to specbind() but for any C variable whose value is a
|
|
|
5996 Lisp_Object. Sets up an unwind-protect to restore the variable
|
|
|
5997 pointed to by ADDR to its existing value, and then changes its
|
|
|
5998 value to NEWVAL. Returns the previous value of specpdl_depth();
|
|
|
5999 pass this to unbind_to() after you are done. */
|
|
|
6000 int
|
|
|
6001 internal_bind_lisp_object (Lisp_Object *addr, Lisp_Object newval)
|
|
|
6002 {
|
|
|
6003 int count = specpdl_depth ();
|
|
|
6004 record_unwind_protect_restoring_lisp_object (addr, *addr);
|
|
|
6005 *addr = newval;
|
|
|
6006 return count;
|
|
|
6007 }
|
|
|
6008
|
|
|
6009 static Lisp_Object
|
|
|
6010 restore_int (Lisp_Object cons)
|
|
|
6011 {
|
|
|
6012 Lisp_Object opaque = XCAR (cons);
|
|
|
6013 Lisp_Object lval = XCDR (cons);
|
|
|
6014 int *addr = (int *) get_opaque_ptr (opaque);
|
|
|
6015 int val;
|
|
|
6016
|
|
4025
|
6017 /* In the event that a C integer will always fit in an Emacs int, we
|
|
|
6018 haven't ever stored a C integer as an opaque pointer. This #ifdef
|
|
|
6019 eliminates a warning on AMD 64, where EMACS_INT has 63 value bits and C
|
|
|
6020 integers have 32 value bits. */
|
|
|
6021 #if INT_VALBITS < INTBITS
|
|
802
|
6022 if (INTP (lval))
|
|
4025
|
6023 {
|
|
|
6024 val = XINT (lval);
|
|
|
6025 }
|
|
802
|
6026 else
|
|
|
6027 {
|
|
|
6028 val = (int) get_opaque_ptr (lval);
|
|
|
6029 free_opaque_ptr (lval);
|
|
|
6030 }
|
|
4025
|
6031 #else /* !(INT_VALBITS < INTBITS) */
|
|
|
6032 val = XINT(lval);
|
|
|
6033 #endif /* INT_VALBITS < INTBITS */
|
|
802
|
6034
|
|
|
6035 *addr = val;
|
|
|
6036 free_opaque_ptr (opaque);
|
|
853
|
6037 free_cons (cons);
|
|
802
|
6038 return Qnil;
|
|
|
6039 }
|
|
|
6040
|
|
|
6041 /* Establish an unwind-protect which will restore the int pointed to
|
|
|
6042 by ADDR with the value VAL. This function works correctly with
|
|
|
6043 all ints, even those that don't fit into a Lisp integer. */
|
|
1333
|
6044 int
|
|
802
|
6045 record_unwind_protect_restoring_int (int *addr, int val)
|
|
|
6046 {
|
|
|
6047 Lisp_Object opaque = make_opaque_ptr (addr);
|
|
|
6048 Lisp_Object lval;
|
|
|
6049
|
|
4025
|
6050 /* In the event that a C integer will always fit in an Emacs int, we don't
|
|
|
6051 ever want to store a C integer as an opaque pointer. This #ifdef
|
|
|
6052 eliminates a warning on AMD 64, where EMACS_INT has 63 value bits and C
|
|
|
6053 integers have 32 value bits. */
|
|
|
6054 #if INT_VALBITS <= INTBITS
|
|
802
|
6055 if (NUMBER_FITS_IN_AN_EMACS_INT (val))
|
|
|
6056 lval = make_int (val);
|
|
|
6057 else
|
|
|
6058 lval = make_opaque_ptr ((void *) val);
|
|
4025
|
6059 #else /* !(INT_VALBITS < INTBITS) */
|
|
|
6060 lval = make_int (val);
|
|
|
6061 #endif /* INT_VALBITS <= INTBITS */
|
|
|
6062
|
|
802
|
6063 return record_unwind_protect (restore_int, noseeum_cons (opaque, lval));
|
|
|
6064 }
|
|
|
6065
|
|
|
6066 /* Similar to specbind() but for any C variable whose value is an int.
|
|
|
6067 Sets up an unwind-protect to restore the variable pointed to by
|
|
|
6068 ADDR to its existing value, and then changes its value to NEWVAL.
|
|
|
6069 Returns the previous value of specpdl_depth(); pass this to
|
|
|
6070 unbind_to() after you are done. This function works correctly with
|
|
|
6071 all ints, even those that don't fit into a Lisp integer. */
|
|
|
6072 int
|
|
|
6073 internal_bind_int (int *addr, int newval)
|
|
|
6074 {
|
|
|
6075 int count = specpdl_depth ();
|
|
|
6076 record_unwind_protect_restoring_int (addr, *addr);
|
|
|
6077 *addr = newval;
|
|
|
6078 return count;
|
|
|
6079 }
|
|
|
6080
|
|
|
6081 static Lisp_Object
|
|
771
|
6082 free_pointer (Lisp_Object opaque)
|
|
|
6083 {
|
|
1726
|
6084 xfree (get_opaque_ptr (opaque), void *);
|
|
771
|
6085 free_opaque_ptr (opaque);
|
|
|
6086 return Qnil;
|
|
|
6087 }
|
|
|
6088
|
|
|
6089 /* Establish an unwind-protect which will free the specified block.
|
|
|
6090 */
|
|
|
6091 int
|
|
|
6092 record_unwind_protect_freeing (void *ptr)
|
|
|
6093 {
|
|
|
6094 Lisp_Object opaque = make_opaque_ptr (ptr);
|
|
|
6095 return record_unwind_protect (free_pointer, opaque);
|
|
|
6096 }
|
|
|
6097
|
|
|
6098 static Lisp_Object
|
|
|
6099 free_dynarr (Lisp_Object opaque)
|
|
|
6100 {
|
|
|
6101 Dynarr_free (get_opaque_ptr (opaque));
|
|
|
6102 free_opaque_ptr (opaque);
|
|
|
6103 return Qnil;
|
|
|
6104 }
|
|
|
6105
|
|
|
6106 int
|
|
|
6107 record_unwind_protect_freeing_dynarr (void *ptr)
|
|
|
6108 {
|
|
|
6109 Lisp_Object opaque = make_opaque_ptr (ptr);
|
|
|
6110 return record_unwind_protect (free_dynarr, opaque);
|
|
|
6111 }
|
|
428
|
6112
|
|
|
6113 /* Unwind the stack till specpdl_depth() == COUNT.
|
|
|
6114 VALUE is not used, except that, purely as a convenience to the
|
|
771
|
6115 caller, it is protected from garbage-protection and returned. */
|
|
428
|
6116 Lisp_Object
|
|
771
|
6117 unbind_to_1 (int count, Lisp_Object value)
|
|
428
|
6118 {
|
|
|
6119 UNBIND_TO_GCPRO (count, value);
|
|
853
|
6120 check_specbind_stack_sanity ();
|
|
428
|
6121 return value;
|
|
|
6122 }
|
|
|
6123
|
|
|
6124 /* Don't call this directly.
|
|
|
6125 Only for use by UNBIND_TO* macros in backtrace.h */
|
|
|
6126 void
|
|
|
6127 unbind_to_hairy (int count)
|
|
|
6128 {
|
|
442
|
6129 ++specpdl_ptr;
|
|
|
6130 ++specpdl_depth_counter;
|
|
|
6131
|
|
428
|
6132 while (specpdl_depth_counter != count)
|
|
|
6133 {
|
|
1313
|
6134 Lisp_Object oquit = Qunbound;
|
|
|
6135
|
|
|
6136 /* Do this check BEFORE decrementing the values below, because once
|
|
|
6137 they're decremented, GC protection is lost on
|
|
|
6138 specpdl_ptr->old_value. */
|
|
1322
|
6139 if (specpdl_ptr[-1].func == Fprogn)
|
|
1313
|
6140 {
|
|
|
6141 /* Allow QUIT within unwind-protect routines, but defer any
|
|
|
6142 existing QUIT until afterwards. Only do this, however, for
|
|
|
6143 unwind-protects established by Lisp code, not by C code
|
|
|
6144 (e.g. free_opaque_ptr() or something), because the act of
|
|
|
6145 checking for QUIT can cause all sorts of weird things to
|
|
|
6146 happen, since it churns the event loop -- redisplay, running
|
|
|
6147 Lisp, etc. Code should not have to worry about this just
|
|
|
6148 because of establishing an unwind-protect. */
|
|
|
6149 check_quit (); /* make Vquit_flag accurate */
|
|
|
6150 oquit = Vquit_flag;
|
|
|
6151 Vquit_flag = Qnil;
|
|
|
6152 }
|
|
|
6153
|
|
428
|
6154 --specpdl_ptr;
|
|
|
6155 --specpdl_depth_counter;
|
|
|
6156
|
|
1313
|
6157 /* #### At this point, there is no GC protection on old_value. This
|
|
|
6158 could be a real problem, depending on what unwind-protect function
|
|
|
6159 is called. It looks like it just so happens that the ones
|
|
|
6160 actually called don't have a problem with this, e.g. Fprogn. But
|
|
|
6161 we should look into fixing this. (Many unwind-protect functions
|
|
|
6162 free values. Is it a problem if freed values are
|
|
|
6163 GC-protected?) */
|
|
428
|
6164 if (specpdl_ptr->func != 0)
|
|
1313
|
6165 {
|
|
|
6166 /* An unwind-protect */
|
|
|
6167 (*specpdl_ptr->func) (specpdl_ptr->old_value);
|
|
|
6168 }
|
|
|
6169
|
|
428
|
6170 else
|
|
|
6171 {
|
|
|
6172 /* We checked symbol for validity when we specbound it,
|
|
|
6173 so only need to call Fset if symbol has magic value. */
|
|
440
|
6174 Lisp_Symbol *sym = XSYMBOL (specpdl_ptr->symbol);
|
|
428
|
6175 if (!SYMBOL_VALUE_MAGIC_P (sym->value))
|
|
|
6176 sym->value = specpdl_ptr->old_value;
|
|
|
6177 else
|
|
|
6178 Fset (specpdl_ptr->symbol, specpdl_ptr->old_value);
|
|
|
6179 }
|
|
|
6180
|
|
|
6181 #if 0 /* martin */
|
|
|
6182 #ifndef EXCEEDINGLY_QUESTIONABLE_CODE
|
|
|
6183 /* There should never be anything here for us to remove.
|
|
|
6184 If so, it indicates a logic error in Emacs. Catches
|
|
|
6185 should get removed when a throw or signal occurs, or
|
|
|
6186 when a catch or condition-case exits normally. But
|
|
|
6187 it's too dangerous to just remove this code. --ben */
|
|
|
6188
|
|
|
6189 /* Furthermore, this code is not in FSFmacs!!!
|
|
|
6190 Braino on mly's part? */
|
|
|
6191 /* If we're unwound past the pdlcount of a catch frame,
|
|
|
6192 that catch can't possibly still be valid. */
|
|
|
6193 while (catchlist && catchlist->pdlcount > specpdl_depth_counter)
|
|
|
6194 {
|
|
|
6195 catchlist = catchlist->next;
|
|
|
6196 /* Don't mess with gcprolist, backtrace_list here */
|
|
|
6197 }
|
|
|
6198 #endif
|
|
|
6199 #endif
|
|
1313
|
6200
|
|
|
6201 if (!UNBOUNDP (oquit))
|
|
|
6202 Vquit_flag = oquit;
|
|
428
|
6203 }
|
|
853
|
6204 check_specbind_stack_sanity ();
|
|
428
|
6205 }
|
|
|
6206
|
|
|
6207
|
|
|
6208
|
|
|
6209 /* Get the value of symbol's global binding, even if that binding is
|
|
|
6210 not now dynamically visible. May return Qunbound or magic values. */
|
|
|
6211
|
|
|
6212 Lisp_Object
|
|
|
6213 top_level_value (Lisp_Object symbol)
|
|
|
6214 {
|
|
|
6215 REGISTER struct specbinding *ptr = specpdl;
|
|
|
6216
|
|
|
6217 CHECK_SYMBOL (symbol);
|
|
|
6218 for (; ptr != specpdl_ptr; ptr++)
|
|
|
6219 {
|
|
|
6220 if (EQ (ptr->symbol, symbol))
|
|
|
6221 return ptr->old_value;
|
|
|
6222 }
|
|
|
6223 return XSYMBOL (symbol)->value;
|
|
|
6224 }
|
|
|
6225
|
|
|
6226 #if 0
|
|
|
6227
|
|
|
6228 Lisp_Object
|
|
|
6229 top_level_set (Lisp_Object symbol, Lisp_Object newval)
|
|
|
6230 {
|
|
|
6231 REGISTER struct specbinding *ptr = specpdl;
|
|
|
6232
|
|
|
6233 CHECK_SYMBOL (symbol);
|
|
|
6234 for (; ptr != specpdl_ptr; ptr++)
|
|
|
6235 {
|
|
|
6236 if (EQ (ptr->symbol, symbol))
|
|
|
6237 {
|
|
|
6238 ptr->old_value = newval;
|
|
|
6239 return newval;
|
|
|
6240 }
|
|
|
6241 }
|
|
|
6242 return Fset (symbol, newval);
|
|
|
6243 }
|
|
|
6244
|
|
|
6245 #endif /* 0 */
|
|
|
6246
|
|
|
6247
|
|
|
6248 /************************************************************************/
|
|
|
6249 /* Backtraces */
|
|
|
6250 /************************************************************************/
|
|
|
6251
|
|
|
6252 DEFUN ("backtrace-debug", Fbacktrace_debug, 2, 2, 0, /*
|
|
|
6253 Set the debug-on-exit flag of eval frame LEVEL levels down to FLAG.
|
|
|
6254 The debugger is entered when that frame exits, if the flag is non-nil.
|
|
|
6255 */
|
|
|
6256 (level, flag))
|
|
|
6257 {
|
|
|
6258 REGISTER struct backtrace *backlist = backtrace_list;
|
|
|
6259 REGISTER int i;
|
|
|
6260
|
|
|
6261 CHECK_INT (level);
|
|
|
6262
|
|
|
6263 for (i = 0; backlist && i < XINT (level); i++)
|
|
|
6264 {
|
|
|
6265 backlist = backlist->next;
|
|
|
6266 }
|
|
|
6267
|
|
|
6268 if (backlist)
|
|
|
6269 backlist->debug_on_exit = !NILP (flag);
|
|
|
6270
|
|
|
6271 return flag;
|
|
|
6272 }
|
|
|
6273
|
|
|
6274 static void
|
|
|
6275 backtrace_specials (int speccount, int speclimit, Lisp_Object stream)
|
|
|
6276 {
|
|
|
6277 int printing_bindings = 0;
|
|
|
6278
|
|
|
6279 for (; speccount > speclimit; speccount--)
|
|
|
6280 {
|
|
|
6281 if (specpdl[speccount - 1].func == 0
|
|
|
6282 || specpdl[speccount - 1].func == specbind_unwind_local
|
|
|
6283 || specpdl[speccount - 1].func == specbind_unwind_wasnt_local)
|
|
|
6284 {
|
|
826
|
6285 write_c_string (stream, !printing_bindings ? " # bind (" : " ");
|
|
428
|
6286 Fprin1 (specpdl[speccount - 1].symbol, stream);
|
|
|
6287 printing_bindings = 1;
|
|
|
6288 }
|
|
|
6289 else
|
|
|
6290 {
|
|
826
|
6291 if (printing_bindings) write_c_string (stream, ")\n");
|
|
|
6292 write_c_string (stream, " # (unwind-protect ...)\n");
|
|
428
|
6293 printing_bindings = 0;
|
|
|
6294 }
|
|
|
6295 }
|
|
826
|
6296 if (printing_bindings) write_c_string (stream, ")\n");
|
|
428
|
6297 }
|
|
|
6298
|
|
1292
|
6299 static Lisp_Object
|
|
|
6300 backtrace_unevalled_args (Lisp_Object *args)
|
|
|
6301 {
|
|
|
6302 if (args)
|
|
|
6303 return *args;
|
|
|
6304 else
|
|
|
6305 return list1 (build_string ("[internal]"));
|
|
|
6306 }
|
|
|
6307
|
|
428
|
6308 DEFUN ("backtrace", Fbacktrace, 0, 2, "", /*
|
|
|
6309 Print a trace of Lisp function calls currently active.
|
|
438
|
6310 Optional arg STREAM specifies the output stream to send the backtrace to,
|
|
444
|
6311 and defaults to the value of `standard-output'.
|
|
|
6312 Optional second arg DETAILED non-nil means show places where currently
|
|
|
6313 active variable bindings, catches, condition-cases, and
|
|
|
6314 unwind-protects, as well as function calls, were made.
|
|
428
|
6315 */
|
|
|
6316 (stream, detailed))
|
|
|
6317 {
|
|
|
6318 /* This function can GC */
|
|
|
6319 struct backtrace *backlist = backtrace_list;
|
|
|
6320 struct catchtag *catches = catchlist;
|
|
|
6321 int speccount = specpdl_depth();
|
|
|
6322
|
|
|
6323 int old_nl = print_escape_newlines;
|
|
|
6324 int old_pr = print_readably;
|
|
|
6325 Lisp_Object old_level = Vprint_level;
|
|
|
6326 Lisp_Object oiq = Vinhibit_quit;
|
|
|
6327 struct gcpro gcpro1, gcpro2;
|
|
|
6328
|
|
|
6329 /* We can't allow quits in here because that could cause the values
|
|
|
6330 of print_readably and print_escape_newlines to get screwed up.
|
|
|
6331 Normally we would use a record_unwind_protect but that would
|
|
|
6332 screw up the functioning of this function. */
|
|
|
6333 Vinhibit_quit = Qt;
|
|
|
6334
|
|
|
6335 entering_debugger = 0;
|
|
|
6336
|
|
872
|
6337 if (!NILP (detailed))
|
|
|
6338 Vprint_level = make_int (50);
|
|
|
6339 else
|
|
|
6340 Vprint_level = make_int (3);
|
|
428
|
6341 print_readably = 0;
|
|
|
6342 print_escape_newlines = 1;
|
|
|
6343
|
|
|
6344 GCPRO2 (stream, old_level);
|
|
|
6345
|
|
1261
|
6346 stream = canonicalize_printcharfun (stream);
|
|
428
|
6347
|
|
|
6348 for (;;)
|
|
|
6349 {
|
|
|
6350 if (!NILP (detailed) && catches && catches->backlist == backlist)
|
|
|
6351 {
|
|
|
6352 int catchpdl = catches->pdlcount;
|
|
438
|
6353 if (speccount > catchpdl
|
|
|
6354 && specpdl[catchpdl].func == condition_case_unwind)
|
|
428
|
6355 /* This is a condition-case catchpoint */
|
|
|
6356 catchpdl = catchpdl + 1;
|
|
|
6357
|
|
|
6358 backtrace_specials (speccount, catchpdl, stream);
|
|
|
6359
|
|
|
6360 speccount = catches->pdlcount;
|
|
|
6361 if (catchpdl == speccount)
|
|
|
6362 {
|
|
826
|
6363 write_c_string (stream, " # (catch ");
|
|
428
|
6364 Fprin1 (catches->tag, stream);
|
|
826
|
6365 write_c_string (stream, " ...)\n");
|
|
428
|
6366 }
|
|
|
6367 else
|
|
|
6368 {
|
|
826
|
6369 write_c_string (stream, " # (condition-case ... . ");
|
|
428
|
6370 Fprin1 (Fcdr (Fcar (catches->tag)), stream);
|
|
826
|
6371 write_c_string (stream, ")\n");
|
|
428
|
6372 }
|
|
|
6373 catches = catches->next;
|
|
|
6374 }
|
|
|
6375 else if (!backlist)
|
|
|
6376 break;
|
|
|
6377 else
|
|
|
6378 {
|
|
|
6379 if (!NILP (detailed) && backlist->pdlcount < speccount)
|
|
|
6380 {
|
|
|
6381 backtrace_specials (speccount, backlist->pdlcount, stream);
|
|
|
6382 speccount = backlist->pdlcount;
|
|
|
6383 }
|
|
826
|
6384 write_c_string (stream, backlist->debug_on_exit ? "* " : " ");
|
|
428
|
6385 if (backlist->nargs == UNEVALLED)
|
|
|
6386 {
|
|
1292
|
6387 Fprin1 (Fcons (*backlist->function,
|
|
|
6388 backtrace_unevalled_args (backlist->args)),
|
|
|
6389 stream);
|
|
826
|
6390 write_c_string (stream, "\n"); /* from FSFmacs 19.30 */
|
|
428
|
6391 }
|
|
|
6392 else
|
|
|
6393 {
|
|
|
6394 Lisp_Object tem = *backlist->function;
|
|
|
6395 Fprin1 (tem, stream); /* This can QUIT */
|
|
826
|
6396 write_c_string (stream, "(");
|
|
428
|
6397 if (backlist->nargs == MANY)
|
|
|
6398 {
|
|
|
6399 int i;
|
|
|
6400 Lisp_Object tail = Qnil;
|
|
|
6401 struct gcpro ngcpro1;
|
|
|
6402
|
|
|
6403 NGCPRO1 (tail);
|
|
|
6404 for (tail = *backlist->args, i = 0;
|
|
|
6405 !NILP (tail);
|
|
|
6406 tail = Fcdr (tail), i++)
|
|
|
6407 {
|
|
826
|
6408 if (i != 0) write_c_string (stream, " ");
|
|
428
|
6409 Fprin1 (Fcar (tail), stream);
|
|
|
6410 }
|
|
|
6411 NUNGCPRO;
|
|
|
6412 }
|
|
|
6413 else
|
|
|
6414 {
|
|
|
6415 int i;
|
|
|
6416 for (i = 0; i < backlist->nargs; i++)
|
|
|
6417 {
|
|
826
|
6418 if (!i && EQ (tem, Qbyte_code))
|
|
|
6419 {
|
|
|
6420 write_c_string (stream, "\"...\"");
|
|
|
6421 continue;
|
|
|
6422 }
|
|
|
6423 if (i != 0) write_c_string (stream, " ");
|
|
428
|
6424 Fprin1 (backlist->args[i], stream);
|
|
|
6425 }
|
|
|
6426 }
|
|
826
|
6427 write_c_string (stream, ")\n");
|
|
428
|
6428 }
|
|
|
6429 backlist = backlist->next;
|
|
|
6430 }
|
|
|
6431 }
|
|
|
6432 Vprint_level = old_level;
|
|
|
6433 print_readably = old_pr;
|
|
|
6434 print_escape_newlines = old_nl;
|
|
|
6435 UNGCPRO;
|
|
|
6436 Vinhibit_quit = oiq;
|
|
|
6437 return Qnil;
|
|
|
6438 }
|
|
|
6439
|
|
|
6440
|
|
444
|
6441 DEFUN ("backtrace-frame", Fbacktrace_frame, 1, 1, 0, /*
|
|
|
6442 Return the function and arguments NFRAMES up from current execution point.
|
|
428
|
6443 If that frame has not evaluated the arguments yet (or is a special form),
|
|
|
6444 the value is (nil FUNCTION ARG-FORMS...).
|
|
|
6445 If that frame has evaluated its arguments and called its function already,
|
|
|
6446 the value is (t FUNCTION ARG-VALUES...).
|
|
|
6447 A &rest arg is represented as the tail of the list ARG-VALUES.
|
|
|
6448 FUNCTION is whatever was supplied as car of evaluated list,
|
|
|
6449 or a lambda expression for macro calls.
|
|
444
|
6450 If NFRAMES is more than the number of frames, the value is nil.
|
|
428
|
6451 */
|
|
|
6452 (nframes))
|
|
|
6453 {
|
|
|
6454 REGISTER struct backtrace *backlist = backtrace_list;
|
|
|
6455 REGISTER int i;
|
|
|
6456 Lisp_Object tem;
|
|
|
6457
|
|
|
6458 CHECK_NATNUM (nframes);
|
|
|
6459
|
|
|
6460 /* Find the frame requested. */
|
|
|
6461 for (i = XINT (nframes); backlist && (i-- > 0);)
|
|
|
6462 backlist = backlist->next;
|
|
|
6463
|
|
|
6464 if (!backlist)
|
|
|
6465 return Qnil;
|
|
|
6466 if (backlist->nargs == UNEVALLED)
|
|
1292
|
6467 return Fcons (Qnil, Fcons (*backlist->function,
|
|
|
6468 backtrace_unevalled_args (backlist->args)));
|
|
428
|
6469 else
|
|
|
6470 {
|
|
|
6471 if (backlist->nargs == MANY)
|
|
|
6472 tem = *backlist->args;
|
|
|
6473 else
|
|
|
6474 tem = Flist (backlist->nargs, backlist->args);
|
|
|
6475
|
|
|
6476 return Fcons (Qt, Fcons (*backlist->function, tem));
|
|
|
6477 }
|
|
|
6478 }
|
|
|
6479
|
|
|
6480
|
|
|
6481 /************************************************************************/
|
|
|
6482 /* Warnings */
|
|
|
6483 /************************************************************************/
|
|
|
6484
|
|
1123
|
6485 static int
|
|
|
6486 warning_will_be_discarded (Lisp_Object level)
|
|
|
6487 {
|
|
|
6488 /* Don't even generate debug warnings if they're going to be discarded,
|
|
|
6489 to avoid excessive consing. */
|
|
|
6490 return (EQ (level, Qdebug) && !NILP (Vlog_warning_minimum_level) &&
|
|
|
6491 !EQ (Vlog_warning_minimum_level, Qdebug));
|
|
|
6492 }
|
|
|
6493
|
|
428
|
6494 void
|
|
1204
|
6495 warn_when_safe_lispobj (Lisp_Object class_, Lisp_Object level,
|
|
428
|
6496 Lisp_Object obj)
|
|
|
6497 {
|
|
1123
|
6498 if (warning_will_be_discarded (level))
|
|
793
|
6499 return;
|
|
1123
|
6500
|
|
1204
|
6501 obj = list1 (list3 (class_, level, obj));
|
|
428
|
6502 if (NILP (Vpending_warnings))
|
|
|
6503 Vpending_warnings = Vpending_warnings_tail = obj;
|
|
|
6504 else
|
|
|
6505 {
|
|
|
6506 Fsetcdr (Vpending_warnings_tail, obj);
|
|
|
6507 Vpending_warnings_tail = obj;
|
|
|
6508 }
|
|
|
6509 }
|
|
|
6510
|
|
|
6511 /* #### This should probably accept Lisp objects; but then we have
|
|
|
6512 to make sure that Feval() isn't called, since it might not be safe.
|
|
|
6513
|
|
|
6514 An alternative approach is to just pass some non-string type of
|
|
|
6515 Lisp_Object to warn_when_safe_lispobj(); `prin1-to-string' will
|
|
|
6516 automatically be called when it is safe to do so. */
|
|
|
6517
|
|
|
6518 void
|
|
1204
|
6519 warn_when_safe (Lisp_Object class_, Lisp_Object level, const CIbyte *fmt, ...)
|
|
428
|
6520 {
|
|
|
6521 Lisp_Object obj;
|
|
|
6522 va_list args;
|
|
|
6523
|
|
1123
|
6524 if (warning_will_be_discarded (level))
|
|
793
|
6525 return;
|
|
1123
|
6526
|
|
428
|
6527 va_start (args, fmt);
|
|
771
|
6528 obj = emacs_vsprintf_string (CGETTEXT (fmt), args);
|
|
428
|
6529 va_end (args);
|
|
|
6530
|
|
1204
|
6531 warn_when_safe_lispobj (class_, level, obj);
|
|
428
|
6532 }
|
|
|
6533
|
|
|
6534
|
|
|
6535
|
|
|
6536
|
|
|
6537 /************************************************************************/
|
|
|
6538 /* Initialization */
|
|
|
6539 /************************************************************************/
|
|
|
6540
|
|
|
6541 void
|
|
|
6542 syms_of_eval (void)
|
|
|
6543 {
|
|
442
|
6544 INIT_LRECORD_IMPLEMENTATION (subr);
|
|
|
6545
|
|
563
|
6546 DEFSYMBOL (Qinhibit_quit);
|
|
|
6547 DEFSYMBOL (Qautoload);
|
|
|
6548 DEFSYMBOL (Qdebug_on_error);
|
|
|
6549 DEFSYMBOL (Qstack_trace_on_error);
|
|
|
6550 DEFSYMBOL (Qdebug_on_signal);
|
|
|
6551 DEFSYMBOL (Qstack_trace_on_signal);
|
|
|
6552 DEFSYMBOL (Qdebugger);
|
|
|
6553 DEFSYMBOL (Qmacro);
|
|
428
|
6554 defsymbol (&Qand_rest, "&rest");
|
|
|
6555 defsymbol (&Qand_optional, "&optional");
|
|
|
6556 /* Note that the process code also uses Qexit */
|
|
563
|
6557 DEFSYMBOL (Qexit);
|
|
|
6558 DEFSYMBOL (Qsetq);
|
|
|
6559 DEFSYMBOL (Qinteractive);
|
|
|
6560 DEFSYMBOL (Qcommandp);
|
|
|
6561 DEFSYMBOL (Qdefun);
|
|
|
6562 DEFSYMBOL (Qprogn);
|
|
|
6563 DEFSYMBOL (Qvalues);
|
|
|
6564 DEFSYMBOL (Qdisplay_warning);
|
|
|
6565 DEFSYMBOL (Qrun_hooks);
|
|
887
|
6566 DEFSYMBOL (Qfinalize_list);
|
|
563
|
6567 DEFSYMBOL (Qif);
|
|
428
|
6568
|
|
|
6569 DEFSUBR (For);
|
|
|
6570 DEFSUBR (Fand);
|
|
|
6571 DEFSUBR (Fif);
|
|
|
6572 DEFSUBR_MACRO (Fwhen);
|
|
|
6573 DEFSUBR_MACRO (Funless);
|
|
|
6574 DEFSUBR (Fcond);
|
|
|
6575 DEFSUBR (Fprogn);
|
|
|
6576 DEFSUBR (Fprog1);
|
|
|
6577 DEFSUBR (Fprog2);
|
|
|
6578 DEFSUBR (Fsetq);
|
|
|
6579 DEFSUBR (Fquote);
|
|
|
6580 DEFSUBR (Ffunction);
|
|
|
6581 DEFSUBR (Fdefun);
|
|
|
6582 DEFSUBR (Fdefmacro);
|
|
|
6583 DEFSUBR (Fdefvar);
|
|
|
6584 DEFSUBR (Fdefconst);
|
|
|
6585 DEFSUBR (Fuser_variable_p);
|
|
|
6586 DEFSUBR (Flet);
|
|
|
6587 DEFSUBR (FletX);
|
|
|
6588 DEFSUBR (Fwhile);
|
|
|
6589 DEFSUBR (Fmacroexpand_internal);
|
|
|
6590 DEFSUBR (Fcatch);
|
|
|
6591 DEFSUBR (Fthrow);
|
|
|
6592 DEFSUBR (Funwind_protect);
|
|
|
6593 DEFSUBR (Fcondition_case);
|
|
|
6594 DEFSUBR (Fcall_with_condition_handler);
|
|
|
6595 DEFSUBR (Fsignal);
|
|
|
6596 DEFSUBR (Finteractive_p);
|
|
|
6597 DEFSUBR (Fcommandp);
|
|
|
6598 DEFSUBR (Fcommand_execute);
|
|
|
6599 DEFSUBR (Fautoload);
|
|
|
6600 DEFSUBR (Feval);
|
|
|
6601 DEFSUBR (Fapply);
|
|
|
6602 DEFSUBR (Ffuncall);
|
|
|
6603 DEFSUBR (Ffunctionp);
|
|
|
6604 DEFSUBR (Ffunction_min_args);
|
|
|
6605 DEFSUBR (Ffunction_max_args);
|
|
|
6606 DEFSUBR (Frun_hooks);
|
|
|
6607 DEFSUBR (Frun_hook_with_args);
|
|
|
6608 DEFSUBR (Frun_hook_with_args_until_success);
|
|
|
6609 DEFSUBR (Frun_hook_with_args_until_failure);
|
|
|
6610 DEFSUBR (Fbacktrace_debug);
|
|
|
6611 DEFSUBR (Fbacktrace);
|
|
|
6612 DEFSUBR (Fbacktrace_frame);
|
|
|
6613 }
|
|
|
6614
|
|
|
6615 void
|
|
814
|
6616 init_eval_semi_early (void)
|
|
428
|
6617 {
|
|
|
6618 specpdl_ptr = specpdl;
|
|
|
6619 specpdl_depth_counter = 0;
|
|
|
6620 catchlist = 0;
|
|
|
6621 Vcondition_handlers = Qnil;
|
|
|
6622 backtrace_list = 0;
|
|
|
6623 Vquit_flag = Qnil;
|
|
|
6624 debug_on_next_call = 0;
|
|
|
6625 lisp_eval_depth = 0;
|
|
|
6626 entering_debugger = 0;
|
|
|
6627 }
|
|
|
6628
|
|
|
6629 void
|
|
|
6630 reinit_vars_of_eval (void)
|
|
|
6631 {
|
|
|
6632 preparing_for_armageddon = 0;
|
|
|
6633 in_warnings = 0;
|
|
|
6634 specpdl_size = 50;
|
|
|
6635 specpdl = xnew_array (struct specbinding, specpdl_size);
|
|
|
6636 /* XEmacs change: increase these values. */
|
|
|
6637 max_specpdl_size = 3000;
|
|
442
|
6638 max_lisp_eval_depth = 1000;
|
|
|
6639 #ifdef DEFEND_AGAINST_THROW_RECURSION
|
|
428
|
6640 throw_level = 0;
|
|
|
6641 #endif
|
|
2367
|
6642 init_eval_semi_early ();
|
|
428
|
6643 }
|
|
|
6644
|
|
|
6645 void
|
|
|
6646 vars_of_eval (void)
|
|
|
6647 {
|
|
|
6648 DEFVAR_INT ("max-specpdl-size", &max_specpdl_size /*
|
|
|
6649 Limit on number of Lisp variable bindings & unwind-protects before error.
|
|
|
6650 */ );
|
|
|
6651
|
|
|
6652 DEFVAR_INT ("max-lisp-eval-depth", &max_lisp_eval_depth /*
|
|
|
6653 Limit on depth in `eval', `apply' and `funcall' before error.
|
|
|
6654 This limit is to catch infinite recursions for you before they cause
|
|
|
6655 actual stack overflow in C, which would be fatal for Emacs.
|
|
|
6656 You can safely make it considerably larger than its default value,
|
|
|
6657 if that proves inconveniently small.
|
|
|
6658 */ );
|
|
|
6659
|
|
|
6660 DEFVAR_LISP ("quit-flag", &Vquit_flag /*
|
|
853
|
6661 t causes running Lisp code to abort, unless `inhibit-quit' is non-nil.
|
|
|
6662 `critical' causes running Lisp code to abort regardless of `inhibit-quit'.
|
|
|
6663 Normally, you do not need to set this value yourself. It is set to
|
|
|
6664 t each time a Control-G is detected, and to `critical' each time a
|
|
|
6665 Shift-Control-G is detected. The XEmacs core C code is littered with
|
|
|
6666 calls to the QUIT; macro, which check the values of `quit-flag' and
|
|
2500
|
6667 `inhibit-quit' and ABORT (or more accurately, call (signal 'quit)) if
|
|
853
|
6668 it's correct to do so.
|
|
428
|
6669 */ );
|
|
|
6670 Vquit_flag = Qnil;
|
|
|
6671
|
|
|
6672 DEFVAR_LISP ("inhibit-quit", &Vinhibit_quit /*
|
|
|
6673 Non-nil inhibits C-g quitting from happening immediately.
|
|
|
6674 Note that `quit-flag' will still be set by typing C-g,
|
|
|
6675 so a quit will be signalled as soon as `inhibit-quit' is nil.
|
|
|
6676 To prevent this happening, set `quit-flag' to nil
|
|
853
|
6677 before making `inhibit-quit' nil.
|
|
|
6678
|
|
|
6679 The value of `inhibit-quit' is ignored if a critical quit is
|
|
|
6680 requested by typing control-shift-G in a window-system frame;
|
|
|
6681 this is explained in more detail in `quit-flag'.
|
|
428
|
6682 */ );
|
|
|
6683 Vinhibit_quit = Qnil;
|
|
|
6684
|
|
|
6685 DEFVAR_LISP ("stack-trace-on-error", &Vstack_trace_on_error /*
|
|
|
6686 *Non-nil means automatically display a backtrace buffer
|
|
|
6687 after any error that is not handled by a `condition-case'.
|
|
|
6688 If the value is a list, an error only means to display a backtrace
|
|
|
6689 if one of its condition symbols appears in the list.
|
|
|
6690 See also variable `stack-trace-on-signal'.
|
|
|
6691 */ );
|
|
|
6692 Vstack_trace_on_error = Qnil;
|
|
|
6693
|
|
|
6694 DEFVAR_LISP ("stack-trace-on-signal", &Vstack_trace_on_signal /*
|
|
|
6695 *Non-nil means automatically display a backtrace buffer
|
|
|
6696 after any error that is signalled, whether or not it is handled by
|
|
|
6697 a `condition-case'.
|
|
|
6698 If the value is a list, an error only means to display a backtrace
|
|
|
6699 if one of its condition symbols appears in the list.
|
|
|
6700 See also variable `stack-trace-on-error'.
|
|
|
6701 */ );
|
|
|
6702 Vstack_trace_on_signal = Qnil;
|
|
|
6703
|
|
|
6704 DEFVAR_LISP ("debug-ignored-errors", &Vdebug_ignored_errors /*
|
|
|
6705 *List of errors for which the debugger should not be called.
|
|
|
6706 Each element may be a condition-name or a regexp that matches error messages.
|
|
|
6707 If any element applies to a given error, that error skips the debugger
|
|
|
6708 and just returns to top level.
|
|
|
6709 This overrides the variable `debug-on-error'.
|
|
|
6710 It does not apply to errors handled by `condition-case'.
|
|
|
6711 */ );
|
|
|
6712 Vdebug_ignored_errors = Qnil;
|
|
|
6713
|
|
|
6714 DEFVAR_LISP ("debug-on-error", &Vdebug_on_error /*
|
|
|
6715 *Non-nil means enter debugger if an unhandled error is signalled.
|
|
|
6716 The debugger will not be entered if the error is handled by
|
|
|
6717 a `condition-case'.
|
|
|
6718 If the value is a list, an error only means to enter the debugger
|
|
|
6719 if one of its condition symbols appears in the list.
|
|
|
6720 This variable is overridden by `debug-ignored-errors'.
|
|
|
6721 See also variables `debug-on-quit' and `debug-on-signal'.
|
|
1123
|
6722
|
|
|
6723 If this variable is set while XEmacs is running noninteractively (using
|
|
|
6724 `-batch'), and XEmacs was configured with `--debug' (#define XEMACS_DEBUG
|
|
|
6725 in the C code), instead of trying to invoke the Lisp debugger (which
|
|
|
6726 obviously won't work), XEmacs will break out to a C debugger using
|
|
|
6727 \(force-debugging-signal t). This is useful because debugging
|
|
|
6728 noninteractive runs of XEmacs is often very difficult, since they typically
|
|
|
6729 happen as part of sometimes large and complex make suites (e.g. rebuilding
|
|
2500
|
6730 the XEmacs packages). NOTE: This runs ABORT()!!! (As well as and after
|
|
1123
|
6731 executing INT 3 under MS Windows, which should invoke a debugger if it's
|
|
|
6732 active.) This is guaranteed to kill XEmacs! (But in this situation, XEmacs
|
|
|
6733 is about to die anyway, and if no debugger is present, this will usefully
|
|
|
6734 dump core.) The most useful way to set this flag when debugging
|
|
|
6735 noninteractive runs, especially in makefiles, is using the environment
|
|
|
6736 variable XEMACSDEBUG, like this:
|
|
771
|
6737
|
|
|
6738 \(using csh) setenv XEMACSDEBUG '(setq debug-on-error t)'
|
|
|
6739 \(using bash) export XEMACSDEBUG='(setq debug-on-error t)'
|
|
428
|
6740 */ );
|
|
|
6741 Vdebug_on_error = Qnil;
|
|
|
6742
|
|
|
6743 DEFVAR_LISP ("debug-on-signal", &Vdebug_on_signal /*
|
|
|
6744 *Non-nil means enter debugger if an error is signalled.
|
|
|
6745 The debugger will be entered whether or not the error is handled by
|
|
|
6746 a `condition-case'.
|
|
|
6747 If the value is a list, an error only means to enter the debugger
|
|
|
6748 if one of its condition symbols appears in the list.
|
|
|
6749 See also variable `debug-on-quit'.
|
|
1123
|
6750
|
|
|
6751 This will attempt to enter a C debugger when XEmacs is run noninteractively
|
|
|
6752 and under the same conditions as described in `debug-on-error'.
|
|
428
|
6753 */ );
|
|
|
6754 Vdebug_on_signal = Qnil;
|
|
|
6755
|
|
|
6756 DEFVAR_BOOL ("debug-on-quit", &debug_on_quit /*
|
|
|
6757 *Non-nil means enter debugger if quit is signalled (C-G, for example).
|
|
|
6758 Does not apply if quit is handled by a `condition-case'. Entering the
|
|
|
6759 debugger can also be achieved at any time (for X11 console) by typing
|
|
|
6760 control-shift-G to signal a critical quit.
|
|
|
6761 */ );
|
|
|
6762 debug_on_quit = 0;
|
|
|
6763
|
|
|
6764 DEFVAR_BOOL ("debug-on-next-call", &debug_on_next_call /*
|
|
|
6765 Non-nil means enter debugger before next `eval', `apply' or `funcall'.
|
|
|
6766 */ );
|
|
|
6767
|
|
1292
|
6768 DEFVAR_BOOL ("backtrace-with-interal-sections",
|
|
|
6769 &backtrace_with_internal_sections /*
|
|
|
6770 Non-nil means backtraces will contain additional information indicating
|
|
|
6771 when particular sections of the C code have been entered, e.g. redisplay(),
|
|
|
6772 byte-char conversion, internal-external conversion, etc. This can be
|
|
|
6773 particularly useful when XEmacs crashes, in helping to pinpoint the problem.
|
|
|
6774 */ );
|
|
|
6775 #ifdef ERROR_CHECK_STRUCTURES
|
|
|
6776 backtrace_with_internal_sections = 1;
|
|
|
6777 #else
|
|
|
6778 backtrace_with_internal_sections = 0;
|
|
|
6779 #endif
|
|
|
6780
|
|
428
|
6781 DEFVAR_LISP ("debugger", &Vdebugger /*
|
|
|
6782 Function to call to invoke debugger.
|
|
|
6783 If due to frame exit, args are `exit' and the value being returned;
|
|
|
6784 this function's value will be returned instead of that.
|
|
|
6785 If due to error, args are `error' and a list of the args to `signal'.
|
|
|
6786 If due to `apply' or `funcall' entry, one arg, `lambda'.
|
|
|
6787 If due to `eval' entry, one arg, t.
|
|
|
6788 */ );
|
|
|
6789 Vdebugger = Qnil;
|
|
|
6790
|
|
853
|
6791 staticpro (&Vcatch_everything_tag);
|
|
|
6792 Vcatch_everything_tag = make_opaque (OPAQUE_CLEAR, 0);
|
|
|
6793
|
|
428
|
6794 staticpro (&Vpending_warnings);
|
|
|
6795 Vpending_warnings = Qnil;
|
|
1204
|
6796 dump_add_root_lisp_object (&Vpending_warnings_tail);
|
|
428
|
6797 Vpending_warnings_tail = Qnil;
|
|
|
6798
|
|
793
|
6799 DEFVAR_LISP ("log-warning-minimum-level", &Vlog_warning_minimum_level);
|
|
|
6800 Vlog_warning_minimum_level = Qinfo;
|
|
|
6801
|
|
428
|
6802 staticpro (&Vautoload_queue);
|
|
|
6803 Vautoload_queue = Qnil;
|
|
|
6804
|
|
|
6805 staticpro (&Vcondition_handlers);
|
|
|
6806
|
|
853
|
6807 staticpro (&Vdeletable_permanent_display_objects);
|
|
|
6808 Vdeletable_permanent_display_objects = Qnil;
|
|
|
6809
|
|
|
6810 staticpro (&Vmodifiable_buffers);
|
|
|
6811 Vmodifiable_buffers = Qnil;
|
|
|
6812
|
|
|
6813 inhibit_flags = 0;
|
|
|
6814 }
|
