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