1 /* Call a Lisp function interactively.
2 Copyright (C) 1985, 1986, 1993, 1994, 1995, 1997, 2000, 2001, 2002,
3 2003, 2004, 2005, 2006, 2007 Free Software Foundation, Inc.
5 This file is part of GNU Emacs.
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
9 the Free Software Foundation; either version 3, or (at your option)
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.
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
19 the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
20 Boston, MA 02110-1301, USA. */
33 extern char *index
P_ ((const char *, int));
36 extern Lisp_Object Qcursor_in_echo_area
;
37 extern Lisp_Object Qfile_directory_p
;
39 Lisp_Object Vcurrent_prefix_arg
, Qminus
, Qplus
;
40 Lisp_Object Qcall_interactively
;
41 Lisp_Object Vcommand_history
;
43 extern Lisp_Object Vhistory_length
;
44 extern Lisp_Object Vthis_original_command
, real_this_command
;
46 Lisp_Object Vcommand_debug_status
, Qcommand_debug_status
;
47 Lisp_Object Qenable_recursive_minibuffers
;
49 /* Non-nil means treat the mark as active
50 even if mark_active is 0. */
51 Lisp_Object Vmark_even_if_inactive
;
53 Lisp_Object Vmouse_leave_buffer_hook
, Qmouse_leave_buffer_hook
;
55 Lisp_Object Qlist
, Qlet
, Qletx
, Qsave_excursion
, Qprogn
, Qif
, Qwhen
;
56 static Lisp_Object preserved_fns
;
58 /* Marker used within call-interactively to refer to point. */
59 static Lisp_Object point_marker
;
61 /* String for the prompt text used in Fcall_interactively. */
62 static Lisp_Object callint_message
;
65 DEFUN ("interactive", Finteractive
, Sinteractive
, 0, UNEVALLED
, 0,
66 doc
: /* Specify a way of parsing arguments for interactive use of a function.
68 (defun foo (arg) "Doc string" (interactive "p") ...use arg...)
69 to make ARG be the prefix argument when `foo' is called as a command.
70 The "call" to `interactive' is actually a declaration rather than a function;
71 it tells `call-interactively' how to read arguments
72 to pass to the function.
73 When actually called, `interactive' just returns nil.
75 The argument of `interactive' is usually a string containing a code letter
76 followed by a prompt. (Some code letters do not use I/O to get
77 the argument and do not need prompts.) To prompt for multiple arguments,
78 give a code letter, its prompt, a newline, and another code letter, etc.
79 Prompts are passed to format, and may use % escapes to print the
80 arguments that have already been read.
81 If the argument is not a string, it is evaluated to get a list of
82 arguments to pass to the function.
83 Just `(interactive)' means pass no args when calling interactively.
85 Code letters available are:
86 a -- Function name: symbol with a function definition.
87 b -- Name of existing buffer.
88 B -- Name of buffer, possibly nonexistent.
89 c -- Character (no input method is used).
90 C -- Command name: symbol with interactive function definition.
91 d -- Value of point as number. Does not do I/O.
93 e -- Parametrized event (i.e., one that's a list) that invoked this command.
94 If used more than once, the Nth `e' returns the Nth parameterized event.
95 This skips events that are integers or symbols.
96 f -- Existing file name.
97 F -- Possibly nonexistent file name.
98 G -- Possibly nonexistent file name, defaulting to just directory name.
99 i -- Ignored, i.e. always nil. Does not do I/O.
100 k -- Key sequence (downcase the last event if needed to get a definition).
101 K -- Key sequence to be redefined (do not downcase the last event).
102 m -- Value of mark as number. Does not do I/O.
103 M -- Any string. Inherits the current input method.
104 n -- Number read using minibuffer.
105 N -- Numeric prefix arg, or if none, do like code `n'.
106 p -- Prefix arg converted to number. Does not do I/O.
107 P -- Prefix arg in raw form. Does not do I/O.
108 r -- Region: point and mark as 2 numeric args, smallest first. Does no I/O.
109 s -- Any string. Does not inherit the current input method.
111 U -- Mouse up event discarded by a previous k or K argument.
112 v -- Variable name: symbol that is user-variable-p.
113 x -- Lisp expression read but not evaluated.
114 X -- Lisp expression read and evaluated.
116 Z -- Coding system, nil if no prefix arg.
117 In addition, if the string begins with `*'
118 then an error is signaled if the buffer is read-only.
119 This happens before reading any arguments.
120 If the string begins with `@', then Emacs searches the key sequence
121 which invoked the command for its first mouse click (or any other
122 event which specifies a window), and selects that window before
123 reading any arguments. You may use both `@' and `*'; they are
124 processed in the order that they appear.
125 usage: (interactive ARGS) */)
132 /* Quotify EXP: if EXP is constant, return it.
133 If EXP is not constant, return (quote EXP). */
136 register Lisp_Object exp
;
138 if (!INTEGERP (exp
) && !STRINGP (exp
)
139 && !NILP (exp
) && !EQ (exp
, Qt
))
140 return Fcons (Qquote
, Fcons (exp
, Qnil
));
145 /* Modify EXP by quotifying each element (except the first). */
150 register Lisp_Object tail
;
152 for (tail
= exp
; CONSP (tail
); tail
= next
)
155 XSETCAR (tail
, quotify_arg (XCAR (tail
)));
160 char *callint_argfuns
[]
161 = {"", "point", "mark", "region-beginning", "region-end"};
164 check_mark (for_region
)
168 tem
= Fmarker_buffer (current_buffer
->mark
);
169 if (NILP (tem
) || (XBUFFER (tem
) != current_buffer
))
170 error (for_region
? "The mark is not set now, so there is no region"
171 : "The mark is not set now");
172 if (!NILP (Vtransient_mark_mode
) && NILP (Vmark_even_if_inactive
)
173 && NILP (current_buffer
->mark_active
))
174 xsignal0 (Qmark_inactive
);
177 /* If the list of args INPUT was produced with an explicit call to
178 `list', look for elements that were computed with
179 (region-beginning) or (region-end), and put those expressions into
180 VALUES instead of the present values.
182 This function doesn't return a value because it modifies elements
183 of VALUES to do its job. */
186 fix_command (input
, values
)
187 Lisp_Object input
, values
;
194 /* Skip through certain special forms. */
195 while (EQ (car
, Qlet
) || EQ (car
, Qletx
)
196 || EQ (car
, Qsave_excursion
)
199 while (CONSP (XCDR (input
)))
200 input
= XCDR (input
);
201 input
= XCAR (input
);
208 Lisp_Object intail
, valtail
;
209 for (intail
= Fcdr (input
), valtail
= values
;
211 intail
= Fcdr (intail
), valtail
= XCDR (valtail
))
217 Lisp_Object presflag
, carelt
;
219 /* If it is (if X Y), look at Y. */
221 && EQ (Fnthcdr (make_number (3), elt
), Qnil
))
222 elt
= Fnth (make_number (2), elt
);
223 /* If it is (when ... Y), look at Y. */
224 else if (EQ (carelt
, Qwhen
))
226 while (CONSP (XCDR (elt
)))
231 /* If the function call we're looking at
232 is a special preserved one, copy the
233 whole expression for this argument. */
236 presflag
= Fmemq (Fcar (elt
), preserved_fns
);
237 if (!NILP (presflag
))
238 Fsetcar (valtail
, Fcar (intail
));
246 DEFUN ("call-interactively", Fcall_interactively
, Scall_interactively
, 1, 3, 0,
247 doc
: /* Call FUNCTION, reading args according to its interactive calling specs.
248 Return the value FUNCTION returns.
249 The function contains a specification of how to do the argument reading.
250 In the case of user-defined functions, this is specified by placing a call
251 to the function `interactive' at the top level of the function body.
254 Optional second arg RECORD-FLAG non-nil
255 means unconditionally put this command in the command-history.
256 Otherwise, this is done only if an arg is read using the minibuffer.
258 Optional third arg KEYS, if given, specifies the sequence of events to
259 supply, as a vector, if the command inquires which events were used to
260 invoke it. If KEYS is omitted or nil, the return value of
261 `this-command-keys-vector' is used. */)
262 (function
, record_flag
, keys
)
263 Lisp_Object function
, record_flag
, keys
;
265 Lisp_Object
*args
, *visargs
;
268 Lisp_Object filter_specs
;
270 Lisp_Object up_event
;
272 int speccount
= SPECPDL_INDEX ();
274 /* The index of the next element of this_command_keys to examine for
275 the 'e' interactive code. */
278 Lisp_Object prefix_arg
;
279 unsigned char *string
;
282 /* If varies[i] > 0, the i'th argument shouldn't just have its value
283 in this call quoted in the command history. It should be
284 recorded as a call to the function named callint_argfuns[varies[i]]. */
291 int arg_from_tty
= 0;
292 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
, gcpro5
;
294 int record_then_fail
= 0;
296 Lisp_Object save_this_command
, save_last_command
;
297 Lisp_Object save_this_original_command
, save_real_this_command
;
299 save_this_command
= Vthis_command
;
300 save_this_original_command
= Vthis_original_command
;
301 save_real_this_command
= real_this_command
;
302 save_last_command
= current_kboard
->Vlast_command
;
305 keys
= this_command_keys
, key_count
= this_command_key_count
;
309 key_count
= XVECTOR (keys
)->size
;
312 /* Save this now, since use of minibuffer will clobber it. */
313 prefix_arg
= Vcurrent_prefix_arg
;
315 if (SYMBOLP (function
))
316 enable
= Fget (function
, Qenable_recursive_minibuffers
);
320 fun
= indirect_function (function
);
324 /* The idea of FILTER_SPECS is to provide away to
325 specify how to represent the arguments in command history.
326 The feature is not fully implemented. */
329 /* If k or K discard an up-event, save it here so it can be retrieved with U */
332 /* Decode the kind of function. Either handle it and return,
333 or go to `lose' if not interactive, or set either STRING or SPECS. */
337 GCPRO2 (function
, prefix_arg
);
338 form
= Finteractive_form (function
);
341 specs
= filter_specs
= Fcar (XCDR (form
));
343 wrong_type_argument (Qcommandp
, function
);
346 /* If either SPECS or STRING is set to a string, use it. */
349 /* Make a copy of string so that if a GC relocates specs,
350 `string' will still be valid. */
351 string
= (unsigned char *) alloca (SBYTES (specs
) + 1);
352 bcopy (SDATA (specs
), string
,
358 i
= num_input_events
;
360 /* Compute the arg values using the user's expression. */
361 GCPRO2 (input
, filter_specs
);
362 specs
= Feval (specs
);
364 if (i
!= num_input_events
|| !NILP (record_flag
))
366 /* We should record this command on the command history. */
368 /* Make a copy of the list of values, for the command history,
369 and turn them into things we can eval. */
370 values
= quotify_args (Fcopy_sequence (specs
));
371 fix_command (input
, values
);
373 = Fcons (Fcons (function
, values
), Vcommand_history
);
375 /* Don't keep command history around forever. */
376 if (INTEGERP (Vhistory_length
) && XINT (Vhistory_length
) > 0)
378 teml
= Fnthcdr (Vhistory_length
, Vcommand_history
);
380 XSETCDR (teml
, Qnil
);
384 Vthis_command
= save_this_command
;
385 Vthis_original_command
= save_this_original_command
;
386 real_this_command
= save_real_this_command
;
387 current_kboard
->Vlast_command
= save_last_command
;
389 temporarily_switch_to_single_kboard (NULL
);
390 return unbind_to (speccount
, apply1 (function
, specs
));
393 /* Here if function specifies a string to control parsing the defaults */
395 /* Set next_event to point to the first event with parameters. */
396 for (next_event
= 0; next_event
< key_count
; next_event
++)
397 if (EVENT_HAS_PARAMETERS (XVECTOR (keys
)->contents
[next_event
]))
400 /* Handle special starting chars `*' and `@'. Also `-'. */
401 /* Note that `+' is reserved for user extensions. */
405 error ("`+' is not used in `interactive' for ordinary commands");
406 else if (*string
== '*')
409 if (!NILP (current_buffer
->read_only
))
411 if (!NILP (record_flag
))
413 unsigned char *p
= string
;
416 if (! (*p
== 'r' || *p
== 'p' || *p
== 'P'
418 Fbarf_if_buffer_read_only ();
421 record_then_fail
= 1;
424 Fbarf_if_buffer_read_only ();
427 /* Ignore this for semi-compatibility with Lucid. */
428 else if (*string
== '-')
430 else if (*string
== '@')
432 Lisp_Object event
, tem
;
434 event
= (next_event
< key_count
435 ? XVECTOR (keys
)->contents
[next_event
]
437 if (EVENT_HAS_PARAMETERS (event
)
438 && (tem
= XCDR (event
), CONSP (tem
))
439 && (tem
= XCAR (tem
), CONSP (tem
))
440 && (tem
= XCAR (tem
), WINDOWP (tem
)))
442 if (MINI_WINDOW_P (XWINDOW (tem
))
443 && ! (minibuf_level
> 0 && EQ (tem
, minibuf_window
)))
444 error ("Attempt to select inactive minibuffer window");
446 /* If the current buffer wants to clean up, let it. */
447 if (!NILP (Vmouse_leave_buffer_hook
))
448 call1 (Vrun_hooks
, Qmouse_leave_buffer_hook
);
450 Fselect_window (tem
, Qnil
);
457 /* Count the number of arguments the interactive spec would have
458 us give to the function. */
462 /* 'r' specifications ("point and mark as 2 numeric args")
463 produce *two* arguments. */
468 tem
= (unsigned char *) index (tem
, '\n');
476 args
= (Lisp_Object
*) alloca ((count
+ 1) * sizeof (Lisp_Object
));
477 visargs
= (Lisp_Object
*) alloca ((count
+ 1) * sizeof (Lisp_Object
));
478 varies
= (int *) alloca ((count
+ 1) * sizeof (int));
480 for (i
= 0; i
< (count
+ 1); i
++)
487 GCPRO5 (prefix_arg
, function
, *args
, *visargs
, up_event
);
488 gcpro3
.nvars
= (count
+ 1);
489 gcpro4
.nvars
= (count
+ 1);
492 specbind (Qenable_recursive_minibuffers
, Qt
);
495 for (i
= 1; *tem
; i
++)
497 strncpy (prompt1
, tem
+ 1, sizeof prompt1
- 1);
498 prompt1
[sizeof prompt1
- 1] = 0;
499 tem1
= (char *) index (prompt1
, '\n');
502 visargs
[0] = build_string (prompt1
);
503 if (index (prompt1
, '%'))
504 callint_message
= Fformat (i
, visargs
);
506 callint_message
= visargs
[0];
510 case 'a': /* Symbol defined as a function */
511 visargs
[i
] = Fcompleting_read (callint_message
,
512 Vobarray
, Qfboundp
, Qt
,
513 Qnil
, Qnil
, Qnil
, Qnil
);
514 /* Passing args[i] directly stimulates compiler bug */
516 args
[i
] = Fintern (teml
, Qnil
);
519 case 'b': /* Name of existing buffer */
520 args
[i
] = Fcurrent_buffer ();
521 if (EQ (selected_window
, minibuf_window
))
522 args
[i
] = Fother_buffer (args
[i
], Qnil
, Qnil
);
523 args
[i
] = Fread_buffer (callint_message
, args
[i
], Qt
);
526 case 'B': /* Name of buffer, possibly nonexistent */
527 args
[i
] = Fread_buffer (callint_message
,
528 Fother_buffer (Fcurrent_buffer (), Qnil
, Qnil
),
532 case 'c': /* Character */
533 args
[i
] = Fread_char (callint_message
, Qnil
, Qnil
);
534 message1_nolog ((char *) 0);
535 /* Passing args[i] directly stimulates compiler bug */
537 visargs
[i
] = Fchar_to_string (teml
);
540 case 'C': /* Command: symbol with interactive function */
541 visargs
[i
] = Fcompleting_read (callint_message
,
543 Qt
, Qnil
, Qnil
, Qnil
, Qnil
);
544 /* Passing args[i] directly stimulates compiler bug */
546 args
[i
] = Fintern (teml
, Qnil
);
549 case 'd': /* Value of point. Does not do I/O. */
550 set_marker_both (point_marker
, Qnil
, PT
, PT_BYTE
);
551 args
[i
] = point_marker
;
552 /* visargs[i] = Qnil; */
556 case 'D': /* Directory name. */
557 args
[i
] = Fread_file_name (callint_message
, Qnil
,
558 current_buffer
->directory
, Qlambda
, Qnil
,
562 case 'f': /* Existing file name. */
563 args
[i
] = Fread_file_name (callint_message
,
564 Qnil
, Qnil
, Qlambda
, Qnil
, Qnil
);
567 case 'F': /* Possibly nonexistent file name. */
568 args
[i
] = Fread_file_name (callint_message
,
569 Qnil
, Qnil
, Qnil
, Qnil
, Qnil
);
572 case 'G': /* Possibly nonexistent file name,
573 default to directory alone. */
574 args
[i
] = Fread_file_name (callint_message
,
575 Qnil
, Qnil
, Qnil
, empty_unibyte_string
, Qnil
);
578 case 'i': /* Ignore an argument -- Does not do I/O */
582 case 'k': /* Key sequence. */
584 int speccount1
= SPECPDL_INDEX ();
585 specbind (Qcursor_in_echo_area
, Qt
);
586 args
[i
] = Fread_key_sequence (callint_message
,
587 Qnil
, Qnil
, Qnil
, Qnil
);
588 unbind_to (speccount1
, Qnil
);
590 visargs
[i
] = Fkey_description (teml
, Qnil
);
592 /* If the key sequence ends with a down-event,
593 discard the following up-event. */
594 teml
= Faref (args
[i
], make_number (XINT (Flength (args
[i
])) - 1));
601 teml
= Fget (teml
, intern ("event-symbol-elements"));
602 /* Ignore first element, which is the base key. */
603 tem2
= Fmemq (intern ("down"), Fcdr (teml
));
605 up_event
= Fread_event (Qnil
, Qnil
, Qnil
);
610 case 'K': /* Key sequence to be defined. */
612 int speccount1
= SPECPDL_INDEX ();
613 specbind (Qcursor_in_echo_area
, Qt
);
614 args
[i
] = Fread_key_sequence (callint_message
,
615 Qnil
, Qt
, Qnil
, Qnil
);
617 visargs
[i
] = Fkey_description (teml
, Qnil
);
618 unbind_to (speccount1
, Qnil
);
620 /* If the key sequence ends with a down-event,
621 discard the following up-event. */
622 teml
= Faref (args
[i
], make_number (XINT (Flength (args
[i
])) - 1));
629 teml
= Fget (teml
, intern ("event-symbol-elements"));
630 /* Ignore first element, which is the base key. */
631 tem2
= Fmemq (intern ("down"), Fcdr (teml
));
633 up_event
= Fread_event (Qnil
, Qnil
, Qnil
);
638 case 'U': /* Up event from last k or K */
639 if (!NILP (up_event
))
641 args
[i
] = Fmake_vector (make_number (1), up_event
);
644 visargs
[i
] = Fkey_description (teml
, Qnil
);
648 case 'e': /* The invoking event. */
649 if (next_event
>= key_count
)
650 error ("%s must be bound to an event with parameters",
652 ? (char *) SDATA (SYMBOL_NAME (function
))
654 args
[i
] = XVECTOR (keys
)->contents
[next_event
++];
657 /* Find the next parameterized event. */
658 while (next_event
< key_count
659 && ! (EVENT_HAS_PARAMETERS
660 (XVECTOR (keys
)->contents
[next_event
])))
665 case 'm': /* Value of mark. Does not do I/O. */
667 /* visargs[i] = Qnil; */
668 args
[i
] = current_buffer
->mark
;
672 case 'M': /* String read via minibuffer with
673 inheriting the current input method. */
674 args
[i
] = Fread_string (callint_message
,
675 Qnil
, Qnil
, Qnil
, Qt
);
678 case 'N': /* Prefix arg as number, else number from minibuffer */
679 if (!NILP (prefix_arg
))
680 goto have_prefix_arg
;
681 case 'n': /* Read number from minibuffer. */
689 message ("Please enter a number.");
690 sit_for (make_number (1), 0, 0);
694 tem
= Fread_from_minibuffer (callint_message
,
695 Qnil
, Qnil
, Qnil
, Qnil
, Qnil
,
697 if (! STRINGP (tem
) || SCHARS (tem
) == 0)
700 args
[i
] = Fread (tem
);
702 while (! NUMBERP (args
[i
]));
704 visargs
[i
] = args
[i
];
707 case 'P': /* Prefix arg in raw form. Does no I/O. */
708 args
[i
] = prefix_arg
;
709 /* visargs[i] = Qnil; */
713 case 'p': /* Prefix arg converted to number. No I/O. */
715 args
[i
] = Fprefix_numeric_value (prefix_arg
);
716 /* visargs[i] = Qnil; */
720 case 'r': /* Region, point and mark as 2 args. */
722 set_marker_both (point_marker
, Qnil
, PT
, PT_BYTE
);
723 /* visargs[i+1] = Qnil; */
724 foo
= marker_position (current_buffer
->mark
);
725 /* visargs[i] = Qnil; */
726 args
[i
] = PT
< foo
? point_marker
: current_buffer
->mark
;
728 args
[++i
] = PT
> foo
? point_marker
: current_buffer
->mark
;
732 case 's': /* String read via minibuffer without
733 inheriting the current input method. */
734 args
[i
] = Fread_string (callint_message
,
735 Qnil
, Qnil
, Qnil
, Qnil
);
738 case 'S': /* Any symbol. */
739 visargs
[i
] = Fread_string (callint_message
,
740 Qnil
, Qnil
, Qnil
, Qnil
);
741 /* Passing args[i] directly stimulates compiler bug */
743 args
[i
] = Fintern (teml
, Qnil
);
746 case 'v': /* Variable name: symbol that is
748 args
[i
] = Fread_variable (callint_message
, Qnil
);
749 visargs
[i
] = last_minibuf_string
;
752 case 'x': /* Lisp expression read but not evaluated */
753 args
[i
] = Fread_minibuffer (callint_message
, Qnil
);
754 visargs
[i
] = last_minibuf_string
;
757 case 'X': /* Lisp expression read and evaluated */
758 args
[i
] = Feval_minibuffer (callint_message
, Qnil
);
759 visargs
[i
] = last_minibuf_string
;
762 case 'Z': /* Coding-system symbol, or ignore the
763 argument if no prefix */
764 if (NILP (prefix_arg
))
772 = Fread_non_nil_coding_system (callint_message
);
773 visargs
[i
] = last_minibuf_string
;
777 case 'z': /* Coding-system symbol or nil */
778 args
[i
] = Fread_coding_system (callint_message
, Qnil
);
779 visargs
[i
] = last_minibuf_string
;
782 /* We have a case for `+' so we get an error
783 if anyone tries to define one here. */
786 error ("Invalid control letter `%c' (%03o) in interactive calling string",
793 if (NILP (visargs
[i
]) && STRINGP (args
[i
]))
794 visargs
[i
] = args
[i
];
796 tem
= (unsigned char *) index (tem
, '\n');
798 else tem
= (unsigned char *) "";
800 unbind_to (speccount
, Qnil
);
806 if (arg_from_tty
|| !NILP (record_flag
))
808 visargs
[0] = function
;
809 for (i
= 1; i
< count
+ 1; i
++)
812 visargs
[i
] = Fcons (intern (callint_argfuns
[varies
[i
]]), Qnil
);
814 visargs
[i
] = quotify_arg (args
[i
]);
816 Vcommand_history
= Fcons (Flist (count
+ 1, visargs
),
818 /* Don't keep command history around forever. */
819 if (INTEGERP (Vhistory_length
) && XINT (Vhistory_length
) > 0)
821 teml
= Fnthcdr (Vhistory_length
, Vcommand_history
);
823 XSETCDR (teml
, Qnil
);
827 /* If we used a marker to hold point, mark, or an end of the region,
828 temporarily, convert it to an integer now. */
829 for (i
= 1; i
<= count
; i
++)
830 if (varies
[i
] >= 1 && varies
[i
] <= 4)
831 XSETINT (args
[i
], marker_position (args
[i
]));
833 if (record_then_fail
)
834 Fbarf_if_buffer_read_only ();
836 Vthis_command
= save_this_command
;
837 Vthis_original_command
= save_this_original_command
;
838 real_this_command
= save_real_this_command
;
839 current_kboard
->Vlast_command
= save_last_command
;
843 specbind (Qcommand_debug_status
, Qnil
);
845 temporarily_switch_to_single_kboard (NULL
);
846 val
= Ffuncall (count
+ 1, args
);
848 return unbind_to (speccount
, val
);
852 DEFUN ("prefix-numeric-value", Fprefix_numeric_value
, Sprefix_numeric_value
,
854 doc
: /* Return numeric meaning of raw prefix argument RAW.
855 A raw prefix argument is what you get from `(interactive "P")'.
856 Its numeric meaning is what you would get from `(interactive "p")'. */)
863 XSETFASTINT (val
, 1);
864 else if (EQ (raw
, Qminus
))
866 else if (CONSP (raw
) && INTEGERP (XCAR (raw
)))
867 XSETINT (val
, XINT (XCAR (raw
)));
868 else if (INTEGERP (raw
))
871 XSETFASTINT (val
, 1);
879 point_marker
= Fmake_marker ();
880 staticpro (&point_marker
);
882 callint_message
= Qnil
;
883 staticpro (&callint_message
);
885 preserved_fns
= Fcons (intern ("region-beginning"),
886 Fcons (intern ("region-end"),
887 Fcons (intern ("point"),
888 Fcons (intern ("mark"), Qnil
))));
889 staticpro (&preserved_fns
);
891 Qlist
= intern ("list");
893 Qlet
= intern ("let");
897 Qwhen
= intern ("when");
899 Qletx
= intern ("let*");
901 Qsave_excursion
= intern ("save-excursion");
902 staticpro (&Qsave_excursion
);
903 Qprogn
= intern ("progn");
906 Qminus
= intern ("-");
909 Qplus
= intern ("+");
912 Qcall_interactively
= intern ("call-interactively");
913 staticpro (&Qcall_interactively
);
915 Qcommand_debug_status
= intern ("command-debug-status");
916 staticpro (&Qcommand_debug_status
);
918 Qenable_recursive_minibuffers
= intern ("enable-recursive-minibuffers");
919 staticpro (&Qenable_recursive_minibuffers
);
921 Qmouse_leave_buffer_hook
= intern ("mouse-leave-buffer-hook");
922 staticpro (&Qmouse_leave_buffer_hook
);
924 DEFVAR_KBOARD ("prefix-arg", Vprefix_arg
,
925 doc
: /* The value of the prefix argument for the next editing command.
926 It may be a number, or the symbol `-' for just a minus sign as arg,
927 or a list whose car is a number for just one or more C-u's
928 or nil if no argument has been specified.
930 You cannot examine this variable to find the argument for this command
931 since it has been set to nil by the time you can look.
932 Instead, you should use the variable `current-prefix-arg', although
933 normally commands can get this prefix argument with (interactive "P"). */);
935 DEFVAR_KBOARD ("last-prefix-arg", Vlast_prefix_arg
,
936 doc
: /* The value of the prefix argument for the previous editing command.
937 See `prefix-arg' for the meaning of the value. */);
939 DEFVAR_LISP ("current-prefix-arg", &Vcurrent_prefix_arg
,
940 doc
: /* The value of the prefix argument for this editing command.
941 It may be a number, or the symbol `-' for just a minus sign as arg,
942 or a list whose car is a number for just one or more C-u's
943 or nil if no argument has been specified.
944 This is what `(interactive \"P\")' returns. */);
945 Vcurrent_prefix_arg
= Qnil
;
947 DEFVAR_LISP ("command-history", &Vcommand_history
,
948 doc
: /* List of recent commands that read arguments from terminal.
949 Each command is represented as a form to evaluate. */);
950 Vcommand_history
= Qnil
;
952 DEFVAR_LISP ("command-debug-status", &Vcommand_debug_status
,
953 doc
: /* Debugging status of current interactive command.
954 Bound each time `call-interactively' is called;
955 may be set by the debugger as a reminder for itself. */);
956 Vcommand_debug_status
= Qnil
;
958 DEFVAR_LISP ("mark-even-if-inactive", &Vmark_even_if_inactive
,
959 doc
: /* *Non-nil means you can use the mark even when inactive.
960 This option makes a difference in Transient Mark mode.
961 When the option is non-nil, deactivation of the mark
962 turns off region highlighting, but commands that use the mark
963 behave as if the mark were still active. */);
964 Vmark_even_if_inactive
= Qnil
;
966 DEFVAR_LISP ("mouse-leave-buffer-hook", &Vmouse_leave_buffer_hook
,
967 doc
: /* Hook to run when about to switch windows with a mouse command.
968 Its purpose is to give temporary modes such as Isearch mode
969 a way to turn themselves off when a mouse command switches windows. */);
970 Vmouse_leave_buffer_hook
= Qnil
;
972 defsubr (&Sinteractive
);
973 defsubr (&Scall_interactively
);
974 defsubr (&Sprefix_numeric_value
);
977 /* arch-tag: a3a7cad7-bcac-42ce-916e-1bd2546ebf37
978 (do not change this comment) */