272
|
1 /* Evaluator for GNU Emacs Lisp interpreter.
|
61901
787052160d87
(do_autoload): Record only autoloads in the autoload property of symbols.
Lute Kamstra <lute@gnu.org>
diff
changeset
|
2 Copyright (C) 1985, 1986, 1987, 1993, 1994, 1995, 1999, 2000, 2001,
|
75348
|
3 2002, 2003, 2004, 2005, 2006, 2007 Free Software Foundation, Inc.
|
272
|
4
|
|
5 This file is part of GNU Emacs.
|
|
6
|
|
7 GNU Emacs is free software; you can redistribute it and/or modify
|
|
8 it under the terms of the GNU General Public License as published by
|
78260
|
9 the Free Software Foundation; either version 3, or (at your option)
|
272
|
10 any later version.
|
|
11
|
|
12 GNU Emacs is distributed in the hope that it will be useful,
|
|
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
15 GNU General Public License for more details.
|
|
16
|
|
17 You should have received a copy of the GNU General Public License
|
|
18 along with GNU Emacs; see the file COPYING. If not, write to
|
64084
|
19 the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
|
|
20 Boston, MA 02110-1301, USA. */
|
272
|
21
|
|
22
|
4696
|
23 #include <config.h>
|
272
|
24 #include "lisp.h"
|
2439
|
25 #include "blockinput.h"
|
272
|
26 #include "commands.h"
|
515
|
27 #include "keyboard.h"
|
26764
|
28 #include "dispextern.h"
|
272
|
29 #include <setjmp.h>
|
|
30
|
73323
d38d245297fa
Include xterm.h for x_fully_uncatch_errors and friends.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
31 #if HAVE_X_WINDOWS
|
d38d245297fa
Include xterm.h for x_fully_uncatch_errors and friends.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
32 #include "xterm.h"
|
d38d245297fa
Include xterm.h for x_fully_uncatch_errors and friends.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
33 #endif
|
d38d245297fa
Include xterm.h for x_fully_uncatch_errors and friends.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
34
|
272
|
35 /* This definition is duplicated in alloc.c and keyboard.c */
|
|
36 /* Putting it in lisp.h makes cc bomb out! */
|
|
37
|
|
38 struct backtrace
|
30080
|
39 {
|
|
40 struct backtrace *next;
|
|
41 Lisp_Object *function;
|
|
42 Lisp_Object *args; /* Points to vector of args. */
|
|
43 int nargs; /* Length of vector.
|
727
|
44 If nargs is UNEVALLED, args points to slot holding
|
|
45 list of unevalled args */
|
30080
|
46 char evalargs;
|
|
47 /* Nonzero means call value of debugger when done with this operation. */
|
|
48 char debug_on_exit;
|
|
49 };
|
272
|
50
|
|
51 struct backtrace *backtrace_list;
|
|
52
|
1196
|
53 /* This structure helps implement the `catch' and `throw' control
|
|
54 structure. A struct catchtag contains all the information needed
|
|
55 to restore the state of the interpreter after a non-local jump.
|
|
56
|
|
57 Handlers for error conditions (represented by `struct handler'
|
|
58 structures) just point to a catch tag to do the cleanup required
|
|
59 for their jumps.
|
|
60
|
|
61 catchtag structures are chained together in the C calling stack;
|
|
62 the `next' member points to the next outer catchtag.
|
|
63
|
|
64 A call like (throw TAG VAL) searches for a catchtag whose `tag'
|
|
65 member is TAG, and then unbinds to it. The `val' member is used to
|
|
66 hold VAL while the stack is unwound; `val' is returned as the value
|
|
67 of the catch form.
|
|
68
|
|
69 All the other members are concerned with restoring the interpreter
|
|
70 state. */
|
30080
|
71
|
272
|
72 struct catchtag
|
30080
|
73 {
|
|
74 Lisp_Object tag;
|
|
75 Lisp_Object val;
|
|
76 struct catchtag *next;
|
|
77 struct gcpro *gcpro;
|
|
78 jmp_buf jmp;
|
|
79 struct backtrace *backlist;
|
|
80 struct handler *handlerlist;
|
|
81 int lisp_eval_depth;
|
|
82 int pdlcount;
|
|
83 int poll_suppress_count;
|
48909
|
84 int interrupt_input_blocked;
|
30080
|
85 struct byte_stack *byte_stack;
|
|
86 };
|
272
|
87
|
|
88 struct catchtag *catchlist;
|
|
89
|
26297
|
90 #ifdef DEBUG_GCPRO
|
|
91 /* Count levels of GCPRO to detect failure to UNGCPRO. */
|
|
92 int gcpro_level;
|
|
93 #endif
|
|
94
|
59109
|
95 Lisp_Object Qautoload, Qmacro, Qexit, Qinteractive, Qcommandp, Qdefun;
|
381
|
96 Lisp_Object Qinhibit_quit, Vinhibit_quit, Vquit_flag;
|
272
|
97 Lisp_Object Qand_rest, Qand_optional;
|
|
98 Lisp_Object Qdebug_on_error;
|
44132
|
99 Lisp_Object Qdeclare;
|
78141
|
100 Lisp_Object Qdebug;
|
272
|
101
|
16296
|
102 /* This holds either the symbol `run-hooks' or nil.
|
|
103 It is nil at an early stage of startup, and when Emacs
|
|
104 is shutting down. */
|
30080
|
105
|
272
|
106 Lisp_Object Vrun_hooks;
|
|
107
|
|
108 /* Non-nil means record all fset's and provide's, to be undone
|
|
109 if the file being autoloaded is not fully loaded.
|
|
110 They are recorded by being consed onto the front of Vautoload_queue:
|
67810
65be704fdaf2
(un_autoload): Expect (0 . OFEATURES) in Vautoload_queue to undo a `provide'.
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
111 (FUN . ODEF) for a defun, (0 . OFEATURES) for a provide. */
|
272
|
112
|
|
113 Lisp_Object Vautoload_queue;
|
|
114
|
|
115 /* Current number of specbindings allocated in specpdl. */
|
30080
|
116
|
272
|
117 int specpdl_size;
|
|
118
|
|
119 /* Pointer to beginning of specpdl. */
|
30080
|
120
|
272
|
121 struct specbinding *specpdl;
|
|
122
|
|
123 /* Pointer to first unused element in specpdl. */
|
30080
|
124
|
69158
812b2bed63c2
(specpdl_ptr): Remove volatile qualifier for consistency with lisp.h.
Luc Teirlinck <teirllm@auburn.edu>
diff
changeset
|
125 struct specbinding *specpdl_ptr;
|
272
|
126
|
|
127 /* Maximum size allowed for specpdl allocation */
|
30080
|
128
|
43713
f92c4d87863a
Change defvar_int def and vars to use EMACS_INT instead of just int.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
129 EMACS_INT max_specpdl_size;
|
272
|
130
|
|
131 /* Depth in Lisp evaluations and function calls. */
|
30080
|
132
|
272
|
133 int lisp_eval_depth;
|
|
134
|
|
135 /* Maximum allowed depth in Lisp evaluations and function calls. */
|
30080
|
136
|
43713
f92c4d87863a
Change defvar_int def and vars to use EMACS_INT instead of just int.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
137 EMACS_INT max_lisp_eval_depth;
|
272
|
138
|
|
139 /* Nonzero means enter debugger before next function call */
|
30080
|
140
|
272
|
141 int debug_on_next_call;
|
|
142
|
40661
|
143 /* Non-zero means debugger may continue. This is zero when the
|
26947
|
144 debugger is called during redisplay, where it might not be safe to
|
|
145 continue the interrupted redisplay. */
|
|
146
|
|
147 int debugger_may_continue;
|
|
148
|
684
|
149 /* List of conditions (non-nil atom means all) which cause a backtrace
|
706
|
150 if an error is handled by the command loop's error handler. */
|
30080
|
151
|
684
|
152 Lisp_Object Vstack_trace_on_error;
|
272
|
153
|
684
|
154 /* List of conditions (non-nil atom means all) which enter the debugger
|
706
|
155 if an error is handled by the command loop's error handler. */
|
30080
|
156
|
684
|
157 Lisp_Object Vdebug_on_error;
|
272
|
158
|
13768
|
159 /* List of conditions and regexps specifying error messages which
|
40661
|
160 do not enter the debugger even if Vdebug_on_error says they should. */
|
30080
|
161
|
13768
|
162 Lisp_Object Vdebug_ignored_errors;
|
|
163
|
16355
|
164 /* Non-nil means call the debugger even if the error will be handled. */
|
30080
|
165
|
16443
|
166 Lisp_Object Vdebug_on_signal;
|
16355
|
167
|
|
168 /* Hook for edebug to use. */
|
30080
|
169
|
16355
|
170 Lisp_Object Vsignal_hook_function;
|
|
171
|
272
|
172 /* Nonzero means enter debugger if a quit signal
|
684
|
173 is handled by the command loop's error handler. */
|
30080
|
174
|
272
|
175 int debug_on_quit;
|
|
176
|
17872
|
177 /* The value of num_nonmacro_input_events as of the last time we
|
1196
|
178 started to enter the debugger. If we decide to enter the debugger
|
17872
|
179 again when this is still equal to num_nonmacro_input_events, then we
|
1196
|
180 know that the debugger itself has an error, and we should just
|
|
181 signal the error instead of entering an infinite loop of debugger
|
|
182 invocations. */
|
30080
|
183
|
1196
|
184 int when_entered_debugger;
|
272
|
185
|
|
186 Lisp_Object Vdebugger;
|
|
187
|
30073
|
188 /* The function from which the last `signal' was called. Set in
|
|
189 Fsignal. */
|
|
190
|
|
191 Lisp_Object Vsignaling_function;
|
|
192
|
30080
|
193 /* Set to non-zero while processing X events. Checked in Feval to
|
|
194 make sure the Lisp interpreter isn't called from a signal handler,
|
|
195 which is unsafe because the interpreter isn't reentrant. */
|
|
196
|
|
197 int handling_signal;
|
|
198
|
44132
|
199 /* Function to process declarations in defmacro forms. */
|
|
200
|
|
201 Lisp_Object Vmacro_declaration_function;
|
|
202
|
71341
|
203 extern Lisp_Object Qrisky_local_variable;
|
44132
|
204
|
41114
242c6928accc
(max_specpdl_size, max_lisp_eval_depth): Use EMACS_INT.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
205 static Lisp_Object funcall_lambda P_ ((Lisp_Object, int, Lisp_Object*));
|
72005
|
206 static void unwind_to_catch P_ ((struct catchtag *, Lisp_Object)) NO_RETURN;
|
72610
01fdc3c9ea0e
(apply1, call2) [__GNUC__]: Declare with `__attribute__((noinline))'.
Eli Zaretskii <eliz@gnu.org>
diff
changeset
|
207
|
01fdc3c9ea0e
(apply1, call2) [__GNUC__]: Declare with `__attribute__((noinline))'.
Eli Zaretskii <eliz@gnu.org>
diff
changeset
|
208 #if __GNUC__
|
01fdc3c9ea0e
(apply1, call2) [__GNUC__]: Declare with `__attribute__((noinline))'.
Eli Zaretskii <eliz@gnu.org>
diff
changeset
|
209 /* "gcc -O3" enables automatic function inlining, which optimizes out
|
01fdc3c9ea0e
(apply1, call2) [__GNUC__]: Declare with `__attribute__((noinline))'.
Eli Zaretskii <eliz@gnu.org>
diff
changeset
|
210 the arguments for the invocations of these functions, whereas they
|
01fdc3c9ea0e
(apply1, call2) [__GNUC__]: Declare with `__attribute__((noinline))'.
Eli Zaretskii <eliz@gnu.org>
diff
changeset
|
211 expect these values on the stack. */
|
01fdc3c9ea0e
(apply1, call2) [__GNUC__]: Declare with `__attribute__((noinline))'.
Eli Zaretskii <eliz@gnu.org>
diff
changeset
|
212 Lisp_Object apply1 () __attribute__((noinline));
|
01fdc3c9ea0e
(apply1, call2) [__GNUC__]: Declare with `__attribute__((noinline))'.
Eli Zaretskii <eliz@gnu.org>
diff
changeset
|
213 Lisp_Object call2 () __attribute__((noinline));
|
01fdc3c9ea0e
(apply1, call2) [__GNUC__]: Declare with `__attribute__((noinline))'.
Eli Zaretskii <eliz@gnu.org>
diff
changeset
|
214 #endif
|
71341
|
215
|
21514
|
216 void
|
272
|
217 init_eval_once ()
|
|
218 {
|
|
219 specpdl_size = 50;
|
7885
|
220 specpdl = (struct specbinding *) xmalloc (specpdl_size * sizeof (struct specbinding));
|
14600
|
221 specpdl_ptr = specpdl;
|
70084
|
222 /* Don't forget to update docs (lispref node "Local Variables"). */
|
58827
|
223 max_specpdl_size = 1000;
|
78359
2dd5d799a16d
* vc-git.el: (vc-directory-exclusion-list, vc-handled-backends):
Dan Nicolaescu <dann@ics.uci.edu>
diff
changeset
|
224 max_lisp_eval_depth = 400;
|
8980
|
225
|
|
226 Vrun_hooks = Qnil;
|
272
|
227 }
|
|
228
|
21514
|
229 void
|
272
|
230 init_eval ()
|
|
231 {
|
|
232 specpdl_ptr = specpdl;
|
|
233 catchlist = 0;
|
|
234 handlerlist = 0;
|
|
235 backtrace_list = 0;
|
|
236 Vquit_flag = Qnil;
|
|
237 debug_on_next_call = 0;
|
|
238 lisp_eval_depth = 0;
|
26307
|
239 #ifdef DEBUG_GCPRO
|
26297
|
240 gcpro_level = 0;
|
26307
|
241 #endif
|
17872
|
242 /* This is less than the initial value of num_nonmacro_input_events. */
|
7213
|
243 when_entered_debugger = -1;
|
272
|
244 }
|
|
245
|
63767
|
246 /* unwind-protect function used by call_debugger. */
|
|
247
|
|
248 static Lisp_Object
|
|
249 restore_stack_limits (data)
|
|
250 Lisp_Object data;
|
|
251 {
|
|
252 max_specpdl_size = XINT (XCAR (data));
|
|
253 max_lisp_eval_depth = XINT (XCDR (data));
|
64568
|
254 return Qnil;
|
63767
|
255 }
|
|
256
|
|
257 /* Call the Lisp debugger, giving it argument ARG. */
|
|
258
|
272
|
259 Lisp_Object
|
|
260 call_debugger (arg)
|
|
261 Lisp_Object arg;
|
|
262 {
|
26764
|
263 int debug_while_redisplaying;
|
46293
|
264 int count = SPECPDL_INDEX ();
|
26764
|
265 Lisp_Object val;
|
63767
|
266 int old_max = max_specpdl_size;
|
|
267
|
|
268 /* Temporarily bump up the stack limits,
|
|
269 so the debugger won't run out of stack. */
|
|
270
|
|
271 max_specpdl_size += 1;
|
|
272 record_unwind_protect (restore_stack_limits,
|
|
273 Fcons (make_number (old_max),
|
|
274 make_number (max_lisp_eval_depth)));
|
|
275 max_specpdl_size = old_max;
|
|
276
|
|
277 if (lisp_eval_depth + 40 > max_lisp_eval_depth)
|
|
278 max_lisp_eval_depth = lisp_eval_depth + 40;
|
|
279
|
|
280 if (SPECPDL_INDEX () + 100 > max_specpdl_size)
|
|
281 max_specpdl_size = SPECPDL_INDEX () + 100;
|
49600
|
282
|
28383
|
283 #ifdef HAVE_X_WINDOWS
|
36256
e033d60bd048
Use display_hourglass_p, start_hourglass, cancel_hourglass instead of
Gerd Moellmann <gerd@gnu.org>
diff
changeset
|
284 if (display_hourglass_p)
|
e033d60bd048
Use display_hourglass_p, start_hourglass, cancel_hourglass instead of
Gerd Moellmann <gerd@gnu.org>
diff
changeset
|
285 cancel_hourglass ();
|
28383
|
286 #endif
|
|
287
|
272
|
288 debug_on_next_call = 0;
|
17872
|
289 when_entered_debugger = num_nonmacro_input_events;
|
26764
|
290
|
|
291 /* Resetting redisplaying_p to 0 makes sure that debug output is
|
|
292 displayed if the debugger is invoked during redisplay. */
|
|
293 debug_while_redisplaying = redisplaying_p;
|
|
294 redisplaying_p = 0;
|
26947
|
295 specbind (intern ("debugger-may-continue"),
|
|
296 debug_while_redisplaying ? Qnil : Qt);
|
37043
|
297 specbind (Qinhibit_redisplay, Qnil);
|
63767
|
298 specbind (Qdebug_on_error, Qnil);
|
37799
|
299
|
|
300 #if 0 /* Binding this prevents execution of Lisp code during
|
|
301 redisplay, which necessarily leads to display problems. */
|
37043
|
302 specbind (Qinhibit_eval_during_redisplay, Qt);
|
37799
|
303 #endif
|
49600
|
304
|
26764
|
305 val = apply1 (Vdebugger, arg);
|
|
306
|
|
307 /* Interrupting redisplay and resuming it later is not safe under
|
|
308 all circumstances. So, when the debugger returns, abort the
|
40661
|
309 interrupted redisplay by going back to the top-level. */
|
26764
|
310 if (debug_while_redisplaying)
|
|
311 Ftop_level ();
|
|
312
|
26947
|
313 return unbind_to (count, val);
|
272
|
314 }
|
|
315
|
21514
|
316 void
|
272
|
317 do_debug_on_call (code)
|
|
318 Lisp_Object code;
|
|
319 {
|
|
320 debug_on_next_call = 0;
|
|
321 backtrace_list->debug_on_exit = 1;
|
|
322 call_debugger (Fcons (code, Qnil));
|
|
323 }
|
|
324
|
|
325 /* NOTE!!! Every function that can call EVAL must protect its args
|
|
326 and temporaries from garbage collection while it needs them.
|
|
327 The definition of `For' shows what you have to do. */
|
|
328
|
|
329 DEFUN ("or", For, Sor, 0, UNEVALLED, 0,
|
40570
|
330 doc: /* Eval args until one of them yields non-nil, then return that value.
|
|
331 The remaining args are not evalled at all.
|
|
332 If all args return nil, return nil.
|
78153
|
333 usage: (or CONDITIONS...) */)
|
40570
|
334 (args)
|
272
|
335 Lisp_Object args;
|
|
336 {
|
50630
dfbdcffdcfc9
(For, Fand, Fprogn, un_autoload, do_autoload): Use XCDR, XCAR, CONSP.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
337 register Lisp_Object val = Qnil;
|
272
|
338 struct gcpro gcpro1;
|
|
339
|
50630
dfbdcffdcfc9
(For, Fand, Fprogn, un_autoload, do_autoload): Use XCDR, XCAR, CONSP.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
340 GCPRO1 (args);
|
dfbdcffdcfc9
(For, Fand, Fprogn, un_autoload, do_autoload): Use XCDR, XCAR, CONSP.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
341
|
dfbdcffdcfc9
(For, Fand, Fprogn, un_autoload, do_autoload): Use XCDR, XCAR, CONSP.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
342 while (CONSP (args))
|
272
|
343 {
|
50630
dfbdcffdcfc9
(For, Fand, Fprogn, un_autoload, do_autoload): Use XCDR, XCAR, CONSP.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
344 val = Feval (XCAR (args));
|
485
|
345 if (!NILP (val))
|
272
|
346 break;
|
50630
dfbdcffdcfc9
(For, Fand, Fprogn, un_autoload, do_autoload): Use XCDR, XCAR, CONSP.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
347 args = XCDR (args);
|
272
|
348 }
|
|
349
|
|
350 UNGCPRO;
|
|
351 return val;
|
|
352 }
|
|
353
|
|
354 DEFUN ("and", Fand, Sand, 0, UNEVALLED, 0,
|
40983
|
355 doc: /* Eval args until one of them yields nil, then return nil.
|
40570
|
356 The remaining args are not evalled at all.
|
|
357 If no arg yields nil, return the last arg's value.
|
78153
|
358 usage: (and CONDITIONS...) */)
|
40570
|
359 (args)
|
272
|
360 Lisp_Object args;
|
|
361 {
|
50630
dfbdcffdcfc9
(For, Fand, Fprogn, un_autoload, do_autoload): Use XCDR, XCAR, CONSP.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
362 register Lisp_Object val = Qt;
|
272
|
363 struct gcpro gcpro1;
|
|
364
|
50630
dfbdcffdcfc9
(For, Fand, Fprogn, un_autoload, do_autoload): Use XCDR, XCAR, CONSP.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
365 GCPRO1 (args);
|
dfbdcffdcfc9
(For, Fand, Fprogn, un_autoload, do_autoload): Use XCDR, XCAR, CONSP.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
366
|
dfbdcffdcfc9
(For, Fand, Fprogn, un_autoload, do_autoload): Use XCDR, XCAR, CONSP.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
367 while (CONSP (args))
|
272
|
368 {
|
50630
dfbdcffdcfc9
(For, Fand, Fprogn, un_autoload, do_autoload): Use XCDR, XCAR, CONSP.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
369 val = Feval (XCAR (args));
|
485
|
370 if (NILP (val))
|
272
|
371 break;
|
50630
dfbdcffdcfc9
(For, Fand, Fprogn, un_autoload, do_autoload): Use XCDR, XCAR, CONSP.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
372 args = XCDR (args);
|
272
|
373 }
|
|
374
|
|
375 UNGCPRO;
|
|
376 return val;
|
|
377 }
|
|
378
|
|
379 DEFUN ("if", Fif, Sif, 2, UNEVALLED, 0,
|
40983
|
380 doc: /* If COND yields non-nil, do THEN, else do ELSE...
|
40570
|
381 Returns the value of THEN or the value of the last of the ELSE's.
|
|
382 THEN must be one expression, but ELSE... can be zero or more expressions.
|
|
383 If COND yields nil, and there are no ELSE's, the value is nil.
|
41846
680de0f18330
Undo last change. Consistency doesn't seem to be desired.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
384 usage: (if COND THEN ELSE...) */)
|
40570
|
385 (args)
|
272
|
386 Lisp_Object args;
|
|
387 {
|
|
388 register Lisp_Object cond;
|
|
389 struct gcpro gcpro1;
|
|
390
|
|
391 GCPRO1 (args);
|
|
392 cond = Feval (Fcar (args));
|
|
393 UNGCPRO;
|
|
394
|
485
|
395 if (!NILP (cond))
|
272
|
396 return Feval (Fcar (Fcdr (args)));
|
|
397 return Fprogn (Fcdr (Fcdr (args)));
|
|
398 }
|
|
399
|
|
400 DEFUN ("cond", Fcond, Scond, 0, UNEVALLED, 0,
|
40570
|
401 doc: /* Try each clause until one succeeds.
|
|
402 Each clause looks like (CONDITION BODY...). CONDITION is evaluated
|
|
403 and, if the value is non-nil, this clause succeeds:
|
|
404 then the expressions in BODY are evaluated and the last one's
|
|
405 value is the value of the cond-form.
|
|
406 If no clause succeeds, cond returns nil.
|
|
407 If a clause has one element, as in (CONDITION),
|
|
408 CONDITION's value if non-nil is returned from the cond-form.
|
41846
680de0f18330
Undo last change. Consistency doesn't seem to be desired.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
409 usage: (cond CLAUSES...) */)
|
40570
|
410 (args)
|
272
|
411 Lisp_Object args;
|
|
412 {
|
|
413 register Lisp_Object clause, val;
|
|
414 struct gcpro gcpro1;
|
|
415
|
|
416 val = Qnil;
|
|
417 GCPRO1 (args);
|
485
|
418 while (!NILP (args))
|
272
|
419 {
|
|
420 clause = Fcar (args);
|
|
421 val = Feval (Fcar (clause));
|
485
|
422 if (!NILP (val))
|
272
|
423 {
|
25662
0a7261c1d487
Use XCAR, XCDR, and XFLOAT_DATA instead of explicit member access.
Ken Raeburn <raeburn@raeburn.org>
diff
changeset
|
424 if (!EQ (XCDR (clause), Qnil))
|
0a7261c1d487
Use XCAR, XCDR, and XFLOAT_DATA instead of explicit member access.
Ken Raeburn <raeburn@raeburn.org>
diff
changeset
|
425 val = Fprogn (XCDR (clause));
|
272
|
426 break;
|
|
427 }
|
25662
0a7261c1d487
Use XCAR, XCDR, and XFLOAT_DATA instead of explicit member access.
Ken Raeburn <raeburn@raeburn.org>
diff
changeset
|
428 args = XCDR (args);
|
272
|
429 }
|
|
430 UNGCPRO;
|
|
431
|
|
432 return val;
|
|
433 }
|
|
434
|
|
435 DEFUN ("progn", Fprogn, Sprogn, 0, UNEVALLED, 0,
|
40570
|
436 doc: /* Eval BODY forms sequentially and return value of last one.
|
78153
|
437 usage: (progn BODY...) */)
|
40570
|
438 (args)
|
272
|
439 Lisp_Object args;
|
|
440 {
|
50630
dfbdcffdcfc9
(For, Fand, Fprogn, un_autoload, do_autoload): Use XCDR, XCAR, CONSP.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
441 register Lisp_Object val = Qnil;
|
272
|
442 struct gcpro gcpro1;
|
|
443
|
50630
dfbdcffdcfc9
(For, Fand, Fprogn, un_autoload, do_autoload): Use XCDR, XCAR, CONSP.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
444 GCPRO1 (args);
|
dfbdcffdcfc9
(For, Fand, Fprogn, un_autoload, do_autoload): Use XCDR, XCAR, CONSP.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
445
|
dfbdcffdcfc9
(For, Fand, Fprogn, un_autoload, do_autoload): Use XCDR, XCAR, CONSP.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
446 while (CONSP (args))
|
272
|
447 {
|
50630
dfbdcffdcfc9
(For, Fand, Fprogn, un_autoload, do_autoload): Use XCDR, XCAR, CONSP.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
448 val = Feval (XCAR (args));
|
dfbdcffdcfc9
(For, Fand, Fprogn, un_autoload, do_autoload): Use XCDR, XCAR, CONSP.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
449 args = XCDR (args);
|
272
|
450 }
|
|
451
|
|
452 UNGCPRO;
|
|
453 return val;
|
|
454 }
|
|
455
|
|
456 DEFUN ("prog1", Fprog1, Sprog1, 1, UNEVALLED, 0,
|
40570
|
457 doc: /* Eval FIRST and BODY sequentially; value from FIRST.
|
|
458 The value of FIRST is saved during the evaluation of the remaining args,
|
|
459 whose values are discarded.
|
41846
680de0f18330
Undo last change. Consistency doesn't seem to be desired.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
460 usage: (prog1 FIRST BODY...) */)
|
40570
|
461 (args)
|
272
|
462 Lisp_Object args;
|
|
463 {
|
|
464 Lisp_Object val;
|
|
465 register Lisp_Object args_left;
|
|
466 struct gcpro gcpro1, gcpro2;
|
|
467 register int argnum = 0;
|
|
468
|
79082
|
469 if (NILP (args))
|
272
|
470 return Qnil;
|
|
471
|
|
472 args_left = args;
|
|
473 val = Qnil;
|
|
474 GCPRO2 (args, val);
|
|
475
|
|
476 do
|
|
477 {
|
|
478 if (!(argnum++))
|
|
479 val = Feval (Fcar (args_left));
|
|
480 else
|
|
481 Feval (Fcar (args_left));
|
|
482 args_left = Fcdr (args_left);
|
|
483 }
|
485
|
484 while (!NILP(args_left));
|
272
|
485
|
|
486 UNGCPRO;
|
|
487 return val;
|
|
488 }
|
|
489
|
|
490 DEFUN ("prog2", Fprog2, Sprog2, 2, UNEVALLED, 0,
|
64499
34bf5187c5aa
(Fprog2, Fcalled_interactively_p), (syms_of_eval) <debug-on-quit>: Doc fixes.
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
491 doc: /* Eval FORM1, FORM2 and BODY sequentially; value from FORM2.
|
34bf5187c5aa
(Fprog2, Fcalled_interactively_p), (syms_of_eval) <debug-on-quit>: Doc fixes.
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
492 The value of FORM2 is saved during the evaluation of the
|
34bf5187c5aa
(Fprog2, Fcalled_interactively_p), (syms_of_eval) <debug-on-quit>: Doc fixes.
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
493 remaining args, whose values are discarded.
|
34bf5187c5aa
(Fprog2, Fcalled_interactively_p), (syms_of_eval) <debug-on-quit>: Doc fixes.
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
494 usage: (prog2 FORM1 FORM2 BODY...) */)
|
40570
|
495 (args)
|
272
|
496 Lisp_Object args;
|
|
497 {
|
|
498 Lisp_Object val;
|
|
499 register Lisp_Object args_left;
|
|
500 struct gcpro gcpro1, gcpro2;
|
|
501 register int argnum = -1;
|
|
502
|
|
503 val = Qnil;
|
|
504
|
6803
|
505 if (NILP (args))
|
272
|
506 return Qnil;
|
|
507
|
|
508 args_left = args;
|
|
509 val = Qnil;
|
|
510 GCPRO2 (args, val);
|
|
511
|
|
512 do
|
|
513 {
|
|
514 if (!(argnum++))
|
|
515 val = Feval (Fcar (args_left));
|
|
516 else
|
|
517 Feval (Fcar (args_left));
|
|
518 args_left = Fcdr (args_left);
|
|
519 }
|
6803
|
520 while (!NILP (args_left));
|
272
|
521
|
|
522 UNGCPRO;
|
|
523 return val;
|
|
524 }
|
|
525
|
|
526 DEFUN ("setq", Fsetq, Ssetq, 0, UNEVALLED, 0,
|
40570
|
527 doc: /* Set each SYM to the value of its VAL.
|
|
528 The symbols SYM are variables; they are literal (not evaluated).
|
|
529 The values VAL are expressions; they are evaluated.
|
|
530 Thus, (setq x (1+ y)) sets `x' to the value of `(1+ y)'.
|
|
531 The second VAL is not computed until after the first SYM is set, and so on;
|
|
532 each VAL can use the new value of variables set earlier in the `setq'.
|
|
533 The return value of the `setq' form is the value of the last VAL.
|
78141
|
534 usage: (setq [SYM VAL]...) */)
|
40570
|
535 (args)
|
272
|
536 Lisp_Object args;
|
|
537 {
|
|
538 register Lisp_Object args_left;
|
|
539 register Lisp_Object val, sym;
|
|
540 struct gcpro gcpro1;
|
|
541
|
485
|
542 if (NILP(args))
|
272
|
543 return Qnil;
|
|
544
|
|
545 args_left = args;
|
|
546 GCPRO1 (args);
|
|
547
|
|
548 do
|
|
549 {
|
|
550 val = Feval (Fcar (Fcdr (args_left)));
|
|
551 sym = Fcar (args_left);
|
|
552 Fset (sym, val);
|
|
553 args_left = Fcdr (Fcdr (args_left));
|
|
554 }
|
485
|
555 while (!NILP(args_left));
|
272
|
556
|
|
557 UNGCPRO;
|
|
558 return val;
|
|
559 }
|
49600
|
560
|
272
|
561 DEFUN ("quote", Fquote, Squote, 1, UNEVALLED, 0,
|
40570
|
562 doc: /* Return the argument, without evaluating it. `(quote x)' yields `x'.
|
|
563 usage: (quote ARG) */)
|
|
564 (args)
|
272
|
565 Lisp_Object args;
|
|
566 {
|
|
567 return Fcar (args);
|
|
568 }
|
49600
|
569
|
272
|
570 DEFUN ("function", Ffunction, Sfunction, 1, UNEVALLED, 0,
|
40570
|
571 doc: /* Like `quote', but preferred for objects which are functions.
|
|
572 In byte compilation, `function' causes its argument to be compiled.
|
|
573 `quote' cannot do that.
|
|
574 usage: (function ARG) */)
|
|
575 (args)
|
272
|
576 Lisp_Object args;
|
|
577 {
|
|
578 return Fcar (args);
|
|
579 }
|
|
580
|
35774
|
581
|
272
|
582 DEFUN ("interactive-p", Finteractive_p, Sinteractive_p, 0, 0, 0,
|
57873
|
583 doc: /* Return t if the function was run directly by user input.
|
64499
34bf5187c5aa
(Fprog2, Fcalled_interactively_p), (syms_of_eval) <debug-on-quit>: Doc fixes.
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
584 This means that the function was called with `call-interactively'
|
34bf5187c5aa
(Fprog2, Fcalled_interactively_p), (syms_of_eval) <debug-on-quit>: Doc fixes.
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
585 \(which includes being called as the binding of a key)
|
57873
|
586 and input is currently coming from the keyboard (not in keyboard macro),
|
|
587 and Emacs is not running in batch mode (`noninteractive' is nil).
|
|
588
|
|
589 The only known proper use of `interactive-p' is in deciding whether to
|
|
590 display a helpful message, or how to display it. If you're thinking
|
|
591 of using it for any other purpose, it is quite likely that you're
|
|
592 making a mistake. Think: what do you want to do when the command is
|
|
593 called from a keyboard macro?
|
|
594
|
|
595 If you want to test whether your function was called with
|
|
596 `call-interactively', the way to do that is by adding an extra
|
|
597 optional argument, and making the `interactive' spec specify non-nil
|
|
598 unconditionally for that argument. (`p' is a good way to do this.) */)
|
40570
|
599 ()
|
272
|
600 {
|
57873
|
601 return (INTERACTIVE && interactive_p (1)) ? Qt : Qnil;
|
35774
|
602 }
|
|
603
|
|
604
|
57889
|
605 DEFUN ("called-interactively-p", Fcalled_interactively_p, Scalled_interactively_p, 0, 0, 0,
|
64499
34bf5187c5aa
(Fprog2, Fcalled_interactively_p), (syms_of_eval) <debug-on-quit>: Doc fixes.
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
606 doc: /* Return t if the function using this was called with `call-interactively'.
|
57873
|
607 This is used for implementing advice and other function-modifying
|
|
608 features of Emacs.
|
|
609
|
|
610 The cleanest way to test whether your function was called with
|
64499
34bf5187c5aa
(Fprog2, Fcalled_interactively_p), (syms_of_eval) <debug-on-quit>: Doc fixes.
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
611 `call-interactively' is by adding an extra optional argument,
|
34bf5187c5aa
(Fprog2, Fcalled_interactively_p), (syms_of_eval) <debug-on-quit>: Doc fixes.
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
612 and making the `interactive' spec specify non-nil unconditionally
|
34bf5187c5aa
(Fprog2, Fcalled_interactively_p), (syms_of_eval) <debug-on-quit>: Doc fixes.
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
613 for that argument. (`p' is a good way to do this.) */)
|
57873
|
614 ()
|
|
615 {
|
58734
|
616 return interactive_p (1) ? Qt : Qnil;
|
57873
|
617 }
|
|
618
|
|
619
|
|
620 /* Return 1 if function in which this appears was called using
|
|
621 call-interactively.
|
35774
|
622
|
|
623 EXCLUDE_SUBRS_P non-zero means always return 0 if the function
|
|
624 called is a built-in. */
|
|
625
|
|
626 int
|
|
627 interactive_p (exclude_subrs_p)
|
|
628 int exclude_subrs_p;
|
|
629 {
|
|
630 struct backtrace *btp;
|
|
631 Lisp_Object fun;
|
272
|
632
|
|
633 btp = backtrace_list;
|
727
|
634
|
|
635 /* If this isn't a byte-compiled function, there may be a frame at
|
35774
|
636 the top for Finteractive_p. If so, skip it. */
|
68758
|
637 fun = Findirect_function (*btp->function, Qnil);
|
58734
|
638 if (SUBRP (fun) && (XSUBR (fun) == &Sinteractive_p
|
|
639 || XSUBR (fun) == &Scalled_interactively_p))
|
323
|
640 btp = btp->next;
|
|
641
|
727
|
642 /* If we're running an Emacs 18-style byte-compiled function, there
|
48492
|
643 may be a frame for Fbytecode at the top level. In any version of
|
|
644 Emacs there can be Fbytecode frames for subexpressions evaluated
|
|
645 inside catch and condition-case. Skip past them.
|
|
646
|
|
647 If this isn't a byte-compiled function, then we may now be
|
727
|
648 looking at several frames for special forms. Skip past them. */
|
48492
|
649 while (btp
|
|
650 && (EQ (*btp->function, Qbytecode)
|
|
651 || btp->nargs == UNEVALLED))
|
727
|
652 btp = btp->next;
|
|
653
|
|
654 /* btp now points at the frame of the innermost function that isn't
|
|
655 a special form, ignoring frames for Finteractive_p and/or
|
|
656 Fbytecode at the top. If this frame is for a built-in function
|
|
657 (such as load or eval-region) return nil. */
|
68758
|
658 fun = Findirect_function (*btp->function, Qnil);
|
35774
|
659 if (exclude_subrs_p && SUBRP (fun))
|
|
660 return 0;
|
49600
|
661
|
272
|
662 /* btp points to the frame of a Lisp function that called interactive-p.
|
|
663 Return t if that function was called interactively. */
|
|
664 if (btp && btp->next && EQ (*btp->next->function, Qcall_interactively))
|
35774
|
665 return 1;
|
|
666 return 0;
|
272
|
667 }
|
|
668
|
35774
|
669
|
272
|
670 DEFUN ("defun", Fdefun, Sdefun, 2, UNEVALLED, 0,
|
40570
|
671 doc: /* Define NAME as a function.
|
|
672 The definition is (lambda ARGLIST [DOCSTRING] BODY...).
|
|
673 See also the function `interactive'.
|
41846
680de0f18330
Undo last change. Consistency doesn't seem to be desired.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
674 usage: (defun NAME ARGLIST [DOCSTRING] BODY...) */)
|
40570
|
675 (args)
|
272
|
676 Lisp_Object args;
|
|
677 {
|
|
678 register Lisp_Object fn_name;
|
|
679 register Lisp_Object defn;
|
|
680
|
|
681 fn_name = Fcar (args);
|
56052
|
682 CHECK_SYMBOL (fn_name);
|
272
|
683 defn = Fcons (Qlambda, Fcdr (args));
|
485
|
684 if (!NILP (Vpurify_flag))
|
272
|
685 defn = Fpurecopy (defn);
|
48724
ccd782f27e54
(Fdefun, Fdefmacro): Record in load-history redefining an autoload.
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
686 if (CONSP (XSYMBOL (fn_name)->function)
|
ccd782f27e54
(Fdefun, Fdefmacro): Record in load-history redefining an autoload.
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
687 && EQ (XCAR (XSYMBOL (fn_name)->function), Qautoload))
|
ccd782f27e54
(Fdefun, Fdefmacro): Record in load-history redefining an autoload.
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
688 LOADHIST_ATTACH (Fcons (Qt, fn_name));
|
272
|
689 Ffset (fn_name, defn);
|
59109
|
690 LOADHIST_ATTACH (Fcons (Qdefun, fn_name));
|
272
|
691 return fn_name;
|
|
692 }
|
|
693
|
|
694 DEFUN ("defmacro", Fdefmacro, Sdefmacro, 2, UNEVALLED, 0,
|
40570
|
695 doc: /* Define NAME as a macro.
|
46198
|
696 The actual definition looks like
|
|
697 (macro lambda ARGLIST [DOCSTRING] [DECL] BODY...).
|
40570
|
698 When the macro is called, as in (NAME ARGS...),
|
|
699 the function (lambda ARGLIST BODY...) is applied to
|
|
700 the list ARGS... as it appears in the expression,
|
|
701 and the result should be a form to be evaluated instead of the original.
|
46198
|
702
|
|
703 DECL is a declaration, optional, which can specify how to indent
|
|
704 calls to this macro and how Edebug should handle it. It looks like this:
|
|
705 (declare SPECS...)
|
|
706 The elements can look like this:
|
|
707 (indent INDENT)
|
|
708 Set NAME's `lisp-indent-function' property to INDENT.
|
|
709
|
50630
dfbdcffdcfc9
(For, Fand, Fprogn, un_autoload, do_autoload): Use XCDR, XCAR, CONSP.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
710 (debug DEBUG)
|
46198
|
711 Set NAME's `edebug-form-spec' property to DEBUG. (This is
|
49752
|
712 equivalent to writing a `def-edebug-spec' for the macro.)
|
46198
|
713 usage: (defmacro NAME ARGLIST [DOCSTRING] [DECL] BODY...) */)
|
40570
|
714 (args)
|
272
|
715 Lisp_Object args;
|
|
716 {
|
|
717 register Lisp_Object fn_name;
|
|
718 register Lisp_Object defn;
|
44132
|
719 Lisp_Object lambda_list, doc, tail;
|
272
|
720
|
|
721 fn_name = Fcar (args);
|
56356
|
722 CHECK_SYMBOL (fn_name);
|
44132
|
723 lambda_list = Fcar (Fcdr (args));
|
|
724 tail = Fcdr (Fcdr (args));
|
|
725
|
|
726 doc = Qnil;
|
|
727 if (STRINGP (Fcar (tail)))
|
|
728 {
|
50630
dfbdcffdcfc9
(For, Fand, Fprogn, un_autoload, do_autoload): Use XCDR, XCAR, CONSP.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
729 doc = XCAR (tail);
|
dfbdcffdcfc9
(For, Fand, Fprogn, un_autoload, do_autoload): Use XCDR, XCAR, CONSP.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
730 tail = XCDR (tail);
|
44132
|
731 }
|
|
732
|
|
733 while (CONSP (Fcar (tail))
|
|
734 && EQ (Fcar (Fcar (tail)), Qdeclare))
|
|
735 {
|
|
736 if (!NILP (Vmacro_declaration_function))
|
|
737 {
|
|
738 struct gcpro gcpro1;
|
|
739 GCPRO1 (args);
|
|
740 call2 (Vmacro_declaration_function, fn_name, Fcar (tail));
|
|
741 UNGCPRO;
|
|
742 }
|
49600
|
743
|
44132
|
744 tail = Fcdr (tail);
|
|
745 }
|
|
746
|
|
747 if (NILP (doc))
|
|
748 tail = Fcons (lambda_list, tail);
|
|
749 else
|
|
750 tail = Fcons (lambda_list, Fcons (doc, tail));
|
|
751 defn = Fcons (Qmacro, Fcons (Qlambda, tail));
|
49600
|
752
|
485
|
753 if (!NILP (Vpurify_flag))
|
272
|
754 defn = Fpurecopy (defn);
|
48724
ccd782f27e54
(Fdefun, Fdefmacro): Record in load-history redefining an autoload.
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
755 if (CONSP (XSYMBOL (fn_name)->function)
|
ccd782f27e54
(Fdefun, Fdefmacro): Record in load-history redefining an autoload.
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
756 && EQ (XCAR (XSYMBOL (fn_name)->function), Qautoload))
|
ccd782f27e54
(Fdefun, Fdefmacro): Record in load-history redefining an autoload.
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
757 LOADHIST_ATTACH (Fcons (Qt, fn_name));
|
272
|
758 Ffset (fn_name, defn);
|
59109
|
759 LOADHIST_ATTACH (Fcons (Qdefun, fn_name));
|
272
|
760 return fn_name;
|
|
761 }
|
|
762
|
39577
|
763
|
46388
|
764 DEFUN ("defvaralias", Fdefvaralias, Sdefvaralias, 2, 3, 0,
|
63391
e44f5953ff6a
(Fdefvaralias): Rename arguments SYMBOL and ALIASED to NEW-ALIAS and
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
765 doc: /* Make NEW-ALIAS a variable alias for symbol BASE-VARIABLE.
|
71574
|
766 Aliased variables always have the same value; setting one sets the other.
|
63391
e44f5953ff6a
(Fdefvaralias): Rename arguments SYMBOL and ALIASED to NEW-ALIAS and
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
767 Third arg DOCSTRING, if non-nil, is documentation for NEW-ALIAS. If it is
|
e44f5953ff6a
(Fdefvaralias): Rename arguments SYMBOL and ALIASED to NEW-ALIAS and
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
768 omitted or nil, NEW-ALIAS gets the documentation string of BASE-VARIABLE,
|
e44f5953ff6a
(Fdefvaralias): Rename arguments SYMBOL and ALIASED to NEW-ALIAS and
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
769 or of the variable at the end of the chain of aliases, if BASE-VARIABLE is
|
e44f5953ff6a
(Fdefvaralias): Rename arguments SYMBOL and ALIASED to NEW-ALIAS and
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
770 itself an alias.
|
e44f5953ff6a
(Fdefvaralias): Rename arguments SYMBOL and ALIASED to NEW-ALIAS and
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
771 The return value is BASE-VARIABLE. */)
|
e44f5953ff6a
(Fdefvaralias): Rename arguments SYMBOL and ALIASED to NEW-ALIAS and
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
772 (new_alias, base_variable, docstring)
|
e44f5953ff6a
(Fdefvaralias): Rename arguments SYMBOL and ALIASED to NEW-ALIAS and
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
773 Lisp_Object new_alias, base_variable, docstring;
|
39577
|
774 {
|
|
775 struct Lisp_Symbol *sym;
|
46388
|
776
|
63391
e44f5953ff6a
(Fdefvaralias): Rename arguments SYMBOL and ALIASED to NEW-ALIAS and
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
777 CHECK_SYMBOL (new_alias);
|
e44f5953ff6a
(Fdefvaralias): Rename arguments SYMBOL and ALIASED to NEW-ALIAS and
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
778 CHECK_SYMBOL (base_variable);
|
e44f5953ff6a
(Fdefvaralias): Rename arguments SYMBOL and ALIASED to NEW-ALIAS and
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
779
|
e44f5953ff6a
(Fdefvaralias): Rename arguments SYMBOL and ALIASED to NEW-ALIAS and
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
780 if (SYMBOL_CONSTANT_P (new_alias))
|
39577
|
781 error ("Cannot make a constant an alias");
|
|
782
|
63391
e44f5953ff6a
(Fdefvaralias): Rename arguments SYMBOL and ALIASED to NEW-ALIAS and
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
783 sym = XSYMBOL (new_alias);
|
39577
|
784 sym->indirect_variable = 1;
|
63391
e44f5953ff6a
(Fdefvaralias): Rename arguments SYMBOL and ALIASED to NEW-ALIAS and
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
785 sym->value = base_variable;
|
e44f5953ff6a
(Fdefvaralias): Rename arguments SYMBOL and ALIASED to NEW-ALIAS and
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
786 sym->constant = SYMBOL_CONSTANT_P (base_variable);
|
e44f5953ff6a
(Fdefvaralias): Rename arguments SYMBOL and ALIASED to NEW-ALIAS and
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
787 LOADHIST_ATTACH (new_alias);
|
46388
|
788 if (!NILP (docstring))
|
63391
e44f5953ff6a
(Fdefvaralias): Rename arguments SYMBOL and ALIASED to NEW-ALIAS and
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
789 Fput (new_alias, Qvariable_documentation, docstring);
|
62178
91b45e7531ea
(Fdefvaralias): Remove any pre-existing variable-documentation
Luc Teirlinck <teirllm@auburn.edu>
diff
changeset
|
790 else
|
63391
e44f5953ff6a
(Fdefvaralias): Rename arguments SYMBOL and ALIASED to NEW-ALIAS and
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
791 Fput (new_alias, Qvariable_documentation, Qnil);
|
e44f5953ff6a
(Fdefvaralias): Rename arguments SYMBOL and ALIASED to NEW-ALIAS and
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
792
|
e44f5953ff6a
(Fdefvaralias): Rename arguments SYMBOL and ALIASED to NEW-ALIAS and
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
793 return base_variable;
|
39577
|
794 }
|
|
795
|
|
796
|
272
|
797 DEFUN ("defvar", Fdefvar, Sdefvar, 1, UNEVALLED, 0,
|
64540
|
798 doc: /* Define SYMBOL as a variable, and return SYMBOL.
|
40570
|
799 You are not required to define a variable in order to use it,
|
|
800 but the definition can supply documentation and an initial value
|
|
801 in a way that tags can recognize.
|
|
802
|
|
803 INITVALUE is evaluated, and used to set SYMBOL, only if SYMBOL's value is void.
|
|
804 If SYMBOL is buffer-local, its default value is what is set;
|
|
805 buffer-local values are not affected.
|
|
806 INITVALUE and DOCSTRING are optional.
|
|
807 If DOCSTRING starts with *, this variable is identified as a user option.
|
|
808 This means that M-x set-variable recognizes it.
|
|
809 See also `user-variable-p'.
|
|
810 If INITVALUE is missing, SYMBOL's value is not set.
|
56557
|
811
|
|
812 If SYMBOL has a local binding, then this form affects the local
|
|
813 binding. This is usually not what you want. Thus, if you need to
|
|
814 load a file defining variables, with this form or with `defconst' or
|
|
815 `defcustom', you should always load that file _outside_ any bindings
|
|
816 for these variables. \(`defconst' and `defcustom' behave similarly in
|
|
817 this respect.)
|
40703
21597de09a0d
(top_level_value, top_level_set): Remove commented and #ifdef'd-out code.
Pavel Janík <Pavel@Janik.cz>
diff
changeset
|
818 usage: (defvar SYMBOL &optional INITVALUE DOCSTRING) */)
|
40570
|
819 (args)
|
272
|
820 Lisp_Object args;
|
|
821 {
|
10161
|
822 register Lisp_Object sym, tem, tail;
|
272
|
823
|
|
824 sym = Fcar (args);
|
10161
|
825 tail = Fcdr (args);
|
|
826 if (!NILP (Fcdr (Fcdr (tail))))
|
63697
9f617bb41e22
(Fdefvar, Fdefconst, Feval, Ffuncall): Follow error conventions.
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
827 error ("Too many arguments");
|
10161
|
828
|
37732
f98176963881
(Fdefvar): Only record (defvar <var>) in the load-history
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
829 tem = Fdefault_boundp (sym);
|
10161
|
830 if (!NILP (tail))
|
272
|
831 {
|
64638
|
832 if (SYMBOL_CONSTANT_P (sym))
|
|
833 {
|
|
834 /* For upward compatibility, allow (defvar :foo (quote :foo)). */
|
|
835 Lisp_Object tem = Fcar (tail);
|
|
836 if (! (CONSP (tem)
|
|
837 && EQ (XCAR (tem), Qquote)
|
|
838 && CONSP (XCDR (tem))
|
|
839 && EQ (XCAR (XCDR (tem)), sym)))
|
|
840 error ("Constant symbol `%s' specified in defvar",
|
|
841 SDATA (SYMBOL_NAME (sym)));
|
|
842 }
|
|
843
|
485
|
844 if (NILP (tem))
|
37732
f98176963881
(Fdefvar): Only record (defvar <var>) in the load-history
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
845 Fset_default (sym, Feval (Fcar (tail)));
|
58413
73c39b73a189
(Fdefvar): Warn when var is let-bound but globally void.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
846 else
|
73c39b73a189
(Fdefvar): Warn when var is let-bound but globally void.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
847 { /* Check if there is really a global binding rather than just a let
|
73c39b73a189
(Fdefvar): Warn when var is let-bound but globally void.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
848 binding that shadows the global unboundness of the var. */
|
58523
|
849 volatile struct specbinding *pdl = specpdl_ptr;
|
58413
73c39b73a189
(Fdefvar): Warn when var is let-bound but globally void.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
850 while (--pdl >= specpdl)
|
73c39b73a189
(Fdefvar): Warn when var is let-bound but globally void.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
851 {
|
73c39b73a189
(Fdefvar): Warn when var is let-bound but globally void.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
852 if (EQ (pdl->symbol, sym) && !pdl->func
|
73c39b73a189
(Fdefvar): Warn when var is let-bound but globally void.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
853 && EQ (pdl->old_value, Qunbound))
|
73c39b73a189
(Fdefvar): Warn when var is let-bound but globally void.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
854 {
|
73c39b73a189
(Fdefvar): Warn when var is let-bound but globally void.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
855 message_with_string ("Warning: defvar ignored because %s is let-bound",
|
73c39b73a189
(Fdefvar): Warn when var is let-bound but globally void.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
856 SYMBOL_NAME (sym), 1);
|
73c39b73a189
(Fdefvar): Warn when var is let-bound but globally void.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
857 break;
|
73c39b73a189
(Fdefvar): Warn when var is let-bound but globally void.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
858 }
|
73c39b73a189
(Fdefvar): Warn when var is let-bound but globally void.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
859 }
|
73c39b73a189
(Fdefvar): Warn when var is let-bound but globally void.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
860 }
|
37732
f98176963881
(Fdefvar): Only record (defvar <var>) in the load-history
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
861 tail = Fcdr (tail);
|
50630
dfbdcffdcfc9
(For, Fand, Fprogn, un_autoload, do_autoload): Use XCDR, XCAR, CONSP.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
862 tem = Fcar (tail);
|
dfbdcffdcfc9
(For, Fand, Fprogn, un_autoload, do_autoload): Use XCDR, XCAR, CONSP.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
863 if (!NILP (tem))
|
37732
f98176963881
(Fdefvar): Only record (defvar <var>) in the load-history
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
864 {
|
f98176963881
(Fdefvar): Only record (defvar <var>) in the load-history
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
865 if (!NILP (Vpurify_flag))
|
f98176963881
(Fdefvar): Only record (defvar <var>) in the load-history
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
866 tem = Fpurecopy (tem);
|
f98176963881
(Fdefvar): Only record (defvar <var>) in the load-history
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
867 Fput (sym, Qvariable_documentation, tem);
|
f98176963881
(Fdefvar): Only record (defvar <var>) in the load-history
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
868 }
|
59109
|
869 LOADHIST_ATTACH (sym);
|
272
|
870 }
|
37732
f98176963881
(Fdefvar): Only record (defvar <var>) in the load-history
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
871 else
|
47022
|
872 /* Simple (defvar <var>) should not count as a definition at all.
|
|
873 It could get in the way of other definitions, and unloading this
|
|
874 package could try to make the variable unbound. */
|
47026
|
875 ;
|
|
876
|
272
|
877 return sym;
|
|
878 }
|
|
879
|
|
880 DEFUN ("defconst", Fdefconst, Sdefconst, 2, UNEVALLED, 0,
|
40570
|
881 doc: /* Define SYMBOL as a constant variable.
|
|
882 The intent is that neither programs nor users should ever change this value.
|
|
883 Always sets the value of SYMBOL to the result of evalling INITVALUE.
|
|
884 If SYMBOL is buffer-local, its default value is what is set;
|
|
885 buffer-local values are not affected.
|
|
886 DOCSTRING is optional.
|
56557
|
887
|
|
888 If SYMBOL has a local binding, then this form sets the local binding's
|
|
889 value. However, you should normally not make local bindings for
|
|
890 variables defined with this form.
|
41846
680de0f18330
Undo last change. Consistency doesn't seem to be desired.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
891 usage: (defconst SYMBOL INITVALUE [DOCSTRING]) */)
|
40570
|
892 (args)
|
272
|
893 Lisp_Object args;
|
|
894 {
|
|
895 register Lisp_Object sym, tem;
|
|
896
|
|
897 sym = Fcar (args);
|
10161
|
898 if (!NILP (Fcdr (Fcdr (Fcdr (args)))))
|
63697
9f617bb41e22
(Fdefvar, Fdefconst, Feval, Ffuncall): Follow error conventions.
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
899 error ("Too many arguments");
|
10161
|
900
|
27554
|
901 tem = Feval (Fcar (Fcdr (args)));
|
|
902 if (!NILP (Vpurify_flag))
|
|
903 tem = Fpurecopy (tem);
|
|
904 Fset_default (sym, tem);
|
272
|
905 tem = Fcar (Fcdr (Fcdr (args)));
|
485
|
906 if (!NILP (tem))
|
272
|
907 {
|
485
|
908 if (!NILP (Vpurify_flag))
|
272
|
909 tem = Fpurecopy (tem);
|
|
910 Fput (sym, Qvariable_documentation, tem);
|
|
911 }
|
71341
|
912 Fput (sym, Qrisky_local_variable, Qt);
|
59109
|
913 LOADHIST_ATTACH (sym);
|
272
|
914 return sym;
|
|
915 }
|
|
916
|
63826
|
917 /* Error handler used in Fuser_variable_p. */
|
|
918 static Lisp_Object
|
|
919 user_variable_p_eh (ignore)
|
|
920 Lisp_Object ignore;
|
|
921 {
|
|
922 return Qnil;
|
|
923 }
|
|
924
|
272
|
925 DEFUN ("user-variable-p", Fuser_variable_p, Suser_variable_p, 1, 1, 0,
|
63826
|
926 doc: /* Return t if VARIABLE is intended to be set and modified by users.
|
40570
|
927 \(The alternative is a variable used internally in a Lisp program.)
|
63826
|
928 A variable is a user variable if
|
|
929 \(1) the first character of its documentation is `*', or
|
|
930 \(2) it is customizable (its property list contains a non-nil value
|
|
931 of `standard-value' or `custom-autoload'), or
|
|
932 \(3) it is an alias for another user variable.
|
|
933 Return nil if VARIABLE is an alias and there is a loop in the
|
|
934 chain of symbols. */)
|
40570
|
935 (variable)
|
272
|
936 Lisp_Object variable;
|
|
937 {
|
|
938 Lisp_Object documentation;
|
49600
|
939
|
17275
|
940 if (!SYMBOLP (variable))
|
|
941 return Qnil;
|
|
942
|
63826
|
943 /* If indirect and there's an alias loop, don't check anything else. */
|
|
944 if (XSYMBOL (variable)->indirect_variable
|
|
945 && NILP (internal_condition_case_1 (indirect_variable, variable,
|
|
946 Qt, user_variable_p_eh)))
|
|
947 return Qnil;
|
|
948
|
|
949 while (1)
|
|
950 {
|
|
951 documentation = Fget (variable, Qvariable_documentation);
|
|
952 if (INTEGERP (documentation) && XINT (documentation) < 0)
|
|
953 return Qt;
|
|
954 if (STRINGP (documentation)
|
|
955 && ((unsigned char) SREF (documentation, 0) == '*'))
|
|
956 return Qt;
|
|
957 /* If it is (STRING . INTEGER), a negative integer means a user variable. */
|
|
958 if (CONSP (documentation)
|
|
959 && STRINGP (XCAR (documentation))
|
|
960 && INTEGERP (XCDR (documentation))
|
|
961 && XINT (XCDR (documentation)) < 0)
|
|
962 return Qt;
|
|
963 /* Customizable? See `custom-variable-p'. */
|
|
964 if ((!NILP (Fget (variable, intern ("standard-value"))))
|
|
965 || (!NILP (Fget (variable, intern ("custom-autoload")))))
|
|
966 return Qt;
|
|
967
|
|
968 if (!XSYMBOL (variable)->indirect_variable)
|
|
969 return Qnil;
|
|
970
|
|
971 /* An indirect variable? Let's follow the chain. */
|
|
972 variable = XSYMBOL (variable)->value;
|
|
973 }
|
49600
|
974 }
|
272
|
975
|
|
976 DEFUN ("let*", FletX, SletX, 1, UNEVALLED, 0,
|
40570
|
977 doc: /* Bind variables according to VARLIST then eval BODY.
|
|
978 The value of the last form in BODY is returned.
|
|
979 Each element of VARLIST is a symbol (which is bound to nil)
|
|
980 or a list (SYMBOL VALUEFORM) (which binds SYMBOL to the value of VALUEFORM).
|
|
981 Each VALUEFORM can refer to the symbols already bound by this VARLIST.
|
41846
680de0f18330
Undo last change. Consistency doesn't seem to be desired.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
982 usage: (let* VARLIST BODY...) */)
|
40570
|
983 (args)
|
272
|
984 Lisp_Object args;
|
|
985 {
|
|
986 Lisp_Object varlist, val, elt;
|
46293
|
987 int count = SPECPDL_INDEX ();
|
272
|
988 struct gcpro gcpro1, gcpro2, gcpro3;
|
|
989
|
|
990 GCPRO3 (args, elt, varlist);
|
|
991
|
|
992 varlist = Fcar (args);
|
485
|
993 while (!NILP (varlist))
|
272
|
994 {
|
|
995 QUIT;
|
|
996 elt = Fcar (varlist);
|
9148
|
997 if (SYMBOLP (elt))
|
272
|
998 specbind (elt, Qnil);
|
604
|
999 else if (! NILP (Fcdr (Fcdr (elt))))
|
71976
|
1000 signal_error ("`let' bindings can have only one value-form", elt);
|
272
|
1001 else
|
|
1002 {
|
|
1003 val = Feval (Fcar (Fcdr (elt)));
|
|
1004 specbind (Fcar (elt), val);
|
|
1005 }
|
|
1006 varlist = Fcdr (varlist);
|
|
1007 }
|
|
1008 UNGCPRO;
|
|
1009 val = Fprogn (Fcdr (args));
|
|
1010 return unbind_to (count, val);
|
|
1011 }
|
|
1012
|
|
1013 DEFUN ("let", Flet, Slet, 1, UNEVALLED, 0,
|
40570
|
1014 doc: /* Bind variables according to VARLIST then eval BODY.
|
|
1015 The value of the last form in BODY is returned.
|
|
1016 Each element of VARLIST is a symbol (which is bound to nil)
|
|
1017 or a list (SYMBOL VALUEFORM) (which binds SYMBOL to the value of VALUEFORM).
|
|
1018 All the VALUEFORMs are evalled before any symbols are bound.
|
41846
680de0f18330
Undo last change. Consistency doesn't seem to be desired.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
1019 usage: (let VARLIST BODY...) */)
|
40570
|
1020 (args)
|
272
|
1021 Lisp_Object args;
|
|
1022 {
|
|
1023 Lisp_Object *temps, tem;
|
|
1024 register Lisp_Object elt, varlist;
|
46293
|
1025 int count = SPECPDL_INDEX ();
|
272
|
1026 register int argnum;
|
|
1027 struct gcpro gcpro1, gcpro2;
|
|
1028
|
|
1029 varlist = Fcar (args);
|
|
1030
|
|
1031 /* Make space to hold the values to give the bound variables */
|
|
1032 elt = Flength (varlist);
|
|
1033 temps = (Lisp_Object *) alloca (XFASTINT (elt) * sizeof (Lisp_Object));
|
|
1034
|
|
1035 /* Compute the values and store them in `temps' */
|
|
1036
|
|
1037 GCPRO2 (args, *temps);
|
|
1038 gcpro2.nvars = 0;
|
|
1039
|
485
|
1040 for (argnum = 0; !NILP (varlist); varlist = Fcdr (varlist))
|
272
|
1041 {
|
|
1042 QUIT;
|
|
1043 elt = Fcar (varlist);
|
9148
|
1044 if (SYMBOLP (elt))
|
272
|
1045 temps [argnum++] = Qnil;
|
604
|
1046 else if (! NILP (Fcdr (Fcdr (elt))))
|
71976
|
1047 signal_error ("`let' bindings can have only one value-form", elt);
|
272
|
1048 else
|
|
1049 temps [argnum++] = Feval (Fcar (Fcdr (elt)));
|
|
1050 gcpro2.nvars = argnum;
|
|
1051 }
|
|
1052 UNGCPRO;
|
|
1053
|
|
1054 varlist = Fcar (args);
|
485
|
1055 for (argnum = 0; !NILP (varlist); varlist = Fcdr (varlist))
|
272
|
1056 {
|
|
1057 elt = Fcar (varlist);
|
|
1058 tem = temps[argnum++];
|
9148
|
1059 if (SYMBOLP (elt))
|
272
|
1060 specbind (elt, tem);
|
|
1061 else
|
|
1062 specbind (Fcar (elt), tem);
|
|
1063 }
|
|
1064
|
|
1065 elt = Fprogn (Fcdr (args));
|
|
1066 return unbind_to (count, elt);
|
|
1067 }
|
|
1068
|
|
1069 DEFUN ("while", Fwhile, Swhile, 1, UNEVALLED, 0,
|
40570
|
1070 doc: /* If TEST yields non-nil, eval BODY... and repeat.
|
|
1071 The order of execution is thus TEST, BODY, TEST, BODY and so on
|
|
1072 until TEST returns nil.
|
41846
680de0f18330
Undo last change. Consistency doesn't seem to be desired.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
1073 usage: (while TEST BODY...) */)
|
40570
|
1074 (args)
|
272
|
1075 Lisp_Object args;
|
|
1076 {
|
42277
|
1077 Lisp_Object test, body;
|
272
|
1078 struct gcpro gcpro1, gcpro2;
|
|
1079
|
|
1080 GCPRO2 (test, body);
|
|
1081
|
|
1082 test = Fcar (args);
|
|
1083 body = Fcdr (args);
|
42277
|
1084 while (!NILP (Feval (test)))
|
272
|
1085 {
|
|
1086 QUIT;
|
|
1087 Fprogn (body);
|
|
1088 }
|
|
1089
|
|
1090 UNGCPRO;
|
|
1091 return Qnil;
|
|
1092 }
|
|
1093
|
|
1094 DEFUN ("macroexpand", Fmacroexpand, Smacroexpand, 1, 2, 0,
|
40570
|
1095 doc: /* Return result of expanding macros at top level of FORM.
|
|
1096 If FORM is not a macro call, it is returned unchanged.
|
|
1097 Otherwise, the macro is expanded and the expansion is considered
|
|
1098 in place of FORM. When a non-macro-call results, it is returned.
|
|
1099
|
|
1100 The second optional arg ENVIRONMENT specifies an environment of macro
|
|
1101 definitions to shadow the loaded ones for use in file byte-compilation. */)
|
|
1102 (form, environment)
|
16113
|
1103 Lisp_Object form;
|
14073
|
1104 Lisp_Object environment;
|
272
|
1105 {
|
753
|
1106 /* With cleanups from Hallvard Furuseth. */
|
272
|
1107 register Lisp_Object expander, sym, def, tem;
|
|
1108
|
|
1109 while (1)
|
|
1110 {
|
|
1111 /* Come back here each time we expand a macro call,
|
|
1112 in case it expands into another macro call. */
|
9148
|
1113 if (!CONSP (form))
|
272
|
1114 break;
|
753
|
1115 /* Set SYM, give DEF and TEM right values in case SYM is not a symbol. */
|
25662
0a7261c1d487
Use XCAR, XCDR, and XFLOAT_DATA instead of explicit member access.
Ken Raeburn <raeburn@raeburn.org>
diff
changeset
|
1116 def = sym = XCAR (form);
|
753
|
1117 tem = Qnil;
|
272
|
1118 /* Trace symbols aliases to other symbols
|
|
1119 until we get a symbol that is not an alias. */
|
9148
|
1120 while (SYMBOLP (def))
|
272
|
1121 {
|
|
1122 QUIT;
|
753
|
1123 sym = def;
|
14073
|
1124 tem = Fassq (sym, environment);
|
485
|
1125 if (NILP (tem))
|
272
|
1126 {
|
|
1127 def = XSYMBOL (sym)->function;
|
753
|
1128 if (!EQ (def, Qunbound))
|
|
1129 continue;
|
272
|
1130 }
|
753
|
1131 break;
|
272
|
1132 }
|
14073
|
1133 /* Right now TEM is the result from SYM in ENVIRONMENT,
|
272
|
1134 and if TEM is nil then DEF is SYM's function definition. */
|
485
|
1135 if (NILP (tem))
|
272
|
1136 {
|
14073
|
1137 /* SYM is not mentioned in ENVIRONMENT.
|
272
|
1138 Look at its function definition. */
|
9148
|
1139 if (EQ (def, Qunbound) || !CONSP (def))
|
272
|
1140 /* Not defined or definition not suitable */
|
|
1141 break;
|
25662
0a7261c1d487
Use XCAR, XCDR, and XFLOAT_DATA instead of explicit member access.
Ken Raeburn <raeburn@raeburn.org>
diff
changeset
|
1142 if (EQ (XCAR (def), Qautoload))
|
272
|
1143 {
|
|
1144 /* Autoloading function: will it be a macro when loaded? */
|
1564
|
1145 tem = Fnth (make_number (4), def);
|
5254
|
1146 if (EQ (tem, Qt) || EQ (tem, Qmacro))
|
1564
|
1147 /* Yes, load it and try again. */
|
|
1148 {
|
16108
|
1149 struct gcpro gcpro1;
|
|
1150 GCPRO1 (form);
|
1564
|
1151 do_autoload (def, sym);
|
16108
|
1152 UNGCPRO;
|
1564
|
1153 continue;
|
|
1154 }
|
|
1155 else
|
272
|
1156 break;
|
|
1157 }
|
25662
0a7261c1d487
Use XCAR, XCDR, and XFLOAT_DATA instead of explicit member access.
Ken Raeburn <raeburn@raeburn.org>
diff
changeset
|
1158 else if (!EQ (XCAR (def), Qmacro))
|
272
|
1159 break;
|
25662
0a7261c1d487
Use XCAR, XCDR, and XFLOAT_DATA instead of explicit member access.
Ken Raeburn <raeburn@raeburn.org>
diff
changeset
|
1160 else expander = XCDR (def);
|
272
|
1161 }
|
|
1162 else
|
|
1163 {
|
25662
0a7261c1d487
Use XCAR, XCDR, and XFLOAT_DATA instead of explicit member access.
Ken Raeburn <raeburn@raeburn.org>
diff
changeset
|
1164 expander = XCDR (tem);
|
485
|
1165 if (NILP (expander))
|
272
|
1166 break;
|
|
1167 }
|
25662
0a7261c1d487
Use XCAR, XCDR, and XFLOAT_DATA instead of explicit member access.
Ken Raeburn <raeburn@raeburn.org>
diff
changeset
|
1168 form = apply1 (expander, XCDR (form));
|
272
|
1169 }
|
|
1170 return form;
|
|
1171 }
|
|
1172
|
|
1173 DEFUN ("catch", Fcatch, Scatch, 1, UNEVALLED, 0,
|
40570
|
1174 doc: /* Eval BODY allowing nonlocal exits using `throw'.
|
|
1175 TAG is evalled to get the tag to use; it must not be nil.
|
|
1176
|
|
1177 Then the BODY is executed.
|
73602
|
1178 Within BODY, a call to `throw' with the same TAG exits BODY and this `catch'.
|
40570
|
1179 If no throw happens, `catch' returns the value of the last BODY form.
|
|
1180 If a throw happens, it specifies the value to return from `catch'.
|
41846
680de0f18330
Undo last change. Consistency doesn't seem to be desired.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
1181 usage: (catch TAG BODY...) */)
|
40570
|
1182 (args)
|
272
|
1183 Lisp_Object args;
|
|
1184 {
|
|
1185 register Lisp_Object tag;
|
|
1186 struct gcpro gcpro1;
|
|
1187
|
|
1188 GCPRO1 (args);
|
|
1189 tag = Feval (Fcar (args));
|
|
1190 UNGCPRO;
|
|
1191 return internal_catch (tag, Fprogn, Fcdr (args));
|
|
1192 }
|
|
1193
|
|
1194 /* Set up a catch, then call C function FUNC on argument ARG.
|
|
1195 FUNC should return a Lisp_Object.
|
|
1196 This is how catches are done from within C code. */
|
|
1197
|
|
1198 Lisp_Object
|
|
1199 internal_catch (tag, func, arg)
|
|
1200 Lisp_Object tag;
|
|
1201 Lisp_Object (*func) ();
|
|
1202 Lisp_Object arg;
|
|
1203 {
|
|
1204 /* This structure is made part of the chain `catchlist'. */
|
|
1205 struct catchtag c;
|
|
1206
|
|
1207 /* Fill in the components of c, and put it on the list. */
|
|
1208 c.next = catchlist;
|
|
1209 c.tag = tag;
|
|
1210 c.val = Qnil;
|
|
1211 c.backlist = backtrace_list;
|
|
1212 c.handlerlist = handlerlist;
|
|
1213 c.lisp_eval_depth = lisp_eval_depth;
|
46293
|
1214 c.pdlcount = SPECPDL_INDEX ();
|
272
|
1215 c.poll_suppress_count = poll_suppress_count;
|
48909
|
1216 c.interrupt_input_blocked = interrupt_input_blocked;
|
272
|
1217 c.gcpro = gcprolist;
|
26365
|
1218 c.byte_stack = byte_stack_list;
|
272
|
1219 catchlist = &c;
|
|
1220
|
|
1221 /* Call FUNC. */
|
|
1222 if (! _setjmp (c.jmp))
|
|
1223 c.val = (*func) (arg);
|
|
1224
|
|
1225 /* Throw works by a longjmp that comes right here. */
|
|
1226 catchlist = c.next;
|
|
1227 return c.val;
|
|
1228 }
|
|
1229
|
1199
|
1230 /* Unwind the specbind, catch, and handler stacks back to CATCH, and
|
|
1231 jump to that CATCH, returning VALUE as the value of that catch.
|
|
1232
|
|
1233 This is the guts Fthrow and Fsignal; they differ only in the way
|
|
1234 they choose the catch tag to throw to. A catch tag for a
|
|
1235 condition-case form has a TAG of Qnil.
|
272
|
1236
|
1199
|
1237 Before each catch is discarded, unbind all special bindings and
|
|
1238 execute all unwind-protect clauses made above that catch. Unwind
|
|
1239 the handler stack as we go, so that the proper handlers are in
|
|
1240 effect for each unwind-protect clause we run. At the end, restore
|
|
1241 some static info saved in CATCH, and longjmp to the location
|
|
1242 specified in the
|
272
|
1243
|
1199
|
1244 This is used for correct unwinding in Fthrow and Fsignal. */
|
272
|
1245
|
|
1246 static void
|
1199
|
1247 unwind_to_catch (catch, value)
|
272
|
1248 struct catchtag *catch;
|
1199
|
1249 Lisp_Object value;
|
272
|
1250 {
|
|
1251 register int last_time;
|
|
1252
|
1199
|
1253 /* Save the value in the tag. */
|
|
1254 catch->val = value;
|
|
1255
|
58734
|
1256 /* Restore certain special C variables. */
|
4474
|
1257 set_poll_suppress_count (catch->poll_suppress_count);
|
60418
|
1258 UNBLOCK_INPUT_TO (catch->interrupt_input_blocked);
|
58734
|
1259 handling_signal = 0;
|
59051
|
1260 immediate_quit = 0;
|
1196
|
1261
|
272
|
1262 do
|
|
1263 {
|
|
1264 last_time = catchlist == catch;
|
1196
|
1265
|
|
1266 /* Unwind the specpdl stack, and then restore the proper set of
|
|
1267 handlers. */
|
272
|
1268 unbind_to (catchlist->pdlcount, Qnil);
|
|
1269 handlerlist = catchlist->handlerlist;
|
|
1270 catchlist = catchlist->next;
|
|
1271 }
|
|
1272 while (! last_time);
|
|
1273
|
69399
947598ed954a
(unwind_to_catch): Call x_fully_uncatch_errors only if HAVE_X_WINDOWS.
Eli Zaretskii <eliz@gnu.org>
diff
changeset
|
1274 #if HAVE_X_WINDOWS
|
69387
|
1275 /* If x_catch_errors was done, turn it off now.
|
|
1276 (First we give unbind_to a chance to do that.) */
|
|
1277 x_fully_uncatch_errors ();
|
69399
947598ed954a
(unwind_to_catch): Call x_fully_uncatch_errors only if HAVE_X_WINDOWS.
Eli Zaretskii <eliz@gnu.org>
diff
changeset
|
1278 #endif
|
69387
|
1279
|
26365
|
1280 byte_stack_list = catch->byte_stack;
|
272
|
1281 gcprolist = catch->gcpro;
|
26297
|
1282 #ifdef DEBUG_GCPRO
|
|
1283 if (gcprolist != 0)
|
|
1284 gcpro_level = gcprolist->level + 1;
|
|
1285 else
|
|
1286 gcpro_level = 0;
|
|
1287 #endif
|
272
|
1288 backtrace_list = catch->backlist;
|
|
1289 lisp_eval_depth = catch->lisp_eval_depth;
|
49600
|
1290
|
1199
|
1291 _longjmp (catch->jmp, 1);
|
272
|
1292 }
|
|
1293
|
|
1294 DEFUN ("throw", Fthrow, Sthrow, 2, 2, 0,
|
40570
|
1295 doc: /* Throw to the catch for TAG and return VALUE from it.
|
|
1296 Both TAG and VALUE are evalled. */)
|
|
1297 (tag, value)
|
14073
|
1298 register Lisp_Object tag, value;
|
272
|
1299 {
|
|
1300 register struct catchtag *c;
|
|
1301
|
71872
|
1302 if (!NILP (tag))
|
|
1303 for (c = catchlist; c; c = c->next)
|
|
1304 {
|
|
1305 if (EQ (c->tag, tag))
|
|
1306 unwind_to_catch (c, value);
|
|
1307 }
|
71976
|
1308 xsignal2 (Qno_catch, tag, value);
|
272
|
1309 }
|
|
1310
|
|
1311
|
|
1312 DEFUN ("unwind-protect", Funwind_protect, Sunwind_protect, 1, UNEVALLED, 0,
|
40570
|
1313 doc: /* Do BODYFORM, protecting with UNWINDFORMS.
|
|
1314 If BODYFORM completes normally, its value is returned
|
|
1315 after executing the UNWINDFORMS.
|
|
1316 If BODYFORM exits nonlocally, the UNWINDFORMS are executed anyway.
|
41846
680de0f18330
Undo last change. Consistency doesn't seem to be desired.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
1317 usage: (unwind-protect BODYFORM UNWINDFORMS...) */)
|
40570
|
1318 (args)
|
272
|
1319 Lisp_Object args;
|
|
1320 {
|
|
1321 Lisp_Object val;
|
46293
|
1322 int count = SPECPDL_INDEX ();
|
272
|
1323
|
50774
cddacf81f5e7
(Funwind_protect): Use func = Fprogn rather symbol = Qnil.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
1324 record_unwind_protect (Fprogn, Fcdr (args));
|
272
|
1325 val = Feval (Fcar (args));
|
49600
|
1326 return unbind_to (count, val);
|
272
|
1327 }
|
|
1328
|
|
1329 /* Chain of condition handlers currently in effect.
|
|
1330 The elements of this chain are contained in the stack frames
|
|
1331 of Fcondition_case and internal_condition_case.
|
|
1332 When an error is signaled (by calling Fsignal, below),
|
|
1333 this chain is searched for an element that applies. */
|
|
1334
|
|
1335 struct handler *handlerlist;
|
|
1336
|
|
1337 DEFUN ("condition-case", Fcondition_case, Scondition_case, 2, UNEVALLED, 0,
|
40570
|
1338 doc: /* Regain control when an error is signaled.
|
40661
|
1339 Executes BODYFORM and returns its value if no error happens.
|
40570
|
1340 Each element of HANDLERS looks like (CONDITION-NAME BODY...)
|
|
1341 where the BODY is made of Lisp expressions.
|
|
1342
|
|
1343 A handler is applicable to an error
|
|
1344 if CONDITION-NAME is one of the error's condition names.
|
|
1345 If an error happens, the first applicable handler is run.
|
|
1346
|
|
1347 The car of a handler may be a list of condition names
|
78664
|
1348 instead of a single condition name. Then it handles all of them.
|
|
1349
|
|
1350 When a handler handles an error, control returns to the `condition-case'
|
|
1351 and it executes the handler's BODY...
|
|
1352 with VAR bound to (SIGNALED-CONDITIONS . SIGNAL-DATA) from the error.
|
|
1353 (If VAR is nil, the handler can't access that information.)
|
|
1354 Then the value of the last BODY form is returned from the `condition-case'
|
|
1355 expression.
|
|
1356
|
40570
|
1357 See also the function `signal' for more info.
|
55879
|
1358 usage: (condition-case VAR BODYFORM &rest HANDLERS) */)
|
40570
|
1359 (args)
|
272
|
1360 Lisp_Object args;
|
|
1361 {
|
32657
|
1362 register Lisp_Object bodyform, handlers;
|
|
1363 volatile Lisp_Object var;
|
1196
|
1364
|
|
1365 var = Fcar (args);
|
|
1366 bodyform = Fcar (Fcdr (args));
|
|
1367 handlers = Fcdr (Fcdr (args));
|
66528
|
1368
|
|
1369 return internal_lisp_condition_case (var, bodyform, handlers);
|
|
1370 }
|
|
1371
|
|
1372 /* Like Fcondition_case, but the args are separate
|
|
1373 rather than passed in a list. Used by Fbyte_code. */
|
|
1374
|
|
1375 Lisp_Object
|
|
1376 internal_lisp_condition_case (var, bodyform, handlers)
|
|
1377 volatile Lisp_Object var;
|
|
1378 Lisp_Object bodyform, handlers;
|
|
1379 {
|
|
1380 Lisp_Object val;
|
|
1381 struct catchtag c;
|
|
1382 struct handler h;
|
|
1383
|
40656
|
1384 CHECK_SYMBOL (var);
|
272
|
1385
|
55879
|
1386 for (val = handlers; CONSP (val); val = XCDR (val))
|
1196
|
1387 {
|
|
1388 Lisp_Object tem;
|
55879
|
1389 tem = XCAR (val);
|
5563
50ada322de3e
(Fcondition_case): Allow a list of condition names in a handler.
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
1390 if (! (NILP (tem)
|
50ada322de3e
(Fcondition_case): Allow a list of condition names in a handler.
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
1391 || (CONSP (tem)
|
25662
0a7261c1d487
Use XCAR, XCDR, and XFLOAT_DATA instead of explicit member access.
Ken Raeburn <raeburn@raeburn.org>
diff
changeset
|
1392 && (SYMBOLP (XCAR (tem))
|
0a7261c1d487
Use XCAR, XCDR, and XFLOAT_DATA instead of explicit member access.
Ken Raeburn <raeburn@raeburn.org>
diff
changeset
|
1393 || CONSP (XCAR (tem))))))
|
1196
|
1394 error ("Invalid condition handler", tem);
|
|
1395 }
|
272
|
1396
|
|
1397 c.tag = Qnil;
|
|
1398 c.val = Qnil;
|
|
1399 c.backlist = backtrace_list;
|
|
1400 c.handlerlist = handlerlist;
|
|
1401 c.lisp_eval_depth = lisp_eval_depth;
|
46293
|
1402 c.pdlcount = SPECPDL_INDEX ();
|
272
|
1403 c.poll_suppress_count = poll_suppress_count;
|
48909
|
1404 c.interrupt_input_blocked = interrupt_input_blocked;
|
272
|
1405 c.gcpro = gcprolist;
|
26365
|
1406 c.byte_stack = byte_stack_list;
|
272
|
1407 if (_setjmp (c.jmp))
|
|
1408 {
|
485
|
1409 if (!NILP (h.var))
|
6132
|
1410 specbind (h.var, c.val);
|
|
1411 val = Fprogn (Fcdr (h.chosen_clause));
|
1196
|
1412
|
|
1413 /* Note that this just undoes the binding of h.var; whoever
|
|
1414 longjumped to us unwound the stack to c.pdlcount before
|
|
1415 throwing. */
|
272
|
1416 unbind_to (c.pdlcount, Qnil);
|
|
1417 return val;
|
|
1418 }
|
|
1419 c.next = catchlist;
|
|
1420 catchlist = &c;
|
49600
|
1421
|
1196
|
1422 h.var = var;
|
|
1423 h.handler = handlers;
|
272
|
1424 h.next = handlerlist;
|
|
1425 h.tag = &c;
|
|
1426 handlerlist = &h;
|
|
1427
|
1196
|
1428 val = Feval (bodyform);
|
272
|
1429 catchlist = c.next;
|
|
1430 handlerlist = h.next;
|
|
1431 return val;
|
|
1432 }
|
|
1433
|
14218
|
1434 /* Call the function BFUN with no arguments, catching errors within it
|
|
1435 according to HANDLERS. If there is an error, call HFUN with
|
|
1436 one argument which is the data that describes the error:
|
|
1437 (SIGNALNAME . DATA)
|
|
1438
|
|
1439 HANDLERS can be a list of conditions to catch.
|
|
1440 If HANDLERS is Qt, catch all errors.
|
|
1441 If HANDLERS is Qerror, catch all errors
|
|
1442 but allow the debugger to run if that is enabled. */
|
|
1443
|
272
|
1444 Lisp_Object
|
|
1445 internal_condition_case (bfun, handlers, hfun)
|
|
1446 Lisp_Object (*bfun) ();
|
|
1447 Lisp_Object handlers;
|
|
1448 Lisp_Object (*hfun) ();
|
|
1449 {
|
|
1450 Lisp_Object val;
|
|
1451 struct catchtag c;
|
|
1452 struct handler h;
|
|
1453
|
69387
|
1454 /* Since Fsignal will close off all calls to x_catch_errors,
|
|
1455 we will get the wrong results if some are not closed now. */
|
69399
947598ed954a
(unwind_to_catch): Call x_fully_uncatch_errors only if HAVE_X_WINDOWS.
Eli Zaretskii <eliz@gnu.org>
diff
changeset
|
1456 #if HAVE_X_WINDOWS
|
69387
|
1457 if (x_catching_errors ())
|
11365
|
1458 abort ();
|
69399
947598ed954a
(unwind_to_catch): Call x_fully_uncatch_errors only if HAVE_X_WINDOWS.
Eli Zaretskii <eliz@gnu.org>
diff
changeset
|
1459 #endif
|
11365
|
1460
|
272
|
1461 c.tag = Qnil;
|
|
1462 c.val = Qnil;
|
|
1463 c.backlist = backtrace_list;
|
|
1464 c.handlerlist = handlerlist;
|
|
1465 c.lisp_eval_depth = lisp_eval_depth;
|
46293
|
1466 c.pdlcount = SPECPDL_INDEX ();
|
272
|
1467 c.poll_suppress_count = poll_suppress_count;
|
48909
|
1468 c.interrupt_input_blocked = interrupt_input_blocked;
|
272
|
1469 c.gcpro = gcprolist;
|
26365
|
1470 c.byte_stack = byte_stack_list;
|
272
|
1471 if (_setjmp (c.jmp))
|
|
1472 {
|
6132
|
1473 return (*hfun) (c.val);
|
272
|
1474 }
|
|
1475 c.next = catchlist;
|
|
1476 catchlist = &c;
|
|
1477 h.handler = handlers;
|
|
1478 h.var = Qnil;
|
|
1479 h.next = handlerlist;
|
|
1480 h.tag = &c;
|
|
1481 handlerlist = &h;
|
|
1482
|
|
1483 val = (*bfun) ();
|
|
1484 catchlist = c.next;
|
|
1485 handlerlist = h.next;
|
|
1486 return val;
|
|
1487 }
|
|
1488
|
48909
|
1489 /* Like internal_condition_case but call BFUN with ARG as its argument. */
|
14218
|
1490
|
5807
|
1491 Lisp_Object
|
|
1492 internal_condition_case_1 (bfun, arg, handlers, hfun)
|
|
1493 Lisp_Object (*bfun) ();
|
|
1494 Lisp_Object arg;
|
|
1495 Lisp_Object handlers;
|
|
1496 Lisp_Object (*hfun) ();
|
|
1497 {
|
|
1498 Lisp_Object val;
|
|
1499 struct catchtag c;
|
|
1500 struct handler h;
|
|
1501
|
69387
|
1502 /* Since Fsignal will close off all calls to x_catch_errors,
|
|
1503 we will get the wrong results if some are not closed now. */
|
69399
947598ed954a
(unwind_to_catch): Call x_fully_uncatch_errors only if HAVE_X_WINDOWS.
Eli Zaretskii <eliz@gnu.org>
diff
changeset
|
1504 #if HAVE_X_WINDOWS
|
69387
|
1505 if (x_catching_errors ())
|
|
1506 abort ();
|
69399
947598ed954a
(unwind_to_catch): Call x_fully_uncatch_errors only if HAVE_X_WINDOWS.
Eli Zaretskii <eliz@gnu.org>
diff
changeset
|
1507 #endif
|
69387
|
1508
|
5807
|
1509 c.tag = Qnil;
|
|
1510 c.val = Qnil;
|
|
1511 c.backlist = backtrace_list;
|
|
1512 c.handlerlist = handlerlist;
|
|
1513 c.lisp_eval_depth = lisp_eval_depth;
|
46293
|
1514 c.pdlcount = SPECPDL_INDEX ();
|
5807
|
1515 c.poll_suppress_count = poll_suppress_count;
|
48909
|
1516 c.interrupt_input_blocked = interrupt_input_blocked;
|
5807
|
1517 c.gcpro = gcprolist;
|
26365
|
1518 c.byte_stack = byte_stack_list;
|
5807
|
1519 if (_setjmp (c.jmp))
|
|
1520 {
|
6132
|
1521 return (*hfun) (c.val);
|
5807
|
1522 }
|
|
1523 c.next = catchlist;
|
|
1524 catchlist = &c;
|
|
1525 h.handler = handlers;
|
|
1526 h.var = Qnil;
|
|
1527 h.next = handlerlist;
|
|
1528 h.tag = &c;
|
|
1529 handlerlist = &h;
|
|
1530
|
|
1531 val = (*bfun) (arg);
|
|
1532 catchlist = c.next;
|
|
1533 handlerlist = h.next;
|
|
1534 return val;
|
|
1535 }
|
30217
|
1536
|
|
1537
|
48909
|
1538 /* Like internal_condition_case but call BFUN with NARGS as first,
|
30217
|
1539 and ARGS as second argument. */
|
|
1540
|
|
1541 Lisp_Object
|
|
1542 internal_condition_case_2 (bfun, nargs, args, handlers, hfun)
|
|
1543 Lisp_Object (*bfun) ();
|
|
1544 int nargs;
|
|
1545 Lisp_Object *args;
|
|
1546 Lisp_Object handlers;
|
|
1547 Lisp_Object (*hfun) ();
|
|
1548 {
|
|
1549 Lisp_Object val;
|
|
1550 struct catchtag c;
|
|
1551 struct handler h;
|
|
1552
|
69387
|
1553 /* Since Fsignal will close off all calls to x_catch_errors,
|
|
1554 we will get the wrong results if some are not closed now. */
|
69399
947598ed954a
(unwind_to_catch): Call x_fully_uncatch_errors only if HAVE_X_WINDOWS.
Eli Zaretskii <eliz@gnu.org>
diff
changeset
|
1555 #if HAVE_X_WINDOWS
|
69387
|
1556 if (x_catching_errors ())
|
|
1557 abort ();
|
69399
947598ed954a
(unwind_to_catch): Call x_fully_uncatch_errors only if HAVE_X_WINDOWS.
Eli Zaretskii <eliz@gnu.org>
diff
changeset
|
1558 #endif
|
69387
|
1559
|
30217
|
1560 c.tag = Qnil;
|
|
1561 c.val = Qnil;
|
|
1562 c.backlist = backtrace_list;
|
|
1563 c.handlerlist = handlerlist;
|
|
1564 c.lisp_eval_depth = lisp_eval_depth;
|
46293
|
1565 c.pdlcount = SPECPDL_INDEX ();
|
30217
|
1566 c.poll_suppress_count = poll_suppress_count;
|
48909
|
1567 c.interrupt_input_blocked = interrupt_input_blocked;
|
30217
|
1568 c.gcpro = gcprolist;
|
|
1569 c.byte_stack = byte_stack_list;
|
|
1570 if (_setjmp (c.jmp))
|
|
1571 {
|
|
1572 return (*hfun) (c.val);
|
|
1573 }
|
|
1574 c.next = catchlist;
|
|
1575 catchlist = &c;
|
|
1576 h.handler = handlers;
|
|
1577 h.var = Qnil;
|
|
1578 h.next = handlerlist;
|
|
1579 h.tag = &c;
|
|
1580 handlerlist = &h;
|
|
1581
|
|
1582 val = (*bfun) (nargs, args);
|
|
1583 catchlist = c.next;
|
|
1584 handlerlist = h.next;
|
|
1585 return val;
|
|
1586 }
|
|
1587
|
5807
|
1588
|
41114
242c6928accc
(max_specpdl_size, max_lisp_eval_depth): Use EMACS_INT.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
1589 static Lisp_Object find_handler_clause P_ ((Lisp_Object, Lisp_Object,
|
242c6928accc
(max_specpdl_size, max_lisp_eval_depth): Use EMACS_INT.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
1590 Lisp_Object, Lisp_Object,
|
242c6928accc
(max_specpdl_size, max_lisp_eval_depth): Use EMACS_INT.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
1591 Lisp_Object *));
|
272
|
1592
|
|
1593 DEFUN ("signal", Fsignal, Ssignal, 2, 2, 0,
|
40570
|
1594 doc: /* Signal an error. Args are ERROR-SYMBOL and associated DATA.
|
|
1595 This function does not return.
|
|
1596
|
|
1597 An error symbol is a symbol with an `error-conditions' property
|
|
1598 that is a list of condition names.
|
|
1599 A handler for any of those names will get to handle this signal.
|
|
1600 The symbol `error' should normally be one of them.
|
|
1601
|
|
1602 DATA should be a list. Its elements are printed as part of the error message.
|
53461
abbbd322a247
(Fsignal): Add hyperlink to the definition of `signal' in the Elisp manual.
Luc Teirlinck <teirllm@auburn.edu>
diff
changeset
|
1603 See Info anchor `(elisp)Definition of signal' for some details on how this
|
abbbd322a247
(Fsignal): Add hyperlink to the definition of `signal' in the Elisp manual.
Luc Teirlinck <teirllm@auburn.edu>
diff
changeset
|
1604 error message is constructed.
|
40570
|
1605 If the signal is handled, DATA is made available to the handler.
|
|
1606 See also the function `condition-case'. */)
|
|
1607 (error_symbol, data)
|
5566
|
1608 Lisp_Object error_symbol, data;
|
272
|
1609 {
|
24171
|
1610 /* When memory is full, ERROR-SYMBOL is nil,
|
46315
|
1611 and DATA is (REAL-ERROR-SYMBOL . REAL-DATA).
|
|
1612 That is a special case--don't do this in other situations. */
|
272
|
1613 register struct handler *allhandlers = handlerlist;
|
|
1614 Lisp_Object conditions;
|
|
1615 extern int gc_in_progress;
|
|
1616 extern int waiting_for_input;
|
|
1617 Lisp_Object debugger_value;
|
16895
|
1618 Lisp_Object string;
|
18636
|
1619 Lisp_Object real_error_symbol;
|
30073
|
1620 struct backtrace *bp;
|
25008
|
1621
|
33988
|
1622 immediate_quit = handling_signal = 0;
|
50747
|
1623 abort_on_gc = 0;
|
272
|
1624 if (gc_in_progress || waiting_for_input)
|
|
1625 abort ();
|
|
1626
|
18636
|
1627 if (NILP (error_symbol))
|
|
1628 real_error_symbol = Fcar (data);
|
|
1629 else
|
|
1630 real_error_symbol = error_symbol;
|
|
1631
|
46315
|
1632 #if 0 /* rms: I don't know why this was here,
|
|
1633 but it is surely wrong for an error that is handled. */
|
25008
|
1634 #ifdef HAVE_X_WINDOWS
|
36256
e033d60bd048
Use display_hourglass_p, start_hourglass, cancel_hourglass instead of
Gerd Moellmann <gerd@gnu.org>
diff
changeset
|
1635 if (display_hourglass_p)
|
e033d60bd048
Use display_hourglass_p, start_hourglass, cancel_hourglass instead of
Gerd Moellmann <gerd@gnu.org>
diff
changeset
|
1636 cancel_hourglass ();
|
25008
|
1637 #endif
|
49600
|
1638 #endif
|
25008
|
1639
|
16355
|
1640 /* This hook is used by edebug. */
|
46315
|
1641 if (! NILP (Vsignal_hook_function)
|
|
1642 && ! NILP (error_symbol))
|
63767
|
1643 {
|
|
1644 /* Edebug takes care of restoring these variables when it exits. */
|
|
1645 if (lisp_eval_depth + 20 > max_lisp_eval_depth)
|
|
1646 max_lisp_eval_depth = lisp_eval_depth + 20;
|
|
1647
|
|
1648 if (SPECPDL_INDEX () + 40 > max_specpdl_size)
|
|
1649 max_specpdl_size = SPECPDL_INDEX () + 40;
|
|
1650
|
|
1651 call2 (Vsignal_hook_function, error_symbol, data);
|
|
1652 }
|
16355
|
1653
|
18636
|
1654 conditions = Fget (real_error_symbol, Qerror_conditions);
|
272
|
1655
|
30073
|
1656 /* Remember from where signal was called. Skip over the frame for
|
|
1657 `signal' itself. If a frame for `error' follows, skip that,
|
46315
|
1658 too. Don't do this when ERROR_SYMBOL is nil, because that
|
|
1659 is a memory-full error. */
|
30106
|
1660 Vsignaling_function = Qnil;
|
46315
|
1661 if (backtrace_list && !NILP (error_symbol))
|
30106
|
1662 {
|
|
1663 bp = backtrace_list->next;
|
|
1664 if (bp && bp->function && EQ (*bp->function, Qerror))
|
|
1665 bp = bp->next;
|
|
1666 if (bp && bp->function)
|
|
1667 Vsignaling_function = *bp->function;
|
|
1668 }
|
30073
|
1669
|
272
|
1670 for (; handlerlist; handlerlist = handlerlist->next)
|
|
1671 {
|
|
1672 register Lisp_Object clause;
|
49600
|
1673
|
272
|
1674 clause = find_handler_clause (handlerlist->handler, conditions,
|
5566
|
1675 error_symbol, data, &debugger_value);
|
272
|
1676
|
|
1677 if (EQ (clause, Qlambda))
|
1196
|
1678 {
|
13945
|
1679 /* We can't return values to code which signaled an error, but we
|
|
1680 can continue code which has signaled a quit. */
|
18636
|
1681 if (EQ (real_error_symbol, Qquit))
|
1196
|
1682 return Qnil;
|
|
1683 else
|
3973
|
1684 error ("Cannot return from the debugger in an error");
|
1196
|
1685 }
|
272
|
1686
|
485
|
1687 if (!NILP (clause))
|
272
|
1688 {
|
6132
|
1689 Lisp_Object unwind_data;
|
272
|
1690 struct handler *h = handlerlist;
|
6132
|
1691
|
272
|
1692 handlerlist = allhandlers;
|
18636
|
1693
|
|
1694 if (NILP (error_symbol))
|
|
1695 unwind_data = data;
|
6132
|
1696 else
|
|
1697 unwind_data = Fcons (error_symbol, data);
|
|
1698 h->chosen_clause = clause;
|
|
1699 unwind_to_catch (h->tag, unwind_data);
|
272
|
1700 }
|
|
1701 }
|
|
1702
|
|
1703 handlerlist = allhandlers;
|
|
1704 /* If no handler is present now, try to run the debugger,
|
|
1705 and if that fails, throw to top level. */
|
5566
|
1706 find_handler_clause (Qerror, conditions, error_symbol, data, &debugger_value);
|
16895
|
1707 if (catchlist != 0)
|
|
1708 Fthrow (Qtop_level, Qt);
|
|
1709
|
18636
|
1710 if (! NILP (error_symbol))
|
16895
|
1711 data = Fcons (error_symbol, data);
|
|
1712
|
|
1713 string = Ferror_message_string (data);
|
46370
40db0673e6f0
Most uses of XSTRING combined with STRING_BYTES or indirection changed to
Ken Raeburn <raeburn@raeburn.org>
diff
changeset
|
1714 fatal ("%s", SDATA (string), 0);
|
272
|
1715 }
|
|
1716
|
71976
|
1717 /* Internal version of Fsignal that never returns.
|
|
1718 Used for anything but Qquit (which can return from Fsignal). */
|
|
1719
|
|
1720 void
|
|
1721 xsignal (error_symbol, data)
|
|
1722 Lisp_Object error_symbol, data;
|
|
1723 {
|
|
1724 Fsignal (error_symbol, data);
|
|
1725 abort ();
|
|
1726 }
|
|
1727
|
|
1728 /* Like xsignal, but takes 0, 1, 2, or 3 args instead of a list. */
|
|
1729
|
|
1730 void
|
|
1731 xsignal0 (error_symbol)
|
|
1732 Lisp_Object error_symbol;
|
|
1733 {
|
|
1734 xsignal (error_symbol, Qnil);
|
|
1735 }
|
|
1736
|
|
1737 void
|
|
1738 xsignal1 (error_symbol, arg)
|
|
1739 Lisp_Object error_symbol, arg;
|
|
1740 {
|
|
1741 xsignal (error_symbol, list1 (arg));
|
|
1742 }
|
|
1743
|
|
1744 void
|
|
1745 xsignal2 (error_symbol, arg1, arg2)
|
|
1746 Lisp_Object error_symbol, arg1, arg2;
|
|
1747 {
|
|
1748 xsignal (error_symbol, list2 (arg1, arg2));
|
|
1749 }
|
|
1750
|
|
1751 void
|
|
1752 xsignal3 (error_symbol, arg1, arg2, arg3)
|
|
1753 Lisp_Object error_symbol, arg1, arg2, arg3;
|
|
1754 {
|
|
1755 xsignal (error_symbol, list3 (arg1, arg2, arg3));
|
|
1756 }
|
|
1757
|
|
1758 /* Signal `error' with message S, and additional arg ARG.
|
|
1759 If ARG is not a genuine list, make it a one-element list. */
|
|
1760
|
|
1761 void
|
|
1762 signal_error (s, arg)
|
|
1763 char *s;
|
|
1764 Lisp_Object arg;
|
|
1765 {
|
|
1766 Lisp_Object tortoise, hare;
|
|
1767
|
|
1768 hare = tortoise = arg;
|
|
1769 while (CONSP (hare))
|
|
1770 {
|
|
1771 hare = XCDR (hare);
|
|
1772 if (!CONSP (hare))
|
|
1773 break;
|
|
1774
|
|
1775 hare = XCDR (hare);
|
|
1776 tortoise = XCDR (tortoise);
|
|
1777
|
|
1778 if (EQ (hare, tortoise))
|
|
1779 break;
|
|
1780 }
|
|
1781
|
|
1782 if (!NILP (hare))
|
|
1783 arg = Fcons (arg, Qnil); /* Make it a list. */
|
|
1784
|
|
1785 xsignal (Qerror, Fcons (build_string (s), arg));
|
|
1786 }
|
|
1787
|
|
1788
|
78501
|
1789 /* Return nonzero if LIST is a non-nil atom or
|
684
|
1790 a list containing one of CONDITIONS. */
|
|
1791
|
|
1792 static int
|
|
1793 wants_debugger (list, conditions)
|
|
1794 Lisp_Object list, conditions;
|
|
1795 {
|
706
|
1796 if (NILP (list))
|
684
|
1797 return 0;
|
|
1798 if (! CONSP (list))
|
|
1799 return 1;
|
|
1800
|
878
|
1801 while (CONSP (conditions))
|
684
|
1802 {
|
878
|
1803 Lisp_Object this, tail;
|
25662
0a7261c1d487
Use XCAR, XCDR, and XFLOAT_DATA instead of explicit member access.
Ken Raeburn <raeburn@raeburn.org>
diff
changeset
|
1804 this = XCAR (conditions);
|
0a7261c1d487
Use XCAR, XCDR, and XFLOAT_DATA instead of explicit member access.
Ken Raeburn <raeburn@raeburn.org>
diff
changeset
|
1805 for (tail = list; CONSP (tail); tail = XCDR (tail))
|
0a7261c1d487
Use XCAR, XCDR, and XFLOAT_DATA instead of explicit member access.
Ken Raeburn <raeburn@raeburn.org>
diff
changeset
|
1806 if (EQ (XCAR (tail), this))
|
684
|
1807 return 1;
|
25662
0a7261c1d487
Use XCAR, XCDR, and XFLOAT_DATA instead of explicit member access.
Ken Raeburn <raeburn@raeburn.org>
diff
changeset
|
1808 conditions = XCDR (conditions);
|
684
|
1809 }
|
878
|
1810 return 0;
|
684
|
1811 }
|
|
1812
|
13768
|
1813 /* Return 1 if an error with condition-symbols CONDITIONS,
|
|
1814 and described by SIGNAL-DATA, should skip the debugger
|
40661
|
1815 according to debugger-ignored-errors. */
|
13768
|
1816
|
|
1817 static int
|
|
1818 skip_debugger (conditions, data)
|
|
1819 Lisp_Object conditions, data;
|
|
1820 {
|
|
1821 Lisp_Object tail;
|
|
1822 int first_string = 1;
|
|
1823 Lisp_Object error_message;
|
|
1824
|
32657
|
1825 error_message = Qnil;
|
|
1826 for (tail = Vdebug_ignored_errors; CONSP (tail); tail = XCDR (tail))
|
13768
|
1827 {
|
25662
0a7261c1d487
Use XCAR, XCDR, and XFLOAT_DATA instead of explicit member access.
Ken Raeburn <raeburn@raeburn.org>
diff
changeset
|
1828 if (STRINGP (XCAR (tail)))
|
13768
|
1829 {
|
|
1830 if (first_string)
|
|
1831 {
|
|
1832 error_message = Ferror_message_string (data);
|
|
1833 first_string = 0;
|
|
1834 }
|
49600
|
1835
|
25662
0a7261c1d487
Use XCAR, XCDR, and XFLOAT_DATA instead of explicit member access.
Ken Raeburn <raeburn@raeburn.org>
diff
changeset
|
1836 if (fast_string_match (XCAR (tail), error_message) >= 0)
|
13768
|
1837 return 1;
|
|
1838 }
|
|
1839 else
|
|
1840 {
|
|
1841 Lisp_Object contail;
|
|
1842
|
32657
|
1843 for (contail = conditions; CONSP (contail); contail = XCDR (contail))
|
25662
0a7261c1d487
Use XCAR, XCDR, and XFLOAT_DATA instead of explicit member access.
Ken Raeburn <raeburn@raeburn.org>
diff
changeset
|
1844 if (EQ (XCAR (tail), XCAR (contail)))
|
13768
|
1845 return 1;
|
|
1846 }
|
|
1847 }
|
|
1848
|
|
1849 return 0;
|
|
1850 }
|
|
1851
|
684
|
1852 /* Value of Qlambda means we have called debugger and user has continued.
|
18636
|
1853 There are two ways to pass SIG and DATA:
|
24054
|
1854 = SIG is the error symbol, and DATA is the rest of the data.
|
18636
|
1855 = SIG is nil, and DATA is (SYMBOL . REST-OF-DATA).
|
24054
|
1856 This is for memory-full errors only.
|
18636
|
1857
|
63767
|
1858 Store value returned from debugger into *DEBUGGER_VALUE_PTR.
|
|
1859
|
|
1860 We need to increase max_specpdl_size temporarily around
|
|
1861 anything we do that can push on the specpdl, so as not to get
|
|
1862 a second error here in case we're handling specpdl overflow. */
|
272
|
1863
|
|
1864 static Lisp_Object
|
|
1865 find_handler_clause (handlers, conditions, sig, data, debugger_value_ptr)
|
|
1866 Lisp_Object handlers, conditions, sig, data;
|
|
1867 Lisp_Object *debugger_value_ptr;
|
|
1868 {
|
|
1869 register Lisp_Object h;
|
|
1870 register Lisp_Object tem;
|
|
1871
|
|
1872 if (EQ (handlers, Qt)) /* t is used by handlers for all conditions, set up by C code. */
|
|
1873 return Qt;
|
16355
|
1874 /* error is used similarly, but means print an error message
|
|
1875 and run the debugger if that is enabled. */
|
|
1876 if (EQ (handlers, Qerror)
|
16443
|
1877 || !NILP (Vdebug_on_signal)) /* This says call debugger even if
|
|
1878 there is a handler. */
|
272
|
1879 {
|
16355
|
1880 int debugger_called = 0;
|
18636
|
1881 Lisp_Object sig_symbol, combined_data;
|
24054
|
1882 /* This is set to 1 if we are handling a memory-full error,
|
|
1883 because these must not run the debugger.
|
|
1884 (There is no room in memory to do that!) */
|
|
1885 int no_debugger = 0;
|
18636
|
1886
|
|
1887 if (NILP (sig))
|
|
1888 {
|
|
1889 combined_data = data;
|
|
1890 sig_symbol = Fcar (data);
|
24054
|
1891 no_debugger = 1;
|
18636
|
1892 }
|
|
1893 else
|
|
1894 {
|
|
1895 combined_data = Fcons (sig, data);
|
|
1896 sig_symbol = sig;
|
|
1897 }
|
16355
|
1898
|
684
|
1899 if (wants_debugger (Vstack_trace_on_error, conditions))
|
21853
|
1900 {
|
63767
|
1901 max_specpdl_size++;
|
28056
|
1902 #ifdef PROTOTYPES
|
21853
|
1903 internal_with_output_to_temp_buffer ("*Backtrace*",
|
|
1904 (Lisp_Object (*) (Lisp_Object)) Fbacktrace,
|
|
1905 Qnil);
|
|
1906 #else
|
|
1907 internal_with_output_to_temp_buffer ("*Backtrace*",
|
|
1908 Fbacktrace, Qnil);
|
|
1909 #endif
|
63767
|
1910 max_specpdl_size--;
|
21853
|
1911 }
|
24054
|
1912 if (! no_debugger
|
72730
|
1913 /* Don't try to run the debugger with interrupts blocked.
|
|
1914 The editing loop would return anyway. */
|
|
1915 && ! INPUT_BLOCKED_P
|
24054
|
1916 && (EQ (sig_symbol, Qquit)
|
|
1917 ? debug_on_quit
|
|
1918 : wants_debugger (Vdebug_on_error, conditions))
|
18636
|
1919 && ! skip_debugger (conditions, combined_data)
|
17872
|
1920 && when_entered_debugger < num_nonmacro_input_events)
|
272
|
1921 {
|
13768
|
1922 *debugger_value_ptr
|
|
1923 = call_debugger (Fcons (Qerror,
|
18636
|
1924 Fcons (combined_data, Qnil)));
|
16355
|
1925 debugger_called = 1;
|
272
|
1926 }
|
16355
|
1927 /* If there is no handler, return saying whether we ran the debugger. */
|
|
1928 if (EQ (handlers, Qerror))
|
|
1929 {
|
|
1930 if (debugger_called)
|
63767
|
1931 return Qlambda;
|
16355
|
1932 return Qt;
|
|
1933 }
|
272
|
1934 }
|
|
1935 for (h = handlers; CONSP (h); h = Fcdr (h))
|
|
1936 {
|
5563
50ada322de3e
(Fcondition_case): Allow a list of condition names in a handler.
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
1937 Lisp_Object handler, condit;
|
50ada322de3e
(Fcondition_case): Allow a list of condition names in a handler.
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
1938
|
50ada322de3e
(Fcondition_case): Allow a list of condition names in a handler.
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
1939 handler = Fcar (h);
|
50ada322de3e
(Fcondition_case): Allow a list of condition names in a handler.
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
1940 if (!CONSP (handler))
|
272
|
1941 continue;
|
5563
50ada322de3e
(Fcondition_case): Allow a list of condition names in a handler.
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
1942 condit = Fcar (handler);
|
50ada322de3e
(Fcondition_case): Allow a list of condition names in a handler.
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
1943 /* Handle a single condition name in handler HANDLER. */
|
50ada322de3e
(Fcondition_case): Allow a list of condition names in a handler.
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
1944 if (SYMBOLP (condit))
|
50ada322de3e
(Fcondition_case): Allow a list of condition names in a handler.
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
1945 {
|
50ada322de3e
(Fcondition_case): Allow a list of condition names in a handler.
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
1946 tem = Fmemq (Fcar (handler), conditions);
|
50ada322de3e
(Fcondition_case): Allow a list of condition names in a handler.
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
1947 if (!NILP (tem))
|
50ada322de3e
(Fcondition_case): Allow a list of condition names in a handler.
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
1948 return handler;
|
50ada322de3e
(Fcondition_case): Allow a list of condition names in a handler.
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
1949 }
|
50ada322de3e
(Fcondition_case): Allow a list of condition names in a handler.
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
1950 /* Handle a list of condition names in handler HANDLER. */
|
50ada322de3e
(Fcondition_case): Allow a list of condition names in a handler.
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
1951 else if (CONSP (condit))
|
50ada322de3e
(Fcondition_case): Allow a list of condition names in a handler.
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
1952 {
|
50ada322de3e
(Fcondition_case): Allow a list of condition names in a handler.
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
1953 while (CONSP (condit))
|
50ada322de3e
(Fcondition_case): Allow a list of condition names in a handler.
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
1954 {
|
50ada322de3e
(Fcondition_case): Allow a list of condition names in a handler.
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
1955 tem = Fmemq (Fcar (condit), conditions);
|
50ada322de3e
(Fcondition_case): Allow a list of condition names in a handler.
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
1956 if (!NILP (tem))
|
50ada322de3e
(Fcondition_case): Allow a list of condition names in a handler.
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
1957 return handler;
|
25662
0a7261c1d487
Use XCAR, XCDR, and XFLOAT_DATA instead of explicit member access.
Ken Raeburn <raeburn@raeburn.org>
diff
changeset
|
1958 condit = XCDR (condit);
|
5563
50ada322de3e
(Fcondition_case): Allow a list of condition names in a handler.
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
1959 }
|
50ada322de3e
(Fcondition_case): Allow a list of condition names in a handler.
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
1960 }
|
272
|
1961 }
|
|
1962 return Qnil;
|
|
1963 }
|
|
1964
|
|
1965 /* dump an error message; called like printf */
|
|
1966
|
|
1967 /* VARARGS 1 */
|
|
1968 void
|
|
1969 error (m, a1, a2, a3)
|
|
1970 char *m;
|
6225
|
1971 char *a1, *a2, *a3;
|
272
|
1972 {
|
|
1973 char buf[200];
|
6225
|
1974 int size = 200;
|
|
1975 int mlen;
|
|
1976 char *buffer = buf;
|
|
1977 char *args[3];
|
|
1978 int allocated = 0;
|
|
1979 Lisp_Object string;
|
|
1980
|
|
1981 args[0] = a1;
|
|
1982 args[1] = a2;
|
|
1983 args[2] = a3;
|
|
1984
|
|
1985 mlen = strlen (m);
|
272
|
1986
|
|
1987 while (1)
|
6225
|
1988 {
|
23206
|
1989 int used = doprnt (buffer, size, m, m + mlen, 3, args);
|
6225
|
1990 if (used < size)
|
|
1991 break;
|
|
1992 size *= 2;
|
|
1993 if (allocated)
|
|
1994 buffer = (char *) xrealloc (buffer, size);
|
7353
|
1995 else
|
|
1996 {
|
|
1997 buffer = (char *) xmalloc (size);
|
|
1998 allocated = 1;
|
|
1999 }
|
6225
|
2000 }
|
|
2001
|
23206
|
2002 string = build_string (buffer);
|
6225
|
2003 if (allocated)
|
30610
|
2004 xfree (buffer);
|
6225
|
2005
|
71976
|
2006 xsignal1 (Qerror, string);
|
272
|
2007 }
|
|
2008
|
44941
|
2009 DEFUN ("commandp", Fcommandp, Scommandp, 1, 2, 0,
|
40570
|
2010 doc: /* Non-nil if FUNCTION makes provisions for interactive calling.
|
|
2011 This means it contains a description for how to read arguments to give it.
|
|
2012 The value is nil for an invalid function or a symbol with no function
|
|
2013 definition.
|
|
2014
|
|
2015 Interactively callable functions include strings and vectors (treated
|
|
2016 as keyboard macros), lambda-expressions that contain a top-level call
|
|
2017 to `interactive', autoload definitions made by `autoload' with non-nil
|
|
2018 fourth argument, and some of the built-in functions of Lisp.
|
|
2019
|
44941
|
2020 Also, a symbol satisfies `commandp' if its function definition does so.
|
|
2021
|
|
2022 If the optional argument FOR-CALL-INTERACTIVELY is non-nil,
|
45303
|
2023 then strings and vectors are not accepted. */)
|
44941
|
2024 (function, for_call_interactively)
|
|
2025 Lisp_Object function, for_call_interactively;
|
272
|
2026 {
|
|
2027 register Lisp_Object fun;
|
|
2028 register Lisp_Object funcar;
|
|
2029
|
|
2030 fun = function;
|
|
2031
|
648
|
2032 fun = indirect_function (fun);
|
|
2033 if (EQ (fun, Qunbound))
|
|
2034 return Qnil;
|
272
|
2035
|
|
2036 /* Emacs primitives are interactive if their DEFUN specifies an
|
|
2037 interactive spec. */
|
9148
|
2038 if (SUBRP (fun))
|
272
|
2039 {
|
|
2040 if (XSUBR (fun)->prompt)
|
|
2041 return Qt;
|
|
2042 else
|
|
2043 return Qnil;
|
|
2044 }
|
|
2045
|
|
2046 /* Bytecode objects are interactive if they are long enough to
|
|
2047 have an element whose index is COMPILED_INTERACTIVE, which is
|
|
2048 where the interactive spec is stored. */
|
9148
|
2049 else if (COMPILEDP (fun))
|
41597
|
2050 return ((ASIZE (fun) & PSEUDOVECTOR_SIZE_MASK) > COMPILED_INTERACTIVE
|
272
|
2051 ? Qt : Qnil);
|
|
2052
|
|
2053 /* Strings and vectors are keyboard macros. */
|
44941
|
2054 if (NILP (for_call_interactively) && (STRINGP (fun) || VECTORP (fun)))
|
272
|
2055 return Qt;
|
|
2056
|
|
2057 /* Lists may represent commands. */
|
|
2058 if (!CONSP (fun))
|
|
2059 return Qnil;
|
54630
|
2060 funcar = XCAR (fun);
|
272
|
2061 if (EQ (funcar, Qlambda))
|
54630
|
2062 return Fassq (Qinteractive, Fcdr (XCDR (fun)));
|
272
|
2063 if (EQ (funcar, Qautoload))
|
54630
|
2064 return Fcar (Fcdr (Fcdr (XCDR (fun))));
|
272
|
2065 else
|
|
2066 return Qnil;
|
|
2067 }
|
|
2068
|
|
2069 /* ARGSUSED */
|
|
2070 DEFUN ("autoload", Fautoload, Sautoload, 2, 5, 0,
|
40570
|
2071 doc: /* Define FUNCTION to autoload from FILE.
|
|
2072 FUNCTION is a symbol; FILE is a file name string to pass to `load'.
|
|
2073 Third arg DOCSTRING is documentation for the function.
|
|
2074 Fourth arg INTERACTIVE if non-nil says function can be called interactively.
|
|
2075 Fifth arg TYPE indicates the type of the object:
|
|
2076 nil or omitted says FUNCTION is a function,
|
|
2077 `keymap' says FUNCTION is really a keymap, and
|
|
2078 `macro' or t says FUNCTION is really a macro.
|
|
2079 Third through fifth args give info about the real definition.
|
|
2080 They default to nil.
|
|
2081 If FUNCTION is already defined other than as an autoload,
|
|
2082 this does nothing and returns nil. */)
|
|
2083 (function, file, docstring, interactive, type)
|
1564
|
2084 Lisp_Object function, file, docstring, interactive, type;
|
272
|
2085 {
|
|
2086 #ifdef NO_ARG_ARRAY
|
|
2087 Lisp_Object args[4];
|
|
2088 #endif
|
|
2089
|
40656
|
2090 CHECK_SYMBOL (function);
|
|
2091 CHECK_STRING (file);
|
272
|
2092
|
|
2093 /* If function is defined and not as an autoload, don't override */
|
|
2094 if (!EQ (XSYMBOL (function)->function, Qunbound)
|
9148
|
2095 && !(CONSP (XSYMBOL (function)->function)
|
25662
0a7261c1d487
Use XCAR, XCDR, and XFLOAT_DATA instead of explicit member access.
Ken Raeburn <raeburn@raeburn.org>
diff
changeset
|
2096 && EQ (XCAR (XSYMBOL (function)->function), Qautoload)))
|
272
|
2097 return Qnil;
|
|
2098
|
28297
f37b25e59751
* eval.c (Fautoload): Add entry in load-history (if after dump).
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
2099 if (NILP (Vpurify_flag))
|
f37b25e59751
* eval.c (Fautoload): Add entry in load-history (if after dump).
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
2100 /* Only add entries after dumping, because the ones before are
|
f37b25e59751
* eval.c (Fautoload): Add entry in load-history (if after dump).
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
2101 not useful and else we get loads of them from the loaddefs.el. */
|
f37b25e59751
* eval.c (Fautoload): Add entry in load-history (if after dump).
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
2102 LOADHIST_ATTACH (Fcons (Qautoload, function));
|
f37b25e59751
* eval.c (Fautoload): Add entry in load-history (if after dump).
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
2103
|
272
|
2104 #ifdef NO_ARG_ARRAY
|
|
2105 args[0] = file;
|
|
2106 args[1] = docstring;
|
|
2107 args[2] = interactive;
|
1564
|
2108 args[3] = type;
|
272
|
2109
|
|
2110 return Ffset (function, Fcons (Qautoload, Flist (4, &args[0])));
|
|
2111 #else /* NO_ARG_ARRAY */
|
|
2112 return Ffset (function, Fcons (Qautoload, Flist (4, &file)));
|
|
2113 #endif /* not NO_ARG_ARRAY */
|
|
2114 }
|
|
2115
|
|
2116 Lisp_Object
|
|
2117 un_autoload (oldqueue)
|
|
2118 Lisp_Object oldqueue;
|
|
2119 {
|
|
2120 register Lisp_Object queue, first, second;
|
|
2121
|
|
2122 /* Queue to unwind is current value of Vautoload_queue.
|
|
2123 oldqueue is the shadowed value to leave in Vautoload_queue. */
|
|
2124 queue = Vautoload_queue;
|
|
2125 Vautoload_queue = oldqueue;
|
|
2126 while (CONSP (queue))
|
|
2127 {
|
50630
dfbdcffdcfc9
(For, Fand, Fprogn, un_autoload, do_autoload): Use XCDR, XCAR, CONSP.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
2128 first = XCAR (queue);
|
272
|
2129 second = Fcdr (first);
|
|
2130 first = Fcar (first);
|
67810
65be704fdaf2
(un_autoload): Expect (0 . OFEATURES) in Vautoload_queue to undo a `provide'.
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
2131 if (EQ (first, make_number (0)))
|
65be704fdaf2
(un_autoload): Expect (0 . OFEATURES) in Vautoload_queue to undo a `provide'.
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
2132 Vfeatures = second;
|
272
|
2133 else
|
|
2134 Ffset (first, second);
|
50630
dfbdcffdcfc9
(For, Fand, Fprogn, un_autoload, do_autoload): Use XCDR, XCAR, CONSP.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
2135 queue = XCDR (queue);
|
272
|
2136 }
|
|
2137 return Qnil;
|
|
2138 }
|
|
2139
|
16108
|
2140 /* Load an autoloaded function.
|
|
2141 FUNNAME is the symbol which is the function's name.
|
|
2142 FUNDEF is the autoload definition (a list). */
|
|
2143
|
20378
|
2144 void
|
272
|
2145 do_autoload (fundef, funname)
|
|
2146 Lisp_Object fundef, funname;
|
|
2147 {
|
46293
|
2148 int count = SPECPDL_INDEX ();
|
79082
|
2149 Lisp_Object fun;
|
16108
|
2150 struct gcpro gcpro1, gcpro2, gcpro3;
|
272
|
2151
|
45039
|
2152 /* This is to make sure that loadup.el gives a clear picture
|
|
2153 of what files are preloaded and when. */
|
45036
|
2154 if (! NILP (Vpurify_flag))
|
|
2155 error ("Attempt to autoload %s while preparing to dump",
|
46370
40db0673e6f0
Most uses of XSTRING combined with STRING_BYTES or indirection changed to
Ken Raeburn <raeburn@raeburn.org>
diff
changeset
|
2156 SDATA (SYMBOL_NAME (funname)));
|
45036
|
2157
|
272
|
2158 fun = funname;
|
40656
|
2159 CHECK_SYMBOL (funname);
|
16108
|
2160 GCPRO3 (fun, funname, fundef);
|
272
|
2161
|
24605
|
2162 /* Preserve the match data. */
|
63147
|
2163 record_unwind_save_match_data ();
|
49600
|
2164
|
79207
|
2165 /* If autoloading gets an error (which includes the error of failing
|
|
2166 to define the function being called), we use Vautoload_queue
|
|
2167 to undo function definitions and `provide' calls made by
|
|
2168 the function. We do this in the specific case of autoloading
|
|
2169 because autoloading is not an explicit request "load this file",
|
|
2170 but rather a request to "call this function".
|
|
2171
|
|
2172 The value saved here is to be restored into Vautoload_queue. */
|
272
|
2173 record_unwind_protect (un_autoload, Vautoload_queue);
|
|
2174 Vautoload_queue = Qt;
|
19237
|
2175 Fload (Fcar (Fcdr (fundef)), Qnil, noninteractive ? Qt : Qnil, Qnil, Qt);
|
2547
|
2176
|
272
|
2177 /* Once loading finishes, don't undo it. */
|
|
2178 Vautoload_queue = Qt;
|
|
2179 unbind_to (count, Qnil);
|
|
2180
|
68758
|
2181 fun = Findirect_function (fun, Qnil);
|
648
|
2182
|
4462
|
2183 if (!NILP (Fequal (fun, fundef)))
|
272
|
2184 error ("Autoloading failed to define function %s",
|
46370
40db0673e6f0
Most uses of XSTRING combined with STRING_BYTES or indirection changed to
Ken Raeburn <raeburn@raeburn.org>
diff
changeset
|
2185 SDATA (SYMBOL_NAME (funname)));
|
16108
|
2186 UNGCPRO;
|
272
|
2187 }
|
30080
|
2188
|
272
|
2189
|
|
2190 DEFUN ("eval", Feval, Seval, 1, 1, 0,
|
40570
|
2191 doc: /* Evaluate FORM and return its value. */)
|
|
2192 (form)
|
272
|
2193 Lisp_Object form;
|
|
2194 {
|
|
2195 Lisp_Object fun, val, original_fun, original_args;
|
|
2196 Lisp_Object funcar;
|
|
2197 struct backtrace backtrace;
|
|
2198 struct gcpro gcpro1, gcpro2, gcpro3;
|
|
2199
|
57965
|
2200 if (handling_signal)
|
25008
|
2201 abort ();
|
49600
|
2202
|
9148
|
2203 if (SYMBOLP (form))
|
42277
|
2204 return Fsymbol_value (form);
|
272
|
2205 if (!CONSP (form))
|
|
2206 return form;
|
|
2207
|
|
2208 QUIT;
|
66528
|
2209 if ((consing_since_gc > gc_cons_threshold
|
|
2210 && consing_since_gc > gc_relative_threshold)
|
|
2211 ||
|
|
2212 (!NILP (Vmemory_full) && consing_since_gc > memory_full_cons_threshold))
|
272
|
2213 {
|
|
2214 GCPRO1 (form);
|
|
2215 Fgarbage_collect ();
|
|
2216 UNGCPRO;
|
|
2217 }
|
|
2218
|
|
2219 if (++lisp_eval_depth > max_lisp_eval_depth)
|
|
2220 {
|
|
2221 if (max_lisp_eval_depth < 100)
|
|
2222 max_lisp_eval_depth = 100;
|
|
2223 if (lisp_eval_depth > max_lisp_eval_depth)
|
63697
9f617bb41e22
(Fdefvar, Fdefconst, Feval, Ffuncall): Follow error conventions.
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
2224 error ("Lisp nesting exceeds `max-lisp-eval-depth'");
|
272
|
2225 }
|
|
2226
|
|
2227 original_fun = Fcar (form);
|
|
2228 original_args = Fcdr (form);
|
|
2229
|
|
2230 backtrace.next = backtrace_list;
|
|
2231 backtrace_list = &backtrace;
|
|
2232 backtrace.function = &original_fun; /* This also protects them from gc */
|
|
2233 backtrace.args = &original_args;
|
|
2234 backtrace.nargs = UNEVALLED;
|
|
2235 backtrace.evalargs = 1;
|
|
2236 backtrace.debug_on_exit = 0;
|
|
2237
|
|
2238 if (debug_on_next_call)
|
|
2239 do_debug_on_call (Qt);
|
|
2240
|
|
2241 /* At this point, only original_fun and original_args
|
|
2242 have values that will be used below */
|
|
2243 retry:
|
71872
|
2244
|
|
2245 /* Optimize for no indirection. */
|
|
2246 fun = original_fun;
|
|
2247 if (SYMBOLP (fun) && !EQ (fun, Qunbound)
|
|
2248 && (fun = XSYMBOL (fun)->function, SYMBOLP (fun)))
|
|
2249 fun = indirect_function (fun);
|
272
|
2250
|
9148
|
2251 if (SUBRP (fun))
|
272
|
2252 {
|
|
2253 Lisp_Object numargs;
|
19544
|
2254 Lisp_Object argvals[8];
|
272
|
2255 Lisp_Object args_left;
|
|
2256 register int i, maxargs;
|
|
2257
|
|
2258 args_left = original_args;
|
|
2259 numargs = Flength (args_left);
|
|
2260
|
60418
|
2261 CHECK_CONS_LIST ();
|
|
2262
|
272
|
2263 if (XINT (numargs) < XSUBR (fun)->min_args ||
|
|
2264 (XSUBR (fun)->max_args >= 0 && XSUBR (fun)->max_args < XINT (numargs)))
|
71976
|
2265 xsignal2 (Qwrong_number_of_arguments, original_fun, numargs);
|
272
|
2266
|
|
2267 if (XSUBR (fun)->max_args == UNEVALLED)
|
|
2268 {
|
|
2269 backtrace.evalargs = 0;
|
|
2270 val = (*XSUBR (fun)->function) (args_left);
|
|
2271 goto done;
|
|
2272 }
|
|
2273
|
|
2274 if (XSUBR (fun)->max_args == MANY)
|
|
2275 {
|
|
2276 /* Pass a vector of evaluated arguments */
|
|
2277 Lisp_Object *vals;
|
|
2278 register int argnum = 0;
|
|
2279
|
|
2280 vals = (Lisp_Object *) alloca (XINT (numargs) * sizeof (Lisp_Object));
|
|
2281
|
|
2282 GCPRO3 (args_left, fun, fun);
|
|
2283 gcpro3.var = vals;
|
|
2284 gcpro3.nvars = 0;
|
|
2285
|
485
|
2286 while (!NILP (args_left))
|
272
|
2287 {
|
|
2288 vals[argnum++] = Feval (Fcar (args_left));
|
|
2289 args_left = Fcdr (args_left);
|
|
2290 gcpro3.nvars = argnum;
|
|
2291 }
|
|
2292
|
|
2293 backtrace.args = vals;
|
|
2294 backtrace.nargs = XINT (numargs);
|
|
2295
|
|
2296 val = (*XSUBR (fun)->function) (XINT (numargs), vals);
|
323
|
2297 UNGCPRO;
|
272
|
2298 goto done;
|
|
2299 }
|
|
2300
|
|
2301 GCPRO3 (args_left, fun, fun);
|
|
2302 gcpro3.var = argvals;
|
|
2303 gcpro3.nvars = 0;
|
|
2304
|
|
2305 maxargs = XSUBR (fun)->max_args;
|
|
2306 for (i = 0; i < maxargs; args_left = Fcdr (args_left))
|
|
2307 {
|
|
2308 argvals[i] = Feval (Fcar (args_left));
|
|
2309 gcpro3.nvars = ++i;
|
|
2310 }
|
|
2311
|
|
2312 UNGCPRO;
|
|
2313
|
|
2314 backtrace.args = argvals;
|
|
2315 backtrace.nargs = XINT (numargs);
|
|
2316
|
|
2317 switch (i)
|
|
2318 {
|
|
2319 case 0:
|
|
2320 val = (*XSUBR (fun)->function) ();
|
|
2321 goto done;
|
|
2322 case 1:
|
|
2323 val = (*XSUBR (fun)->function) (argvals[0]);
|
|
2324 goto done;
|
|
2325 case 2:
|
|
2326 val = (*XSUBR (fun)->function) (argvals[0], argvals[1]);
|
|
2327 goto done;
|
|
2328 case 3:
|
|
2329 val = (*XSUBR (fun)->function) (argvals[0], argvals[1],
|
|
2330 argvals[2]);
|
|
2331 goto done;
|
|
2332 case 4:
|
|
2333 val = (*XSUBR (fun)->function) (argvals[0], argvals[1],
|
|
2334 argvals[2], argvals[3]);
|
|
2335 goto done;
|
|
2336 case 5:
|
|
2337 val = (*XSUBR (fun)->function) (argvals[0], argvals[1], argvals[2],
|
|
2338 argvals[3], argvals[4]);
|
|
2339 goto done;
|
|
2340 case 6:
|
|
2341 val = (*XSUBR (fun)->function) (argvals[0], argvals[1], argvals[2],
|
|
2342 argvals[3], argvals[4], argvals[5]);
|
|
2343 goto done;
|
863
|
2344 case 7:
|
|
2345 val = (*XSUBR (fun)->function) (argvals[0], argvals[1], argvals[2],
|
|
2346 argvals[3], argvals[4], argvals[5],
|
|
2347 argvals[6]);
|
|
2348 goto done;
|
272
|
2349
|
19544
|
2350 case 8:
|
|
2351 val = (*XSUBR (fun)->function) (argvals[0], argvals[1], argvals[2],
|
|
2352 argvals[3], argvals[4], argvals[5],
|
|
2353 argvals[6], argvals[7]);
|
|
2354 goto done;
|
|
2355
|
272
|
2356 default:
|
604
|
2357 /* Someone has created a subr that takes more arguments than
|
|
2358 is supported by this code. We need to either rewrite the
|
|
2359 subr to use a different argument protocol, or add more
|
|
2360 cases to this switch. */
|
|
2361 abort ();
|
272
|
2362 }
|
|
2363 }
|
9148
|
2364 if (COMPILEDP (fun))
|
272
|
2365 val = apply_lambda (fun, original_args, 1);
|
|
2366 else
|
|
2367 {
|
71872
|
2368 if (EQ (fun, Qunbound))
|
71976
|
2369 xsignal1 (Qvoid_function, original_fun);
|
272
|
2370 if (!CONSP (fun))
|
71976
|
2371 xsignal1 (Qinvalid_function, original_fun);
|
|
2372 funcar = XCAR (fun);
|
9148
|
2373 if (!SYMBOLP (funcar))
|
71976
|
2374 xsignal1 (Qinvalid_function, original_fun);
|
272
|
2375 if (EQ (funcar, Qautoload))
|
|
2376 {
|
|
2377 do_autoload (fun, original_fun);
|
|
2378 goto retry;
|
|
2379 }
|
|
2380 if (EQ (funcar, Qmacro))
|
|
2381 val = Feval (apply1 (Fcdr (fun), original_args));
|
|
2382 else if (EQ (funcar, Qlambda))
|
|
2383 val = apply_lambda (fun, original_args, 1);
|
|
2384 else
|
71976
|
2385 xsignal1 (Qinvalid_function, original_fun);
|
272
|
2386 }
|
|
2387 done:
|
60418
|
2388 CHECK_CONS_LIST ();
|
|
2389
|
272
|
2390 lisp_eval_depth--;
|
|
2391 if (backtrace.debug_on_exit)
|
|
2392 val = call_debugger (Fcons (Qexit, Fcons (val, Qnil)));
|
|
2393 backtrace_list = backtrace.next;
|
48742
7b5cd8383f0b
Feval: On Carbon/MacOSX call mac_check_for_quit_char at each stack frame.
Steven Tamm <steventamm@mac.com>
diff
changeset
|
2394
|
272
|
2395 return val;
|
|
2396 }
|
|
2397
|
|
2398 DEFUN ("apply", Fapply, Sapply, 2, MANY, 0,
|
40570
|
2399 doc: /* Call FUNCTION with our remaining args, using our last arg as list of args.
|
|
2400 Then return the value FUNCTION returns.
|
|
2401 Thus, (apply '+ 1 2 '(3 4)) returns 10.
|
|
2402 usage: (apply FUNCTION &rest ARGUMENTS) */)
|
|
2403 (nargs, args)
|
272
|
2404 int nargs;
|
|
2405 Lisp_Object *args;
|
|
2406 {
|
|
2407 register int i, numargs;
|
|
2408 register Lisp_Object spread_arg;
|
|
2409 register Lisp_Object *funcall_args;
|
|
2410 Lisp_Object fun;
|
50644
0c4bf42e6557
(Fapply): Undo last change and add a comment about why.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
2411 struct gcpro gcpro1;
|
272
|
2412
|
|
2413 fun = args [0];
|
|
2414 funcall_args = 0;
|
|
2415 spread_arg = args [nargs - 1];
|
40656
|
2416 CHECK_LIST (spread_arg);
|
49600
|
2417
|
272
|
2418 numargs = XINT (Flength (spread_arg));
|
|
2419
|
|
2420 if (numargs == 0)
|
|
2421 return Ffuncall (nargs - 1, args);
|
|
2422 else if (numargs == 1)
|
|
2423 {
|
25662
0a7261c1d487
Use XCAR, XCDR, and XFLOAT_DATA instead of explicit member access.
Ken Raeburn <raeburn@raeburn.org>
diff
changeset
|
2424 args [nargs - 1] = XCAR (spread_arg);
|
272
|
2425 return Ffuncall (nargs, args);
|
|
2426 }
|
|
2427
|
323
|
2428 numargs += nargs - 2;
|
272
|
2429
|
71872
|
2430 /* Optimize for no indirection. */
|
|
2431 if (SYMBOLP (fun) && !EQ (fun, Qunbound)
|
|
2432 && (fun = XSYMBOL (fun)->function, SYMBOLP (fun)))
|
|
2433 fun = indirect_function (fun);
|
648
|
2434 if (EQ (fun, Qunbound))
|
272
|
2435 {
|
648
|
2436 /* Let funcall get the error */
|
|
2437 fun = args[0];
|
|
2438 goto funcall;
|
272
|
2439 }
|
|
2440
|
9148
|
2441 if (SUBRP (fun))
|
272
|
2442 {
|
|
2443 if (numargs < XSUBR (fun)->min_args
|
|
2444 || (XSUBR (fun)->max_args >= 0 && XSUBR (fun)->max_args < numargs))
|
|
2445 goto funcall; /* Let funcall get the error */
|
|
2446 else if (XSUBR (fun)->max_args > numargs)
|
|
2447 {
|
|
2448 /* Avoid making funcall cons up a yet another new vector of arguments
|
|
2449 by explicitly supplying nil's for optional values */
|
|
2450 funcall_args = (Lisp_Object *) alloca ((1 + XSUBR (fun)->max_args)
|
|
2451 * sizeof (Lisp_Object));
|
|
2452 for (i = numargs; i < XSUBR (fun)->max_args;)
|
|
2453 funcall_args[++i] = Qnil;
|
50644
0c4bf42e6557
(Fapply): Undo last change and add a comment about why.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
2454 GCPRO1 (*funcall_args);
|
0c4bf42e6557
(Fapply): Undo last change and add a comment about why.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
2455 gcpro1.nvars = 1 + XSUBR (fun)->max_args;
|
272
|
2456 }
|
|
2457 }
|
|
2458 funcall:
|
|
2459 /* We add 1 to numargs because funcall_args includes the
|
|
2460 function itself as well as its arguments. */
|
|
2461 if (!funcall_args)
|
323
|
2462 {
|
|
2463 funcall_args = (Lisp_Object *) alloca ((1 + numargs)
|
|
2464 * sizeof (Lisp_Object));
|
50644
0c4bf42e6557
(Fapply): Undo last change and add a comment about why.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
2465 GCPRO1 (*funcall_args);
|
0c4bf42e6557
(Fapply): Undo last change and add a comment about why.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
2466 gcpro1.nvars = 1 + numargs;
|
323
|
2467 }
|
|
2468
|
272
|
2469 bcopy (args, funcall_args, nargs * sizeof (Lisp_Object));
|
|
2470 /* Spread the last arg we got. Its first element goes in
|
|
2471 the slot that it used to occupy, hence this value of I. */
|
|
2472 i = nargs - 1;
|
485
|
2473 while (!NILP (spread_arg))
|
272
|
2474 {
|
25662
0a7261c1d487
Use XCAR, XCDR, and XFLOAT_DATA instead of explicit member access.
Ken Raeburn <raeburn@raeburn.org>
diff
changeset
|
2475 funcall_args [i++] = XCAR (spread_arg);
|
0a7261c1d487
Use XCAR, XCDR, and XFLOAT_DATA instead of explicit member access.
Ken Raeburn <raeburn@raeburn.org>
diff
changeset
|
2476 spread_arg = XCDR (spread_arg);
|
272
|
2477 }
|
323
|
2478
|
50644
0c4bf42e6557
(Fapply): Undo last change and add a comment about why.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
2479 /* By convention, the caller needs to gcpro Ffuncall's args. */
|
0c4bf42e6557
(Fapply): Undo last change and add a comment about why.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
2480 RETURN_UNGCPRO (Ffuncall (gcpro1.nvars, funcall_args));
|
272
|
2481 }
|
|
2482
|
12732
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2483 /* Run hook variables in various ways. */
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2484
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2485 enum run_hooks_condition {to_completion, until_success, until_failure};
|
41114
242c6928accc
(max_specpdl_size, max_lisp_eval_depth): Use EMACS_INT.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
2486 static Lisp_Object run_hook_with_args P_ ((int, Lisp_Object *,
|
242c6928accc
(max_specpdl_size, max_lisp_eval_depth): Use EMACS_INT.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
2487 enum run_hooks_condition));
|
12732
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2488
|
34013
|
2489 DEFUN ("run-hooks", Frun_hooks, Srun_hooks, 0, MANY, 0,
|
62709
|
2490 doc: /* Run each hook in HOOKS.
|
40570
|
2491 Each argument should be a symbol, a hook variable.
|
|
2492 These symbols are processed in the order specified.
|
|
2493 If a hook symbol has a non-nil value, that value may be a function
|
|
2494 or a list of functions to be called to run the hook.
|
|
2495 If the value is a function, it is called with no arguments.
|
|
2496 If it is a list, the elements are called, in order, with no arguments.
|
|
2497
|
62709
|
2498 Major modes should not use this function directly to run their mode
|
|
2499 hook; they should use `run-mode-hooks' instead.
|
|
2500
|
40629
|
2501 Do not use `make-local-variable' to make a hook variable buffer-local.
|
|
2502 Instead, use `add-hook' and specify t for the LOCAL argument.
|
40570
|
2503 usage: (run-hooks &rest HOOKS) */)
|
|
2504 (nargs, args)
|
12732
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2505 int nargs;
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2506 Lisp_Object *args;
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2507 {
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2508 Lisp_Object hook[1];
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2509 register int i;
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2510
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2511 for (i = 0; i < nargs; i++)
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2512 {
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2513 hook[0] = args[i];
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2514 run_hook_with_args (1, hook, to_completion);
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2515 }
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2516
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2517 return Qnil;
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2518 }
|
49600
|
2519
|
16485
|
2520 DEFUN ("run-hook-with-args", Frun_hook_with_args,
|
40570
|
2521 Srun_hook_with_args, 1, MANY, 0,
|
|
2522 doc: /* Run HOOK with the specified arguments ARGS.
|
|
2523 HOOK should be a symbol, a hook variable. If HOOK has a non-nil
|
|
2524 value, that value may be a function or a list of functions to be
|
|
2525 called to run the hook. If the value is a function, it is called with
|
|
2526 the given arguments and its return value is returned. If it is a list
|
|
2527 of functions, those functions are called, in order,
|
|
2528 with the given arguments ARGS.
|
59953
|
2529 It is best not to depend on the value returned by `run-hook-with-args',
|
40570
|
2530 as that may change.
|
|
2531
|
40629
|
2532 Do not use `make-local-variable' to make a hook variable buffer-local.
|
|
2533 Instead, use `add-hook' and specify t for the LOCAL argument.
|
40570
|
2534 usage: (run-hook-with-args HOOK &rest ARGS) */)
|
|
2535 (nargs, args)
|
12732
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2536 int nargs;
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2537 Lisp_Object *args;
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2538 {
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2539 return run_hook_with_args (nargs, args, to_completion);
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2540 }
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2541
|
16485
|
2542 DEFUN ("run-hook-with-args-until-success", Frun_hook_with_args_until_success,
|
40570
|
2543 Srun_hook_with_args_until_success, 1, MANY, 0,
|
|
2544 doc: /* Run HOOK with the specified arguments ARGS.
|
59953
|
2545 HOOK should be a symbol, a hook variable. If HOOK has a non-nil
|
|
2546 value, that value may be a function or a list of functions to be
|
|
2547 called to run the hook. If the value is a function, it is called with
|
|
2548 the given arguments and its return value is returned.
|
|
2549 If it is a list of functions, those functions are called, in order,
|
|
2550 with the given arguments ARGS, until one of them
|
40570
|
2551 returns a non-nil value. Then we return that value.
|
59953
|
2552 However, if they all return nil, we return nil.
|
40570
|
2553
|
40629
|
2554 Do not use `make-local-variable' to make a hook variable buffer-local.
|
|
2555 Instead, use `add-hook' and specify t for the LOCAL argument.
|
40570
|
2556 usage: (run-hook-with-args-until-success HOOK &rest ARGS) */)
|
|
2557 (nargs, args)
|
12654
|
2558 int nargs;
|
|
2559 Lisp_Object *args;
|
|
2560 {
|
12732
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2561 return run_hook_with_args (nargs, args, until_success);
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2562 }
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2563
|
16485
|
2564 DEFUN ("run-hook-with-args-until-failure", Frun_hook_with_args_until_failure,
|
40570
|
2565 Srun_hook_with_args_until_failure, 1, MANY, 0,
|
|
2566 doc: /* Run HOOK with the specified arguments ARGS.
|
59953
|
2567 HOOK should be a symbol, a hook variable. If HOOK has a non-nil
|
|
2568 value, that value may be a function or a list of functions to be
|
|
2569 called to run the hook. If the value is a function, it is called with
|
|
2570 the given arguments and its return value is returned.
|
|
2571 If it is a list of functions, those functions are called, in order,
|
|
2572 with the given arguments ARGS, until one of them returns nil.
|
|
2573 Then we return nil. However, if they all return non-nil, we return non-nil.
|
40570
|
2574
|
40629
|
2575 Do not use `make-local-variable' to make a hook variable buffer-local.
|
|
2576 Instead, use `add-hook' and specify t for the LOCAL argument.
|
40570
|
2577 usage: (run-hook-with-args-until-failure HOOK &rest ARGS) */)
|
|
2578 (nargs, args)
|
12732
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2579 int nargs;
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2580 Lisp_Object *args;
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2581 {
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2582 return run_hook_with_args (nargs, args, until_failure);
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2583 }
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2584
|
12781
|
2585 /* ARGS[0] should be a hook symbol.
|
|
2586 Call each of the functions in the hook value, passing each of them
|
|
2587 as arguments all the rest of ARGS (all NARGS - 1 elements).
|
|
2588 COND specifies a condition to test after each call
|
|
2589 to decide whether to stop.
|
|
2590 The caller (or its caller, etc) must gcpro all of ARGS,
|
|
2591 except that it isn't necessary to gcpro ARGS[0]. */
|
|
2592
|
41114
242c6928accc
(max_specpdl_size, max_lisp_eval_depth): Use EMACS_INT.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
2593 static Lisp_Object
|
12732
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2594 run_hook_with_args (nargs, args, cond)
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2595 int nargs;
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2596 Lisp_Object *args;
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2597 enum run_hooks_condition cond;
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2598 {
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2599 Lisp_Object sym, val, ret;
|
25257
|
2600 Lisp_Object globals;
|
|
2601 struct gcpro gcpro1, gcpro2, gcpro3;
|
12654
|
2602
|
14218
|
2603 /* If we are dying or still initializing,
|
|
2604 don't do anything--it would probably crash if we tried. */
|
|
2605 if (NILP (Vrun_hooks))
|
27226
|
2606 return Qnil;
|
14218
|
2607
|
12654
|
2608 sym = args[0];
|
12663
|
2609 val = find_symbol_value (sym);
|
12732
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2610 ret = (cond == until_failure ? Qt : Qnil);
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2611
|
12654
|
2612 if (EQ (val, Qunbound) || NILP (val))
|
12732
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2613 return ret;
|
25662
0a7261c1d487
Use XCAR, XCDR, and XFLOAT_DATA instead of explicit member access.
Ken Raeburn <raeburn@raeburn.org>
diff
changeset
|
2614 else if (!CONSP (val) || EQ (XCAR (val), Qlambda))
|
12654
|
2615 {
|
|
2616 args[0] = val;
|
|
2617 return Ffuncall (nargs, args);
|
|
2618 }
|
|
2619 else
|
|
2620 {
|
25257
|
2621 globals = Qnil;
|
|
2622 GCPRO3 (sym, val, globals);
|
12788
|
2623
|
12732
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2624 for (;
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2625 CONSP (val) && ((cond == to_completion)
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2626 || (cond == until_success ? NILP (ret)
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2627 : !NILP (ret)));
|
25662
0a7261c1d487
Use XCAR, XCDR, and XFLOAT_DATA instead of explicit member access.
Ken Raeburn <raeburn@raeburn.org>
diff
changeset
|
2628 val = XCDR (val))
|
12654
|
2629 {
|
25662
0a7261c1d487
Use XCAR, XCDR, and XFLOAT_DATA instead of explicit member access.
Ken Raeburn <raeburn@raeburn.org>
diff
changeset
|
2630 if (EQ (XCAR (val), Qt))
|
12654
|
2631 {
|
|
2632 /* t indicates this hook has a local binding;
|
|
2633 it means to run the global binding too. */
|
|
2634
|
12732
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2635 for (globals = Fdefault_value (sym);
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2636 CONSP (globals) && ((cond == to_completion)
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2637 || (cond == until_success ? NILP (ret)
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2638 : !NILP (ret)));
|
25662
0a7261c1d487
Use XCAR, XCDR, and XFLOAT_DATA instead of explicit member access.
Ken Raeburn <raeburn@raeburn.org>
diff
changeset
|
2639 globals = XCDR (globals))
|
12654
|
2640 {
|
25662
0a7261c1d487
Use XCAR, XCDR, and XFLOAT_DATA instead of explicit member access.
Ken Raeburn <raeburn@raeburn.org>
diff
changeset
|
2641 args[0] = XCAR (globals);
|
13444
|
2642 /* In a global value, t should not occur. If it does, we
|
|
2643 must ignore it to avoid an endless loop. */
|
|
2644 if (!EQ (args[0], Qt))
|
|
2645 ret = Ffuncall (nargs, args);
|
12654
|
2646 }
|
|
2647 }
|
|
2648 else
|
|
2649 {
|
25662
0a7261c1d487
Use XCAR, XCDR, and XFLOAT_DATA instead of explicit member access.
Ken Raeburn <raeburn@raeburn.org>
diff
changeset
|
2650 args[0] = XCAR (val);
|
12732
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2651 ret = Ffuncall (nargs, args);
|
12654
|
2652 }
|
|
2653 }
|
12788
|
2654
|
|
2655 UNGCPRO;
|
12732
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2656 return ret;
|
12654
|
2657 }
|
|
2658 }
|
12781
|
2659
|
|
2660 /* Run a hook symbol ARGS[0], but use FUNLIST instead of the actual
|
|
2661 present value of that symbol.
|
|
2662 Call each element of FUNLIST,
|
|
2663 passing each of them the rest of ARGS.
|
|
2664 The caller (or its caller, etc) must gcpro all of ARGS,
|
|
2665 except that it isn't necessary to gcpro ARGS[0]. */
|
|
2666
|
|
2667 Lisp_Object
|
|
2668 run_hook_list_with_args (funlist, nargs, args)
|
|
2669 Lisp_Object funlist;
|
|
2670 int nargs;
|
|
2671 Lisp_Object *args;
|
|
2672 {
|
|
2673 Lisp_Object sym;
|
|
2674 Lisp_Object val;
|
25257
|
2675 Lisp_Object globals;
|
|
2676 struct gcpro gcpro1, gcpro2, gcpro3;
|
12781
|
2677
|
|
2678 sym = args[0];
|
25257
|
2679 globals = Qnil;
|
|
2680 GCPRO3 (sym, val, globals);
|
12781
|
2681
|
25662
0a7261c1d487
Use XCAR, XCDR, and XFLOAT_DATA instead of explicit member access.
Ken Raeburn <raeburn@raeburn.org>
diff
changeset
|
2682 for (val = funlist; CONSP (val); val = XCDR (val))
|
12781
|
2683 {
|
25662
0a7261c1d487
Use XCAR, XCDR, and XFLOAT_DATA instead of explicit member access.
Ken Raeburn <raeburn@raeburn.org>
diff
changeset
|
2684 if (EQ (XCAR (val), Qt))
|
12781
|
2685 {
|
|
2686 /* t indicates this hook has a local binding;
|
|
2687 it means to run the global binding too. */
|
|
2688
|
|
2689 for (globals = Fdefault_value (sym);
|
|
2690 CONSP (globals);
|
25662
0a7261c1d487
Use XCAR, XCDR, and XFLOAT_DATA instead of explicit member access.
Ken Raeburn <raeburn@raeburn.org>
diff
changeset
|
2691 globals = XCDR (globals))
|
12781
|
2692 {
|
25662
0a7261c1d487
Use XCAR, XCDR, and XFLOAT_DATA instead of explicit member access.
Ken Raeburn <raeburn@raeburn.org>
diff
changeset
|
2693 args[0] = XCAR (globals);
|
13444
|
2694 /* In a global value, t should not occur. If it does, we
|
|
2695 must ignore it to avoid an endless loop. */
|
|
2696 if (!EQ (args[0], Qt))
|
|
2697 Ffuncall (nargs, args);
|
12781
|
2698 }
|
|
2699 }
|
|
2700 else
|
|
2701 {
|
25662
0a7261c1d487
Use XCAR, XCDR, and XFLOAT_DATA instead of explicit member access.
Ken Raeburn <raeburn@raeburn.org>
diff
changeset
|
2702 args[0] = XCAR (val);
|
12781
|
2703 Ffuncall (nargs, args);
|
|
2704 }
|
|
2705 }
|
|
2706 UNGCPRO;
|
|
2707 return Qnil;
|
|
2708 }
|
13103
|
2709
|
|
2710 /* Run the hook HOOK, giving each function the two args ARG1 and ARG2. */
|
|
2711
|
|
2712 void
|
|
2713 run_hook_with_args_2 (hook, arg1, arg2)
|
|
2714 Lisp_Object hook, arg1, arg2;
|
|
2715 {
|
|
2716 Lisp_Object temp[3];
|
|
2717 temp[0] = hook;
|
|
2718 temp[1] = arg1;
|
|
2719 temp[2] = arg2;
|
|
2720
|
|
2721 Frun_hook_with_args (3, temp);
|
|
2722 }
|
12732
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
2723
|
272
|
2724 /* Apply fn to arg */
|
|
2725 Lisp_Object
|
|
2726 apply1 (fn, arg)
|
|
2727 Lisp_Object fn, arg;
|
|
2728 {
|
323
|
2729 struct gcpro gcpro1;
|
|
2730
|
|
2731 GCPRO1 (fn);
|
485
|
2732 if (NILP (arg))
|
323
|
2733 RETURN_UNGCPRO (Ffuncall (1, &fn));
|
|
2734 gcpro1.nvars = 2;
|
272
|
2735 #ifdef NO_ARG_ARRAY
|
|
2736 {
|
|
2737 Lisp_Object args[2];
|
|
2738 args[0] = fn;
|
|
2739 args[1] = arg;
|
323
|
2740 gcpro1.var = args;
|
|
2741 RETURN_UNGCPRO (Fapply (2, args));
|
272
|
2742 }
|
|
2743 #else /* not NO_ARG_ARRAY */
|
323
|
2744 RETURN_UNGCPRO (Fapply (2, &fn));
|
272
|
2745 #endif /* not NO_ARG_ARRAY */
|
|
2746 }
|
|
2747
|
|
2748 /* Call function fn on no arguments */
|
|
2749 Lisp_Object
|
|
2750 call0 (fn)
|
|
2751 Lisp_Object fn;
|
|
2752 {
|
323
|
2753 struct gcpro gcpro1;
|
|
2754
|
|
2755 GCPRO1 (fn);
|
|
2756 RETURN_UNGCPRO (Ffuncall (1, &fn));
|
272
|
2757 }
|
|
2758
|
3703
|
2759 /* Call function fn with 1 argument arg1 */
|
272
|
2760 /* ARGSUSED */
|
|
2761 Lisp_Object
|
3703
|
2762 call1 (fn, arg1)
|
|
2763 Lisp_Object fn, arg1;
|
272
|
2764 {
|
323
|
2765 struct gcpro gcpro1;
|
272
|
2766 #ifdef NO_ARG_ARRAY
|
49600
|
2767 Lisp_Object args[2];
|
323
|
2768
|
272
|
2769 args[0] = fn;
|
3703
|
2770 args[1] = arg1;
|
323
|
2771 GCPRO1 (args[0]);
|
|
2772 gcpro1.nvars = 2;
|
|
2773 RETURN_UNGCPRO (Ffuncall (2, args));
|
272
|
2774 #else /* not NO_ARG_ARRAY */
|
323
|
2775 GCPRO1 (fn);
|
|
2776 gcpro1.nvars = 2;
|
|
2777 RETURN_UNGCPRO (Ffuncall (2, &fn));
|
272
|
2778 #endif /* not NO_ARG_ARRAY */
|
|
2779 }
|
|
2780
|
3703
|
2781 /* Call function fn with 2 arguments arg1, arg2 */
|
272
|
2782 /* ARGSUSED */
|
|
2783 Lisp_Object
|
3703
|
2784 call2 (fn, arg1, arg2)
|
|
2785 Lisp_Object fn, arg1, arg2;
|
272
|
2786 {
|
323
|
2787 struct gcpro gcpro1;
|
272
|
2788 #ifdef NO_ARG_ARRAY
|
|
2789 Lisp_Object args[3];
|
|
2790 args[0] = fn;
|
3703
|
2791 args[1] = arg1;
|
|
2792 args[2] = arg2;
|
323
|
2793 GCPRO1 (args[0]);
|
|
2794 gcpro1.nvars = 3;
|
|
2795 RETURN_UNGCPRO (Ffuncall (3, args));
|
272
|
2796 #else /* not NO_ARG_ARRAY */
|
323
|
2797 GCPRO1 (fn);
|
|
2798 gcpro1.nvars = 3;
|
|
2799 RETURN_UNGCPRO (Ffuncall (3, &fn));
|
272
|
2800 #endif /* not NO_ARG_ARRAY */
|
|
2801 }
|
|
2802
|
3703
|
2803 /* Call function fn with 3 arguments arg1, arg2, arg3 */
|
272
|
2804 /* ARGSUSED */
|
|
2805 Lisp_Object
|
3703
|
2806 call3 (fn, arg1, arg2, arg3)
|
|
2807 Lisp_Object fn, arg1, arg2, arg3;
|
272
|
2808 {
|
323
|
2809 struct gcpro gcpro1;
|
272
|
2810 #ifdef NO_ARG_ARRAY
|
|
2811 Lisp_Object args[4];
|
|
2812 args[0] = fn;
|
3703
|
2813 args[1] = arg1;
|
|
2814 args[2] = arg2;
|
|
2815 args[3] = arg3;
|
323
|
2816 GCPRO1 (args[0]);
|
|
2817 gcpro1.nvars = 4;
|
|
2818 RETURN_UNGCPRO (Ffuncall (4, args));
|
272
|
2819 #else /* not NO_ARG_ARRAY */
|
323
|
2820 GCPRO1 (fn);
|
|
2821 gcpro1.nvars = 4;
|
|
2822 RETURN_UNGCPRO (Ffuncall (4, &fn));
|
272
|
2823 #endif /* not NO_ARG_ARRAY */
|
|
2824 }
|
|
2825
|
3703
|
2826 /* Call function fn with 4 arguments arg1, arg2, arg3, arg4 */
|
3598
3c4b5489d2b4
* fileio.c (Frename_file): Pass all arguments to the file name handler.
Jim Blandy <jimb@redhat.com>
diff
changeset
|
2827 /* ARGSUSED */
|
3c4b5489d2b4
* fileio.c (Frename_file): Pass all arguments to the file name handler.
Jim Blandy <jimb@redhat.com>
diff
changeset
|
2828 Lisp_Object
|
3703
|
2829 call4 (fn, arg1, arg2, arg3, arg4)
|
|
2830 Lisp_Object fn, arg1, arg2, arg3, arg4;
|
3598
3c4b5489d2b4
* fileio.c (Frename_file): Pass all arguments to the file name handler.
Jim Blandy <jimb@redhat.com>
diff
changeset
|
2831 {
|
3c4b5489d2b4
* fileio.c (Frename_file): Pass all arguments to the file name handler.
Jim Blandy <jimb@redhat.com>
diff
changeset
|
2832 struct gcpro gcpro1;
|
3c4b5489d2b4
* fileio.c (Frename_file): Pass all arguments to the file name handler.
Jim Blandy <jimb@redhat.com>
diff
changeset
|
2833 #ifdef NO_ARG_ARRAY
|
3c4b5489d2b4
* fileio.c (Frename_file): Pass all arguments to the file name handler.
Jim Blandy <jimb@redhat.com>
diff
changeset
|
2834 Lisp_Object args[5];
|
3c4b5489d2b4
* fileio.c (Frename_file): Pass all arguments to the file name handler.
Jim Blandy <jimb@redhat.com>
diff
changeset
|
2835 args[0] = fn;
|
3703
|
2836 args[1] = arg1;
|
|
2837 args[2] = arg2;
|
|
2838 args[3] = arg3;
|
|
2839 args[4] = arg4;
|
3598
3c4b5489d2b4
* fileio.c (Frename_file): Pass all arguments to the file name handler.
Jim Blandy <jimb@redhat.com>
diff
changeset
|
2840 GCPRO1 (args[0]);
|
3c4b5489d2b4
* fileio.c (Frename_file): Pass all arguments to the file name handler.
Jim Blandy <jimb@redhat.com>
diff
changeset
|
2841 gcpro1.nvars = 5;
|
3c4b5489d2b4
* fileio.c (Frename_file): Pass all arguments to the file name handler.
Jim Blandy <jimb@redhat.com>
diff
changeset
|
2842 RETURN_UNGCPRO (Ffuncall (5, args));
|
3c4b5489d2b4
* fileio.c (Frename_file): Pass all arguments to the file name handler.
Jim Blandy <jimb@redhat.com>
diff
changeset
|
2843 #else /* not NO_ARG_ARRAY */
|
3c4b5489d2b4
* fileio.c (Frename_file): Pass all arguments to the file name handler.
Jim Blandy <jimb@redhat.com>
diff
changeset
|
2844 GCPRO1 (fn);
|
3c4b5489d2b4
* fileio.c (Frename_file): Pass all arguments to the file name handler.
Jim Blandy <jimb@redhat.com>
diff
changeset
|
2845 gcpro1.nvars = 5;
|
3c4b5489d2b4
* fileio.c (Frename_file): Pass all arguments to the file name handler.
Jim Blandy <jimb@redhat.com>
diff
changeset
|
2846 RETURN_UNGCPRO (Ffuncall (5, &fn));
|
3c4b5489d2b4
* fileio.c (Frename_file): Pass all arguments to the file name handler.
Jim Blandy <jimb@redhat.com>
diff
changeset
|
2847 #endif /* not NO_ARG_ARRAY */
|
3c4b5489d2b4
* fileio.c (Frename_file): Pass all arguments to the file name handler.
Jim Blandy <jimb@redhat.com>
diff
changeset
|
2848 }
|
3c4b5489d2b4
* fileio.c (Frename_file): Pass all arguments to the file name handler.
Jim Blandy <jimb@redhat.com>
diff
changeset
|
2849
|
3703
|
2850 /* Call function fn with 5 arguments arg1, arg2, arg3, arg4, arg5 */
|
|
2851 /* ARGSUSED */
|
|
2852 Lisp_Object
|
|
2853 call5 (fn, arg1, arg2, arg3, arg4, arg5)
|
|
2854 Lisp_Object fn, arg1, arg2, arg3, arg4, arg5;
|
|
2855 {
|
|
2856 struct gcpro gcpro1;
|
|
2857 #ifdef NO_ARG_ARRAY
|
|
2858 Lisp_Object args[6];
|
|
2859 args[0] = fn;
|
|
2860 args[1] = arg1;
|
|
2861 args[2] = arg2;
|
|
2862 args[3] = arg3;
|
|
2863 args[4] = arg4;
|
|
2864 args[5] = arg5;
|
|
2865 GCPRO1 (args[0]);
|
|
2866 gcpro1.nvars = 6;
|
|
2867 RETURN_UNGCPRO (Ffuncall (6, args));
|
|
2868 #else /* not NO_ARG_ARRAY */
|
|
2869 GCPRO1 (fn);
|
|
2870 gcpro1.nvars = 6;
|
|
2871 RETURN_UNGCPRO (Ffuncall (6, &fn));
|
|
2872 #endif /* not NO_ARG_ARRAY */
|
|
2873 }
|
|
2874
|
|
2875 /* Call function fn with 6 arguments arg1, arg2, arg3, arg4, arg5, arg6 */
|
|
2876 /* ARGSUSED */
|
|
2877 Lisp_Object
|
|
2878 call6 (fn, arg1, arg2, arg3, arg4, arg5, arg6)
|
|
2879 Lisp_Object fn, arg1, arg2, arg3, arg4, arg5, arg6;
|
|
2880 {
|
|
2881 struct gcpro gcpro1;
|
|
2882 #ifdef NO_ARG_ARRAY
|
|
2883 Lisp_Object args[7];
|
|
2884 args[0] = fn;
|
|
2885 args[1] = arg1;
|
|
2886 args[2] = arg2;
|
|
2887 args[3] = arg3;
|
|
2888 args[4] = arg4;
|
|
2889 args[5] = arg5;
|
|
2890 args[6] = arg6;
|
|
2891 GCPRO1 (args[0]);
|
|
2892 gcpro1.nvars = 7;
|
|
2893 RETURN_UNGCPRO (Ffuncall (7, args));
|
|
2894 #else /* not NO_ARG_ARRAY */
|
|
2895 GCPRO1 (fn);
|
|
2896 gcpro1.nvars = 7;
|
|
2897 RETURN_UNGCPRO (Ffuncall (7, &fn));
|
|
2898 #endif /* not NO_ARG_ARRAY */
|
|
2899 }
|
|
2900
|
53362
|
2901 /* The caller should GCPRO all the elements of ARGS. */
|
|
2902
|
272
|
2903 DEFUN ("funcall", Ffuncall, Sfuncall, 1, MANY, 0,
|
40570
|
2904 doc: /* Call first argument as a function, passing remaining arguments to it.
|
|
2905 Return the value that function returns.
|
|
2906 Thus, (funcall 'cons 'x 'y) returns (x . y).
|
|
2907 usage: (funcall FUNCTION &rest ARGUMENTS) */)
|
|
2908 (nargs, args)
|
272
|
2909 int nargs;
|
|
2910 Lisp_Object *args;
|
|
2911 {
|
71872
|
2912 Lisp_Object fun, original_fun;
|
272
|
2913 Lisp_Object funcar;
|
|
2914 int numargs = nargs - 1;
|
|
2915 Lisp_Object lisp_numargs;
|
|
2916 Lisp_Object val;
|
|
2917 struct backtrace backtrace;
|
|
2918 register Lisp_Object *internal_args;
|
|
2919 register int i;
|
|
2920
|
|
2921 QUIT;
|
66528
|
2922 if ((consing_since_gc > gc_cons_threshold
|
|
2923 && consing_since_gc > gc_relative_threshold)
|
|
2924 ||
|
|
2925 (!NILP (Vmemory_full) && consing_since_gc > memory_full_cons_threshold))
|
323
|
2926 Fgarbage_collect ();
|
272
|
2927
|
|
2928 if (++lisp_eval_depth > max_lisp_eval_depth)
|
|
2929 {
|
|
2930 if (max_lisp_eval_depth < 100)
|
|
2931 max_lisp_eval_depth = 100;
|
|
2932 if (lisp_eval_depth > max_lisp_eval_depth)
|
63697
9f617bb41e22
(Fdefvar, Fdefconst, Feval, Ffuncall): Follow error conventions.
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
2933 error ("Lisp nesting exceeds `max-lisp-eval-depth'");
|
272
|
2934 }
|
|
2935
|
|
2936 backtrace.next = backtrace_list;
|
|
2937 backtrace_list = &backtrace;
|
|
2938 backtrace.function = &args[0];
|
|
2939 backtrace.args = &args[1];
|
|
2940 backtrace.nargs = nargs - 1;
|
|
2941 backtrace.evalargs = 0;
|
|
2942 backtrace.debug_on_exit = 0;
|
|
2943
|
|
2944 if (debug_on_next_call)
|
|
2945 do_debug_on_call (Qlambda);
|
|
2946
|
61250
|
2947 CHECK_CONS_LIST ();
|
|
2948
|
71872
|
2949 original_fun = args[0];
|
|
2950
|
272
|
2951 retry:
|
|
2952
|
71872
|
2953 /* Optimize for no indirection. */
|
|
2954 fun = original_fun;
|
|
2955 if (SYMBOLP (fun) && !EQ (fun, Qunbound)
|
|
2956 && (fun = XSYMBOL (fun)->function, SYMBOLP (fun)))
|
|
2957 fun = indirect_function (fun);
|
272
|
2958
|
9148
|
2959 if (SUBRP (fun))
|
272
|
2960 {
|
61250
|
2961 if (numargs < XSUBR (fun)->min_args
|
272
|
2962 || (XSUBR (fun)->max_args >= 0 && XSUBR (fun)->max_args < numargs))
|
|
2963 {
|
9306
ac852c183fa1
(Feval, Ffuncall, funcall_lambda, Fbacktrace): Don't use XFASTINT as an
Karl Heuer <kwzh@gnu.org>
diff
changeset
|
2964 XSETFASTINT (lisp_numargs, numargs);
|
71976
|
2965 xsignal2 (Qwrong_number_of_arguments, original_fun, lisp_numargs);
|
272
|
2966 }
|
|
2967
|
|
2968 if (XSUBR (fun)->max_args == UNEVALLED)
|
71976
|
2969 xsignal1 (Qinvalid_function, original_fun);
|
272
|
2970
|
|
2971 if (XSUBR (fun)->max_args == MANY)
|
|
2972 {
|
|
2973 val = (*XSUBR (fun)->function) (numargs, args + 1);
|
|
2974 goto done;
|
|
2975 }
|
|
2976
|
|
2977 if (XSUBR (fun)->max_args > numargs)
|
|
2978 {
|
|
2979 internal_args = (Lisp_Object *) alloca (XSUBR (fun)->max_args * sizeof (Lisp_Object));
|
|
2980 bcopy (args + 1, internal_args, numargs * sizeof (Lisp_Object));
|
|
2981 for (i = numargs; i < XSUBR (fun)->max_args; i++)
|
|
2982 internal_args[i] = Qnil;
|
|
2983 }
|
|
2984 else
|
|
2985 internal_args = args + 1;
|
|
2986 switch (XSUBR (fun)->max_args)
|
|
2987 {
|
|
2988 case 0:
|
|
2989 val = (*XSUBR (fun)->function) ();
|
|
2990 goto done;
|
|
2991 case 1:
|
|
2992 val = (*XSUBR (fun)->function) (internal_args[0]);
|
|
2993 goto done;
|
|
2994 case 2:
|
64499
34bf5187c5aa
(Fprog2, Fcalled_interactively_p), (syms_of_eval) <debug-on-quit>: Doc fixes.
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
2995 val = (*XSUBR (fun)->function) (internal_args[0], internal_args[1]);
|
272
|
2996 goto done;
|
|
2997 case 3:
|
|
2998 val = (*XSUBR (fun)->function) (internal_args[0], internal_args[1],
|
|
2999 internal_args[2]);
|
|
3000 goto done;
|
|
3001 case 4:
|
|
3002 val = (*XSUBR (fun)->function) (internal_args[0], internal_args[1],
|
64499
34bf5187c5aa
(Fprog2, Fcalled_interactively_p), (syms_of_eval) <debug-on-quit>: Doc fixes.
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
3003 internal_args[2], internal_args[3]);
|
272
|
3004 goto done;
|
|
3005 case 5:
|
|
3006 val = (*XSUBR (fun)->function) (internal_args[0], internal_args[1],
|
|
3007 internal_args[2], internal_args[3],
|
|
3008 internal_args[4]);
|
|
3009 goto done;
|
|
3010 case 6:
|
|
3011 val = (*XSUBR (fun)->function) (internal_args[0], internal_args[1],
|
|
3012 internal_args[2], internal_args[3],
|
|
3013 internal_args[4], internal_args[5]);
|
|
3014 goto done;
|
863
|
3015 case 7:
|
|
3016 val = (*XSUBR (fun)->function) (internal_args[0], internal_args[1],
|
|
3017 internal_args[2], internal_args[3],
|
|
3018 internal_args[4], internal_args[5],
|
|
3019 internal_args[6]);
|
|
3020 goto done;
|
272
|
3021
|
19544
|
3022 case 8:
|
|
3023 val = (*XSUBR (fun)->function) (internal_args[0], internal_args[1],
|
|
3024 internal_args[2], internal_args[3],
|
|
3025 internal_args[4], internal_args[5],
|
|
3026 internal_args[6], internal_args[7]);
|
|
3027 goto done;
|
|
3028
|
272
|
3029 default:
|
573
|
3030
|
19544
|
3031 /* If a subr takes more than 8 arguments without using MANY
|
49600
|
3032 or UNEVALLED, we need to extend this function to support it.
|
573
|
3033 Until this is done, there is no way to call the function. */
|
|
3034 abort ();
|
272
|
3035 }
|
|
3036 }
|
9148
|
3037 if (COMPILEDP (fun))
|
272
|
3038 val = funcall_lambda (fun, numargs, args + 1);
|
|
3039 else
|
|
3040 {
|
71872
|
3041 if (EQ (fun, Qunbound))
|
71976
|
3042 xsignal1 (Qvoid_function, original_fun);
|
272
|
3043 if (!CONSP (fun))
|
71976
|
3044 xsignal1 (Qinvalid_function, original_fun);
|
|
3045 funcar = XCAR (fun);
|
9148
|
3046 if (!SYMBOLP (funcar))
|
71976
|
3047 xsignal1 (Qinvalid_function, original_fun);
|
272
|
3048 if (EQ (funcar, Qlambda))
|
|
3049 val = funcall_lambda (fun, numargs, args + 1);
|
|
3050 else if (EQ (funcar, Qautoload))
|
|
3051 {
|
71872
|
3052 do_autoload (fun, original_fun);
|
61250
|
3053 CHECK_CONS_LIST ();
|
272
|
3054 goto retry;
|
|
3055 }
|
|
3056 else
|
71976
|
3057 xsignal1 (Qinvalid_function, original_fun);
|
272
|
3058 }
|
|
3059 done:
|
60418
|
3060 CHECK_CONS_LIST ();
|
272
|
3061 lisp_eval_depth--;
|
|
3062 if (backtrace.debug_on_exit)
|
|
3063 val = call_debugger (Fcons (Qexit, Fcons (val, Qnil)));
|
|
3064 backtrace_list = backtrace.next;
|
|
3065 return val;
|
|
3066 }
|
|
3067
|
|
3068 Lisp_Object
|
|
3069 apply_lambda (fun, args, eval_flag)
|
|
3070 Lisp_Object fun, args;
|
|
3071 int eval_flag;
|
|
3072 {
|
|
3073 Lisp_Object args_left;
|
|
3074 Lisp_Object numargs;
|
|
3075 register Lisp_Object *arg_vector;
|
|
3076 struct gcpro gcpro1, gcpro2, gcpro3;
|
|
3077 register int i;
|
|
3078 register Lisp_Object tem;
|
|
3079
|
|
3080 numargs = Flength (args);
|
|
3081 arg_vector = (Lisp_Object *) alloca (XINT (numargs) * sizeof (Lisp_Object));
|
|
3082 args_left = args;
|
|
3083
|
|
3084 GCPRO3 (*arg_vector, args_left, fun);
|
|
3085 gcpro1.nvars = 0;
|
|
3086
|
|
3087 for (i = 0; i < XINT (numargs);)
|
|
3088 {
|
|
3089 tem = Fcar (args_left), args_left = Fcdr (args_left);
|
|
3090 if (eval_flag) tem = Feval (tem);
|
|
3091 arg_vector[i++] = tem;
|
|
3092 gcpro1.nvars = i;
|
|
3093 }
|
|
3094
|
|
3095 UNGCPRO;
|
|
3096
|
|
3097 if (eval_flag)
|
|
3098 {
|
|
3099 backtrace_list->args = arg_vector;
|
|
3100 backtrace_list->nargs = i;
|
|
3101 }
|
|
3102 backtrace_list->evalargs = 0;
|
|
3103 tem = funcall_lambda (fun, XINT (numargs), arg_vector);
|
|
3104
|
|
3105 /* Do the debug-on-exit now, while arg_vector still exists. */
|
|
3106 if (backtrace_list->debug_on_exit)
|
|
3107 tem = call_debugger (Fcons (Qexit, Fcons (tem, Qnil)));
|
|
3108 /* Don't do it again when we return to eval. */
|
|
3109 backtrace_list->debug_on_exit = 0;
|
|
3110 return tem;
|
|
3111 }
|
|
3112
|
|
3113 /* Apply a Lisp function FUN to the NARGS evaluated arguments in ARG_VECTOR
|
|
3114 and return the result of evaluation.
|
|
3115 FUN must be either a lambda-expression or a compiled-code object. */
|
|
3116
|
41114
242c6928accc
(max_specpdl_size, max_lisp_eval_depth): Use EMACS_INT.
Stefan Monnier <monnier@iro.umontreal.ca>
diff
changeset
|
3117 static Lisp_Object
|
272
|
3118 funcall_lambda (fun, nargs, arg_vector)
|
|
3119 Lisp_Object fun;
|
|
3120 int nargs;
|
|
3121 register Lisp_Object *arg_vector;
|
|
3122 {
|
27781
|
3123 Lisp_Object val, syms_left, next;
|
46293
|
3124 int count = SPECPDL_INDEX ();
|
27781
|
3125 int i, optional, rest;
|
|
3126
|
9148
|
3127 if (CONSP (fun))
|
27781
|
3128 {
|
|
3129 syms_left = XCDR (fun);
|
|
3130 if (CONSP (syms_left))
|
|
3131 syms_left = XCAR (syms_left);
|
|
3132 else
|
71976
|
3133 xsignal1 (Qinvalid_function, fun);
|
27781
|
3134 }
|
9148
|
3135 else if (COMPILEDP (fun))
|
41597
|
3136 syms_left = AREF (fun, COMPILED_ARGLIST);
|
27781
|
3137 else
|
|
3138 abort ();
|
|
3139
|
|
3140 i = optional = rest = 0;
|
|
3141 for (; CONSP (syms_left); syms_left = XCDR (syms_left))
|
272
|
3142 {
|
|
3143 QUIT;
|
49600
|
3144
|
27781
|
3145 next = XCAR (syms_left);
|
71872
|
3146 if (!SYMBOLP (next))
|
71976
|
3147 xsignal1 (Qinvalid_function, fun);
|
49600
|
3148
|
272
|
3149 if (EQ (next, Qand_rest))
|
|
3150 rest = 1;
|
|
3151 else if (EQ (next, Qand_optional))
|
|
3152 optional = 1;
|
|
3153 else if (rest)
|
|
3154 {
|
431
|
3155 specbind (next, Flist (nargs - i, &arg_vector[i]));
|
272
|
3156 i = nargs;
|
|
3157 }
|
|
3158 else if (i < nargs)
|
27781
|
3159 specbind (next, arg_vector[i++]);
|
272
|
3160 else if (!optional)
|
71976
|
3161 xsignal2 (Qwrong_number_of_arguments, fun, make_number (nargs));
|
272
|
3162 else
|
|
3163 specbind (next, Qnil);
|
|
3164 }
|
|
3165
|
27781
|
3166 if (!NILP (syms_left))
|
71976
|
3167 xsignal1 (Qinvalid_function, fun);
|
27781
|
3168 else if (i < nargs)
|
71976
|
3169 xsignal2 (Qwrong_number_of_arguments, fun, make_number (nargs));
|
272
|
3170
|
9148
|
3171 if (CONSP (fun))
|
27781
|
3172 val = Fprogn (XCDR (XCDR (fun)));
|
272
|
3173 else
|
10201
|
3174 {
|
|
3175 /* If we have not actually read the bytecode string
|
|
3176 and constants vector yet, fetch them from the file. */
|
41597
|
3177 if (CONSP (AREF (fun, COMPILED_BYTECODE)))
|
11205
|
3178 Ffetch_bytecode (fun);
|
41597
|
3179 val = Fbyte_code (AREF (fun, COMPILED_BYTECODE),
|
|
3180 AREF (fun, COMPILED_CONSTANTS),
|
|
3181 AREF (fun, COMPILED_STACK_DEPTH));
|
10201
|
3182 }
|
49600
|
3183
|
272
|
3184 return unbind_to (count, val);
|
|
3185 }
|
11205
|
3186
|
|
3187 DEFUN ("fetch-bytecode", Ffetch_bytecode, Sfetch_bytecode,
|
40570
|
3188 1, 1, 0,
|
|
3189 doc: /* If byte-compiled OBJECT is lazy-loaded, fetch it now. */)
|
|
3190 (object)
|
11205
|
3191 Lisp_Object object;
|
|
3192 {
|
|
3193 Lisp_Object tem;
|
|
3194
|
41597
|
3195 if (COMPILEDP (object) && CONSP (AREF (object, COMPILED_BYTECODE)))
|
11205
|
3196 {
|
41597
|
3197 tem = read_doc_string (AREF (object, COMPILED_BYTECODE));
|
11481
af7833ecb551
(Ffetch_bytecode): Check the type of the object being read from the file.
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
3198 if (!CONSP (tem))
|
41597
|
3199 {
|
|
3200 tem = AREF (object, COMPILED_BYTECODE);
|
|
3201 if (CONSP (tem) && STRINGP (XCAR (tem)))
|
46370
40db0673e6f0
Most uses of XSTRING combined with STRING_BYTES or indirection changed to
Ken Raeburn <raeburn@raeburn.org>
diff
changeset
|
3202 error ("Invalid byte code in %s", SDATA (XCAR (tem)));
|
41597
|
3203 else
|
|
3204 error ("Invalid byte code");
|
|
3205 }
|
|
3206 AREF (object, COMPILED_BYTECODE) = XCAR (tem);
|
|
3207 AREF (object, COMPILED_CONSTANTS) = XCDR (tem);
|
11205
|
3208 }
|
|
3209 return object;
|
|
3210 }
|
272
|
3211
|
|
3212 void
|
|
3213 grow_specpdl ()
|
|
3214 {
|
46293
|
3215 register int count = SPECPDL_INDEX ();
|
272
|
3216 if (specpdl_size >= max_specpdl_size)
|
|
3217 {
|
|
3218 if (max_specpdl_size < 400)
|
|
3219 max_specpdl_size = 400;
|
|
3220 if (specpdl_size >= max_specpdl_size)
|
71976
|
3221 signal_error ("Variable binding depth exceeds max-specpdl-size", Qnil);
|
272
|
3222 }
|
|
3223 specpdl_size *= 2;
|
|
3224 if (specpdl_size > max_specpdl_size)
|
|
3225 specpdl_size = max_specpdl_size;
|
|
3226 specpdl = (struct specbinding *) xrealloc (specpdl, specpdl_size * sizeof (struct specbinding));
|
|
3227 specpdl_ptr = specpdl + count;
|
|
3228 }
|
|
3229
|
|
3230 void
|
|
3231 specbind (symbol, value)
|
|
3232 Lisp_Object symbol, value;
|
|
3233 {
|
|
3234 Lisp_Object ovalue;
|
39577
|
3235 Lisp_Object valcontents;
|
272
|
3236
|
40656
|
3237 CHECK_SYMBOL (symbol);
|
272
|
3238 if (specpdl_ptr == specpdl + specpdl_size)
|
|
3239 grow_specpdl ();
|
27781
|
3240
|
39577
|
3241 /* The most common case is that of a non-constant symbol with a
|
|
3242 trivial value. Make that as fast as we can. */
|
|
3243 valcontents = SYMBOL_VALUE (symbol);
|
|
3244 if (!MISCP (valcontents) && !SYMBOL_CONSTANT_P (symbol))
|
27295
|
3245 {
|
27781
|
3246 specpdl_ptr->symbol = symbol;
|
39577
|
3247 specpdl_ptr->old_value = valcontents;
|
27781
|
3248 specpdl_ptr->func = NULL;
|
|
3249 ++specpdl_ptr;
|
39577
|
3250 SET_SYMBOL_VALUE (symbol, value);
|
27295
|
3251 }
|
|
3252 else
|
27781
|
3253 {
|
38276
|
3254 Lisp_Object valcontents;
|
49600
|
3255
|
27781
|
3256 ovalue = find_symbol_value (symbol);
|
|
3257 specpdl_ptr->func = 0;
|
|
3258 specpdl_ptr->old_value = ovalue;
|
|
3259
|
38276
|
3260 valcontents = XSYMBOL (symbol)->value;
|
|
3261
|
|
3262 if (BUFFER_LOCAL_VALUEP (valcontents)
|
|
3263 || SOME_BUFFER_LOCAL_VALUEP (valcontents)
|
|
3264 || BUFFER_OBJFWDP (valcontents))
|
27781
|
3265 {
|
38290
|
3266 Lisp_Object where, current_buffer;
|
|
3267
|
|
3268 current_buffer = Fcurrent_buffer ();
|
49600
|
3269
|
27781
|
3270 /* For a local variable, record both the symbol and which
|
38276
|
3271 buffer's or frame's value we are saving. */
|
|
3272 if (!NILP (Flocal_variable_p (symbol, Qnil)))
|
38290
|
3273 where = current_buffer;
|
38276
|
3274 else if (!BUFFER_OBJFWDP (valcontents)
|
|
3275 && XBUFFER_LOCAL_VALUE (valcontents)->found_for_frame)
|
|
3276 where = XBUFFER_LOCAL_VALUE (valcontents)->frame;
|
|
3277 else
|
|
3278 where = Qnil;
|
|
3279
|
|
3280 /* We're not using the `unused' slot in the specbinding
|
|
3281 structure because this would mean we have to do more
|
|
3282 work for simple variables. */
|
38290
|
3283 specpdl_ptr->symbol = Fcons (symbol, Fcons (where, current_buffer));
|
35394
|
3284
|
|
3285 /* If SYMBOL is a per-buffer variable which doesn't have a
|
|
3286 buffer-local value here, make the `let' change the global
|
|
3287 value by changing the value of SYMBOL in all buffers not
|
|
3288 having their own value. This is consistent with what
|
|
3289 happens with other buffer-local variables. */
|
38276
|
3290 if (NILP (where)
|
|
3291 && BUFFER_OBJFWDP (valcontents))
|
35394
|
3292 {
|
|
3293 ++specpdl_ptr;
|
|
3294 Fset_default (symbol, value);
|
|
3295 return;
|
|
3296 }
|
27781
|
3297 }
|
|
3298 else
|
|
3299 specpdl_ptr->symbol = symbol;
|
|
3300
|
|
3301 specpdl_ptr++;
|
|
3302 if (BUFFER_OBJFWDP (ovalue) || KBOARD_OBJFWDP (ovalue))
|
36817
|
3303 store_symval_forwarding (symbol, ovalue, value, NULL);
|
27781
|
3304 else
|
|
3305 set_internal (symbol, value, 0, 1);
|
|
3306 }
|
272
|
3307 }
|
|
3308
|
|
3309 void
|
|
3310 record_unwind_protect (function, arg)
|
20312
|
3311 Lisp_Object (*function) P_ ((Lisp_Object));
|
272
|
3312 Lisp_Object arg;
|
|
3313 {
|
69152
|
3314 eassert (!handling_signal);
|
|
3315
|
272
|
3316 if (specpdl_ptr == specpdl + specpdl_size)
|
|
3317 grow_specpdl ();
|
|
3318 specpdl_ptr->func = function;
|
|
3319 specpdl_ptr->symbol = Qnil;
|
|
3320 specpdl_ptr->old_value = arg;
|
|
3321 specpdl_ptr++;
|
|
3322 }
|
|
3323
|
|
3324 Lisp_Object
|
|
3325 unbind_to (count, value)
|
|
3326 int count;
|
|
3327 Lisp_Object value;
|
|
3328 {
|
62980
|
3329 Lisp_Object quitf = Vquit_flag;
|
|
3330 struct gcpro gcpro1, gcpro2;
|
|
3331
|
|
3332 GCPRO2 (value, quitf);
|
272
|
3333 Vquit_flag = Qnil;
|
|
3334
|
|
3335 while (specpdl_ptr != specpdl + count)
|
|
3336 {
|
50919
|
3337 /* Copy the binding, and decrement specpdl_ptr, before we do
|
|
3338 the work to unbind it. We decrement first
|
|
3339 so that an error in unbinding won't try to unbind
|
|
3340 the same entry again, and we copy the binding first
|
|
3341 in case more bindings are made during some of the code we run. */
|
|
3342
|
51294
|
3343 struct specbinding this_binding;
|
|
3344 this_binding = *--specpdl_ptr;
|
50919
|
3345
|
|
3346 if (this_binding.func != 0)
|
|
3347 (*this_binding.func) (this_binding.old_value);
|
38290
|
3348 /* If the symbol is a list, it is really (SYMBOL WHERE
|
|
3349 . CURRENT-BUFFER) where WHERE is either nil, a buffer, or a
|
|
3350 frame. If WHERE is a buffer or frame, this indicates we
|
40661
|
3351 bound a variable that had a buffer-local or frame-local
|
|
3352 binding. WHERE nil means that the variable had the default
|
38290
|
3353 value when it was bound. CURRENT-BUFFER is the buffer that
|
|
3354 was current when the variable was bound. */
|
50919
|
3355 else if (CONSP (this_binding.symbol))
|
27295
|
3356 {
|
38276
|
3357 Lisp_Object symbol, where;
|
27295
|
3358
|
50919
|
3359 symbol = XCAR (this_binding.symbol);
|
|
3360 where = XCAR (XCDR (this_binding.symbol));
|
38276
|
3361
|
|
3362 if (NILP (where))
|
50919
|
3363 Fset_default (symbol, this_binding.old_value);
|
38276
|
3364 else if (BUFFERP (where))
|
50919
|
3365 set_internal (symbol, this_binding.old_value, XBUFFER (where), 1);
|
49600
|
3366 else
|
50919
|
3367 set_internal (symbol, this_binding.old_value, NULL, 1);
|
27295
|
3368 }
|
272
|
3369 else
|
27781
|
3370 {
|
|
3371 /* If variable has a trivial value (no forwarding), we can
|
|
3372 just set it. No need to check for constant symbols here,
|
|
3373 since that was already done by specbind. */
|
50919
|
3374 if (!MISCP (SYMBOL_VALUE (this_binding.symbol)))
|
|
3375 SET_SYMBOL_VALUE (this_binding.symbol, this_binding.old_value);
|
27781
|
3376 else
|
50919
|
3377 set_internal (this_binding.symbol, this_binding.old_value, 0, 1);
|
27781
|
3378 }
|
272
|
3379 }
|
49600
|
3380
|
62980
|
3381 if (NILP (Vquit_flag) && !NILP (quitf))
|
|
3382 Vquit_flag = quitf;
|
272
|
3383
|
|
3384 UNGCPRO;
|
|
3385 return value;
|
|
3386 }
|
|
3387
|
|
3388 DEFUN ("backtrace-debug", Fbacktrace_debug, Sbacktrace_debug, 2, 2, 0,
|
40570
|
3389 doc: /* Set the debug-on-exit flag of eval frame LEVEL levels down to FLAG.
|
|
3390 The debugger is entered when that frame exits, if the flag is non-nil. */)
|
|
3391 (level, flag)
|
272
|
3392 Lisp_Object level, flag;
|
|
3393 {
|
|
3394 register struct backtrace *backlist = backtrace_list;
|
|
3395 register int i;
|
|
3396
|
40656
|
3397 CHECK_NUMBER (level);
|
272
|
3398
|
|
3399 for (i = 0; backlist && i < XINT (level); i++)
|
|
3400 {
|
|
3401 backlist = backlist->next;
|
|
3402 }
|
|
3403
|
|
3404 if (backlist)
|
485
|
3405 backlist->debug_on_exit = !NILP (flag);
|
272
|
3406
|
|
3407 return flag;
|
|
3408 }
|
|
3409
|
|
3410 DEFUN ("backtrace", Fbacktrace, Sbacktrace, 0, 0, "",
|
40570
|
3411 doc: /* Print a trace of Lisp function calls currently active.
|
|
3412 Output stream used is value of `standard-output'. */)
|
|
3413 ()
|
272
|
3414 {
|
|
3415 register struct backtrace *backlist = backtrace_list;
|
|
3416 register int i;
|
|
3417 Lisp_Object tail;
|
|
3418 Lisp_Object tem;
|
|
3419 extern Lisp_Object Vprint_level;
|
|
3420 struct gcpro gcpro1;
|
|
3421
|
9306
ac852c183fa1
(Feval, Ffuncall, funcall_lambda, Fbacktrace): Don't use XFASTINT as an
Karl Heuer <kwzh@gnu.org>
diff
changeset
|
3422 XSETFASTINT (Vprint_level, 3);
|
272
|
3423
|
|
3424 tail = Qnil;
|
|
3425 GCPRO1 (tail);
|
|
3426
|
|
3427 while (backlist)
|
|
3428 {
|
|
3429 write_string (backlist->debug_on_exit ? "* " : " ", 2);
|
|
3430 if (backlist->nargs == UNEVALLED)
|
|
3431 {
|
|
3432 Fprin1 (Fcons (*backlist->function, *backlist->args), Qnil);
|
7533
|
3433 write_string ("\n", -1);
|
272
|
3434 }
|
|
3435 else
|
|
3436 {
|
|
3437 tem = *backlist->function;
|
|
3438 Fprin1 (tem, Qnil); /* This can QUIT */
|
|
3439 write_string ("(", -1);
|
|
3440 if (backlist->nargs == MANY)
|
|
3441 {
|
|
3442 for (tail = *backlist->args, i = 0;
|
485
|
3443 !NILP (tail);
|
272
|
3444 tail = Fcdr (tail), i++)
|
|
3445 {
|
|
3446 if (i) write_string (" ", -1);
|
|
3447 Fprin1 (Fcar (tail), Qnil);
|
|
3448 }
|
|
3449 }
|
|
3450 else
|
|
3451 {
|
|
3452 for (i = 0; i < backlist->nargs; i++)
|
|
3453 {
|
|
3454 if (i) write_string (" ", -1);
|
|
3455 Fprin1 (backlist->args[i], Qnil);
|
|
3456 }
|
|
3457 }
|
7533
|
3458 write_string (")\n", -1);
|
272
|
3459 }
|
|
3460 backlist = backlist->next;
|
|
3461 }
|
|
3462
|
|
3463 Vprint_level = Qnil;
|
|
3464 UNGCPRO;
|
|
3465 return Qnil;
|
|
3466 }
|
|
3467
|
32657
|
3468 DEFUN ("backtrace-frame", Fbacktrace_frame, Sbacktrace_frame, 1, 1, NULL,
|
40570
|
3469 doc: /* Return the function and arguments NFRAMES up from current execution point.
|
|
3470 If that frame has not evaluated the arguments yet (or is a special form),
|
|
3471 the value is (nil FUNCTION ARG-FORMS...).
|
|
3472 If that frame has evaluated its arguments and called its function already,
|
|
3473 the value is (t FUNCTION ARG-VALUES...).
|
|
3474 A &rest arg is represented as the tail of the list ARG-VALUES.
|
|
3475 FUNCTION is whatever was supplied as car of evaluated list,
|
|
3476 or a lambda expression for macro calls.
|
|
3477 If NFRAMES is more than the number of frames, the value is nil. */)
|
|
3478 (nframes)
|
272
|
3479 Lisp_Object nframes;
|
|
3480 {
|
|
3481 register struct backtrace *backlist = backtrace_list;
|
|
3482 register int i;
|
|
3483 Lisp_Object tem;
|
|
3484
|
40656
|
3485 CHECK_NATNUM (nframes);
|
272
|
3486
|
|
3487 /* Find the frame requested. */
|
7533
|
3488 for (i = 0; backlist && i < XFASTINT (nframes); i++)
|
272
|
3489 backlist = backlist->next;
|
|
3490
|
|
3491 if (!backlist)
|
|
3492 return Qnil;
|
|
3493 if (backlist->nargs == UNEVALLED)
|
|
3494 return Fcons (Qnil, Fcons (*backlist->function, *backlist->args));
|
|
3495 else
|
|
3496 {
|
|
3497 if (backlist->nargs == MANY)
|
|
3498 tem = *backlist->args;
|
|
3499 else
|
|
3500 tem = Flist (backlist->nargs, backlist->args);
|
|
3501
|
|
3502 return Fcons (Qt, Fcons (*backlist->function, tem));
|
|
3503 }
|
|
3504 }
|
30073
|
3505
|
272
|
3506
|
21514
|
3507 void
|
55796
|
3508 mark_backtrace ()
|
|
3509 {
|
|
3510 register struct backtrace *backlist;
|
|
3511 register int i;
|
|
3512
|
|
3513 for (backlist = backtrace_list; backlist; backlist = backlist->next)
|
|
3514 {
|
|
3515 mark_object (*backlist->function);
|
|
3516
|
|
3517 if (backlist->nargs == UNEVALLED || backlist->nargs == MANY)
|
|
3518 i = 0;
|
|
3519 else
|
|
3520 i = backlist->nargs - 1;
|
|
3521 for (; i >= 0; i--)
|
|
3522 mark_object (backlist->args[i]);
|
|
3523 }
|
|
3524 }
|
|
3525
|
|
3526 void
|
272
|
3527 syms_of_eval ()
|
|
3528 {
|
|
3529 DEFVAR_INT ("max-specpdl-size", &max_specpdl_size,
|
64499
34bf5187c5aa
(Fprog2, Fcalled_interactively_p), (syms_of_eval) <debug-on-quit>: Doc fixes.
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
3530 doc: /* *Limit on number of Lisp variable bindings and `unwind-protect's.
|
63767
|
3531 If Lisp code tries to increase the total number past this amount,
|
45560
|
3532 an error is signaled.
|
|
3533 You can safely use a value considerably larger than the default value,
|
|
3534 if that proves inconveniently small. However, if you increase it too far,
|
|
3535 Emacs could run out of memory trying to make the stack bigger. */);
|
272
|
3536
|
|
3537 DEFVAR_INT ("max-lisp-eval-depth", &max_lisp_eval_depth,
|
40570
|
3538 doc: /* *Limit on depth in `eval', `apply' and `funcall' before error.
|
45560
|
3539
|
|
3540 This limit serves to catch infinite recursions for you before they cause
|
40570
|
3541 actual stack overflow in C, which would be fatal for Emacs.
|
|
3542 You can safely make it considerably larger than its default value,
|
45560
|
3543 if that proves inconveniently small. However, if you increase it too far,
|
|
3544 Emacs could overflow the real C stack, and crash. */);
|
272
|
3545
|
|
3546 DEFVAR_LISP ("quit-flag", &Vquit_flag,
|
40570
|
3547 doc: /* Non-nil causes `eval' to abort, unless `inhibit-quit' is non-nil.
|
58933
|
3548 If the value is t, that means do an ordinary quit.
|
|
3549 If the value equals `throw-on-input', that means quit by throwing
|
|
3550 to the tag specified in `throw-on-input'; it's for handling `while-no-input'.
|
|
3551 Typing C-g sets `quit-flag' to t, regardless of `inhibit-quit',
|
|
3552 but `inhibit-quit' non-nil prevents anything from taking notice of that. */);
|
272
|
3553 Vquit_flag = Qnil;
|
|
3554
|
|
3555 DEFVAR_LISP ("inhibit-quit", &Vinhibit_quit,
|
40570
|
3556 doc: /* Non-nil inhibits C-g quitting from happening immediately.
|
|
3557 Note that `quit-flag' will still be set by typing C-g,
|
|
3558 so a quit will be signaled as soon as `inhibit-quit' is nil.
|
|
3559 To prevent this happening, set `quit-flag' to nil
|
|
3560 before making `inhibit-quit' nil. */);
|
272
|
3561 Vinhibit_quit = Qnil;
|
|
3562
|
381
|
3563 Qinhibit_quit = intern ("inhibit-quit");
|
|
3564 staticpro (&Qinhibit_quit);
|
|
3565
|
272
|
3566 Qautoload = intern ("autoload");
|
|
3567 staticpro (&Qautoload);
|
|
3568
|
|
3569 Qdebug_on_error = intern ("debug-on-error");
|
|
3570 staticpro (&Qdebug_on_error);
|
|
3571
|
|
3572 Qmacro = intern ("macro");
|
|
3573 staticpro (&Qmacro);
|
|
3574
|
44132
|
3575 Qdeclare = intern ("declare");
|
|
3576 staticpro (&Qdeclare);
|
49600
|
3577
|
272
|
3578 /* Note that the process handling also uses Qexit, but we don't want
|
|
3579 to staticpro it twice, so we just do it here. */
|
|
3580 Qexit = intern ("exit");
|
|
3581 staticpro (&Qexit);
|
|
3582
|
|
3583 Qinteractive = intern ("interactive");
|
|
3584 staticpro (&Qinteractive);
|
|
3585
|
|
3586 Qcommandp = intern ("commandp");
|
|
3587 staticpro (&Qcommandp);
|
|
3588
|
|
3589 Qdefun = intern ("defun");
|
|
3590 staticpro (&Qdefun);
|
|
3591
|
|
3592 Qand_rest = intern ("&rest");
|
|
3593 staticpro (&Qand_rest);
|
|
3594
|
|
3595 Qand_optional = intern ("&optional");
|
|
3596 staticpro (&Qand_optional);
|
|
3597
|
78141
|
3598 Qdebug = intern ("debug");
|
|
3599 staticpro (&Qdebug);
|
|
3600
|
684
|
3601 DEFVAR_LISP ("stack-trace-on-error", &Vstack_trace_on_error,
|
41029
|
3602 doc: /* *Non-nil means errors display a backtrace buffer.
|
|
3603 More precisely, this happens for any error that is handled
|
|
3604 by the editor command loop.
|
40570
|
3605 If the value is a list, an error only means to display a backtrace
|
|
3606 if one of its condition symbols appears in the list. */);
|
684
|
3607 Vstack_trace_on_error = Qnil;
|
272
|
3608
|
684
|
3609 DEFVAR_LISP ("debug-on-error", &Vdebug_on_error,
|
40570
|
3610 doc: /* *Non-nil means enter debugger if an error is signaled.
|
|
3611 Does not apply to errors handled by `condition-case' or those
|
|
3612 matched by `debug-ignored-errors'.
|
|
3613 If the value is a list, an error only means to enter the debugger
|
|
3614 if one of its condition symbols appears in the list.
|
|
3615 When you evaluate an expression interactively, this variable
|
|
3616 is temporarily non-nil if `eval-expression-debug-on-error' is non-nil.
|
|
3617 See also variable `debug-on-quit'. */);
|
684
|
3618 Vdebug_on_error = Qnil;
|
272
|
3619
|
13768
|
3620 DEFVAR_LISP ("debug-ignored-errors", &Vdebug_ignored_errors,
|
40570
|
3621 doc: /* *List of errors for which the debugger should not be called.
|
|
3622 Each element may be a condition-name or a regexp that matches error messages.
|
|
3623 If any element applies to a given error, that error skips the debugger
|
|
3624 and just returns to top level.
|
|
3625 This overrides the variable `debug-on-error'.
|
|
3626 It does not apply to errors handled by `condition-case'. */);
|
13768
|
3627 Vdebug_ignored_errors = Qnil;
|
|
3628
|
272
|
3629 DEFVAR_BOOL ("debug-on-quit", &debug_on_quit,
|
64499
34bf5187c5aa
(Fprog2, Fcalled_interactively_p), (syms_of_eval) <debug-on-quit>: Doc fixes.
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
3630 doc: /* *Non-nil means enter debugger if quit is signaled (C-g, for example).
|
34bf5187c5aa
(Fprog2, Fcalled_interactively_p), (syms_of_eval) <debug-on-quit>: Doc fixes.
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
3631 Does not apply if quit is handled by a `condition-case'. */);
|
272
|
3632 debug_on_quit = 0;
|
|
3633
|
|
3634 DEFVAR_BOOL ("debug-on-next-call", &debug_on_next_call,
|
40570
|
3635 doc: /* Non-nil means enter debugger before next `eval', `apply' or `funcall'. */);
|
272
|
3636
|
26947
|
3637 DEFVAR_BOOL ("debugger-may-continue", &debugger_may_continue,
|
40570
|
3638 doc: /* Non-nil means debugger may continue execution.
|
|
3639 This is nil when the debugger is called under circumstances where it
|
|
3640 might not be safe to continue. */);
|
27031
|
3641 debugger_may_continue = 1;
|
26947
|
3642
|
272
|
3643 DEFVAR_LISP ("debugger", &Vdebugger,
|
40570
|
3644 doc: /* Function to call to invoke debugger.
|
|
3645 If due to frame exit, args are `exit' and the value being returned;
|
|
3646 this function's value will be returned instead of that.
|
|
3647 If due to error, args are `error' and a list of the args to `signal'.
|
|
3648 If due to `apply' or `funcall' entry, one arg, `lambda'.
|
|
3649 If due to `eval' entry, one arg, t. */);
|
272
|
3650 Vdebugger = Qnil;
|
|
3651
|
16355
|
3652 DEFVAR_LISP ("signal-hook-function", &Vsignal_hook_function,
|
40570
|
3653 doc: /* If non-nil, this is a function for `signal' to call.
|
|
3654 It receives the same arguments that `signal' was given.
|
|
3655 The Edebug package uses this to regain control. */);
|
16355
|
3656 Vsignal_hook_function = Qnil;
|
|
3657
|
16443
|
3658 DEFVAR_LISP ("debug-on-signal", &Vdebug_on_signal,
|
40570
|
3659 doc: /* *Non-nil means call the debugger regardless of condition handlers.
|
|
3660 Note that `debug-on-error', `debug-on-quit' and friends
|
|
3661 still determine whether to handle the particular condition. */);
|
16443
|
3662 Vdebug_on_signal = Qnil;
|
16355
|
3663
|
44132
|
3664 DEFVAR_LISP ("macro-declaration-function", &Vmacro_declaration_function,
|
|
3665 doc: /* Function to process declarations in a macro definition.
|
|
3666 The function will be called with two args MACRO and DECL.
|
|
3667 MACRO is the name of the macro being defined.
|
|
3668 DECL is a list `(declare ...)' containing the declarations.
|
|
3669 The value the function returns is not used. */);
|
|
3670 Vmacro_declaration_function = Qnil;
|
|
3671
|
16296
|
3672 Vrun_hooks = intern ("run-hooks");
|
|
3673 staticpro (&Vrun_hooks);
|
272
|
3674
|
|
3675 staticpro (&Vautoload_queue);
|
|
3676 Vautoload_queue = Qnil;
|
30073
|
3677 staticpro (&Vsignaling_function);
|
|
3678 Vsignaling_function = Qnil;
|
272
|
3679
|
|
3680 defsubr (&Sor);
|
|
3681 defsubr (&Sand);
|
|
3682 defsubr (&Sif);
|
|
3683 defsubr (&Scond);
|
|
3684 defsubr (&Sprogn);
|
|
3685 defsubr (&Sprog1);
|
|
3686 defsubr (&Sprog2);
|
|
3687 defsubr (&Ssetq);
|
|
3688 defsubr (&Squote);
|
|
3689 defsubr (&Sfunction);
|
|
3690 defsubr (&Sdefun);
|
|
3691 defsubr (&Sdefmacro);
|
|
3692 defsubr (&Sdefvar);
|
39577
|
3693 defsubr (&Sdefvaralias);
|
272
|
3694 defsubr (&Sdefconst);
|
|
3695 defsubr (&Suser_variable_p);
|
|
3696 defsubr (&Slet);
|
|
3697 defsubr (&SletX);
|
|
3698 defsubr (&Swhile);
|
|
3699 defsubr (&Smacroexpand);
|
|
3700 defsubr (&Scatch);
|
|
3701 defsubr (&Sthrow);
|
|
3702 defsubr (&Sunwind_protect);
|
|
3703 defsubr (&Scondition_case);
|
|
3704 defsubr (&Ssignal);
|
|
3705 defsubr (&Sinteractive_p);
|
57889
|
3706 defsubr (&Scalled_interactively_p);
|
272
|
3707 defsubr (&Scommandp);
|
|
3708 defsubr (&Sautoload);
|
|
3709 defsubr (&Seval);
|
|
3710 defsubr (&Sapply);
|
12732
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
3711 defsubr (&Sfuncall);
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
3712 defsubr (&Srun_hooks);
|
12711
|
3713 defsubr (&Srun_hook_with_args);
|
12732
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
3714 defsubr (&Srun_hook_with_args_until_success);
|
981b924c832b
Add Frun_hooks, Frun_hook_with_args, Frun_hook_with_args_until_success, Frun_hook_with_args_until_failure in terms of run_hook_with_args.
Simon Marshall <simon@gnu.org>
diff
changeset
|
3715 defsubr (&Srun_hook_with_args_until_failure);
|
11205
|
3716 defsubr (&Sfetch_bytecode);
|
272
|
3717 defsubr (&Sbacktrace_debug);
|
|
3718 defsubr (&Sbacktrace);
|
|
3719 defsubr (&Sbacktrace_frame);
|
|
3720 }
|
52401
|
3721
|
|
3722 /* arch-tag: 014a07aa-33ab-4a8f-a3d2-ee8a4a9ff7fb
|
|
3723 (do not change this comment) */
|