| 1 | /* Call a Lisp function interactively. |
| 2 | Copyright (C) 1985-1986, 1993-1995, 1997, 2000-2011 |
| 3 | Free Software Foundation, Inc. |
| 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 |
| 9 | the Free Software Foundation, either version 3 of the License, or |
| 10 | (at your option) 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. If not, see <http://www.gnu.org/licenses/>. */ |
| 19 | |
| 20 | |
| 21 | #include <config.h> |
| 22 | #include <setjmp.h> |
| 23 | |
| 24 | #include "lisp.h" |
| 25 | #include "buffer.h" |
| 26 | #include "commands.h" |
| 27 | #include "keyboard.h" |
| 28 | #include "window.h" |
| 29 | #include "keymap.h" |
| 30 | |
| 31 | Lisp_Object Qminus, Qplus; |
| 32 | Lisp_Object Qcall_interactively; |
| 33 | static Lisp_Object Qcommand_debug_status; |
| 34 | static Lisp_Object Qenable_recursive_minibuffers; |
| 35 | |
| 36 | static Lisp_Object Qhandle_shift_selection; |
| 37 | |
| 38 | Lisp_Object Qmouse_leave_buffer_hook; |
| 39 | |
| 40 | static Lisp_Object Qlist, Qlet, Qletx, Qsave_excursion, Qprogn, Qif; |
| 41 | Lisp_Object Qwhen; |
| 42 | static Lisp_Object preserved_fns; |
| 43 | |
| 44 | /* Marker used within call-interactively to refer to point. */ |
| 45 | static Lisp_Object point_marker; |
| 46 | |
| 47 | /* String for the prompt text used in Fcall_interactively. */ |
| 48 | static Lisp_Object callint_message; |
| 49 | \f |
| 50 | /* ARGSUSED */ |
| 51 | DEFUN ("interactive", Finteractive, Sinteractive, 0, UNEVALLED, 0, |
| 52 | doc: /* Specify a way of parsing arguments for interactive use of a function. |
| 53 | For example, write |
| 54 | (defun foo (arg buf) "Doc string" (interactive "P\\nbbuffer: ") .... ) |
| 55 | to make ARG be the raw prefix argument, and set BUF to an existing buffer, |
| 56 | when `foo' is called as a command. |
| 57 | The "call" to `interactive' is actually a declaration rather than a function; |
| 58 | it tells `call-interactively' how to read arguments |
| 59 | to pass to the function. |
| 60 | When actually called, `interactive' just returns nil. |
| 61 | |
| 62 | Usually the argument of `interactive' is a string containing a code letter |
| 63 | followed optionally by a prompt. (Some code letters do not use I/O to get |
| 64 | the argument and do not use prompts.) To get several arguments, concatenate |
| 65 | the individual strings, separating them by newline characters. |
| 66 | Prompts are passed to format, and may use % escapes to print the |
| 67 | arguments that have already been read. |
| 68 | If the argument is not a string, it is evaluated to get a list of |
| 69 | arguments to pass to the function. |
| 70 | Just `(interactive)' means pass no args when calling interactively. |
| 71 | |
| 72 | Code letters available are: |
| 73 | a -- Function name: symbol with a function definition. |
| 74 | b -- Name of existing buffer. |
| 75 | B -- Name of buffer, possibly nonexistent. |
| 76 | c -- Character (no input method is used). |
| 77 | C -- Command name: symbol with interactive function definition. |
| 78 | d -- Value of point as number. Does not do I/O. |
| 79 | D -- Directory name. |
| 80 | e -- Parametrized event (i.e., one that's a list) that invoked this command. |
| 81 | If used more than once, the Nth `e' returns the Nth parameterized event. |
| 82 | This skips events that are integers or symbols. |
| 83 | f -- Existing file name. |
| 84 | F -- Possibly nonexistent file name. |
| 85 | G -- Possibly nonexistent file name, defaulting to just directory name. |
| 86 | i -- Ignored, i.e. always nil. Does not do I/O. |
| 87 | k -- Key sequence (downcase the last event if needed to get a definition). |
| 88 | K -- Key sequence to be redefined (do not downcase the last event). |
| 89 | m -- Value of mark as number. Does not do I/O. |
| 90 | M -- Any string. Inherits the current input method. |
| 91 | n -- Number read using minibuffer. |
| 92 | N -- Numeric prefix arg, or if none, do like code `n'. |
| 93 | p -- Prefix arg converted to number. Does not do I/O. |
| 94 | P -- Prefix arg in raw form. Does not do I/O. |
| 95 | r -- Region: point and mark as 2 numeric args, smallest first. Does no I/O. |
| 96 | s -- Any string. Does not inherit the current input method. |
| 97 | S -- Any symbol. |
| 98 | U -- Mouse up event discarded by a previous k or K argument. |
| 99 | v -- Variable name: symbol that is user-variable-p. |
| 100 | x -- Lisp expression read but not evaluated. |
| 101 | X -- Lisp expression read and evaluated. |
| 102 | z -- Coding system. |
| 103 | Z -- Coding system, nil if no prefix arg. |
| 104 | |
| 105 | In addition, if the string begins with `*', an error is signaled if |
| 106 | the buffer is read-only. |
| 107 | If the string begins with `@', Emacs searches the key sequence which |
| 108 | invoked the command for its first mouse click (or any other event |
| 109 | which specifies a window). |
| 110 | If the string begins with `^' and `shift-select-mode' is non-nil, |
| 111 | Emacs first calls the function `handle-shift-selection'. |
| 112 | You may use `@', `*', and `^' together. They are processed in the |
| 113 | order that they appear, before reading any arguments. |
| 114 | usage: (interactive &optional ARGS) */) |
| 115 | (Lisp_Object args) |
| 116 | { |
| 117 | return Qnil; |
| 118 | } |
| 119 | |
| 120 | /* Quotify EXP: if EXP is constant, return it. |
| 121 | If EXP is not constant, return (quote EXP). */ |
| 122 | static Lisp_Object |
| 123 | quotify_arg (register Lisp_Object exp) |
| 124 | { |
| 125 | if (CONSP (exp) |
| 126 | || (SYMBOLP (exp) |
| 127 | && !NILP (exp) && !EQ (exp, Qt))) |
| 128 | return Fcons (Qquote, Fcons (exp, Qnil)); |
| 129 | |
| 130 | return exp; |
| 131 | } |
| 132 | |
| 133 | /* Modify EXP by quotifying each element (except the first). */ |
| 134 | static Lisp_Object |
| 135 | quotify_args (Lisp_Object exp) |
| 136 | { |
| 137 | register Lisp_Object tail; |
| 138 | Lisp_Object next; |
| 139 | for (tail = exp; CONSP (tail); tail = next) |
| 140 | { |
| 141 | next = XCDR (tail); |
| 142 | XSETCAR (tail, quotify_arg (XCAR (tail))); |
| 143 | } |
| 144 | return exp; |
| 145 | } |
| 146 | |
| 147 | static const char *callint_argfuns[] |
| 148 | = {"", "point", "mark", "region-beginning", "region-end"}; |
| 149 | |
| 150 | static void |
| 151 | check_mark (int for_region) |
| 152 | { |
| 153 | Lisp_Object tem; |
| 154 | tem = Fmarker_buffer (BVAR (current_buffer, mark)); |
| 155 | if (NILP (tem) || (XBUFFER (tem) != current_buffer)) |
| 156 | error (for_region ? "The mark is not set now, so there is no region" |
| 157 | : "The mark is not set now"); |
| 158 | if (!NILP (Vtransient_mark_mode) && NILP (Vmark_even_if_inactive) |
| 159 | && NILP (BVAR (current_buffer, mark_active))) |
| 160 | xsignal0 (Qmark_inactive); |
| 161 | } |
| 162 | |
| 163 | /* If the list of args INPUT was produced with an explicit call to |
| 164 | `list', look for elements that were computed with |
| 165 | (region-beginning) or (region-end), and put those expressions into |
| 166 | VALUES instead of the present values. |
| 167 | |
| 168 | This function doesn't return a value because it modifies elements |
| 169 | of VALUES to do its job. */ |
| 170 | |
| 171 | static void |
| 172 | fix_command (Lisp_Object input, Lisp_Object values) |
| 173 | { |
| 174 | /* FIXME: Instead of this ugly hack, we should provide a way for an |
| 175 | interactive spec to return an expression/function that will re-build the |
| 176 | args without user intervention. */ |
| 177 | if (CONSP (input)) |
| 178 | { |
| 179 | Lisp_Object car; |
| 180 | |
| 181 | car = XCAR (input); |
| 182 | /* Skip through certain special forms. */ |
| 183 | while (EQ (car, Qlet) || EQ (car, Qletx) |
| 184 | || EQ (car, Qsave_excursion) |
| 185 | || EQ (car, Qprogn)) |
| 186 | { |
| 187 | while (CONSP (XCDR (input))) |
| 188 | input = XCDR (input); |
| 189 | input = XCAR (input); |
| 190 | if (!CONSP (input)) |
| 191 | break; |
| 192 | car = XCAR (input); |
| 193 | } |
| 194 | if (EQ (car, Qlist)) |
| 195 | { |
| 196 | Lisp_Object intail, valtail; |
| 197 | for (intail = Fcdr (input), valtail = values; |
| 198 | CONSP (valtail); |
| 199 | intail = Fcdr (intail), valtail = XCDR (valtail)) |
| 200 | { |
| 201 | Lisp_Object elt; |
| 202 | elt = Fcar (intail); |
| 203 | if (CONSP (elt)) |
| 204 | { |
| 205 | Lisp_Object presflag, carelt; |
| 206 | carelt = Fcar (elt); |
| 207 | /* If it is (if X Y), look at Y. */ |
| 208 | if (EQ (carelt, Qif) |
| 209 | && EQ (Fnthcdr (make_number (3), elt), Qnil)) |
| 210 | elt = Fnth (make_number (2), elt); |
| 211 | /* If it is (when ... Y), look at Y. */ |
| 212 | else if (EQ (carelt, Qwhen)) |
| 213 | { |
| 214 | while (CONSP (XCDR (elt))) |
| 215 | elt = XCDR (elt); |
| 216 | elt = Fcar (elt); |
| 217 | } |
| 218 | |
| 219 | /* If the function call we're looking at |
| 220 | is a special preserved one, copy the |
| 221 | whole expression for this argument. */ |
| 222 | if (CONSP (elt)) |
| 223 | { |
| 224 | presflag = Fmemq (Fcar (elt), preserved_fns); |
| 225 | if (!NILP (presflag)) |
| 226 | Fsetcar (valtail, Fcar (intail)); |
| 227 | } |
| 228 | } |
| 229 | } |
| 230 | } |
| 231 | } |
| 232 | } |
| 233 | |
| 234 | DEFUN ("call-interactively", Fcall_interactively, Scall_interactively, 1, 3, 0, |
| 235 | doc: /* Call FUNCTION, reading args according to its interactive calling specs. |
| 236 | Return the value FUNCTION returns. |
| 237 | The function contains a specification of how to do the argument reading. |
| 238 | In the case of user-defined functions, this is specified by placing a call |
| 239 | to the function `interactive' at the top level of the function body. |
| 240 | See `interactive'. |
| 241 | |
| 242 | Optional second arg RECORD-FLAG non-nil |
| 243 | means unconditionally put this command in the command-history. |
| 244 | Otherwise, this is done only if an arg is read using the minibuffer. |
| 245 | |
| 246 | Optional third arg KEYS, if given, specifies the sequence of events to |
| 247 | supply, as a vector, if the command inquires which events were used to |
| 248 | invoke it. If KEYS is omitted or nil, the return value of |
| 249 | `this-command-keys-vector' is used. */) |
| 250 | (Lisp_Object function, Lisp_Object record_flag, Lisp_Object keys) |
| 251 | { |
| 252 | Lisp_Object *args, *visargs; |
| 253 | Lisp_Object specs; |
| 254 | Lisp_Object filter_specs; |
| 255 | Lisp_Object teml; |
| 256 | Lisp_Object up_event; |
| 257 | Lisp_Object enable; |
| 258 | int speccount = SPECPDL_INDEX (); |
| 259 | |
| 260 | /* The index of the next element of this_command_keys to examine for |
| 261 | the 'e' interactive code. */ |
| 262 | int next_event; |
| 263 | |
| 264 | Lisp_Object prefix_arg; |
| 265 | char *string; |
| 266 | const char *tem; |
| 267 | |
| 268 | /* If varies[i] > 0, the i'th argument shouldn't just have its value |
| 269 | in this call quoted in the command history. It should be |
| 270 | recorded as a call to the function named callint_argfuns[varies[i]]. */ |
| 271 | int *varies; |
| 272 | |
| 273 | register size_t i; |
| 274 | size_t nargs; |
| 275 | int foo; |
| 276 | char prompt1[100]; |
| 277 | char *tem1; |
| 278 | int arg_from_tty = 0; |
| 279 | struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5; |
| 280 | int key_count; |
| 281 | int record_then_fail = 0; |
| 282 | |
| 283 | Lisp_Object save_this_command, save_last_command; |
| 284 | Lisp_Object save_this_original_command, save_real_this_command; |
| 285 | |
| 286 | save_this_command = Vthis_command; |
| 287 | save_this_original_command = Vthis_original_command; |
| 288 | save_real_this_command = real_this_command; |
| 289 | save_last_command = KVAR (current_kboard, Vlast_command); |
| 290 | |
| 291 | if (NILP (keys)) |
| 292 | keys = this_command_keys, key_count = this_command_key_count; |
| 293 | else |
| 294 | { |
| 295 | CHECK_VECTOR (keys); |
| 296 | key_count = XVECTOR_SIZE (keys); |
| 297 | } |
| 298 | |
| 299 | /* Save this now, since use of minibuffer will clobber it. */ |
| 300 | prefix_arg = Vcurrent_prefix_arg; |
| 301 | |
| 302 | if (SYMBOLP (function)) |
| 303 | enable = Fget (function, Qenable_recursive_minibuffers); |
| 304 | else |
| 305 | enable = Qnil; |
| 306 | |
| 307 | specs = Qnil; |
| 308 | string = 0; |
| 309 | /* The idea of FILTER_SPECS is to provide away to |
| 310 | specify how to represent the arguments in command history. |
| 311 | The feature is not fully implemented. */ |
| 312 | filter_specs = Qnil; |
| 313 | |
| 314 | /* If k or K discard an up-event, save it here so it can be retrieved with U */ |
| 315 | up_event = Qnil; |
| 316 | |
| 317 | /* Set SPECS to the interactive form, or barf if not interactive. */ |
| 318 | { |
| 319 | Lisp_Object form; |
| 320 | GCPRO2 (function, prefix_arg); |
| 321 | form = Finteractive_form (function); |
| 322 | UNGCPRO; |
| 323 | if (CONSP (form)) |
| 324 | specs = filter_specs = Fcar (XCDR (form)); |
| 325 | else |
| 326 | wrong_type_argument (Qcommandp, function); |
| 327 | } |
| 328 | |
| 329 | /* If SPECS is set to a string, use it as an interactive prompt. */ |
| 330 | if (STRINGP (specs)) |
| 331 | { |
| 332 | /* Make a copy of string so that if a GC relocates specs, |
| 333 | `string' will still be valid. */ |
| 334 | string = (char *) alloca (SBYTES (specs) + 1); |
| 335 | memcpy (string, SSDATA (specs), SBYTES (specs) + 1); |
| 336 | } |
| 337 | else |
| 338 | { |
| 339 | Lisp_Object input; |
| 340 | Lisp_Object funval = Findirect_function (function, Qt); |
| 341 | i = num_input_events; |
| 342 | input = specs; |
| 343 | /* Compute the arg values using the user's expression. */ |
| 344 | GCPRO2 (input, filter_specs); |
| 345 | specs = Feval (specs, |
| 346 | CONSP (funval) && EQ (Qclosure, XCAR (funval)) |
| 347 | ? Qt : Qnil); |
| 348 | UNGCPRO; |
| 349 | if (i != num_input_events || !NILP (record_flag)) |
| 350 | { |
| 351 | /* We should record this command on the command history. */ |
| 352 | Lisp_Object values; |
| 353 | Lisp_Object this_cmd; |
| 354 | /* Make a copy of the list of values, for the command history, |
| 355 | and turn them into things we can eval. */ |
| 356 | values = quotify_args (Fcopy_sequence (specs)); |
| 357 | fix_command (input, values); |
| 358 | this_cmd = Fcons (function, values); |
| 359 | if (history_delete_duplicates) |
| 360 | Vcommand_history = Fdelete (this_cmd, Vcommand_history); |
| 361 | Vcommand_history = Fcons (this_cmd, Vcommand_history); |
| 362 | |
| 363 | /* Don't keep command history around forever. */ |
| 364 | if (INTEGERP (Vhistory_length) && XINT (Vhistory_length) > 0) |
| 365 | { |
| 366 | teml = Fnthcdr (Vhistory_length, Vcommand_history); |
| 367 | if (CONSP (teml)) |
| 368 | XSETCDR (teml, Qnil); |
| 369 | } |
| 370 | } |
| 371 | |
| 372 | Vthis_command = save_this_command; |
| 373 | Vthis_original_command = save_this_original_command; |
| 374 | real_this_command= save_real_this_command; |
| 375 | KVAR (current_kboard, Vlast_command) = save_last_command; |
| 376 | |
| 377 | temporarily_switch_to_single_kboard (NULL); |
| 378 | return unbind_to (speccount, apply1 (function, specs)); |
| 379 | } |
| 380 | |
| 381 | /* Here if function specifies a string to control parsing the defaults */ |
| 382 | |
| 383 | /* Set next_event to point to the first event with parameters. */ |
| 384 | for (next_event = 0; next_event < key_count; next_event++) |
| 385 | if (EVENT_HAS_PARAMETERS (AREF (keys, next_event))) |
| 386 | break; |
| 387 | |
| 388 | /* Handle special starting chars `*' and `@'. Also `-'. */ |
| 389 | /* Note that `+' is reserved for user extensions. */ |
| 390 | while (1) |
| 391 | { |
| 392 | if (*string == '+') |
| 393 | error ("`+' is not used in `interactive' for ordinary commands"); |
| 394 | else if (*string == '*') |
| 395 | { |
| 396 | string++; |
| 397 | if (!NILP (BVAR (current_buffer, read_only))) |
| 398 | { |
| 399 | if (!NILP (record_flag)) |
| 400 | { |
| 401 | char *p = string; |
| 402 | while (*p) |
| 403 | { |
| 404 | if (! (*p == 'r' || *p == 'p' || *p == 'P' |
| 405 | || *p == '\n')) |
| 406 | Fbarf_if_buffer_read_only (); |
| 407 | p++; |
| 408 | } |
| 409 | record_then_fail = 1; |
| 410 | } |
| 411 | else |
| 412 | Fbarf_if_buffer_read_only (); |
| 413 | } |
| 414 | } |
| 415 | /* Ignore this for semi-compatibility with Lucid. */ |
| 416 | else if (*string == '-') |
| 417 | string++; |
| 418 | else if (*string == '@') |
| 419 | { |
| 420 | Lisp_Object event, w; |
| 421 | |
| 422 | event = (next_event < key_count |
| 423 | ? AREF (keys, next_event) |
| 424 | : Qnil); |
| 425 | if (EVENT_HAS_PARAMETERS (event) |
| 426 | && (w = XCDR (event), CONSP (w)) |
| 427 | && (w = XCAR (w), CONSP (w)) |
| 428 | && (w = XCAR (w), WINDOWP (w))) |
| 429 | { |
| 430 | if (MINI_WINDOW_P (XWINDOW (w)) |
| 431 | && ! (minibuf_level > 0 && EQ (w, minibuf_window))) |
| 432 | error ("Attempt to select inactive minibuffer window"); |
| 433 | |
| 434 | /* If the current buffer wants to clean up, let it. */ |
| 435 | Frun_hooks (1, &Qmouse_leave_buffer_hook); |
| 436 | |
| 437 | Fselect_window (w, Qnil); |
| 438 | } |
| 439 | string++; |
| 440 | } |
| 441 | else if (*string == '^') |
| 442 | { |
| 443 | call0 (Qhandle_shift_selection); |
| 444 | string++; |
| 445 | } |
| 446 | else break; |
| 447 | } |
| 448 | |
| 449 | /* Count the number of arguments, which is one plus the number of arguments |
| 450 | the interactive spec would have us give to the function. */ |
| 451 | tem = string; |
| 452 | for (nargs = 1; *tem; ) |
| 453 | { |
| 454 | /* 'r' specifications ("point and mark as 2 numeric args") |
| 455 | produce *two* arguments. */ |
| 456 | if (*tem == 'r') |
| 457 | nargs += 2; |
| 458 | else |
| 459 | nargs++; |
| 460 | tem = strchr (tem, '\n'); |
| 461 | if (tem) |
| 462 | ++tem; |
| 463 | else |
| 464 | break; |
| 465 | } |
| 466 | |
| 467 | args = (Lisp_Object *) alloca (nargs * sizeof (Lisp_Object)); |
| 468 | visargs = (Lisp_Object *) alloca (nargs * sizeof (Lisp_Object)); |
| 469 | varies = (int *) alloca (nargs * sizeof (int)); |
| 470 | |
| 471 | for (i = 0; i < nargs; i++) |
| 472 | { |
| 473 | args[i] = Qnil; |
| 474 | visargs[i] = Qnil; |
| 475 | varies[i] = 0; |
| 476 | } |
| 477 | |
| 478 | GCPRO5 (prefix_arg, function, *args, *visargs, up_event); |
| 479 | gcpro3.nvars = nargs; |
| 480 | gcpro4.nvars = nargs; |
| 481 | |
| 482 | if (!NILP (enable)) |
| 483 | specbind (Qenable_recursive_minibuffers, Qt); |
| 484 | |
| 485 | tem = string; |
| 486 | for (i = 1; *tem; i++) |
| 487 | { |
| 488 | strncpy (prompt1, tem + 1, sizeof prompt1 - 1); |
| 489 | prompt1[sizeof prompt1 - 1] = 0; |
| 490 | tem1 = strchr (prompt1, '\n'); |
| 491 | if (tem1) *tem1 = 0; |
| 492 | |
| 493 | visargs[0] = build_string (prompt1); |
| 494 | if (strchr (prompt1, '%')) |
| 495 | callint_message = Fformat (i, visargs); |
| 496 | else |
| 497 | callint_message = visargs[0]; |
| 498 | |
| 499 | switch (*tem) |
| 500 | { |
| 501 | case 'a': /* Symbol defined as a function */ |
| 502 | visargs[i] = Fcompleting_read (callint_message, |
| 503 | Vobarray, Qfboundp, Qt, |
| 504 | Qnil, Qnil, Qnil, Qnil); |
| 505 | /* Passing args[i] directly stimulates compiler bug */ |
| 506 | teml = visargs[i]; |
| 507 | args[i] = Fintern (teml, Qnil); |
| 508 | break; |
| 509 | |
| 510 | case 'b': /* Name of existing buffer */ |
| 511 | args[i] = Fcurrent_buffer (); |
| 512 | if (EQ (selected_window, minibuf_window)) |
| 513 | args[i] = Fother_buffer (args[i], Qnil, Qnil); |
| 514 | args[i] = Fread_buffer (callint_message, args[i], Qt); |
| 515 | break; |
| 516 | |
| 517 | case 'B': /* Name of buffer, possibly nonexistent */ |
| 518 | args[i] = Fread_buffer (callint_message, |
| 519 | Fother_buffer (Fcurrent_buffer (), Qnil, Qnil), |
| 520 | Qnil); |
| 521 | break; |
| 522 | |
| 523 | case 'c': /* Character */ |
| 524 | /* Prompt in `minibuffer-prompt' face. */ |
| 525 | Fput_text_property (make_number (0), |
| 526 | make_number (SCHARS (callint_message)), |
| 527 | Qface, Qminibuffer_prompt, callint_message); |
| 528 | args[i] = Fread_char (callint_message, Qnil, Qnil); |
| 529 | message1_nolog ((char *) 0); |
| 530 | /* Passing args[i] directly stimulates compiler bug */ |
| 531 | teml = args[i]; |
| 532 | visargs[i] = Fchar_to_string (teml); |
| 533 | break; |
| 534 | |
| 535 | case 'C': /* Command: symbol with interactive function */ |
| 536 | visargs[i] = Fcompleting_read (callint_message, |
| 537 | Vobarray, Qcommandp, |
| 538 | Qt, Qnil, Qnil, Qnil, Qnil); |
| 539 | /* Passing args[i] directly stimulates compiler bug */ |
| 540 | teml = visargs[i]; |
| 541 | args[i] = Fintern (teml, Qnil); |
| 542 | break; |
| 543 | |
| 544 | case 'd': /* Value of point. Does not do I/O. */ |
| 545 | set_marker_both (point_marker, Qnil, PT, PT_BYTE); |
| 546 | args[i] = point_marker; |
| 547 | /* visargs[i] = Qnil; */ |
| 548 | varies[i] = 1; |
| 549 | break; |
| 550 | |
| 551 | case 'D': /* Directory name. */ |
| 552 | args[i] = Fread_file_name (callint_message, Qnil, |
| 553 | BVAR (current_buffer, directory), Qlambda, Qnil, |
| 554 | Qfile_directory_p); |
| 555 | break; |
| 556 | |
| 557 | case 'f': /* Existing file name. */ |
| 558 | args[i] = Fread_file_name (callint_message, |
| 559 | Qnil, Qnil, Qlambda, Qnil, Qnil); |
| 560 | break; |
| 561 | |
| 562 | case 'F': /* Possibly nonexistent file name. */ |
| 563 | args[i] = Fread_file_name (callint_message, |
| 564 | Qnil, Qnil, Qnil, Qnil, Qnil); |
| 565 | break; |
| 566 | |
| 567 | case 'G': /* Possibly nonexistent file name, |
| 568 | default to directory alone. */ |
| 569 | args[i] = Fread_file_name (callint_message, |
| 570 | Qnil, Qnil, Qnil, empty_unibyte_string, Qnil); |
| 571 | break; |
| 572 | |
| 573 | case 'i': /* Ignore an argument -- Does not do I/O */ |
| 574 | varies[i] = -1; |
| 575 | break; |
| 576 | |
| 577 | case 'k': /* Key sequence. */ |
| 578 | { |
| 579 | int speccount1 = SPECPDL_INDEX (); |
| 580 | specbind (Qcursor_in_echo_area, Qt); |
| 581 | /* Prompt in `minibuffer-prompt' face. */ |
| 582 | Fput_text_property (make_number (0), |
| 583 | make_number (SCHARS (callint_message)), |
| 584 | Qface, Qminibuffer_prompt, callint_message); |
| 585 | args[i] = Fread_key_sequence (callint_message, |
| 586 | Qnil, Qnil, Qnil, Qnil); |
| 587 | unbind_to (speccount1, Qnil); |
| 588 | teml = args[i]; |
| 589 | visargs[i] = Fkey_description (teml, Qnil); |
| 590 | |
| 591 | /* If the key sequence ends with a down-event, |
| 592 | discard the following up-event. */ |
| 593 | teml = Faref (args[i], make_number (XINT (Flength (args[i])) - 1)); |
| 594 | if (CONSP (teml)) |
| 595 | teml = XCAR (teml); |
| 596 | if (SYMBOLP (teml)) |
| 597 | { |
| 598 | Lisp_Object tem2; |
| 599 | |
| 600 | teml = Fget (teml, intern ("event-symbol-elements")); |
| 601 | /* Ignore first element, which is the base key. */ |
| 602 | tem2 = Fmemq (intern ("down"), Fcdr (teml)); |
| 603 | if (! NILP (tem2)) |
| 604 | up_event = Fread_event (Qnil, Qnil, Qnil); |
| 605 | } |
| 606 | } |
| 607 | break; |
| 608 | |
| 609 | case 'K': /* Key sequence to be defined. */ |
| 610 | { |
| 611 | int speccount1 = SPECPDL_INDEX (); |
| 612 | specbind (Qcursor_in_echo_area, Qt); |
| 613 | /* Prompt in `minibuffer-prompt' face. */ |
| 614 | Fput_text_property (make_number (0), |
| 615 | make_number (SCHARS (callint_message)), |
| 616 | Qface, Qminibuffer_prompt, callint_message); |
| 617 | args[i] = Fread_key_sequence (callint_message, |
| 618 | Qnil, Qt, Qnil, Qnil); |
| 619 | teml = args[i]; |
| 620 | visargs[i] = Fkey_description (teml, Qnil); |
| 621 | unbind_to (speccount1, Qnil); |
| 622 | |
| 623 | /* If the key sequence ends with a down-event, |
| 624 | discard the following up-event. */ |
| 625 | teml = Faref (args[i], make_number (XINT (Flength (args[i])) - 1)); |
| 626 | if (CONSP (teml)) |
| 627 | teml = XCAR (teml); |
| 628 | if (SYMBOLP (teml)) |
| 629 | { |
| 630 | Lisp_Object tem2; |
| 631 | |
| 632 | teml = Fget (teml, intern ("event-symbol-elements")); |
| 633 | /* Ignore first element, which is the base key. */ |
| 634 | tem2 = Fmemq (intern ("down"), Fcdr (teml)); |
| 635 | if (! NILP (tem2)) |
| 636 | up_event = Fread_event (Qnil, Qnil, Qnil); |
| 637 | } |
| 638 | } |
| 639 | break; |
| 640 | |
| 641 | case 'U': /* Up event from last k or K */ |
| 642 | if (!NILP (up_event)) |
| 643 | { |
| 644 | args[i] = Fmake_vector (make_number (1), up_event); |
| 645 | up_event = Qnil; |
| 646 | teml = args[i]; |
| 647 | visargs[i] = Fkey_description (teml, Qnil); |
| 648 | } |
| 649 | break; |
| 650 | |
| 651 | case 'e': /* The invoking event. */ |
| 652 | if (next_event >= key_count) |
| 653 | error ("%s must be bound to an event with parameters", |
| 654 | (SYMBOLP (function) |
| 655 | ? SSDATA (SYMBOL_NAME (function)) |
| 656 | : "command")); |
| 657 | args[i] = AREF (keys, next_event); |
| 658 | next_event++; |
| 659 | varies[i] = -1; |
| 660 | |
| 661 | /* Find the next parameterized event. */ |
| 662 | while (next_event < key_count |
| 663 | && !(EVENT_HAS_PARAMETERS (AREF (keys, next_event)))) |
| 664 | next_event++; |
| 665 | |
| 666 | break; |
| 667 | |
| 668 | case 'm': /* Value of mark. Does not do I/O. */ |
| 669 | check_mark (0); |
| 670 | /* visargs[i] = Qnil; */ |
| 671 | args[i] = BVAR (current_buffer, mark); |
| 672 | varies[i] = 2; |
| 673 | break; |
| 674 | |
| 675 | case 'M': /* String read via minibuffer with |
| 676 | inheriting the current input method. */ |
| 677 | args[i] = Fread_string (callint_message, |
| 678 | Qnil, Qnil, Qnil, Qt); |
| 679 | break; |
| 680 | |
| 681 | case 'N': /* Prefix arg as number, else number from minibuffer */ |
| 682 | if (!NILP (prefix_arg)) |
| 683 | goto have_prefix_arg; |
| 684 | case 'n': /* Read number from minibuffer. */ |
| 685 | { |
| 686 | int first = 1; |
| 687 | do |
| 688 | { |
| 689 | Lisp_Object str; |
| 690 | if (! first) |
| 691 | { |
| 692 | message ("Please enter a number."); |
| 693 | sit_for (make_number (1), 0, 0); |
| 694 | } |
| 695 | first = 0; |
| 696 | |
| 697 | str = Fread_from_minibuffer (callint_message, |
| 698 | Qnil, Qnil, Qnil, Qnil, Qnil, |
| 699 | Qnil); |
| 700 | if (! STRINGP (str) || SCHARS (str) == 0) |
| 701 | args[i] = Qnil; |
| 702 | else |
| 703 | args[i] = Fread (str); |
| 704 | } |
| 705 | while (! NUMBERP (args[i])); |
| 706 | } |
| 707 | visargs[i] = args[i]; |
| 708 | break; |
| 709 | |
| 710 | case 'P': /* Prefix arg in raw form. Does no I/O. */ |
| 711 | args[i] = prefix_arg; |
| 712 | /* visargs[i] = Qnil; */ |
| 713 | varies[i] = -1; |
| 714 | break; |
| 715 | |
| 716 | case 'p': /* Prefix arg converted to number. No I/O. */ |
| 717 | have_prefix_arg: |
| 718 | args[i] = Fprefix_numeric_value (prefix_arg); |
| 719 | /* visargs[i] = Qnil; */ |
| 720 | varies[i] = -1; |
| 721 | break; |
| 722 | |
| 723 | case 'r': /* Region, point and mark as 2 args. */ |
| 724 | check_mark (1); |
| 725 | set_marker_both (point_marker, Qnil, PT, PT_BYTE); |
| 726 | /* visargs[i+1] = Qnil; */ |
| 727 | foo = marker_position (BVAR (current_buffer, mark)); |
| 728 | /* visargs[i] = Qnil; */ |
| 729 | args[i] = PT < foo ? point_marker : BVAR (current_buffer, mark); |
| 730 | varies[i] = 3; |
| 731 | args[++i] = PT > foo ? point_marker : BVAR (current_buffer, mark); |
| 732 | varies[i] = 4; |
| 733 | break; |
| 734 | |
| 735 | case 's': /* String read via minibuffer without |
| 736 | inheriting the current input method. */ |
| 737 | args[i] = Fread_string (callint_message, |
| 738 | Qnil, Qnil, Qnil, Qnil); |
| 739 | break; |
| 740 | |
| 741 | case 'S': /* Any symbol. */ |
| 742 | visargs[i] = Fread_string (callint_message, |
| 743 | Qnil, Qnil, Qnil, Qnil); |
| 744 | /* Passing args[i] directly stimulates compiler bug */ |
| 745 | teml = visargs[i]; |
| 746 | args[i] = Fintern (teml, Qnil); |
| 747 | break; |
| 748 | |
| 749 | case 'v': /* Variable name: symbol that is |
| 750 | user-variable-p. */ |
| 751 | args[i] = Fread_variable (callint_message, Qnil); |
| 752 | visargs[i] = last_minibuf_string; |
| 753 | break; |
| 754 | |
| 755 | case 'x': /* Lisp expression read but not evaluated */ |
| 756 | args[i] = Fread_minibuffer (callint_message, Qnil); |
| 757 | visargs[i] = last_minibuf_string; |
| 758 | break; |
| 759 | |
| 760 | case 'X': /* Lisp expression read and evaluated */ |
| 761 | args[i] = Feval_minibuffer (callint_message, Qnil); |
| 762 | visargs[i] = last_minibuf_string; |
| 763 | break; |
| 764 | |
| 765 | case 'Z': /* Coding-system symbol, or ignore the |
| 766 | argument if no prefix */ |
| 767 | if (NILP (prefix_arg)) |
| 768 | { |
| 769 | args[i] = Qnil; |
| 770 | varies[i] = -1; |
| 771 | } |
| 772 | else |
| 773 | { |
| 774 | args[i] |
| 775 | = Fread_non_nil_coding_system (callint_message); |
| 776 | visargs[i] = last_minibuf_string; |
| 777 | } |
| 778 | break; |
| 779 | |
| 780 | case 'z': /* Coding-system symbol or nil */ |
| 781 | args[i] = Fread_coding_system (callint_message, Qnil); |
| 782 | visargs[i] = last_minibuf_string; |
| 783 | break; |
| 784 | |
| 785 | /* We have a case for `+' so we get an error |
| 786 | if anyone tries to define one here. */ |
| 787 | case '+': |
| 788 | default: |
| 789 | error ("Invalid control letter `%c' (%03o) in interactive calling string", |
| 790 | *tem, (unsigned char) *tem); |
| 791 | } |
| 792 | |
| 793 | if (varies[i] == 0) |
| 794 | arg_from_tty = 1; |
| 795 | |
| 796 | if (NILP (visargs[i]) && STRINGP (args[i])) |
| 797 | visargs[i] = args[i]; |
| 798 | |
| 799 | tem = strchr (tem, '\n'); |
| 800 | if (tem) tem++; |
| 801 | else tem = ""; |
| 802 | } |
| 803 | unbind_to (speccount, Qnil); |
| 804 | |
| 805 | QUIT; |
| 806 | |
| 807 | args[0] = function; |
| 808 | |
| 809 | if (arg_from_tty || !NILP (record_flag)) |
| 810 | { |
| 811 | visargs[0] = function; |
| 812 | for (i = 1; i < nargs; i++) |
| 813 | { |
| 814 | if (varies[i] > 0) |
| 815 | visargs[i] = Fcons (intern (callint_argfuns[varies[i]]), Qnil); |
| 816 | else |
| 817 | visargs[i] = quotify_arg (args[i]); |
| 818 | } |
| 819 | Vcommand_history = Fcons (Flist (nargs, visargs), |
| 820 | Vcommand_history); |
| 821 | /* Don't keep command history around forever. */ |
| 822 | if (INTEGERP (Vhistory_length) && XINT (Vhistory_length) > 0) |
| 823 | { |
| 824 | teml = Fnthcdr (Vhistory_length, Vcommand_history); |
| 825 | if (CONSP (teml)) |
| 826 | XSETCDR (teml, Qnil); |
| 827 | } |
| 828 | } |
| 829 | |
| 830 | /* If we used a marker to hold point, mark, or an end of the region, |
| 831 | temporarily, convert it to an integer now. */ |
| 832 | for (i = 1; i < nargs; i++) |
| 833 | if (varies[i] >= 1 && varies[i] <= 4) |
| 834 | XSETINT (args[i], marker_position (args[i])); |
| 835 | |
| 836 | if (record_then_fail) |
| 837 | Fbarf_if_buffer_read_only (); |
| 838 | |
| 839 | Vthis_command = save_this_command; |
| 840 | Vthis_original_command = save_this_original_command; |
| 841 | real_this_command= save_real_this_command; |
| 842 | KVAR (current_kboard, Vlast_command) = save_last_command; |
| 843 | |
| 844 | { |
| 845 | Lisp_Object val; |
| 846 | specbind (Qcommand_debug_status, Qnil); |
| 847 | |
| 848 | temporarily_switch_to_single_kboard (NULL); |
| 849 | val = Ffuncall (nargs, args); |
| 850 | UNGCPRO; |
| 851 | return unbind_to (speccount, val); |
| 852 | } |
| 853 | } |
| 854 | |
| 855 | DEFUN ("prefix-numeric-value", Fprefix_numeric_value, Sprefix_numeric_value, |
| 856 | 1, 1, 0, |
| 857 | doc: /* Return numeric meaning of raw prefix argument RAW. |
| 858 | A raw prefix argument is what you get from `(interactive "P")'. |
| 859 | Its numeric meaning is what you would get from `(interactive "p")'. */) |
| 860 | (Lisp_Object raw) |
| 861 | { |
| 862 | Lisp_Object val; |
| 863 | |
| 864 | if (NILP (raw)) |
| 865 | XSETFASTINT (val, 1); |
| 866 | else if (EQ (raw, Qminus)) |
| 867 | XSETINT (val, -1); |
| 868 | else if (CONSP (raw) && INTEGERP (XCAR (raw))) |
| 869 | XSETINT (val, XINT (XCAR (raw))); |
| 870 | else if (INTEGERP (raw)) |
| 871 | val = raw; |
| 872 | else |
| 873 | XSETFASTINT (val, 1); |
| 874 | |
| 875 | return val; |
| 876 | } |
| 877 | |
| 878 | void |
| 879 | syms_of_callint (void) |
| 880 | { |
| 881 | point_marker = Fmake_marker (); |
| 882 | staticpro (&point_marker); |
| 883 | |
| 884 | callint_message = Qnil; |
| 885 | staticpro (&callint_message); |
| 886 | |
| 887 | preserved_fns = pure_cons (intern_c_string ("region-beginning"), |
| 888 | pure_cons (intern_c_string ("region-end"), |
| 889 | pure_cons (intern_c_string ("point"), |
| 890 | pure_cons (intern_c_string ("mark"), Qnil)))); |
| 891 | |
| 892 | Qlist = intern_c_string ("list"); |
| 893 | staticpro (&Qlist); |
| 894 | Qlet = intern_c_string ("let"); |
| 895 | staticpro (&Qlet); |
| 896 | Qif = intern_c_string ("if"); |
| 897 | staticpro (&Qif); |
| 898 | Qwhen = intern_c_string ("when"); |
| 899 | staticpro (&Qwhen); |
| 900 | Qletx = intern_c_string ("let*"); |
| 901 | staticpro (&Qletx); |
| 902 | Qsave_excursion = intern_c_string ("save-excursion"); |
| 903 | staticpro (&Qsave_excursion); |
| 904 | Qprogn = intern_c_string ("progn"); |
| 905 | staticpro (&Qprogn); |
| 906 | |
| 907 | Qminus = intern_c_string ("-"); |
| 908 | staticpro (&Qminus); |
| 909 | |
| 910 | Qplus = intern_c_string ("+"); |
| 911 | staticpro (&Qplus); |
| 912 | |
| 913 | Qhandle_shift_selection = intern_c_string ("handle-shift-selection"); |
| 914 | staticpro (&Qhandle_shift_selection); |
| 915 | |
| 916 | Qcall_interactively = intern_c_string ("call-interactively"); |
| 917 | staticpro (&Qcall_interactively); |
| 918 | |
| 919 | Qcommand_debug_status = intern_c_string ("command-debug-status"); |
| 920 | staticpro (&Qcommand_debug_status); |
| 921 | |
| 922 | Qenable_recursive_minibuffers = intern_c_string ("enable-recursive-minibuffers"); |
| 923 | staticpro (&Qenable_recursive_minibuffers); |
| 924 | |
| 925 | Qmouse_leave_buffer_hook = intern_c_string ("mouse-leave-buffer-hook"); |
| 926 | staticpro (&Qmouse_leave_buffer_hook); |
| 927 | |
| 928 | DEFVAR_KBOARD ("prefix-arg", Vprefix_arg, |
| 929 | doc: /* The value of the prefix argument for the next editing command. |
| 930 | It may be a number, or the symbol `-' for just a minus sign as arg, |
| 931 | or a list whose car is a number for just one or more C-u's |
| 932 | or nil if no argument has been specified. |
| 933 | |
| 934 | You cannot examine this variable to find the argument for this command |
| 935 | since it has been set to nil by the time you can look. |
| 936 | Instead, you should use the variable `current-prefix-arg', although |
| 937 | normally commands can get this prefix argument with (interactive "P"). */); |
| 938 | |
| 939 | DEFVAR_KBOARD ("last-prefix-arg", Vlast_prefix_arg, |
| 940 | doc: /* The value of the prefix argument for the previous editing command. |
| 941 | See `prefix-arg' for the meaning of the value. */); |
| 942 | |
| 943 | DEFVAR_LISP ("current-prefix-arg", Vcurrent_prefix_arg, |
| 944 | doc: /* The value of the prefix argument for this editing command. |
| 945 | It may be a number, or the symbol `-' for just a minus sign as arg, |
| 946 | or a list whose car is a number for just one or more C-u's |
| 947 | or nil if no argument has been specified. |
| 948 | This is what `(interactive \"P\")' returns. */); |
| 949 | Vcurrent_prefix_arg = Qnil; |
| 950 | |
| 951 | DEFVAR_LISP ("command-history", Vcommand_history, |
| 952 | doc: /* List of recent commands that read arguments from terminal. |
| 953 | Each command is represented as a form to evaluate. |
| 954 | |
| 955 | Maximum length of the history list is determined by the value |
| 956 | of `history-length', which see. */); |
| 957 | Vcommand_history = Qnil; |
| 958 | |
| 959 | DEFVAR_LISP ("command-debug-status", Vcommand_debug_status, |
| 960 | doc: /* Debugging status of current interactive command. |
| 961 | Bound each time `call-interactively' is called; |
| 962 | may be set by the debugger as a reminder for itself. */); |
| 963 | Vcommand_debug_status = Qnil; |
| 964 | |
| 965 | DEFVAR_LISP ("mark-even-if-inactive", Vmark_even_if_inactive, |
| 966 | doc: /* *Non-nil means you can use the mark even when inactive. |
| 967 | This option makes a difference in Transient Mark mode. |
| 968 | When the option is non-nil, deactivation of the mark |
| 969 | turns off region highlighting, but commands that use the mark |
| 970 | behave as if the mark were still active. */); |
| 971 | Vmark_even_if_inactive = Qt; |
| 972 | |
| 973 | DEFVAR_LISP ("mouse-leave-buffer-hook", Vmouse_leave_buffer_hook, |
| 974 | doc: /* Hook to run when about to switch windows with a mouse command. |
| 975 | Its purpose is to give temporary modes such as Isearch mode |
| 976 | a way to turn themselves off when a mouse command switches windows. */); |
| 977 | Vmouse_leave_buffer_hook = Qnil; |
| 978 | |
| 979 | defsubr (&Sinteractive); |
| 980 | defsubr (&Scall_interactively); |
| 981 | defsubr (&Sprefix_numeric_value); |
| 982 | } |