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