Mercurial > emacs
annotate src/keyboard.c @ 809:8a0066235d56
Initial revision
author | Eric S. Raymond <esr@snark.thyrsus.com> |
---|---|
date | Fri, 17 Jul 1992 06:48:03 +0000 |
parents | e4093444f9f8 |
children | 224b0d5d1a38 |
rev | line source |
---|---|
518 | 1 /* Keyboard and mouse input; editor command loop. |
586 | 2 Copyright (C) 1985, 1986, 1987, 1988, 1989, 1992 Free Software Foundation, Inc. |
518 | 3 |
4 This file is part of GNU Emacs. | |
5 | |
6 GNU Emacs is free software; you can redistribute it and/or modify | |
7 it under the terms of the GNU General Public License as published by | |
8 the Free Software Foundation; either version 1, or (at your option) | |
9 any later version. | |
10 | |
11 GNU Emacs is distributed in the hope that it will be useful, | |
12 but WITHOUT ANY WARRANTY; without even the implied warranty of | |
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
14 GNU General Public License for more details. | |
15 | |
16 You should have received a copy of the GNU General Public License | |
17 along with GNU Emacs; see the file COPYING. If not, write to | |
18 the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. */ | |
19 | |
20 /* Allow config.h to undefine symbols found here. */ | |
21 #include <signal.h> | |
22 | |
23 #include "config.h" | |
24 #include <stdio.h> | |
25 #undef NULL | |
26 #include "termchar.h" | |
27 #include "termopts.h" | |
28 #include "lisp.h" | |
29 #include "termhooks.h" | |
30 #include "macros.h" | |
765 | 31 #include "frame.h" |
518 | 32 #include "window.h" |
33 #include "commands.h" | |
34 #include "buffer.h" | |
35 #include "disptab.h" | |
36 #include "keyboard.h" | |
37 #include <setjmp.h> | |
38 #include <errno.h> | |
39 | |
562 | 40 #ifndef VMS |
41 #include <sys/ioctl.h> | |
42 #endif | |
43 | |
44 #include "syssignal.h" | |
45 #include "systerm.h" | |
648 | 46 #include "systime.h" |
518 | 47 |
48 extern int errno; | |
49 | |
50 #ifdef HAVE_X_WINDOWS | |
51 extern Lisp_Object Vmouse_grabbed; | |
52 | |
53 /* Make all keyboard buffers much bigger when using X windows. */ | |
54 #define KBD_BUFFER_SIZE 4096 | |
55 #else /* No X-windows, character input */ | |
56 #define KBD_BUFFER_SIZE 256 | |
57 #endif /* No X-windows */ | |
58 | |
59 /* Following definition copied from eval.c */ | |
60 | |
61 struct backtrace | |
62 { | |
63 struct backtrace *next; | |
64 Lisp_Object *function; | |
65 Lisp_Object *args; /* Points to vector of args. */ | |
66 int nargs; /* length of vector. If nargs is UNEVALLED, | |
67 args points to slot holding list of | |
68 unevalled args */ | |
69 char evalargs; | |
70 }; | |
71 | |
72 /* Non-nil disable property on a command means | |
73 do not execute it; call disabled-command-hook's value instead. */ | |
74 Lisp_Object Qdisabled, Vdisabled_command_hook; | |
75 | |
76 #define NUM_RECENT_KEYS (100) | |
77 int recent_keys_index; /* Index for storing next element into recent_keys */ | |
78 int total_keys; /* Total number of elements stored into recent_keys */ | |
79 Lisp_Object recent_keys[NUM_RECENT_KEYS]; /* Holds last 100 keystrokes */ | |
80 | |
81 /* Buffer holding the key that invoked the current command. */ | |
82 Lisp_Object *this_command_keys; | |
83 int this_command_key_count; /* Size in use. */ | |
84 int this_command_keys_size; /* Size allocated. */ | |
85 | |
86 extern int minbuf_level; | |
87 | |
88 extern struct backtrace *backtrace_list; | |
89 | |
90 /* Nonzero means do menu prompting. */ | |
91 static int menu_prompting; | |
92 | |
93 /* Character to see next line of menu prompt. */ | |
94 static Lisp_Object menu_prompt_more_char; | |
95 | |
96 /* For longjmp to where kbd input is being done. */ | |
97 static jmp_buf getcjmp; | |
98 | |
99 /* True while doing kbd input. */ | |
100 int waiting_for_input; | |
101 | |
102 /* True while displaying for echoing. Delays C-g throwing. */ | |
103 static int echoing; | |
104 | |
105 /* Nonzero means C-G should cause immediate error-signal. */ | |
106 int immediate_quit; | |
107 | |
108 /* Character to recognize as the help char. */ | |
109 Lisp_Object help_char; | |
110 | |
111 /* Form to execute when help char is typed. */ | |
112 Lisp_Object Vhelp_form; | |
113 | |
114 /* Character that causes a quit. Normally C-g. | |
115 | |
116 If we are running on an ordinary terminal, this must be an ordinary | |
117 ASCII char, since we want to make it our interrupt character. | |
118 | |
119 If we are not running on an ordinary terminal, it still needs to be | |
120 an ordinary ASCII char. This character needs to be recognized in | |
121 the input interrupt handler. At this point, the keystroke is | |
122 represented as a struct input_event, while the desired quit | |
123 character is specified as a lispy event. The mapping from struct | |
124 input_events to lispy events cannot run in an interrupt handler, | |
125 and the reverse mapping is difficult for anything but ASCII | |
126 keystrokes. | |
127 | |
128 FOR THESE ELABORATE AND UNSATISFYING REASONS, quit_char must be an | |
129 ASCII character. */ | |
130 int quit_char; | |
131 | |
132 extern Lisp_Object current_global_map; | |
133 extern int minibuf_level; | |
134 | |
135 /* Current depth in recursive edits. */ | |
136 int command_loop_level; | |
137 | |
138 /* Total number of times command_loop has read a key sequence. */ | |
139 int num_input_keys; | |
140 | |
141 /* Last input character read as a command. */ | |
142 Lisp_Object last_command_char; | |
143 | |
144 /* Last input character read for any purpose. */ | |
145 Lisp_Object last_input_char; | |
146 | |
147 /* If not Qnil, an object to be read as the next command input. */ | |
148 Lisp_Object unread_command_char; | |
149 | |
150 /* Char to use as prefix when a meta character is typed in. | |
151 This is bound on entry to minibuffer in case ESC is changed there. */ | |
152 | |
153 Lisp_Object meta_prefix_char; | |
154 | |
155 /* Last size recorded for a current buffer which is not a minibuffer. */ | |
156 static int last_non_minibuf_size; | |
157 | |
687
e2b747dd6a6e
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
682
diff
changeset
|
158 /* Number of idle seconds before an auto-save and garbage collection. */ |
518 | 159 static Lisp_Object Vauto_save_timeout; |
160 | |
161 /* Total number of times read_char has returned. */ | |
162 int num_input_chars; | |
163 | |
164 /* Auto-save automatically when this many characters have been typed | |
165 since the last time. */ | |
166 | |
167 static int auto_save_interval; | |
168 | |
169 /* Value of num_input_chars as of last auto save. */ | |
170 | |
171 int last_auto_save; | |
172 | |
173 /* Last command executed by the editor command loop, not counting | |
174 commands that set the prefix argument. */ | |
175 | |
176 Lisp_Object last_command; | |
177 | |
178 /* The command being executed by the command loop. | |
179 Commands may set this, and the value set will be copied into last_command | |
180 instead of the actual command. */ | |
181 Lisp_Object this_command; | |
182 | |
183 #ifndef HAVE_X11 | |
184 /* Window of last mouse click. */ | |
185 extern Lisp_Object Vmouse_window; | |
186 | |
187 /* List containing details of last mouse click. */ | |
188 extern Lisp_Object Vmouse_event; | |
189 #endif /* defined HAVE_X11 */ | |
190 | |
191 /* Hook to call on each mouse event after running its definition. */ | |
192 Lisp_Object Vmouse_event_function; | |
193 | |
765 | 194 /* Hook to call when mouse leaves frame. */ |
518 | 195 Lisp_Object Vmouse_left_hook; |
196 | |
765 | 197 /* Hook to call when a frame is mapped. */ |
198 Lisp_Object Vmap_frame_hook; | |
199 | |
200 /* Hook to call when a frame is unmapped. */ | |
201 Lisp_Object Vunmap_frame_hook; | |
518 | 202 |
203 /* Handler for non-grabbed (no keys depressed) mouse motion. */ | |
204 Lisp_Object Vmouse_motion_handler; | |
205 | |
765 | 206 /* The frame in which the last input event occurred. |
207 command_loop_1 will select this frame before running the | |
518 | 208 command bound to an event sequence, and read_key_sequence will |
209 toss the existing prefix if the user starts typing at a | |
765 | 210 new frame. */ |
211 Lisp_Object Vlast_event_frame; | |
518 | 212 |
708 | 213 /* The timestamp of the last input event we received from the X server. |
214 X Windows wants this for selection ownership. */ | |
518 | 215 unsigned long last_event_timestamp; |
216 | |
217 Lisp_Object Qself_insert_command; | |
218 Lisp_Object Qforward_char; | |
219 Lisp_Object Qbackward_char; | |
220 | |
221 /* read_key_sequence stores here the command definition of the | |
222 key sequence that it reads. */ | |
223 Lisp_Object read_key_sequence_cmd; | |
224 | |
225 /* Form to evaluate (if non-nil) when Emacs is started. */ | |
226 Lisp_Object Vtop_level; | |
227 | |
228 /* User-supplied string to translate input characters through. */ | |
229 Lisp_Object Vkeyboard_translate_table; | |
230 | |
231 /* Keymap mapping ASCII function key sequences onto their preferred forms. */ | |
232 extern Lisp_Object Vfunction_key_map; | |
233 | |
234 /* File in which we write all commands we read. */ | |
235 FILE *dribble; | |
236 | |
237 /* Nonzero if input is available. */ | |
238 int input_pending; | |
239 | |
240 /* Nonzero if should obey 0200 bit in input chars as "Meta". */ | |
241 int meta_key; | |
242 | |
243 extern char *pending_malloc_warning; | |
244 | |
245 /* Circular buffer for pre-read keyboard input. */ | |
246 static struct input_event kbd_buffer[KBD_BUFFER_SIZE]; | |
247 | |
248 /* Pointer to next available character in kbd_buffer. | |
249 If kbd_fetch_ptr == kbd_store_ptr, the buffer is empty. | |
250 This may be kbd_buffer + KBD_BUFFER_SIZE, meaning that the the | |
251 next available char is in kbd_buffer[0]. */ | |
252 static struct input_event *kbd_fetch_ptr; | |
253 | |
254 /* Pointer to next place to store character in kbd_buffer. This | |
255 may be kbd_buffer + KBD_BUFFER_SIZE, meaning that the next | |
256 character should go in kbd_buffer[0]. */ | |
257 static struct input_event *kbd_store_ptr; | |
258 | |
259 /* The above pair of variables forms a "queue empty" flag. When we | |
260 enqueue a non-hook event, we increment kbd_write_count. When we | |
261 dequeue a non-hook event, we increment kbd_read_count. We say that | |
262 there is input available iff the two counters are equal. | |
263 | |
264 Why not just have a flag set and cleared by the enqueuing and | |
265 dequeuing functions? Such a flag could be screwed up by interrupts | |
266 at inopportune times. */ | |
267 | |
268 /* If this flag is non-zero, mouse movement events will appear in the | |
269 input stream. If is zero, mouse movement will be ignored. */ | |
270 int do_mouse_tracking; | |
271 | |
272 /* The window system handling code should set this if the mouse has | |
273 moved since the last call to the mouse_position_hook. Calling that | |
274 hook should clear this. Code assumes that if this is set, it can | |
275 call mouse_position_hook to get the promised position, so don't set | |
276 it unless you're prepared to substantiate the claim! */ | |
277 int mouse_moved; | |
278 | |
279 /* True iff there is an event in kbd_buffer, or if mouse tracking is | |
280 enabled and there is a new mouse position in the mouse movement | |
281 buffer. Note that if this is false, that doesn't mean that there | |
282 is readable input; all the events in the queue might be button-up | |
283 events, and do_mouse_tracking might be off. */ | |
284 #define EVENT_QUEUES_EMPTY \ | |
285 ((kbd_fetch_ptr == kbd_store_ptr) && (!do_mouse_tracking || !mouse_moved)) | |
286 | |
287 | |
288 /* Symbols to head events. */ | |
289 Lisp_Object Qmouse_movement; | |
290 | |
291 Lisp_Object Qvscrollbar_part; | |
292 Lisp_Object Qvslider_part; | |
293 Lisp_Object Qvthumbup_part; | |
294 Lisp_Object Qvthumbdown_part; | |
295 | |
296 Lisp_Object Qhscrollbar_part; | |
297 Lisp_Object Qhslider_part; | |
298 Lisp_Object Qhthumbleft_part; | |
299 Lisp_Object Qhthumbright_part; | |
300 | |
301 /* Symbols to denote kinds of events. */ | |
302 Lisp_Object Qfunction_key; | |
303 Lisp_Object Qmouse_click; | |
304 /* Lisp_Object Qmouse_movement; - also an event header */ | |
305 Lisp_Object Qscrollbar_click; | |
306 | |
307 /* Properties of event headers. */ | |
308 Lisp_Object Qevent_kind; | |
309 Lisp_Object Qevent_unmodified; | |
310 | |
311 /* Symbols to use for non-text mouse positions. */ | |
312 Lisp_Object Qmode_line; | |
732 | 313 Lisp_Object Qvertical_line; |
518 | 314 |
315 | |
648 | 316 /* Address (if not 0) of EMACS_TIME to zero out if a SIGIO interrupt |
317 happens. */ | |
318 EMACS_TIME *input_available_clear_time; | |
518 | 319 |
320 /* Nonzero means use SIGIO interrupts; zero means use CBREAK mode. | |
321 Default is 1 if INTERRUPT_INPUT is defined. */ | |
322 int interrupt_input; | |
323 | |
324 /* Nonzero while interrupts are temporarily deferred during redisplay. */ | |
325 int interrupts_deferred; | |
326 | |
327 /* nonzero means use ^S/^Q for flow control. */ | |
328 int flow_control; | |
329 | |
330 /* Allow m- file to inhibit use of FIONREAD. */ | |
331 #ifdef BROKEN_FIONREAD | |
332 #undef FIONREAD | |
333 #endif | |
334 | |
335 /* We are unable to use interrupts if FIONREAD is not available, | |
336 so flush SIGIO so we won't try. */ | |
337 #ifndef FIONREAD | |
338 #ifdef SIGIO | |
339 #undef SIGIO | |
340 #endif | |
341 #endif | |
342 | |
343 /* If we support X Windows, and won't get an interrupt when input | |
344 arrives from the server, poll periodically so we can detect C-g. */ | |
345 #ifdef HAVE_X_WINDOWS | |
346 #ifndef SIGIO | |
347 #define POLL_FOR_INPUT | |
348 #endif | |
349 #endif | |
350 | |
351 /* Global variable declarations. */ | |
352 | |
353 /* Function for init_keyboard to call with no args (if nonzero). */ | |
354 void (*keyboard_init_hook) (); | |
355 | |
356 static int read_avail_input (); | |
357 static void get_input_pending (); | |
358 | |
359 /* > 0 if we are to echo keystrokes. */ | |
360 static int echo_keystrokes; | |
361 | |
362 /* Nonzero means echo each character as typed. */ | |
363 static int immediate_echo; | |
364 | |
365 /* The text we're echoing in the modeline - partial key sequences, | |
366 usually. '\0'-terminated. */ | |
367 static char echobuf[100]; | |
368 | |
369 /* Where to append more text to echobuf if we want to. */ | |
370 static char *echoptr; | |
371 | |
372 #define min(a,b) ((a)<(b)?(a):(b)) | |
373 #define max(a,b) ((a)>(b)?(a):(b)) | |
374 | |
375 /* Install the string STR as the beginning of the string of echoing, | |
376 so that it serves as a prompt for the next character. | |
377 Also start echoing. */ | |
378 | |
379 echo_prompt (str) | |
380 char *str; | |
381 { | |
382 int len = strlen (str); | |
383 if (len > sizeof echobuf - 4) | |
384 len = sizeof echobuf - 4; | |
385 bcopy (str, echobuf, len + 1); | |
386 echoptr = echobuf + len; | |
387 | |
388 echo (); | |
389 } | |
390 | |
391 /* Add C to the echo string, if echoing is going on. | |
392 C can be a character, which is printed prettily ("M-C-x" and all that | |
393 jazz), or a symbol, whose name is printed. */ | |
394 | |
395 echo_char (c) | |
396 Lisp_Object c; | |
397 { | |
398 extern char *push_key_description (); | |
399 | |
400 if (immediate_echo) | |
401 { | |
402 char *ptr = echoptr; | |
403 | |
404 if (ptr != echobuf) | |
405 *ptr++ = ' '; | |
406 | |
407 /* If someone has passed us a composite event, use its head symbol. */ | |
408 if (EVENT_HAS_PARAMETERS (c)) | |
409 c = EVENT_HEAD (c); | |
410 | |
411 if (XTYPE (c) == Lisp_Int) | |
412 { | |
413 if (ptr - echobuf > sizeof echobuf - 6) | |
414 return; | |
415 | |
416 ptr = push_key_description (c, ptr); | |
417 } | |
418 else if (XTYPE (c) == Lisp_Symbol) | |
419 { | |
420 struct Lisp_String *name = XSYMBOL (c)->name; | |
421 if (((ptr - echobuf) + name->size + 4) > sizeof echobuf) | |
422 return; | |
423 bcopy (name->data, ptr, name->size); | |
424 ptr += name->size; | |
425 } | |
426 | |
427 if (echoptr == echobuf && c == help_char) | |
428 { | |
429 strcpy (ptr, " (Type ? for further options)"); | |
430 ptr += strlen (ptr); | |
431 } | |
432 | |
433 *ptr = 0; | |
434 echoptr = ptr; | |
435 | |
436 echo (); | |
437 } | |
438 } | |
439 | |
440 /* Temporarily add a dash to the end of the echo string if it's not | |
441 empty, so that it serves as a mini-prompt for the very next character. */ | |
442 | |
443 echo_dash () | |
444 { | |
445 if (!immediate_echo && echoptr == echobuf) | |
446 return; | |
447 | |
448 /* Put a dash at the end of the buffer temporarily, | |
449 but make it go away when the next character is added. */ | |
450 echoptr[0] = '-'; | |
451 echoptr[1] = 0; | |
452 | |
453 echo (); | |
454 } | |
455 | |
456 /* Display the current echo string, and begin echoing if not already | |
457 doing so. */ | |
458 | |
459 echo () | |
460 { | |
461 if (!immediate_echo) | |
462 { | |
463 int i; | |
464 immediate_echo = 1; | |
465 | |
466 for (i = 0; i < this_command_key_count; i++) | |
467 echo_char (this_command_keys[i]); | |
468 echo_dash (); | |
469 } | |
470 | |
471 echoing = 1; | |
472 message1 (echobuf); | |
473 echoing = 0; | |
474 | |
475 if (waiting_for_input && !NILP (Vquit_flag)) | |
476 quit_throw_to_read_char (); | |
477 } | |
478 | |
479 /* Turn off echoing, for the start of a new command. */ | |
480 | |
481 cancel_echoing () | |
482 { | |
483 immediate_echo = 0; | |
484 echoptr = echobuf; | |
485 } | |
486 | |
487 /* Return the length of the current echo string. */ | |
488 | |
489 static int | |
490 echo_length () | |
491 { | |
492 return echoptr - echobuf; | |
493 } | |
494 | |
495 /* Truncate the current echo message to its first LEN chars. | |
496 This and echo_char get used by read_key_sequence when the user | |
765 | 497 switches frames while entering a key sequence. */ |
518 | 498 |
499 static void | |
500 echo_truncate (len) | |
501 int len; | |
502 { | |
503 echobuf[len] = '\0'; | |
504 echoptr = echobuf + strlen (echobuf); | |
505 } | |
506 | |
507 | |
508 /* Functions for manipulating this_command_keys. */ | |
509 static void | |
510 add_command_key (key) | |
511 Lisp_Object key; | |
512 { | |
513 if (this_command_key_count == this_command_keys_size) | |
514 { | |
515 this_command_keys_size *= 2; | |
516 this_command_keys | |
517 = (Lisp_Object *) xrealloc (this_command_keys, | |
518 (this_command_keys_size | |
519 * sizeof (Lisp_Object))); | |
520 } | |
521 this_command_keys[this_command_key_count++] = key; | |
522 } | |
523 | |
524 Lisp_Object | |
525 recursive_edit_1 () | |
526 { | |
527 int count = specpdl_ptr - specpdl; | |
528 Lisp_Object val; | |
529 | |
530 if (command_loop_level > 0) | |
531 { | |
532 specbind (Qstandard_output, Qt); | |
533 specbind (Qstandard_input, Qt); | |
534 } | |
535 | |
536 val = command_loop (); | |
537 if (EQ (val, Qt)) | |
538 Fsignal (Qquit, Qnil); | |
539 | |
540 unbind_to (count); | |
541 return Qnil; | |
542 } | |
543 | |
544 /* When an auto-save happens, record the "time", and don't do again soon. */ | |
545 record_auto_save () | |
546 { | |
547 last_auto_save = num_input_chars; | |
548 } | |
549 | |
550 Lisp_Object recursive_edit_unwind (), command_loop (); | |
551 | |
552 DEFUN ("recursive-edit", Frecursive_edit, Srecursive_edit, 0, 0, "", | |
553 "Invoke the editor command loop recursively.\n\ | |
554 To get out of the recursive edit, a command can do `(throw 'exit nil)';\n\ | |
555 that tells this function to return.\n\ | |
556 Alternately, `(throw 'exit t)' makes this function signal an error.\n\ | |
557 This function is called by the editor initialization to begin editing.") | |
558 () | |
559 { | |
560 int count = specpdl_ptr - specpdl; | |
561 Lisp_Object val; | |
562 | |
563 command_loop_level++; | |
564 update_mode_lines = 1; | |
565 | |
566 record_unwind_protect (recursive_edit_unwind, | |
567 (command_loop_level | |
568 && current_buffer != XBUFFER (XWINDOW (selected_window)->buffer)) | |
569 ? Fcurrent_buffer () | |
570 : Qnil); | |
571 recursive_edit_1 (); | |
572 return unbind_to (count, Qnil); | |
573 } | |
574 | |
575 Lisp_Object | |
576 recursive_edit_unwind (buffer) | |
577 Lisp_Object buffer; | |
578 { | |
579 if (!NILP (buffer)) | |
580 Fset_buffer (buffer); | |
581 | |
582 command_loop_level--; | |
583 update_mode_lines = 1; | |
584 return Qnil; | |
585 } | |
586 | |
587 Lisp_Object | |
588 cmd_error (data) | |
589 Lisp_Object data; | |
590 { | |
591 Lisp_Object errmsg, tail, errname, file_error; | |
592 Lisp_Object stream; | |
593 struct gcpro gcpro1; | |
594 int i; | |
595 | |
596 Vquit_flag = Qnil; | |
597 Vinhibit_quit = Qt; | |
598 Vstandard_output = Qt; | |
599 Vstandard_input = Qt; | |
600 Vexecuting_macro = Qnil; | |
601 echo_area_glyphs = 0; | |
602 | |
765 | 603 /* If the window system or terminal frame hasn't been initialized |
518 | 604 yet, or we're not interactive, it's best to dump this message out |
605 to stderr and exit. */ | |
765 | 606 if (! FRAME_MESSAGE_BUF (selected_frame) |
518 | 607 || noninteractive) |
608 stream = Qexternal_debugging_output; | |
609 else | |
610 { | |
611 Fdiscard_input (); | |
612 bitch_at_user (); | |
613 stream = Qt; | |
614 } | |
615 | |
616 errname = Fcar (data); | |
617 | |
618 if (EQ (errname, Qerror)) | |
619 { | |
620 data = Fcdr (data); | |
621 if (!CONSP (data)) data = Qnil; | |
622 errmsg = Fcar (data); | |
623 file_error = Qnil; | |
624 } | |
625 else | |
626 { | |
627 errmsg = Fget (errname, Qerror_message); | |
628 file_error = Fmemq (Qfile_error, | |
629 Fget (errname, Qerror_conditions)); | |
630 } | |
631 | |
632 /* Print an error message including the data items. | |
633 This is done by printing it into a scratch buffer | |
634 and then making a copy of the text in the buffer. */ | |
635 | |
636 if (!CONSP (data)) data = Qnil; | |
637 tail = Fcdr (data); | |
638 GCPRO1 (tail); | |
639 | |
640 /* For file-error, make error message by concatenating | |
641 all the data items. They are all strings. */ | |
642 if (!NILP (file_error) && !NILP (tail)) | |
643 errmsg = XCONS (tail)->car, tail = XCONS (tail)->cdr; | |
644 | |
645 if (XTYPE (errmsg) == Lisp_String) | |
646 Fprinc (errmsg, stream); | |
647 else | |
648 write_string_1 ("peculiar error", -1, stream); | |
649 | |
650 for (i = 0; CONSP (tail); tail = Fcdr (tail), i++) | |
651 { | |
652 write_string_1 (i ? ", " : ": ", 2, stream); | |
653 if (!NILP (file_error)) | |
654 Fprinc (Fcar (tail), stream); | |
655 else | |
656 Fprin1 (Fcar (tail), stream); | |
657 } | |
658 UNGCPRO; | |
659 | |
765 | 660 /* If the window system or terminal frame hasn't been initialized |
518 | 661 yet, or we're in -batch mode, this error should cause Emacs to exit. */ |
765 | 662 if (! FRAME_MESSAGE_BUF (selected_frame) |
518 | 663 || noninteractive) |
664 { | |
665 Fterpri (stream); | |
666 Fkill_emacs (make_number (-1)); | |
667 } | |
668 | |
669 Vquit_flag = Qnil; | |
670 | |
671 Vinhibit_quit = Qnil; | |
672 return make_number (0); | |
673 } | |
674 | |
675 Lisp_Object command_loop_1 (); | |
676 Lisp_Object command_loop_2 (); | |
677 Lisp_Object top_level_1 (); | |
678 | |
679 /* Entry to editor-command-loop. | |
680 This level has the catches for exiting/returning to editor command loop. | |
681 It returns nil to exit recursive edit, t to abort it. */ | |
682 | |
683 Lisp_Object | |
684 command_loop () | |
685 { | |
686 if (command_loop_level > 0 || minibuf_level > 0) | |
687 { | |
688 return internal_catch (Qexit, command_loop_2, Qnil); | |
689 } | |
690 else | |
691 while (1) | |
692 { | |
693 internal_catch (Qtop_level, top_level_1, Qnil); | |
694 internal_catch (Qtop_level, command_loop_2, Qnil); | |
695 | |
696 /* End of file in -batch run causes exit here. */ | |
697 if (noninteractive) | |
698 Fkill_emacs (Qt); | |
699 } | |
700 } | |
701 | |
702 /* Here we catch errors in execution of commands within the | |
703 editing loop, and reenter the editing loop. | |
704 When there is an error, cmd_error runs and returns a non-nil | |
705 value to us. A value of nil means that cmd_loop_1 itself | |
706 returned due to end of file (or end of kbd macro). */ | |
707 | |
708 Lisp_Object | |
709 command_loop_2 () | |
710 { | |
711 register Lisp_Object val; | |
712 | |
713 do | |
714 val = internal_condition_case (command_loop_1, Qerror, cmd_error); | |
715 while (!NILP (val)); | |
716 | |
717 return Qnil; | |
718 } | |
719 | |
720 Lisp_Object | |
721 top_level_2 () | |
722 { | |
723 return Feval (Vtop_level); | |
724 } | |
725 | |
726 Lisp_Object | |
727 top_level_1 () | |
728 { | |
729 /* On entry to the outer level, run the startup file */ | |
730 if (!NILP (Vtop_level)) | |
731 internal_condition_case (top_level_2, Qerror, cmd_error); | |
732 else if (!NILP (Vpurify_flag)) | |
733 message ("Bare impure Emacs (standard Lisp code not loaded)"); | |
734 else | |
735 message ("Bare Emacs (standard Lisp code not loaded)"); | |
736 return Qnil; | |
737 } | |
738 | |
739 DEFUN ("top-level", Ftop_level, Stop_level, 0, 0, "", | |
740 "Exit all recursive editing levels.") | |
741 () | |
742 { | |
743 Fthrow (Qtop_level, Qnil); | |
744 } | |
745 | |
746 DEFUN ("exit-recursive-edit", Fexit_recursive_edit, Sexit_recursive_edit, 0, 0, "", | |
747 "Exit from the innermost recursive edit or minibuffer.") | |
748 () | |
749 { | |
750 if (command_loop_level > 0 || minibuf_level > 0) | |
751 Fthrow (Qexit, Qnil); | |
752 | |
753 error ("No recursive edit is in progress"); | |
754 } | |
755 | |
756 DEFUN ("abort-recursive-edit", Fabort_recursive_edit, Sabort_recursive_edit, 0, 0, "", | |
757 "Abort the command that requested this recursive edit or minibuffer input.") | |
758 () | |
759 { | |
760 if (command_loop_level > 0 || minibuf_level > 0) | |
761 Fthrow (Qexit, Qt); | |
762 | |
763 error ("No recursive edit is in progress"); | |
764 } | |
765 | |
766 /* This is the actual command reading loop, | |
767 sans error-handling encapsulation. */ | |
768 | |
769 Lisp_Object Fcommand_execute (); | |
770 static int read_key_sequence (); | |
771 | |
772 Lisp_Object | |
773 command_loop_1 () | |
774 { | |
775 Lisp_Object cmd; | |
776 int lose; | |
777 int nonundocount; | |
778 Lisp_Object keybuf[30]; | |
779 int i; | |
780 int no_redisplay; | |
781 int no_direct; | |
782 | |
783 Vprefix_arg = Qnil; | |
784 waiting_for_input = 0; | |
785 cancel_echoing (); | |
786 | |
787 /* Don't clear out last_command at the beginning of a macro. */ | |
788 if (XTYPE (Vexecuting_macro) != Lisp_String) | |
789 last_command = Qt; | |
790 | |
791 nonundocount = 0; | |
792 no_redisplay = 0; | |
793 this_command_key_count = 0; | |
794 | |
795 while (1) | |
796 { | |
797 /* Install chars successfully executed in kbd macro. */ | |
798 | |
799 if (defining_kbd_macro && NILP (Vprefix_arg)) | |
800 finalize_kbd_macro_chars (); | |
801 | |
802 /* Make sure the current window's buffer is selected. */ | |
803 if (XBUFFER (XWINDOW (selected_window)->buffer) != current_buffer) | |
804 set_buffer_internal (XBUFFER (XWINDOW (selected_window)->buffer)); | |
805 | |
806 /* Display any malloc warning that just came out. Use while because | |
807 displaying one warning can cause another. */ | |
808 | |
809 while (pending_malloc_warning) | |
810 display_malloc_warning (); | |
811 | |
812 no_direct = 0; | |
813 | |
814 /* If minibuffer on and echo area in use, | |
815 wait 2 sec and redraw minibufer. */ | |
816 | |
817 if (minibuf_level && echo_area_glyphs) | |
818 { | |
819 Fsit_for (make_number (2), Qnil, Qnil); | |
820 echo_area_glyphs = 0; | |
821 no_direct = 1; | |
822 if (!NILP (Vquit_flag)) | |
823 { | |
824 Vquit_flag = Qnil; | |
825 unread_command_char = make_number (quit_char); | |
826 } | |
827 } | |
828 | |
829 #ifdef C_ALLOCA | |
830 alloca (0); /* Cause a garbage collection now */ | |
831 /* Since we can free the most stuff here. */ | |
832 #endif /* C_ALLOCA */ | |
833 | |
834 /* Read next key sequence; i gets its length. */ | |
835 i = read_key_sequence (keybuf, (sizeof keybuf / sizeof (keybuf[0])), 0); | |
836 | |
837 ++num_input_keys; | |
838 | |
765 | 839 #ifdef MULTI_FRAME |
840 /* Select the frame that the key sequence came from. */ | |
841 if (XTYPE (Vlast_event_frame) == Lisp_Frame | |
842 && XFRAME (Vlast_event_frame) != selected_frame) | |
843 Fselect_frame (Vlast_event_frame, Qnil); | |
518 | 844 #endif |
845 | |
846 /* Now we have read a key sequence of length I, | |
847 or else I is 0 and we found end of file. */ | |
848 | |
849 if (i == 0) /* End of file -- happens only in */ | |
850 return Qnil; /* a kbd macro, at the end. */ | |
851 | |
852 #if 0 | |
853 #ifdef HAVE_X_WINDOWS | |
765 | 854 if (FRAME_IS_X (selected_frame)) |
518 | 855 { |
856 if (i == -1) /* Mouse event */ | |
857 { | |
858 nonundocount = 0; | |
859 if (NILP (Vprefix_arg) && NILP (Vexecuting_macro) && | |
860 !EQ (minibuf_window, selected_window)) | |
861 Fundo_boundary (); | |
862 | |
863 if (defining_kbd_macro) | |
864 { | |
865 /* Be nice if this worked... */ | |
866 } | |
867 Fexecute_mouse_event (read_key_sequence_cmd); | |
868 no_redisplay = 0; | |
869 goto directly_done; | |
870 } | |
871 | |
872 if (i == -2) /* Lisp Symbol */ | |
873 { | |
874 nonundocount = 0; | |
875 if (NILP (Vprefix_arg) && NILP (Vexecuting_macro) && | |
876 !EQ (minibuf_window, selected_window)) | |
877 Fundo_boundary (); | |
878 | |
879 goto directly_done; | |
880 } | |
881 } | |
882 #endif /* HAVE_X_WINDOWS */ | |
883 #endif | |
884 | |
885 last_command_char = keybuf[i - 1]; | |
886 | |
887 cmd = read_key_sequence_cmd; | |
888 if (!NILP (Vexecuting_macro)) | |
889 { | |
890 if (!NILP (Vquit_flag)) | |
891 { | |
892 Vexecuting_macro = Qt; | |
893 QUIT; /* Make some noise. */ | |
894 /* Will return since macro now empty. */ | |
895 } | |
896 } | |
897 | |
898 /* Do redisplay processing after this command except in special | |
899 cases identified below that set no_redisplay to 1. */ | |
900 no_redisplay = 0; | |
901 | |
902 /* Execute the command. */ | |
903 | |
904 if (NILP (cmd)) | |
905 { | |
906 /* nil means key is undefined. */ | |
907 bitch_at_user (); | |
908 defining_kbd_macro = 0; | |
909 update_mode_lines = 1; | |
910 Vprefix_arg = Qnil; | |
911 } | |
912 else | |
913 { | |
914 this_command = cmd; | |
915 if (NILP (Vprefix_arg) && ! no_direct) | |
916 { | |
917 /* Recognize some common commands in common situations and | |
918 do them directly. */ | |
919 if (EQ (cmd, Qforward_char) && point < ZV) | |
920 { | |
921 struct Lisp_Vector *dp | |
922 = window_display_table (XWINDOW (selected_window)); | |
923 lose = FETCH_CHAR (point); | |
924 SET_PT (point + 1); | |
925 if (((dp == 0 && lose >= 040 && lose < 0177) | |
926 || | |
927 (dp && (XTYPE (dp->contents[lose]) != Lisp_String | |
928 || XSTRING (dp->contents[lose])->size == sizeof (GLYPH)))) | |
929 && (XFASTINT (XWINDOW (selected_window)->last_modified) | |
930 >= MODIFF) | |
931 && (XFASTINT (XWINDOW (selected_window)->last_point) | |
932 == point - 1) | |
933 && !windows_or_buffers_changed | |
934 && EQ (current_buffer->selective_display, Qnil) | |
935 && !detect_input_pending () | |
936 && NILP (Vexecuting_macro)) | |
937 no_redisplay = direct_output_forward_char (1); | |
938 goto directly_done; | |
939 } | |
940 else if (EQ (cmd, Qbackward_char) && point > BEGV) | |
941 { | |
942 struct Lisp_Vector *dp | |
943 = window_display_table (XWINDOW (selected_window)); | |
944 SET_PT (point - 1); | |
945 lose = FETCH_CHAR (point); | |
946 if (((dp == 0 && lose >= 040 && lose < 0177) | |
947 || | |
948 (dp && (XTYPE (dp->contents[lose]) != Lisp_String | |
949 || XSTRING (dp->contents[lose])->size == sizeof (GLYPH)))) | |
950 && (XFASTINT (XWINDOW (selected_window)->last_modified) | |
951 >= MODIFF) | |
952 && (XFASTINT (XWINDOW (selected_window)->last_point) | |
953 == point + 1) | |
954 && !windows_or_buffers_changed | |
955 && EQ (current_buffer->selective_display, Qnil) | |
956 && !detect_input_pending () | |
957 && NILP (Vexecuting_macro)) | |
958 no_redisplay = direct_output_forward_char (-1); | |
959 goto directly_done; | |
960 } | |
961 else if (EQ (cmd, Qself_insert_command) | |
962 /* Try this optimization only on ascii keystrokes. */ | |
963 && XTYPE (last_command_char) == Lisp_Int) | |
964 { | |
965 unsigned char c = XINT (last_command_char); | |
966 | |
967 if (NILP (Vexecuting_macro) && | |
968 !EQ (minibuf_window, selected_window)) | |
969 { | |
970 if (!nonundocount || nonundocount >= 20) | |
971 { | |
972 Fundo_boundary (); | |
973 nonundocount = 0; | |
974 } | |
975 nonundocount++; | |
976 } | |
977 lose = (XFASTINT (XWINDOW (selected_window)->last_modified) | |
978 < MODIFF) | |
979 || (XFASTINT (XWINDOW (selected_window)->last_point) | |
980 != point) | |
981 || MODIFF <= current_buffer->save_modified | |
982 || windows_or_buffers_changed | |
983 || !EQ (current_buffer->selective_display, Qnil) | |
984 || detect_input_pending () | |
985 || !NILP (Vexecuting_macro); | |
986 if (internal_self_insert (c, 0)) | |
987 { | |
988 lose = 1; | |
989 nonundocount = 0; | |
990 } | |
991 if (!lose && | |
992 (point == ZV || FETCH_CHAR (point) == '\n')) | |
993 { | |
994 struct Lisp_Vector *dp | |
995 = window_display_table (XWINDOW (selected_window)); | |
996 | |
997 if (dp == 0 || XTYPE (dp->contents[c]) != Lisp_String) | |
998 no_redisplay = direct_output_for_insert (c); | |
999 else if (XSTRING (dp->contents[c])->size | |
1000 == sizeof (GLYPH)) | |
1001 no_redisplay = | |
1002 direct_output_for_insert (*(GLYPH *)XSTRING (dp->contents[c])->data); | |
1003 } | |
1004 goto directly_done; | |
1005 } | |
1006 } | |
1007 | |
1008 /* Here for a command that isn't executed directly */ | |
1009 | |
1010 nonundocount = 0; | |
1011 if (NILP (Vprefix_arg)) | |
1012 Fundo_boundary (); | |
1013 Fcommand_execute (cmd, Qnil); | |
1014 | |
1015 } | |
547 | 1016 directly_done: ; |
518 | 1017 |
1018 /* If there is a prefix argument, | |
1019 1) We don't want last_command to be ``universal-argument'' | |
1020 (that would be dumb), so don't set last_command, | |
1021 2) we want to leave echoing on so that the prefix will be | |
1022 echoed as part of this key sequence, so don't call | |
1023 cancel_echoing, and | |
1024 3) we want to leave this_command_key_count non-zero, so that | |
1025 read_char will realize that it is re-reading a character, and | |
1026 not echo it a second time. */ | |
1027 if (NILP (Vprefix_arg)) | |
1028 { | |
1029 last_command = this_command; | |
1030 cancel_echoing (); | |
1031 this_command_key_count = 0; | |
1032 } | |
1033 } | |
1034 } | |
1035 | |
1036 /* Number of seconds between polling for input. */ | |
1037 int polling_period; | |
1038 | |
1039 /* Nonzero means polling for input is temporarily suppresed. */ | |
1040 int poll_suppress_count; | |
1041 | |
1042 #ifdef POLL_FOR_INPUT | |
1043 int polling_for_input; | |
1044 | |
1045 /* Handle an alarm once each second and read pending input | |
1046 so as to handle a C-g if it comces in. */ | |
1047 | |
1048 SIGTYPE | |
1049 input_poll_signal () | |
1050 { | |
1051 #ifdef HAVE_X_WINDOWS | |
1052 extern int x_input_blocked; | |
1053 if (x_input_blocked == 0) | |
1054 #endif | |
1055 if (!waiting_for_input) | |
1056 read_avail_input (0); | |
1057 signal (SIGALRM, input_poll_signal); | |
1058 alarm (polling_period); | |
1059 } | |
1060 | |
1061 #endif | |
1062 | |
1063 /* Begin signals to poll for input, if they are appropriate. | |
1064 This function is called unconditionally from various places. */ | |
1065 | |
1066 start_polling () | |
1067 { | |
1068 #ifdef POLL_FOR_INPUT | |
1069 if (read_socket_hook) | |
1070 { | |
1071 poll_suppress_count--; | |
1072 if (poll_suppress_count == 0) | |
1073 { | |
1074 signal (SIGALRM, input_poll_signal); | |
1075 polling_for_input = 1; | |
1076 alarm (polling_period); | |
1077 } | |
1078 } | |
1079 #endif | |
1080 } | |
1081 | |
1082 /* Turn off polling. */ | |
1083 | |
1084 stop_polling () | |
1085 { | |
1086 #ifdef POLL_FOR_INPUT | |
1087 if (read_socket_hook) | |
1088 { | |
1089 if (poll_suppress_count == 0) | |
1090 { | |
1091 polling_for_input = 0; | |
1092 alarm (0); | |
1093 } | |
1094 poll_suppress_count++; | |
1095 } | |
1096 #endif | |
1097 } | |
1098 | |
1099 /* Input of single characters from keyboard */ | |
1100 | |
1101 Lisp_Object print_help (); | |
1102 static Lisp_Object kbd_buffer_get_event (); | |
1103 | |
1104 /* read a character from the keyboard; call the redisplay if needed */ | |
1105 /* commandflag 0 means do not do auto-saving, but do do redisplay. | |
1106 -1 means do not do redisplay, but do do autosaving. | |
1107 1 means do both. */ | |
1108 | |
1109 Lisp_Object | |
1110 read_char (commandflag) | |
1111 int commandflag; | |
1112 { | |
1113 register Lisp_Object c; | |
1114 int count; | |
1115 jmp_buf save_jump; | |
1116 | |
1117 if (!NILP (unread_command_char)) | |
1118 { | |
1119 c = unread_command_char; | |
1120 unread_command_char = Qnil; | |
1121 | |
1122 #if 0 /* We're not handling mouse keys specially anymore. */ | |
1123 if (!EQ (XTYPE (obj), Lisp_Int)) /* Mouse thing */ | |
1124 { | |
1125 num_input_chars++; | |
1126 last_input_char = 0; | |
1127 return obj; | |
1128 } | |
1129 #endif | |
1130 | |
1131 if (this_command_key_count == 0) | |
1132 goto reread_first; | |
1133 else | |
1134 goto reread; | |
1135 } | |
1136 | |
1137 if (!NILP (Vexecuting_macro)) | |
1138 { | |
1139 if (executing_macro_index >= Flength (Vexecuting_macro)) | |
1140 { | |
1141 XSET (c, Lisp_Int, -1); | |
1142 return c; | |
1143 } | |
1144 | |
1145 c = Faref (Vexecuting_macro, make_number (executing_macro_index)); | |
1146 executing_macro_index++; | |
1147 | |
1148 goto from_macro; | |
1149 } | |
1150 | |
1151 /* Save outer setjmp data, in case called recursively. */ | |
650 | 1152 save_getcjmp (save_jump); |
518 | 1153 |
1154 stop_polling (); | |
1155 | |
1156 if (commandflag >= 0 && !input_pending && !detect_input_pending ()) | |
1157 redisplay (); | |
1158 | |
1159 if (_setjmp (getcjmp)) | |
1160 { | |
1161 XSET (c, Lisp_Int, quit_char); | |
765 | 1162 #ifdef MULTI_FRAME |
1163 XSET (Vlast_event_frame, Lisp_Frame, selected_frame); | |
586 | 1164 #endif |
518 | 1165 |
1166 goto non_reread; | |
1167 } | |
1168 | |
1169 /* Message turns off echoing unless more keystrokes turn it on again. */ | |
1170 if (echo_area_glyphs && *echo_area_glyphs && echo_area_glyphs != echobuf) | |
1171 cancel_echoing (); | |
1172 else | |
1173 /* If already echoing, continue. */ | |
1174 echo_dash (); | |
1175 | |
1176 /* If in middle of key sequence and minibuffer not active, | |
1177 start echoing if enough time elapses. */ | |
1178 if (minibuf_level == 0 && !immediate_echo && this_command_key_count > 0 | |
1179 && echo_keystrokes > 0 | |
1180 && (echo_area_glyphs == 0 || *echo_area_glyphs == 0)) | |
1181 { | |
1182 Lisp_Object tem0; | |
1183 | |
650 | 1184 tem0 = sit_for (echo_keystrokes, 0, 1, 1); |
518 | 1185 if (EQ (tem0, Qt)) |
1186 echo (); | |
1187 } | |
1188 | |
1189 /* Maybe auto save due to number of keystrokes or idle time. */ | |
1190 | |
1191 if (commandflag != 0 | |
1192 && auto_save_interval > 0 | |
1193 && num_input_chars - last_auto_save > max (auto_save_interval, 20) | |
1194 && !detect_input_pending ()) | |
1195 { | |
1196 jmp_buf temp; | |
1197 save_getcjmp (temp); | |
1198 Fdo_auto_save (Qnil, Qnil); | |
1199 restore_getcjmp (temp); | |
1200 } | |
1201 | |
1202 /* Slow down auto saves logarithmically in size of current buffer, | |
1203 and garbage collect while we're at it. */ | |
1204 { | |
1205 int delay_level, buffer_size; | |
1206 | |
1207 if (! MINI_WINDOW_P (XWINDOW (selected_window))) | |
1208 last_non_minibuf_size = Z - BEG; | |
1209 buffer_size = (last_non_minibuf_size >> 8) + 1; | |
1210 delay_level = 0; | |
1211 while (buffer_size > 64) | |
1212 delay_level++, buffer_size -= buffer_size >> 2; | |
1213 if (delay_level < 4) delay_level = 4; | |
1214 /* delay_level is 4 for files under around 50k, 7 at 100k, | |
1215 9 at 200k, 11 at 300k, and 12 at 500k. It is 15 at 1 meg. */ | |
1216 | |
1217 /* Auto save if enough time goes by without input. */ | |
1218 if (commandflag != 0 | |
1219 && num_input_chars > last_auto_save | |
1220 && XTYPE (Vauto_save_timeout) == Lisp_Int | |
1221 && XINT (Vauto_save_timeout) > 0) | |
1222 { | |
1223 Lisp_Object tem0; | |
1224 int delay = delay_level * XFASTINT (Vauto_save_timeout) / 4; | |
650 | 1225 tem0 = sit_for (delay, 0, 1, 1); |
518 | 1226 if (EQ (tem0, Qt)) |
1227 { | |
1228 jmp_buf temp; | |
1229 save_getcjmp (temp); | |
1230 Fdo_auto_save (Qnil, Qnil); | |
1231 restore_getcjmp (temp); | |
1232 | |
1233 /* If we have auto-saved and there is still no input | |
1234 available, garbage collect if there has been enough | |
1235 consing going on to make it worthwhile. */ | |
1236 if (!detect_input_pending () | |
1237 && consing_since_gc > gc_cons_threshold / 2) | |
1238 Fgarbage_collect (); | |
1239 } | |
1240 } | |
1241 } | |
1242 | |
1243 /* Actually read a character, waiting if necessary. */ | |
1244 c = kbd_buffer_get_event (); | |
1245 | |
1246 if (NILP (c)) | |
1247 abort (); /* Don't think this can happen. */ | |
1248 | |
1249 #if 0 /* I think that all the different kinds of events should be | |
1250 handled together now... */ | |
1251 if (XTYPE (c) != Lisp_Int) | |
1252 { | |
1253 start_polling (); | |
1254 return c; | |
1255 } | |
1256 c = XINT (obj); | |
1257 #endif | |
1258 | |
1259 /* Terminate Emacs in batch mode if at eof. */ | |
1260 if (noninteractive && c < 0) | |
1261 Fkill_emacs (make_number (1)); | |
1262 | |
1263 non_reread: | |
1264 | |
650 | 1265 restore_getcjmp (save_jump); |
518 | 1266 |
1267 start_polling (); | |
1268 | |
1269 echo_area_glyphs = 0; | |
1270 | |
1271 /* Handle things that only apply to characters. */ | |
1272 if (XTYPE (c) == Lisp_Int) | |
1273 { | |
1274 /* If kbd_buffer_get_event gave us an EOF, return that. */ | |
1275 if (XINT (c) < 0) | |
1276 return c; | |
1277 | |
1278 /* Strip the high bits, and maybe the meta bit too. */ | |
1279 XSETINT (c, c & (meta_key ? 0377 : 0177)); | |
1280 | |
1281 if (XTYPE (Vkeyboard_translate_table) == Lisp_String | |
1282 && XSTRING (Vkeyboard_translate_table)->size > XINT (c)) | |
1283 XSETINT (c, XSTRING (Vkeyboard_translate_table)->data[c]); | |
1284 } | |
1285 | |
1286 total_keys++; | |
1287 recent_keys[recent_keys_index] = c; | |
1288 if (++recent_keys_index >= (sizeof (recent_keys)/sizeof(recent_keys[0]))) | |
1289 recent_keys_index = 0; | |
1290 | |
1291 /* Write c to the dribble file. If c is a lispy event, write | |
1292 the event's symbol to the dribble file, in <brackets>. Bleaugh. | |
1293 If you, dear reader, have a better idea, you've got the source. :-) */ | |
1294 if (dribble) | |
1295 { | |
1296 if (XTYPE (c) == Lisp_Int) | |
1297 putc (c, dribble); | |
1298 else | |
1299 { | |
1300 Lisp_Object dribblee = c; | |
1301 | |
1302 /* If it's a structured event, take the event header. */ | |
1303 if (EVENT_HAS_PARAMETERS (dribblee)) | |
1304 dribblee = EVENT_HEAD (dribblee); | |
1305 | |
1306 if (XTYPE (c) == Lisp_Symbol) | |
1307 { | |
1308 putc ('<', dribble); | |
1309 fwrite (XSYMBOL (c)->name->data, sizeof (char), | |
1310 XSYMBOL (c)->name->size, | |
1311 dribble); | |
1312 putc ('>', dribble); | |
1313 } | |
1314 } | |
1315 | |
1316 fflush (dribble); | |
1317 } | |
1318 | |
1319 store_kbd_macro_char (c); | |
1320 | |
1321 from_macro: | |
1322 reread_first: | |
1323 echo_char (c); | |
1324 | |
1325 /* Record this character as part of the current key. */ | |
1326 add_command_key (c); | |
1327 | |
1328 /* Re-reading in the middle of a command */ | |
1329 reread: | |
1330 last_input_char = c; | |
1331 num_input_chars++; | |
1332 | |
1333 /* Process the help character specially if enabled */ | |
1334 if (EQ (c, help_char) && !NILP (Vhelp_form)) | |
1335 { | |
1336 Lisp_Object tem0; | |
1337 count = specpdl_ptr - specpdl; | |
1338 | |
1339 record_unwind_protect (Fset_window_configuration, | |
1340 Fcurrent_window_configuration (Qnil)); | |
1341 | |
1342 tem0 = Feval (Vhelp_form); | |
1343 if (XTYPE (tem0) == Lisp_String) | |
1344 internal_with_output_to_temp_buffer ("*Help*", print_help, tem0); | |
1345 | |
1346 cancel_echoing (); | |
1347 c = read_char (0); | |
765 | 1348 /* Remove the help from the frame */ |
518 | 1349 unbind_to (count, Qnil); |
1350 redisplay (); | |
1351 if (EQ (c, make_number (040))) | |
1352 { | |
1353 cancel_echoing (); | |
1354 c = read_char (0); | |
1355 } | |
1356 } | |
1357 | |
1358 return c; | |
1359 } | |
1360 | |
1361 Lisp_Object | |
1362 print_help (object) | |
1363 Lisp_Object object; | |
1364 { | |
1365 Fprinc (object, Qnil); | |
1366 return Qnil; | |
1367 } | |
1368 | |
1369 /* Copy out or in the info on where C-g should throw to. | |
1370 This is used when running Lisp code from within get_char, | |
1371 in case get_char is called recursively. | |
1372 See read_process_output. */ | |
1373 | |
1374 save_getcjmp (temp) | |
1375 jmp_buf temp; | |
1376 { | |
1377 bcopy (getcjmp, temp, sizeof getcjmp); | |
1378 } | |
1379 | |
1380 restore_getcjmp (temp) | |
1381 jmp_buf temp; | |
1382 { | |
1383 bcopy (temp, getcjmp, sizeof getcjmp); | |
1384 } | |
1385 | |
1386 | |
1387 /* Low level keyboard/mouse input. | |
1388 kbd_buffer_store_event places events in kbd_buffer, and | |
1389 kbd_buffer_get_event retrieves them. | |
1390 mouse_moved indicates when the mouse has moved again, and | |
1391 *mouse_position_hook provides the mouse position. */ | |
1392 | |
1393 /* Set this for debugging, to have a way to get out */ | |
1394 int stop_character; | |
1395 | |
765 | 1396 extern int frame_garbaged; |
518 | 1397 |
1398 /* Return true iff there are any events in the queue that read-char | |
1399 would return. If this returns false, a read-char would block. */ | |
1400 static int | |
1401 readable_events () | |
1402 { | |
1403 struct input_event *ep; | |
1404 | |
1405 if (EVENT_QUEUES_EMPTY) | |
1406 return 0; | |
1407 | |
1408 if (do_mouse_tracking) | |
1409 return 1; | |
1410 | |
1411 /* Mouse tracking is disabled, so we need to actually scan the | |
1412 input queue to see if any events are currently readable. */ | |
1413 for (ep = kbd_fetch_ptr; ep != kbd_store_ptr; ep++) | |
1414 { | |
1415 if (ep == kbd_buffer + KBD_BUFFER_SIZE) | |
1416 ep = kbd_buffer; | |
1417 | |
1418 /* Skip button-up events. */ | |
1419 if ((ep->kind == mouse_click || ep->kind == scrollbar_click) | |
1420 && (ep->modifiers & up_modifier)) | |
1421 continue; | |
1422 | |
1423 return 1; | |
1424 } | |
1425 | |
1426 return 0; | |
1427 } | |
1428 | |
1429 | |
1430 /* Restore mouse tracking enablement. See Ftrack_mouse for the only use | |
1431 of this function. */ | |
1432 static Lisp_Object | |
1433 tracking_off (old_value) | |
1434 Lisp_Object old_value; | |
1435 { | |
1436 if (! XFASTINT (old_value)) | |
1437 { | |
1438 do_mouse_tracking = 0; | |
1439 | |
1440 /* Redisplay may have been preempted because there was input | |
1441 available, and it assumes it will be called again after the | |
1442 input has been processed. If the only input available was | |
1443 the sort that we have just disabled, then we need to call | |
1444 redisplay. */ | |
1445 if (!readable_events ()) | |
1446 { | |
1447 redisplay_preserve_echo_area (); | |
1448 get_input_pending (&input_pending); | |
1449 } | |
1450 } | |
1451 } | |
1452 | |
1453 DEFUN ("track-mouse", Ftrack_mouse, Strack_mouse, 0, UNEVALLED, 0, | |
1454 "Evaluate BODY with mouse movement and button release events enabled.\n\ | |
682
71f59bd24996
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
650
diff
changeset
|
1455 Within a `track-mouse', mouse motion and button releases generate input\n\ |
71f59bd24996
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
650
diff
changeset
|
1456 events that you can read with `read-event'.\n\ |
71f59bd24996
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
650
diff
changeset
|
1457 Normally, these occurrences don't generate events.") |
518 | 1458 (args) |
1459 Lisp_Object args; | |
1460 { | |
1461 int count = specpdl_ptr - specpdl; | |
1462 Lisp_Object val; | |
1463 | |
1464 XSET (val, Lisp_Int, do_mouse_tracking); | |
1465 record_unwind_protect (tracking_off, val); | |
1466 | |
1467 do_mouse_tracking = 1; | |
1468 | |
1469 val = Fprogn (args); | |
1470 return unbind_to (count, val); | |
1471 } | |
1472 | |
1473 /* Store an event obtained at interrupt level into kbd_buffer, fifo */ | |
1474 | |
1475 void | |
1476 kbd_buffer_store_event (event) | |
1477 register struct input_event *event; | |
1478 { | |
1479 if (event->kind == no_event) | |
1480 abort (); | |
1481 | |
1482 if (event->kind == ascii_keystroke) | |
1483 { | |
1484 register int c = XFASTINT (event->code) & 0377; | |
1485 | |
1486 if (c == quit_char | |
1487 || ((c == (0200 | quit_char)) && !meta_key)) | |
1488 { | |
1489 /* If this results in a quit_char being returned to Emacs as | |
765 | 1490 input, set last-event-frame properly. If this doesn't |
518 | 1491 get returned to Emacs as an event, the next event read |
765 | 1492 will set Vlast_event_frame again, so this is safe to do. */ |
518 | 1493 extern SIGTYPE interrupt_signal (); |
765 | 1494 Vlast_event_frame = FRAME_FOCUS_FRAME (event->frame); |
648 | 1495 last_event_timestamp = event->timestamp; |
518 | 1496 interrupt_signal (); |
1497 return; | |
1498 } | |
1499 | |
1500 if (c && c == stop_character) | |
1501 { | |
1502 sys_suspend (); | |
1503 return; | |
1504 } | |
1505 | |
1506 XSET (event->code, Lisp_Int, c); | |
1507 } | |
1508 | |
1509 if (kbd_store_ptr - kbd_buffer == KBD_BUFFER_SIZE) | |
1510 kbd_store_ptr = kbd_buffer; | |
1511 | |
1512 /* Don't let the very last slot in the buffer become full, | |
1513 since that would make the two pointers equal, | |
1514 and that is indistinguishable from an empty buffer. | |
1515 Discard the event if it would fill the last slot. */ | |
1516 if (kbd_fetch_ptr - 1 != kbd_store_ptr) | |
1517 { | |
1518 kbd_store_ptr->kind = event->kind; | |
1519 kbd_store_ptr->code = event->code; | |
1520 kbd_store_ptr->part = event->part; | |
765 | 1521 kbd_store_ptr->frame = event->frame; |
518 | 1522 kbd_store_ptr->modifiers = event->modifiers; |
1523 kbd_store_ptr->x = event->x; | |
1524 kbd_store_ptr->y = event->y; | |
1525 kbd_store_ptr->timestamp = event->timestamp; | |
1526 | |
1527 kbd_store_ptr++; | |
1528 } | |
1529 } | |
1530 | |
1531 static Lisp_Object make_lispy_event (); | |
1532 static Lisp_Object make_lispy_movement (); | |
1533 static Lisp_Object modify_event_symbol (); | |
1534 | |
1535 static Lisp_Object | |
1536 kbd_buffer_get_event () | |
1537 { | |
1538 register int c; | |
1539 Lisp_Object obj; | |
1540 | |
1541 if (noninteractive) | |
1542 { | |
1543 c = getchar (); | |
1544 XSET (obj, Lisp_Int, c); | |
1545 return obj; | |
1546 } | |
1547 | |
1548 /* Wait until there is input available. */ | |
1549 for (;;) | |
1550 { | |
1551 | |
1552 /* Process or toss any events that we don't want to return as | |
1553 input. The fact that we remove undesirable events here | |
1554 allows us to use EVENT_QUEUES_EMPTY in the rest of this loop. */ | |
1555 if (! do_mouse_tracking) | |
1556 while (kbd_fetch_ptr != kbd_store_ptr) | |
1557 { | |
1558 if (kbd_fetch_ptr == kbd_buffer + KBD_BUFFER_SIZE) | |
1559 kbd_fetch_ptr = kbd_buffer; | |
1560 | |
1561 if (kbd_fetch_ptr->kind == mouse_click | |
1562 || kbd_fetch_ptr->kind == scrollbar_click) | |
1563 { | |
1564 if ((kbd_fetch_ptr->modifiers & up_modifier) == 0) | |
1565 break; | |
1566 } | |
1567 else | |
1568 break; | |
1569 | |
1570 kbd_fetch_ptr++; | |
1571 } | |
1572 | |
1573 if (!EVENT_QUEUES_EMPTY) | |
1574 break; | |
1575 | |
1576 /* If the quit flag is set, then read_char will return | |
1577 quit_char, so that counts as "available input." */ | |
1578 if (!NILP (Vquit_flag)) | |
1579 quit_throw_to_read_char (); | |
1580 | |
1581 /* One way or another, wait until input is available; then, if | |
1582 interrupt handlers have not read it, read it now. */ | |
1583 | |
1584 #ifdef OLDVMS | |
1585 wait_for_kbd_input (); | |
1586 #else | |
1587 /* Note SIGIO has been undef'd if FIONREAD is missing. */ | |
1588 #ifdef SIGIO | |
1589 gobble_input (0); | |
1590 #endif /* SIGIO */ | |
1591 if (EVENT_QUEUES_EMPTY) | |
1592 { | |
650 | 1593 Lisp_Object minus_one; |
1594 | |
1595 XSET (minus_one, Lisp_Int, -1); | |
1596 wait_reading_process_input (0, 0, minus_one, 1); | |
518 | 1597 |
1598 if (!interrupt_input && EVENT_QUEUES_EMPTY) | |
1599 { | |
1600 read_avail_input (0); | |
1601 } | |
1602 } | |
1603 #endif /* not VMS */ | |
1604 } | |
1605 | |
1606 /* At this point, we know that there is a readable event available | |
1607 somewhere. If the event queue is empty, then there must be a | |
1608 mouse movement enabled and available. */ | |
1609 if (kbd_fetch_ptr != kbd_store_ptr) | |
1610 { | |
1611 if (kbd_fetch_ptr == kbd_buffer + KBD_BUFFER_SIZE) | |
1612 kbd_fetch_ptr = kbd_buffer; | |
765 | 1613 /* Do the redirection specified by the focus_frame |
727 | 1614 member now, before we return this event. */ |
765 | 1615 kbd_fetch_ptr->frame = |
1616 XFRAME (FRAME_FOCUS_FRAME (kbd_fetch_ptr->frame)); | |
1617 XSET (Vlast_event_frame, Lisp_Frame, kbd_fetch_ptr->frame); | |
708 | 1618 last_event_timestamp = kbd_fetch_ptr->timestamp; |
518 | 1619 obj = make_lispy_event (kbd_fetch_ptr); |
1620 kbd_fetch_ptr->kind = no_event; | |
1621 kbd_fetch_ptr++; | |
1622 if (XTYPE (obj) == Lisp_Int) | |
1623 XSET (obj, Lisp_Int, XINT (obj) & (meta_key ? 0377 : 0177)); | |
1624 } | |
1625 else if (do_mouse_tracking && mouse_moved) | |
1626 { | |
765 | 1627 FRAME_PTR frame; |
732 | 1628 Lisp_Object x, y; |
1629 unsigned long time; | |
518 | 1630 |
765 | 1631 (*mouse_position_hook) (&frame, &x, &y, &time); |
1632 XSET (Vlast_event_frame, Lisp_Frame, frame); | |
1633 | |
1634 obj = make_lispy_movement (frame, x, y, time); | |
518 | 1635 } |
1636 else | |
1637 /* We were promised by the above while loop that there was | |
1638 something for us to read! */ | |
1639 abort (); | |
1640 | |
1641 input_pending = readable_events (); | |
1642 | |
1643 return (obj); | |
1644 } | |
1645 | |
1646 /* Caches for modify_event_symbol. */ | |
1647 static Lisp_Object func_key_syms; | |
1648 static Lisp_Object mouse_syms; | |
1649 | |
1650 /* You'll notice that this table is arranged to be conveniently | |
1651 indexed by X Windows keysym values. */ | |
1652 static char *lispy_function_keys[] = | |
1653 { | |
1654 /* X Keysym value */ | |
1655 | |
1656 "home", /* 0xff50 */ /* IsCursorKey */ | |
1657 "left", | |
1658 "up", | |
1659 "right", | |
1660 "down", | |
1661 "prior", | |
1662 "next", | |
1663 "end", | |
1664 "begin", | |
1665 0, /* 0xff59 */ | |
1666 0, 0, 0, 0, 0, 0, | |
1667 "select", /* 0xff60 */ /* IsMiscFunctionKey */ | |
1668 "print", | |
1669 "execute", | |
1670 "insert", | |
1671 0, /* 0xff64 */ | |
1672 "undo", | |
1673 "redo", | |
1674 "menu", | |
1675 "find", | |
1676 "cancel", | |
1677 "help", | |
1678 "break", /* 0xff6b */ | |
1679 | |
1680 /* Here are some keys found mostly on HP keyboards. The X event | |
1681 handling code will strip bit 29, which flags vendor-specific | |
1682 keysyms. */ | |
1683 "reset", /* 0x1000ff6c */ | |
1684 "system", | |
1685 "user", | |
1686 "clearline", | |
1687 "insertline", | |
1688 "deleteline", | |
1689 "insertchar", | |
1690 "deletechar", | |
1691 "backtab", | |
1692 "kp_backtab", /* 0x1000ff75 */ | |
1693 0, /* 0xff76 */ | |
1694 0, 0, 0, 0, 0, 0, 0, 0, 0, /* 0xff7f */ | |
1695 "kp-space", /* 0xff80 */ /* IsKeypadKey */ | |
1696 0, 0, 0, 0, 0, 0, 0, 0, | |
1697 "kp-tab", /* 0xff89 */ | |
1698 0, 0, 0, | |
1699 "kp-enter", /* 0xff8d */ | |
1700 0, 0, 0, | |
1701 "kp-f1", /* 0xff91 */ | |
1702 "kp-f2", | |
1703 "kp-f3", | |
1704 "kp-f4", | |
1705 0, /* 0xff95 */ | |
1706 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, | |
1707 "kp-multiply", /* 0xffaa */ | |
1708 "kp-add", | |
1709 "kp-separator", | |
1710 "kp-subtract", | |
1711 "kp-decimal", | |
1712 "kp-divide", /* 0xffaf */ | |
1713 "kp-0", /* 0xffb0 */ | |
1714 "kp-1", "kp-2", "kp-3", "kp-4", "kp-5", "kp-6", "kp-7", "kp-8", "kp-9", | |
1715 0, /* 0xffba */ | |
1716 0, 0, | |
1717 "kp-equal", /* 0xffbd */ | |
1718 "f1", /* 0xffbe */ /* IsFunctionKey */ | |
1719 "f2", "f3", "f4", | |
1720 "f5", "f6", "f7", "f8", "f9", "f10", "f11", "f12", | |
1721 "f13", "f14", "f15", "f16", "f17", "f18", "f19", "f20", | |
1722 "f21", "f22", "f23", "f24", "f25", "f26", "f27", "f28", | |
1723 "f29", "f30", "f31", "f32", "f33", "f34", "f35" /* 0xffe0 */ | |
1724 }; | |
1725 | |
1726 static char *lispy_mouse_names[] = | |
1727 { | |
1728 "mouse-1", "mouse-2", "mouse-3", "mouse-4", "mouse-5" | |
1729 }; | |
1730 | |
1731 /* Given a struct input_event, build the lisp event which represents | |
1732 it. If EVENT is 0, build a mouse movement event from the mouse | |
1733 movement buffer, which should have a movement event in it. */ | |
1734 | |
1735 static Lisp_Object | |
1736 make_lispy_event (event) | |
1737 struct input_event *event; | |
1738 { | |
1739 #ifdef SWITCH_ENUM_BUG | |
1740 switch ((int) event->kind) | |
1741 #else | |
1742 switch (event->kind) | |
1743 #endif | |
1744 { | |
1745 | |
1746 /* A simple keystroke. */ | |
1747 case ascii_keystroke: | |
1748 return event->code; | |
1749 break; | |
1750 | |
1751 /* A function key. The symbol may need to have modifier prefixes | |
1752 tacked onto it. */ | |
1753 case non_ascii_keystroke: | |
1754 return modify_event_symbol (XFASTINT (event->code), event->modifiers, | |
1755 Qfunction_key, | |
1756 lispy_function_keys, &func_key_syms, | |
1757 (sizeof (lispy_function_keys) | |
1758 / sizeof (lispy_function_keys[0]))); | |
1759 break; | |
1760 | |
1761 /* A mouse click - build a list of the relevant information. */ | |
1762 case mouse_click: | |
1763 { | |
1764 int part; | |
1765 Lisp_Object window = | |
765 | 1766 window_from_coordinates (event->frame, |
518 | 1767 XINT (event->x), XINT (event->y), |
1768 &part); | |
1769 Lisp_Object posn; | |
1770 | |
1771 if (XTYPE (window) != Lisp_Window) | |
1772 posn = Qnil; | |
1773 else | |
1774 { | |
1775 XSETINT (event->x, (XINT (event->x) | |
1776 - XINT (XWINDOW (window)->left))); | |
1777 XSETINT (event->y, (XINT (event->y) | |
1778 - XINT (XWINDOW (window)->top))); | |
1779 | |
1780 if (part == 1) | |
1781 posn = Qmode_line; | |
1782 else if (part == 2) | |
732 | 1783 posn = Qvertical_line; |
518 | 1784 else |
1785 XSET (posn, Lisp_Int, | |
1786 buffer_posn_from_coords (XWINDOW (window), | |
1787 XINT (event->x), | |
1788 XINT (event->y))); | |
1789 } | |
1790 | |
1791 return Fcons (modify_event_symbol (XFASTINT (event->code) - 1, | |
1792 event->modifiers, | |
1793 Qmouse_click, | |
1794 lispy_mouse_names, &mouse_syms, | |
1795 (sizeof (lispy_mouse_names) | |
1796 / sizeof (lispy_mouse_names[0]))), | |
1797 Fcons (window, | |
1798 Fcons (posn, | |
1799 Fcons (Fcons (event->x, event->y), | |
708 | 1800 Fcons (make_number |
1801 (event->timestamp), | |
518 | 1802 Qnil))))); |
1803 } | |
1804 | |
1805 /* A scrollbar click. Build a list containing the relevant | |
1806 information. */ | |
1807 case scrollbar_click: | |
1808 { | |
1809 Lisp_Object button | |
1810 = modify_event_symbol (XFASTINT (event->code) - 1, | |
1811 event->modifiers, | |
1812 Qmouse_click, | |
1813 lispy_mouse_names, &mouse_syms, | |
1814 (sizeof (lispy_mouse_names) | |
1815 / sizeof (lispy_mouse_names[0]))); | |
1816 return Fcons (event->part, | |
765 | 1817 Fcons (FRAME_SELECTED_WINDOW (event->frame), |
518 | 1818 Fcons (button, |
1819 Fcons (Fcons (event->x, event->y), | |
708 | 1820 Fcons (make_number |
1821 (event->timestamp), | |
518 | 1822 Qnil))))); |
1823 } | |
1824 | |
1825 /* The 'kind' field of the event is something we don't recognize. */ | |
1826 default: | |
1827 abort(); | |
1828 } | |
1829 } | |
1830 | |
1831 static Lisp_Object | |
765 | 1832 make_lispy_movement (frame, x, y, time) |
1833 FRAME_PTR frame; | |
518 | 1834 Lisp_Object x, y; |
732 | 1835 unsigned long time; |
518 | 1836 { |
1837 Lisp_Object window; | |
1838 int ix, iy; | |
1839 Lisp_Object posn; | |
1840 int part; | |
1841 | |
1842 ix = XINT (x); | |
1843 iy = XINT (y); | |
765 | 1844 window = (frame |
1845 ? window_from_coordinates (frame, ix, iy, &part) | |
518 | 1846 : Qnil); |
1847 if (XTYPE (window) != Lisp_Window) | |
1848 posn = Qnil; | |
1849 else | |
1850 { | |
1851 ix -= XINT (XWINDOW (window)->left); | |
1852 iy -= XINT (XWINDOW (window)->top); | |
1853 if (part == 1) | |
1854 posn = Qmode_line; | |
1855 else if (part == 2) | |
732 | 1856 posn = Qvertical_line; |
518 | 1857 else |
1858 XSET (posn, Lisp_Int, buffer_posn_from_coords (XWINDOW (window), | |
1859 ix, iy)); | |
1860 } | |
1861 | |
1862 XSETINT (x, ix); | |
1863 XSETINT (y, iy); | |
1864 return Fcons (Qmouse_movement, | |
1865 Fcons (window, | |
1866 Fcons (posn, | |
1867 Fcons (Fcons (x, y), | |
732 | 1868 Fcons (make_number (time), Qnil))))); |
518 | 1869 } |
1870 | |
1871 | |
1872 | |
1873 /* Place the written representation of MODIFIERS in BUF, '\0'-terminated, | |
1874 and return its length. */ | |
1875 | |
1876 static int | |
1877 format_modifiers (modifiers, buf) | |
1878 int modifiers; | |
1879 char *buf; | |
1880 { | |
1881 char *p = buf; | |
1882 | |
708 | 1883 if (modifiers & ctrl_modifier) { *p++ = 'C'; *p++ = '-'; } |
518 | 1884 if (modifiers & meta_modifier) { *p++ = 'M'; *p++ = '-'; } |
1885 if (modifiers & shift_modifier) { *p++ = 'S'; *p++ = '-'; } | |
1886 if (modifiers & up_modifier) { *p++ = 'U'; *p++ = '-'; } | |
1887 *p = '\0'; | |
1888 | |
1889 return p - buf; | |
1890 } | |
1891 | |
1892 | |
1893 /* Given a symbol whose name begins with modifiers ("C-", "M-", etc), | |
1894 return a symbol with the modifiers placed in the canonical order. | |
1895 | |
1896 Fdefine_key calls this to make sure that (for example) C-M-foo | |
1897 and M-C-foo end up being equivalent in the keymap. */ | |
1898 | |
1899 Lisp_Object | |
1900 reorder_modifiers (symbol) | |
1901 Lisp_Object symbol; | |
1902 { | |
1903 struct Lisp_String *name; | |
1904 int i; | |
1905 int modifiers; | |
1906 int not_canonical; | |
1907 | |
1908 CHECK_SYMBOL (symbol, 1); | |
1909 | |
1910 modifiers = 0; | |
1911 name = XSYMBOL (symbol)->name; | |
1912 | |
1913 /* Special case for things with only one modifier, which is | |
1914 (hopefully) the vast majority of cases. */ | |
1915 if (! (name->size >= 4 && name->data[1] == '-' && name->data[3] == '-')) | |
1916 return symbol; | |
1917 | |
1918 for (i = 0; i + 1 < name->size && name->data[i + 1] == '-'; i += 2) | |
1919 switch (name->data[i]) | |
1920 { | |
1921 case 'M': | |
1922 not_canonical |= (modifiers & (meta_modifier|ctrl_modifier | |
1923 |shift_modifier|up_modifier)); | |
1924 modifiers |= meta_modifier; | |
1925 break; | |
1926 | |
1927 case 'C': | |
1928 not_canonical |= (modifiers & | |
1929 (ctrl_modifier|shift_modifier|up_modifier)); | |
1930 modifiers |= ctrl_modifier; | |
1931 break; | |
1932 | |
1933 case 'S': | |
1934 not_canonical |= (modifiers & (shift_modifier|up_modifier)); | |
1935 modifiers |= shift_modifier; | |
1936 break; | |
1937 | |
1938 case 'U': | |
1939 not_canonical |= (modifiers & (up_modifier)); | |
1940 modifiers |= up_modifier; | |
1941 break; | |
1942 | |
1943 default: | |
1944 goto no_more_modifiers; | |
1945 } | |
1946 no_more_modifiers: | |
1947 | |
1948 if (!not_canonical) | |
1949 return symbol; | |
1950 | |
1951 /* The modifiers were out of order, so find a new symbol with the | |
1952 mods in order. Since the symbol name could contain nulls, we can't | |
1953 use intern here; we have to use Fintern, which expects a genuine | |
1954 Lisp_String, and keeps a reference to it. */ | |
1955 { | |
1956 char *new_mods = (char *) alloca (sizeof ("C-M-S-U-")); | |
1957 int len = format_modifiers (modifiers, new_mods); | |
1958 Lisp_Object new_name = make_uninit_string (len + name->size - i); | |
1959 | |
1960 bcopy (new_mods, XSTRING (new_name)->data, len); | |
1961 bcopy (name->data + i, XSTRING (new_name)->data + len, name->size - i); | |
1962 | |
1963 return Fintern (new_name, Qnil); | |
1964 } | |
1965 } | |
1966 | |
1967 | |
1968 /* For handling events, we often want to produce a symbol whose name | |
1969 is a series of modifier key prefixes ("M-", "C-", etcetera) attached | |
1970 to some base, like the name of a function key or mouse button. | |
1971 modify_event_symbol produces symbols of this sort. | |
1972 | |
1973 NAME_TABLE should point to an array of strings, such that NAME_TABLE[i] | |
1974 is the name of the i'th symbol. TABLE_SIZE is the number of elements | |
1975 in the table. | |
1976 | |
1977 SYMBOL_TABLE should be a pointer to a Lisp_Object whose value will | |
1978 persist between calls to modify_event_symbol that it can use to | |
1979 store a cache of the symbols it's generated for this NAME_TABLE | |
1980 before. | |
1981 | |
1982 SYMBOL_NUM is the number of the base name we want from NAME_TABLE. | |
1983 | |
1984 MODIFIERS is a set of modifier bits (as given in struct input_events) | |
1985 whose prefixes should be applied to the symbol name. | |
1986 | |
1987 SYMBOL_KIND is the value to be placed in the event_kind property of | |
1988 the returned symbol. */ | |
1989 | |
1990 static Lisp_Object | |
1991 modify_event_symbol (symbol_num, modifiers, symbol_kind, name_table, | |
1992 symbol_table, table_size) | |
1993 int symbol_num; | |
1994 unsigned modifiers; | |
1995 Lisp_Object symbol_kind; | |
1996 char **name_table; | |
1997 Lisp_Object *symbol_table; | |
1998 int table_size; | |
1999 { | |
2000 Lisp_Object *slot, *unmodified_slot; | |
2001 | |
2002 /* Is this a request for a valid symbol? */ | |
2003 if (symbol_num < 0 || symbol_num >= table_size | |
2004 || modifiers >= NUM_MODIFIER_COMBOS) | |
2005 abort (); | |
2006 | |
2007 /* If *symbol_table is not a vector of the appropriate size, | |
2008 set it to one. */ | |
2009 if (XTYPE (*symbol_table) != Lisp_Vector | |
2010 || XVECTOR (*symbol_table)->size != table_size) | |
2011 *symbol_table = Fmake_vector (make_number (table_size), Qnil); | |
2012 | |
2013 unmodified_slot = slot = & XVECTOR (*symbol_table)->contents[symbol_num]; | |
2014 | |
2015 /* If there are modifier keys, there had better be a vector in | |
2016 this symbol's position of the symbol_table. */ | |
2017 if (modifiers != 0) | |
2018 { | |
2019 Lisp_Object slot_contents = *slot; | |
2020 | |
2021 /* If there isn't the right sort of vector there, put one in. */ | |
2022 if (XTYPE (slot_contents) != Lisp_Vector | |
2023 || XVECTOR (slot_contents)->size != NUM_MODIFIER_COMBOS) | |
2024 { | |
2025 *slot = Fmake_vector (make_number (NUM_MODIFIER_COMBOS), Qnil); | |
2026 | |
2027 /* Make sure that the vector has an entry for the unmodified | |
2028 symbol, so we can put it on the event_unmodified property. */ | |
2029 if (! NILP (slot_contents)) | |
2030 XVECTOR (*slot)->contents[0] = slot_contents; | |
2031 else | |
2032 XVECTOR (*slot)->contents[0] = intern (name_table [symbol_num]); | |
2033 } | |
2034 } | |
2035 | |
2036 /* If this entry has been filled in with a modified symbol vector, | |
2037 point to the appropriate slot within that. */ | |
2038 if (XTYPE (*slot) == Lisp_Vector) | |
2039 { | |
2040 unmodified_slot = & XVECTOR (*slot)->contents[0]; | |
2041 slot = & XVECTOR (*slot)->contents[modifiers]; | |
2042 } | |
2043 | |
2044 /* Make sure we have an unmodified version of the symbol in its | |
2045 proper place? */ | |
2046 if (NILP (*unmodified_slot)) | |
2047 { | |
2048 *unmodified_slot = intern (name_table [symbol_num]); | |
2049 Fput (*unmodified_slot, Qevent_kind, symbol_kind); | |
2050 Fput (*unmodified_slot, Qevent_unmodified, *unmodified_slot); | |
2051 } | |
2052 | |
2053 /* Have we already created a symbol for this combination of modifiers? */ | |
2054 if (NILP (*slot)) | |
2055 { | |
2056 /* No, let's create one. */ | |
2057 char *modified_name | |
2058 = (char *) alloca (sizeof ("C-M-S-U-") | |
2059 + strlen (name_table [symbol_num])); | |
2060 | |
2061 strcpy (modified_name + format_modifiers (modifiers, modified_name), | |
2062 name_table [symbol_num]); | |
2063 | |
2064 *slot = intern (modified_name); | |
2065 Fput (*slot, Qevent_kind, symbol_kind); | |
2066 Fput (*slot, Qevent_unmodified, *unmodified_slot); | |
2067 } | |
2068 | |
2069 return *slot; | |
2070 } | |
2071 | |
2072 DEFUN ("mouse-click-p", Fmouse_click_p, Smouse_click_p, 1, 1, 0, | |
2073 "Return non-nil iff OBJECT is a representation of a mouse event.\n\ | |
2074 A mouse event is a list of five elements whose car is a symbol of the\n\ | |
2075 form <MODIFIERS>mouse-<DIGIT>. I hope this is a temporary hack.") | |
2076 (object) | |
2077 Lisp_Object object; | |
2078 { | |
2079 if (EVENT_HAS_PARAMETERS (object) | |
2080 && EQ (EVENT_HEAD_KIND (EVENT_HEAD (object)), | |
2081 Qmouse_click)) | |
2082 return Qt; | |
2083 else | |
2084 return Qnil; | |
2085 } | |
2086 | |
2087 /* Store into *addr a value nonzero if terminal input chars are available. | |
2088 Serves the purpose of ioctl (0, FIONREAD, addr) | |
2089 but works even if FIONREAD does not exist. | |
2090 (In fact, this may actually read some input.) */ | |
2091 | |
2092 static void | |
2093 get_input_pending (addr) | |
2094 int *addr; | |
2095 { | |
2096 /* First of all, have we already counted some input? */ | |
2097 *addr = !NILP (Vquit_flag) || readable_events (); | |
2098 | |
2099 /* If input is being read as it arrives, and we have none, there is none. */ | |
2100 if (*addr > 0 || (interrupt_input && ! interrupts_deferred)) | |
2101 return; | |
2102 | |
2103 /* Try to read some input and see how much we get. */ | |
2104 gobble_input (0); | |
2105 *addr = !NILP (Vquit_flag) || readable_events (); | |
2106 } | |
2107 | |
2108 /* Interface to read_avail_input, blocking SIGIO if necessary. */ | |
2109 | |
2110 int | |
2111 gobble_input (expected) | |
2112 int expected; | |
2113 { | |
2114 #ifndef VMS | |
2115 #ifdef SIGIO | |
2116 if (interrupt_input) | |
2117 { | |
624 | 2118 SIGMASKTYPE mask; |
638 | 2119 mask = sigblockx (SIGIO); |
518 | 2120 read_avail_input (expected); |
638 | 2121 sigsetmask (mask); |
518 | 2122 } |
2123 else | |
2124 #endif | |
2125 read_avail_input (expected); | |
2126 #endif | |
2127 } | |
2128 | |
2129 #ifndef VMS | |
2130 | |
2131 /* Read any terminal input already buffered up by the system | |
2132 into the kbd_buffer, but do not wait. | |
2133 | |
2134 EXPECTED should be nonzero if the caller knows there is some input. | |
2135 | |
2136 Except on VMS, all input is read by this function. | |
2137 If interrupt_input is nonzero, this function MUST be called | |
2138 only when SIGIO is blocked. | |
2139 | |
2140 Returns the number of keyboard chars read, or -1 meaning | |
2141 this is a bad time to try to read input. */ | |
2142 | |
2143 static int | |
2144 read_avail_input (expected) | |
2145 int expected; | |
2146 { | |
2147 struct input_event buf[KBD_BUFFER_SIZE]; | |
2148 register int i; | |
2149 int nread; | |
2150 | |
2151 if (read_socket_hook) | |
2152 /* No need for FIONREAD or fcntl; just say don't wait. */ | |
2153 nread = (*read_socket_hook) (0, buf, KBD_BUFFER_SIZE, expected, expected); | |
2154 else | |
2155 { | |
2156 unsigned char cbuf[KBD_BUFFER_SIZE]; | |
2157 | |
2158 #ifdef FIONREAD | |
2159 /* Find out how much input is available. */ | |
2160 if (ioctl (0, FIONREAD, &nread) < 0) | |
2161 /* Formerly simply reported no input, but that sometimes led to | |
2162 a failure of Emacs to terminate. | |
2163 SIGHUP seems appropriate if we can't reach the terminal. */ | |
2164 kill (getpid (), SIGHUP); | |
2165 if (nread == 0) | |
2166 return 0; | |
2167 if (nread > sizeof cbuf) | |
2168 nread = sizeof cbuf; | |
2169 #else /* no FIONREAD */ | |
2170 #ifdef USG | |
2171 /* Read some input if available, but don't wait. */ | |
2172 nread = sizeof cbuf; | |
2173 fcntl (fileno (stdin), F_SETFL, O_NDELAY); | |
2174 #else | |
2175 you lose; | |
2176 #endif | |
2177 #endif | |
2178 | |
2179 /* Now read; for one reason or another, this will not block. */ | |
2180 while (1) | |
2181 { | |
2182 nread = read (fileno (stdin), cbuf, nread); | |
2183 #ifdef AIX | |
2184 /* The kernel sometimes fails to deliver SIGHUP for ptys. | |
2185 This looks incorrect, but it isn't, because _BSD causes | |
2186 O_NDELAY to be defined in fcntl.h as O_NONBLOCK, | |
2187 and that causes a value other than 0 when there is no input. */ | |
2188 if (nread == 0) | |
2189 kill (SIGHUP, 0); | |
2190 #endif | |
2191 /* Retry the read if it is interrupted. */ | |
2192 if (nread >= 0 | |
2193 || ! (errno == EAGAIN || errno == EFAULT | |
2194 #ifdef EBADSLT | |
2195 || errno == EBADSLT | |
2196 #endif | |
2197 )) | |
2198 break; | |
2199 } | |
2200 | |
2201 #ifndef FIONREAD | |
2202 #ifdef USG | |
2203 fcntl (fileno (stdin), F_SETFL, 0); | |
2204 #endif /* USG */ | |
2205 #endif /* no FIONREAD */ | |
2206 for (i = 0; i < nread; i++) | |
2207 { | |
2208 buf[i].kind = ascii_keystroke; | |
2209 XSET (buf[i].code, Lisp_Int, cbuf[i]); | |
765 | 2210 buf[i].frame = selected_frame; |
518 | 2211 } |
2212 } | |
2213 | |
2214 /* Scan the chars for C-g and store them in kbd_buffer. */ | |
2215 for (i = 0; i < nread; i++) | |
2216 { | |
2217 kbd_buffer_store_event (&buf[i]); | |
2218 /* Don't look at input that follows a C-g too closely. | |
2219 This reduces lossage due to autorepeat on C-g. */ | |
2220 if (buf[i].kind == ascii_keystroke | |
2221 && XINT(buf[i].code) == quit_char) | |
2222 break; | |
2223 } | |
2224 | |
2225 return nread; | |
2226 } | |
2227 #endif /* not VMS */ | |
2228 | |
2229 #ifdef SIGIO /* for entire page */ | |
2230 /* Note SIGIO has been undef'd if FIONREAD is missing. */ | |
2231 | |
2232 input_available_signal (signo) | |
2233 int signo; | |
2234 { | |
2235 /* Must preserve main program's value of errno. */ | |
2236 int old_errno = errno; | |
2237 #ifdef BSD4_1 | |
2238 extern int select_alarmed; | |
2239 #endif | |
2240 | |
2241 #ifdef USG | |
2242 /* USG systems forget handlers when they are used; | |
2243 must reestablish each time */ | |
2244 signal (signo, input_available_signal); | |
2245 #endif /* USG */ | |
2246 | |
2247 #ifdef BSD4_1 | |
2248 sigisheld (SIGIO); | |
2249 #endif | |
2250 | |
648 | 2251 if (input_available_clear_time) |
2252 EMACS_SET_SECS_USECS (*input_available_clear_time, 0, 0); | |
518 | 2253 |
2254 while (1) | |
2255 { | |
2256 int nread; | |
2257 nread = read_avail_input (1); | |
2258 /* -1 means it's not ok to read the input now. | |
2259 UNBLOCK_INPUT will read it later; now, avoid infinite loop. | |
2260 0 means there was no keyboard input available. */ | |
2261 if (nread <= 0) | |
2262 break; | |
2263 | |
2264 #ifdef BSD4_1 | |
2265 select_alarmed = 1; /* Force the select emulator back to life */ | |
2266 #endif | |
2267 } | |
2268 | |
2269 #ifdef BSD4_1 | |
2270 sigfree (); | |
2271 #endif | |
2272 errno = old_errno; | |
2273 } | |
2274 #endif /* SIGIO */ | |
2275 | |
2276 /* Return the prompt-string of a sparse keymap. | |
2277 This is the first element which is a string. | |
2278 Return nil if there is none. */ | |
2279 | |
2280 Lisp_Object | |
2281 map_prompt (map) | |
2282 Lisp_Object map; | |
2283 { | |
2284 while (CONSP (map)) | |
2285 { | |
2286 register Lisp_Object tem; | |
2287 tem = Fcar (map); | |
2288 if (XTYPE (tem) == Lisp_String) | |
2289 return tem; | |
2290 map = Fcdr (map); | |
2291 } | |
2292 return Qnil; | |
2293 } | |
2294 | |
2295 static int echo_flag; | |
2296 static int echo_now; | |
2297 | |
2298 /* Read a character like read_char but optionally prompt based on maps | |
2299 LOCAL and GLOBAL. | |
2300 | |
2301 The prompting is done based on the prompt-string of the map | |
2302 and the strings associated with various map elements. */ | |
2303 | |
2304 Lisp_Object | |
2305 read_char_menu_prompt (prompt, local, global) | |
2306 int prompt; | |
2307 Lisp_Object local, global; | |
2308 { | |
2309 register Lisp_Object rest, name; | |
2310 Lisp_Object hmap; | |
2311 int nlength; | |
765 | 2312 int width = FRAME_WIDTH (selected_frame) - 4; |
518 | 2313 char *menu = (char *) alloca (width); |
2314 | |
2315 /* Use local over global Menu maps */ | |
2316 | |
2317 if (menu_prompting) | |
2318 return read_char (!prompt); | |
2319 | |
2320 /* We can't get prompt strings from dense keymaps. */ | |
2321 if (CONSP (local) | |
2322 && EQ (Fcar (local), Qkeymap) | |
2323 && !(CONSP (XCONS (local)->cdr) | |
2324 && XTYPE (XCONS (XCONS (local)->cdr)->car) == Lisp_Vector)) | |
2325 hmap = local; | |
2326 else if (CONSP (global) | |
2327 && EQ (Fcar (global), Qkeymap) | |
2328 && !(CONSP (XCONS (global)->cdr) | |
2329 && XTYPE (XCONS (XCONS (global)->cdr)->car) == Lisp_Vector)) | |
2330 hmap = global; | |
2331 else | |
2332 return read_char (!prompt); | |
2333 | |
2334 /* Get the map's prompt string. */ | |
2335 name = map_prompt (hmap); | |
2336 if (NILP (name)) | |
2337 return read_char (!prompt); | |
2338 | |
2339 /* Prompt string always starts with map's prompt, and a space. */ | |
2340 strcpy (menu, XSTRING (name)->data); | |
2341 nlength = XSTRING (name)->size; | |
2342 menu[nlength++] = ' '; | |
2343 menu[nlength] = 0; | |
2344 | |
2345 /* Start prompting at start of map. */ | |
2346 rest = hmap; /* Current menu item */ | |
2347 | |
2348 /* Present the documented bindings, a line at a time. */ | |
2349 while (1) | |
2350 { | |
2351 int notfirst = 0; | |
2352 int i = nlength; | |
2353 Lisp_Object obj; | |
2354 int ch; | |
2355 | |
2356 /* If reached end of map, start at beginning. */ | |
2357 if (NILP (Fcdr (rest))) rest = hmap; | |
2358 | |
2359 /* Loop over elements of map. */ | |
2360 while (!NILP (rest) && i < width) | |
2361 { | |
2362 Lisp_Object s; | |
2363 | |
2364 /* Look for conses whose cadrs are strings. */ | |
2365 s = Fcar_safe (Fcdr_safe (Fcar_safe (rest))); | |
2366 if (XTYPE (s) != Lisp_String) | |
2367 /* Ignore all other elements. */ | |
2368 ; | |
2369 /* If first such element, or enough room, add string to prompt. */ | |
2370 else if (XSTRING (s)->size + i < width | |
2371 || !notfirst) | |
2372 { | |
2373 int thiswidth; | |
2374 | |
2375 /* Punctuate between strings. */ | |
2376 if (notfirst) | |
2377 { | |
2378 strcpy (menu + i, ", "); | |
2379 i += 2; | |
2380 } | |
2381 notfirst = 1; | |
2382 | |
2383 /* Add as much of string as fits. */ | |
2384 thiswidth = XSTRING (s)->size; | |
2385 if (thiswidth + i > width) | |
2386 thiswidth = width - i; | |
2387 bcopy (XSTRING (s)->data, menu + i, thiswidth); | |
2388 i += thiswidth; | |
2389 } | |
2390 else | |
2391 { | |
2392 /* If some elts don't fit, show there are more. */ | |
2393 strcpy (menu + i, "..."); | |
2394 break; | |
2395 } | |
2396 | |
2397 /* Move past this element. */ | |
2398 rest = Fcdr_safe (rest); | |
2399 } | |
2400 | |
2401 /* Prompt with that and read response. */ | |
2402 message1 (menu); | |
2403 obj = read_char (1); | |
2404 | |
2405 if (XTYPE (obj) != Lisp_Int) | |
2406 return obj; | |
2407 else | |
2408 ch = XINT (obj); | |
2409 | |
2410 if (obj != menu_prompt_more_char | |
2411 && (XTYPE (menu_prompt_more_char) != Lisp_Int | |
2412 || obj != make_number (Ctl (XINT (menu_prompt_more_char))))) | |
2413 return obj; | |
2414 } | |
2415 } | |
2416 | |
2417 | |
2418 /* Reading key sequences. */ | |
2419 | |
2420 /* Follow KEY in the maps in CURRENT[0..NMAPS-1], placing its bindings | |
2421 in DEFS[0..NMAPS-1]. Set NEXT[i] to DEFS[i] if DEFS[i] is a | |
2422 keymap, or nil otherwise. Return the index of the first keymap in | |
2423 which KEY has any binding, or NMAPS if no map has a binding. | |
2424 | |
2425 If KEY is a meta ASCII character, treat it like meta-prefix-char | |
2426 followed by the corresponding non-meta character. Keymaps in | |
2427 CURRENT with non-prefix bindings for meta-prefix-char become nil in | |
2428 NEXT. | |
2429 | |
2430 When KEY is not defined in any of the keymaps, if it is an upper | |
2431 case letter and there are bindings for the corresponding lower-case | |
2432 letter, return the bindings for the lower-case letter. | |
2433 | |
2434 NEXT may == CURRENT. */ | |
2435 | |
2436 static int | |
2437 follow_key (key, nmaps, current, defs, next) | |
2438 Lisp_Object key; | |
2439 Lisp_Object *current, *defs, *next; | |
2440 int nmaps; | |
2441 { | |
2442 int i, first_binding; | |
2443 | |
2444 /* If KEY is a meta ASCII character, treat it like meta-prefix-char | |
2445 followed by the corresponding non-meta character. */ | |
2446 if (XTYPE (key) == Lisp_Int | |
2447 && XINT (key) >= 0200) | |
2448 { | |
2449 for (i = 0; i < nmaps; i++) | |
2450 if (! NILP (current[i])) | |
2451 { | |
2452 next[i] = get_keyelt (access_keymap (current[i], | |
2453 meta_prefix_char)); | |
2454 | |
2455 /* Note that since we pass the resulting bindings through | |
2456 get_keymap_1, non-prefix bindings for meta-prefix-char | |
2457 disappear. */ | |
2458 next[i] = get_keymap_1 (next[i], 0); | |
2459 } | |
2460 else | |
2461 next[i] = Qnil; | |
2462 | |
2463 current = next; | |
2464 XSET (key, Lisp_Int, XFASTINT (key) & 0177); | |
2465 } | |
2466 | |
2467 first_binding = nmaps; | |
2468 for (i = nmaps - 1; i >= 0; i--) | |
2469 { | |
2470 if (! NILP (current[i])) | |
2471 { | |
2472 defs[i] = get_keyelt (access_keymap (current[i], key)); | |
2473 if (! NILP (defs[i])) | |
2474 first_binding = i; | |
2475 } | |
2476 else | |
2477 defs[i] = Qnil; | |
2478 } | |
2479 | |
2480 /* When KEY is not defined in any of the keymaps, if it is an upper | |
2481 case letter and there are bindings for the corresponding | |
2482 lower-case letter, return the bindings for the lower-case letter. */ | |
2483 if (first_binding == nmaps | |
2484 && XTYPE (key) == Lisp_Int | |
2485 && UPPERCASEP (XINT (key))) | |
2486 { | |
2487 XSETINT (key, DOWNCASE (XINT (key))); | |
2488 | |
2489 first_binding = nmaps; | |
2490 for (i = nmaps - 1; i >= 0; i--) | |
2491 { | |
2492 if (! NILP (current[i])) | |
2493 { | |
2494 defs[i] = get_keyelt (access_keymap (current[i], key)); | |
2495 if (! NILP (defs[i])) | |
2496 first_binding = i; | |
2497 } | |
2498 else | |
2499 defs[i] = Qnil; | |
2500 } | |
2501 } | |
2502 | |
2503 /* Given the set of bindings we've found, produce the next set of maps. */ | |
2504 for (i = 0; i < nmaps; i++) | |
2505 next[i] = NILP (defs[i]) ? Qnil : get_keymap_1 (defs[i], 0); | |
2506 | |
2507 return first_binding; | |
2508 } | |
2509 | |
2510 /* Read a sequence of keys that ends with a non prefix character | |
2511 according to the keymaps in KEYMAPS[0..nmaps-1]. Keymaps appearing | |
2512 earlier in KEYMAPS take precidence over those appearing later. | |
2513 | |
2514 Store the sequence in KEYBUF, a buffer of size BUFSIZE. Prompt | |
2515 with PROMPT. Echo starting immediately unless `prompt' is 0. | |
2516 Return the length of the key sequence stored. | |
2517 | |
765 | 2518 If the user switches frames in the midst of a key sequence, we |
518 | 2519 throw away any prefix we have read so far, and start afresh. For |
2520 mouse clicks, we look up the click in the keymap of the buffer | |
2521 clicked on, throwing away any prefix if it is not the same buffer | |
2522 we used to be reading from. */ | |
2523 | |
2524 static int | |
2525 read_key_sequence (keybuf, bufsize, prompt) | |
2526 Lisp_Object *keybuf; | |
2527 int bufsize; | |
2528 Lisp_Object prompt; | |
2529 { | |
2530 /* How many keys there are in the current key sequence. */ | |
2531 int t; | |
2532 | |
2533 /* The buffer that the most recently read event was typed at. This | |
2534 helps us read mouse clicks according to the buffer clicked in, | |
765 | 2535 and notice when the mouse has moved from one frame to another. */ |
518 | 2536 struct buffer *last_event_buffer = current_buffer; |
2537 | |
2538 /* The length of the echo buffer when we started reading, and | |
2539 the length of this_command_keys when we started reading. */ | |
2540 int echo_start; | |
2541 int keys_start = this_command_key_count; | |
2542 | |
2543 /* The number of keymaps we're scanning right now, and the number of | |
2544 keymaps we have allocated space for. */ | |
2545 int nmaps; | |
2546 int nmaps_allocated = 0; | |
2547 | |
2548 /* current[0..nmaps-1] are the prefix definitions of KEYBUF[0..t-1] | |
2549 in the current keymaps, or nil where it is not a prefix. */ | |
2550 Lisp_Object *current; | |
2551 | |
2552 /* defs[0..nmaps-1] are the definitions of KEYBUF[0..t-1] in | |
2553 the current keymaps. */ | |
2554 Lisp_Object *defs; | |
2555 | |
2556 /* The lowest i such that defs[i] is non-nil. */ | |
2557 int first_binding; | |
2558 | |
2559 /* If mock_input > t, then KEYBUF[t] should be read as the next | |
2560 input key. */ | |
2561 int mock_input = 0; | |
2562 | |
2563 /* If the sequence is unbound in current[], keymap[fkey_start..fkey_end-1] | |
2564 is a prefix in Vfunction_key_map, and fkey_map is its binding. | |
2565 These might be > t, indicating that all function key scanning should | |
2566 hold off until t reaches them. */ | |
2567 int fkey_start = 0, fkey_end = 0; | |
2568 Lisp_Object fkey_map = Vfunction_key_map; | |
2569 | |
2570 if (INTERACTIVE) | |
2571 { | |
2572 if (prompt) | |
2573 echo_prompt (prompt); | |
2574 else if (cursor_in_echo_area) | |
2575 /* This doesn't put in a dash if the echo buffer is empty, so | |
2576 you don't always see a dash hanging out in the minibuffer. */ | |
2577 echo_dash (); | |
2578 echo_start = echo_length (); | |
2579 } | |
2580 | |
2581 /* If there is no function key map, turn of function key scanning. */ | |
2582 if (NILP (Fkeymapp (Vfunction_key_map))) | |
2583 fkey_start = fkey_end = bufsize + 1; | |
2584 | |
2585 restart: | |
2586 t = 0; | |
2587 this_command_key_count = keys_start; | |
2588 | |
2589 { | |
2590 Lisp_Object *maps; | |
2591 | |
2592 nmaps = current_minor_maps (0, &maps) + 2; | |
2593 if (nmaps > nmaps_allocated) | |
2594 { | |
2595 current = (Lisp_Object *) alloca (nmaps * sizeof (current[0])); | |
2596 defs = (Lisp_Object *) alloca (nmaps * sizeof (defs[0])); | |
2597 nmaps_allocated = nmaps; | |
2598 } | |
2599 bcopy (maps, current, (nmaps - 2) * sizeof (current[0])); | |
2600 current[nmaps-2] = last_event_buffer->keymap; | |
2601 current[nmaps-1] = global_map; | |
2602 } | |
2603 | |
2604 /* Find an accurate initial value for first_binding. */ | |
2605 for (first_binding = 0; first_binding < nmaps; first_binding++) | |
2606 if (! NILP (current[first_binding])) | |
2607 break; | |
2608 | |
2609 while ((first_binding < nmaps && ! NILP (current[first_binding])) | |
2610 || (first_binding >= nmaps && fkey_start < t)) | |
2611 { | |
2612 Lisp_Object key; | |
2613 | |
2614 if (t >= bufsize) | |
2615 error ("key sequence too long"); | |
2616 | |
2617 /* Are we reading keys stuffed into keybuf? */ | |
2618 if (t < mock_input) | |
2619 { | |
2620 key = keybuf[t]; | |
2621 add_command_key (key); | |
2622 echo_char (key); | |
2623 } | |
2624 /* Otherwise, we should actually read a character. */ | |
2625 else | |
2626 { | |
2627 struct buffer *buf; | |
2628 | |
2629 if (!prompt && INTERACTIVE) | |
2630 key = read_char_menu_prompt (prompt, Qnil, Qnil); | |
2631 else | |
2632 key = read_char (!prompt); | |
2633 | |
2634 /* The above routines return -1 at the end of a macro. | |
2635 Emacs 18 handles this by returning immediately with a | |
2636 zero, so that's what we'll do. */ | |
2637 if (XTYPE (key) == Lisp_Int && XINT (key) < 0) | |
2638 return 0; | |
2639 | |
2640 Vquit_flag = Qnil; | |
2641 | |
765 | 2642 #ifdef MULTI_FRAME |
518 | 2643 /* What buffer was this event typed/moused at? */ |
2644 if (XTYPE (key) == Lisp_Int || XTYPE (key) == Lisp_Symbol) | |
2645 buf = (XBUFFER | |
2646 (XWINDOW | |
765 | 2647 (FRAME_SELECTED_WINDOW |
2648 (XFRAME (Vlast_event_frame)))->buffer)); | |
518 | 2649 else if (EVENT_HAS_PARAMETERS (key)) |
2650 { | |
2651 Lisp_Object window = EVENT_WINDOW (key); | |
2652 | |
2653 if (NILP (window)) | |
2654 abort (); | |
2655 | |
2656 buf = XBUFFER (XWINDOW (window)->buffer); | |
2657 } | |
2658 else | |
2659 abort (); | |
2660 | |
2661 /* If this event came to a different buffer than the one | |
2662 we're currently in, switch buffers and start a new key | |
2663 sequence, starting with key. */ | |
2664 if (buf != last_event_buffer) | |
2665 { | |
2666 last_event_buffer = buf; | |
765 | 2667 Fselect_frame (Vlast_event_frame, Qnil); |
518 | 2668 |
2669 /* Arrange to read key as the next event. */ | |
2670 keybuf[0] = key; | |
2671 mock_input = 1; | |
2672 | |
2673 /* Truncate the key sequence in the echo area. */ | |
2674 if (INTERACTIVE) | |
2675 echo_truncate (echo_start); | |
2676 | |
2677 goto restart; | |
2678 } | |
732 | 2679 #endif |
518 | 2680 } |
2681 | |
2682 first_binding = (follow_key (key, | |
2683 nmaps - first_binding, | |
2684 current + first_binding, | |
2685 defs + first_binding, | |
2686 current + first_binding) | |
2687 + first_binding); | |
2688 keybuf[t++] = key; | |
2689 | |
2690 /* If the sequence is unbound, see if we can hang a function key | |
2691 off the end of it. Don't reread the expansion of a function key. */ | |
2692 if (first_binding >= nmaps | |
2693 && t > mock_input) | |
2694 { | |
2695 Lisp_Object fkey_next; | |
2696 | |
2697 /* Scan from fkey_end until we find a bound suffix. */ | |
2698 while (fkey_end < t) | |
2699 { | |
2700 fkey_next = | |
2701 get_keyelt (access_keymap (fkey_map, keybuf[fkey_end++])); | |
2702 /* If keybuf[fkey_start..fkey_next] is bound in the | |
547 | 2703 function key map and it's a suffix of the current |
2704 sequence (i.e. fkey_next == t), replace it with | |
2705 the binding and restart with fkey_start at the end. */ | |
518 | 2706 if (XTYPE (fkey_next) == Lisp_Vector |
2707 && fkey_end == t) | |
2708 { | |
2709 t = fkey_start + XVECTOR (fkey_next)->size; | |
2710 if (t >= bufsize) | |
2711 error ("key sequence too long"); | |
2712 | |
2713 bcopy (XVECTOR (fkey_next)->contents, | |
2714 keybuf + fkey_start, | |
2715 (t - fkey_start) * sizeof (keybuf[0])); | |
2716 | |
2717 mock_input = t; | |
2718 fkey_start = fkey_end = t; | |
2719 | |
2720 /* Truncate the key sequence in the echo area. */ | |
2721 if (INTERACTIVE) | |
2722 echo_truncate (echo_start); | |
2723 | |
2724 goto restart; | |
2725 } | |
2726 | |
2727 fkey_map = get_keymap_1 (fkey_next, 0); | |
2728 | |
547 | 2729 /* If we no longer have a bound suffix, try a new positions for |
2730 fkey_start. */ | |
518 | 2731 if (NILP (fkey_map)) |
2732 { | |
2733 fkey_end = ++fkey_start; | |
2734 fkey_map = Vfunction_key_map; | |
2735 } | |
2736 } | |
2737 } | |
2738 } | |
2739 | |
2740 read_key_sequence_cmd = (first_binding < nmaps | |
2741 ? defs[first_binding] | |
2742 : Qnil); | |
2743 | |
2744 return t; | |
2745 } | |
2746 | |
691
cae8c3ef1677
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
687
diff
changeset
|
2747 DEFUN ("read-key-sequence", Fread_key_sequence, Sread_key_sequence, 1, 2, 0, |
518 | 2748 "Read a sequence of keystrokes and return as a string or vector.\n\ |
2749 The sequence is sufficient to specify a non-prefix command in the\n\ | |
2750 current local and global maps.\n\ | |
2751 \n\ | |
691
cae8c3ef1677
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
687
diff
changeset
|
2752 First arg PROMPT is a prompt string. If nil, do not prompt specially.\n\ |
cae8c3ef1677
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
687
diff
changeset
|
2753 Second (optional) arg CONTINUE-ECHO, if non-nil, means this key echos\n\ |
cae8c3ef1677
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
687
diff
changeset
|
2754 as a continuation of the previous key.\n\ |
518 | 2755 \n\ |
765 | 2756 If Emacs is running on multiple frames, switching between frames in\n\ |
518 | 2757 the midst of a keystroke will toss any prefix typed so far. A C-g\n\ |
2758 typed while in this function is treated like any other character, and\n\ | |
2759 `quit-flag' is not set.") | |
691
cae8c3ef1677
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
687
diff
changeset
|
2760 (prompt, continue_echo) |
cae8c3ef1677
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
687
diff
changeset
|
2761 Lisp_Object prompt, continue_echo; |
518 | 2762 { |
2763 Lisp_Object keybuf[30]; | |
2764 register int i; | |
2765 struct gcpro gcpro1, gcpro2; | |
2766 | |
2767 if (!NILP (prompt)) | |
2768 CHECK_STRING (prompt, 0); | |
2769 QUIT; | |
2770 | |
2771 bzero (keybuf, sizeof keybuf); | |
2772 GCPRO1 (keybuf[0]); | |
2773 gcpro1.nvars = (sizeof keybuf/sizeof (keybuf[0])); | |
2774 | |
727 | 2775 if (NILP (continue_echo)) |
691
cae8c3ef1677
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
687
diff
changeset
|
2776 this_command_key_count = 0; |
cae8c3ef1677
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
687
diff
changeset
|
2777 |
518 | 2778 i = read_key_sequence (keybuf, (sizeof keybuf/sizeof (keybuf[0])), |
2779 NILP (prompt) ? 0 : XSTRING (prompt)->data); | |
2780 | |
2781 UNGCPRO; | |
2782 return make_array (i, keybuf); | |
2783 } | |
2784 | |
2785 DEFUN ("command-execute", Fcommand_execute, Scommand_execute, 1, 2, 0, | |
2786 "Execute CMD as an editor command.\n\ | |
2787 CMD must be a symbol that satisfies the `commandp' predicate.\n\ | |
2788 Optional second arg RECORD-FLAG non-nil\n\ | |
2789 means unconditionally put this command in `command-history'.\n\ | |
2790 Otherwise, that is done only if an arg is read using the minibuffer.") | |
2791 (cmd, record) | |
2792 Lisp_Object cmd, record; | |
2793 { | |
2794 register Lisp_Object final; | |
2795 register Lisp_Object tem; | |
2796 Lisp_Object prefixarg; | |
2797 struct backtrace backtrace; | |
2798 extern int debug_on_next_call; | |
2799 | |
2800 prefixarg = Vprefix_arg, Vprefix_arg = Qnil; | |
2801 Vcurrent_prefix_arg = prefixarg; | |
2802 debug_on_next_call = 0; | |
2803 | |
2804 if (XTYPE (cmd) == Lisp_Symbol) | |
2805 { | |
2806 tem = Fget (cmd, Qdisabled); | |
2807 if (!NILP (tem)) | |
2808 return call1 (Vrun_hooks, Vdisabled_command_hook); | |
2809 } | |
2810 | |
2811 while (1) | |
2812 { | |
648 | 2813 final = Findirect_function (cmd); |
518 | 2814 |
2815 if (CONSP (final) && (tem = Fcar (final), EQ (tem, Qautoload))) | |
2816 do_autoload (final, cmd); | |
2817 else | |
2818 break; | |
2819 } | |
2820 | |
2821 if (XTYPE (final) == Lisp_String | |
2822 || XTYPE (final) == Lisp_Vector) | |
2823 { | |
2824 /* If requested, place the macro in the command history. For | |
2825 other sorts of commands, call-interactively takes care of | |
2826 this. */ | |
2827 if (!NILP (record)) | |
2828 Vcommand_history | |
2829 = Fcons (Fcons (Qexecute_kbd_macro, | |
2830 Fcons (final, Fcons (prefixarg, Qnil))), | |
2831 Vcommand_history); | |
2832 | |
2833 return Fexecute_kbd_macro (final, prefixarg); | |
2834 } | |
2835 if (CONSP (final) || XTYPE (final) == Lisp_Subr | |
2836 || XTYPE (final) == Lisp_Compiled) | |
2837 { | |
2838 backtrace.next = backtrace_list; | |
2839 backtrace_list = &backtrace; | |
2840 backtrace.function = &Qcall_interactively; | |
2841 backtrace.args = &cmd; | |
2842 backtrace.nargs = 1; | |
2843 backtrace.evalargs = 0; | |
2844 | |
2845 tem = Fcall_interactively (cmd, record); | |
2846 | |
2847 backtrace_list = backtrace.next; | |
2848 return tem; | |
2849 } | |
2850 return Qnil; | |
2851 } | |
2852 | |
2853 #if 0 | |
2854 DEFUN ("execute-mouse-event", Fexecute_mouse_event, Sexecute_mouse_event, | |
2855 1, 1, 0, | |
2856 "Execute the definition of the mouse-click event EVENT.\n\ | |
2857 The handler function is found by looking the event's key sequence up\n\ | |
2858 in the buffer's local mouse map and in `global-mouse-map'.\n\ | |
2859 \n\ | |
2860 After running the handler, call the value of `mouse-event-function'\n\ | |
2861 with EVENT as arg.") | |
2862 (event) | |
2863 Lisp_Object event; | |
2864 { | |
2865 Lisp_Object tem; | |
2866 Lisp_Object mouse_cmd; | |
765 | 2867 Lisp_Object keyseq, window, frame_part, pos, time; |
518 | 2868 |
2869 #ifndef HAVE_X11 | |
2870 Vmouse_event = event; | |
2871 #endif | |
2872 | |
2873 if (EQ (event, Qnil)) | |
2874 { | |
2875 bitch_at_user (); | |
2876 return Qnil; | |
2877 } | |
2878 | |
2879 CHECK_CONS (event, 0); | |
2880 pos = Fcar (event); | |
2881 window = Fcar (Fcdr (event)); | |
765 | 2882 frame_part = Fcar (Fcdr (Fcdr (event))); |
518 | 2883 keyseq = Fcar (Fcdr (Fcdr (Fcdr (event)))); |
2884 time = Fcar (Fcdr (Fcdr (Fcdr (Fcdr (event))))); | |
2885 CHECK_STRING (keyseq, 0); | |
2886 CHECK_WINDOW (window, 0); | |
2887 | |
2888 /* Look up KEYSEQ in the buffer's local mouse map, then in global one. */ | |
2889 | |
2890 mouse_cmd = Qnil; | |
2891 | |
2892 if (!NILP (XWINDOW (window)->buffer)) | |
2893 { | |
2894 Lisp_Object local_map; | |
2895 | |
2896 local_map = XBUFFER (XWINDOW (window)->buffer)->mouse_map; | |
2897 tem = Fkeymapp (local_map); | |
2898 if (!NILP (tem)) | |
2899 mouse_cmd = Flookup_key (local_map, keyseq); | |
2900 /* A number as value means the key is too long; treat as undefined. */ | |
2901 if (XTYPE (mouse_cmd) == Lisp_Int) | |
2902 mouse_cmd = Qnil; | |
2903 } | |
2904 | |
2905 tem = Fkeymapp (Vglobal_mouse_map); | |
2906 if (NILP (mouse_cmd) && !NILP (tem)) | |
2907 mouse_cmd = Flookup_key (Vglobal_mouse_map, keyseq); | |
2908 if (XTYPE (mouse_cmd) == Lisp_Int) | |
2909 mouse_cmd = Qnil; | |
2910 | |
2911 if (NILP (mouse_cmd)) | |
2912 { | |
2913 /* This button/shift combination is not defined. | |
2914 If it is a button-down event, ring the bell. */ | |
2915 #ifdef HAVE_X11 | |
2916 if (XSTRING (keyseq)->data[XSTRING (keyseq)->size - 1] & 0x18 == 0) | |
2917 #else | |
2918 if (XSTRING (keyseq)->data[XSTRING (keyseq)->size - 1] & 4 == 0) | |
2919 #endif | |
2920 bitch_at_user (); | |
2921 } | |
2922 else | |
2923 { | |
765 | 2924 FRAME_PTR f = XFRAME (WINDOW_FRAME (XWINDOW (window))); |
518 | 2925 |
2926 #ifndef HAVE_X11 | |
765 | 2927 Vmouse_window = f->selected_window; |
518 | 2928 #endif /* HAVE_X11 */ |
2929 /* It's defined; call the definition. */ | |
2930 Vprefix_arg = Qnil; | |
765 | 2931 if (!NILP (frame_part)) |
518 | 2932 { |
2933 /* For a scroll-bar click, set the prefix arg | |
2934 to the number of lines down from the top the click was. | |
2935 Many scroll commands want to scroll by this many lines. */ | |
2936 Lisp_Object position; | |
2937 Lisp_Object length; | |
2938 Lisp_Object offset; | |
2939 | |
2940 position = Fcar (pos); | |
2941 length = Fcar (Fcdr (pos)); | |
2942 offset = Fcar (Fcdr (Fcdr (pos))); | |
2943 | |
2944 if (XINT (length) != 0) | |
2945 XSET (Vprefix_arg, Lisp_Int, | |
765 | 2946 (FRAME_HEIGHT (f) * (XINT (position) + XINT (offset)) |
518 | 2947 / (XINT (length) + 2 * XINT (offset)))); |
2948 } | |
2949 Fcommand_execute (mouse_cmd, Qnil); | |
2950 } | |
2951 | |
2952 if (!NILP (Vmouse_event_function)) /* Not `event' so no need for GCPRO */ | |
2953 call1 (Vmouse_event_function, Vmouse_event); | |
2954 return Qnil; | |
2955 } | |
2956 #endif | |
2957 | |
2958 DEFUN ("execute-extended-command", Fexecute_extended_command, Sexecute_extended_command, | |
2959 1, 1, "P", | |
2960 "Read function name, then read its arguments and call it.") | |
2961 (prefixarg) | |
2962 Lisp_Object prefixarg; | |
2963 { | |
2964 Lisp_Object function; | |
2965 char buf[40]; | |
2966 Lisp_Object saved_keys; | |
2967 struct gcpro gcpro1; | |
2968 | |
2969 saved_keys = Fthis_command_keys (); | |
2970 buf[0] = 0; | |
2971 GCPRO1 (saved_keys); | |
2972 | |
2973 if (EQ (prefixarg, Qminus)) | |
2974 strcpy (buf, "- "); | |
2975 else if (CONSP (prefixarg) && XINT (XCONS (prefixarg)->car) == 4) | |
2976 strcpy (buf, "C-u "); | |
2977 else if (CONSP (prefixarg) && XTYPE (XCONS (prefixarg)->car) == Lisp_Int) | |
2978 sprintf (buf, "%d ", XINT (XCONS (prefixarg)->car)); | |
2979 else if (XTYPE (prefixarg) == Lisp_Int) | |
2980 sprintf (buf, "%d ", XINT (prefixarg)); | |
2981 | |
2982 /* This isn't strictly correct if execute-extended-command | |
2983 is bound to anything else. Perhaps it should use | |
2984 this_command_keys? */ | |
2985 strcat (buf, "M-x "); | |
2986 | |
2987 /* Prompt with buf, and then read a string, completing from and | |
2988 restricting to the set of all defined commands. Don't provide | |
2989 any initial input. The last Qnil says not to perform a | |
2990 peculiar hack on the initial input. */ | |
2991 function = Fcompleting_read (build_string (buf), | |
2992 Vobarray, Qcommandp, | |
2993 Qt, Qnil, Qnil); | |
2994 | |
708 | 2995 /* Set this_command_keys to the concatenation of saved_keys and |
2996 function, followed by a RET. */ | |
518 | 2997 { |
708 | 2998 struct Lisp_String *str; |
518 | 2999 int i; |
3000 Lisp_Object tem; | |
3001 | |
708 | 3002 this_command_key_count = 0; |
3003 | |
3004 str = XSTRING (saved_keys); | |
3005 for (i = 0; i < str->size; i++) | |
518 | 3006 { |
708 | 3007 XFASTINT (tem) = str->data[i]; |
518 | 3008 add_command_key (tem); |
3009 } | |
708 | 3010 |
3011 str = XSTRING (function); | |
3012 for (i = 0; i < str->size; i++) | |
3013 { | |
3014 XFASTINT (tem) = str->data[i]; | |
3015 add_command_key (tem); | |
3016 } | |
3017 | |
3018 XFASTINT (tem) = '\015'; | |
3019 add_command_key (tem); | |
518 | 3020 } |
3021 | |
3022 UNGCPRO; | |
3023 | |
3024 function = Fintern (function, Vobarray); | |
3025 Vprefix_arg = prefixarg; | |
3026 this_command = function; | |
3027 | |
3028 return Fcommand_execute (function, Qt); | |
3029 } | |
3030 | |
3031 | |
3032 detect_input_pending () | |
3033 { | |
3034 if (!input_pending) | |
3035 get_input_pending (&input_pending); | |
3036 | |
3037 return input_pending; | |
3038 } | |
3039 | |
648 | 3040 /* This is called in some cases before a possible quit. |
3041 It cases the next call to detect_input_pending to recompute input_pending. | |
3042 So calling this function unnecessarily can't do any harm. */ | |
3043 clear_input_pending () | |
3044 { | |
3045 input_pending = 0; | |
3046 } | |
3047 | |
518 | 3048 DEFUN ("input-pending-p", Finput_pending_p, Sinput_pending_p, 0, 0, 0, |
3049 "T if command input is currently available with no waiting.\n\ | |
3050 Actually, the value is nil only if we can be sure that no input is available.") | |
3051 () | |
3052 { | |
3053 if (!NILP (unread_command_char)) | |
3054 return (Qt); | |
3055 | |
3056 return detect_input_pending () ? Qt : Qnil; | |
3057 } | |
3058 | |
3059 DEFUN ("recent-keys", Frecent_keys, Srecent_keys, 0, 0, 0, | |
727 | 3060 "Return vector of last 100 chars read from terminal.") |
518 | 3061 () |
3062 { | |
3063 Lisp_Object val; | |
3064 | |
3065 if (total_keys < NUM_RECENT_KEYS) | |
3066 return Fvector (total_keys, recent_keys); | |
3067 else | |
3068 { | |
3069 val = Fvector (NUM_RECENT_KEYS, recent_keys); | |
3070 bcopy (recent_keys + recent_keys_index, | |
3071 XVECTOR (val)->contents, | |
3072 (NUM_RECENT_KEYS - recent_keys_index) * sizeof (Lisp_Object)); | |
3073 bcopy (recent_keys, | |
3074 XVECTOR (val)->contents + NUM_RECENT_KEYS - recent_keys_index, | |
3075 recent_keys_index * sizeof (Lisp_Object)); | |
3076 return val; | |
3077 } | |
3078 } | |
3079 | |
3080 DEFUN ("this-command-keys", Fthis_command_keys, Sthis_command_keys, 0, 0, 0, | |
3081 "Return string of the keystrokes that invoked this command.") | |
3082 () | |
3083 { | |
3084 return make_array (this_command_key_count, this_command_keys); | |
3085 } | |
3086 | |
3087 DEFUN ("recursion-depth", Frecursion_depth, Srecursion_depth, 0, 0, 0, | |
3088 "Return the current depth in recursive edits.") | |
3089 () | |
3090 { | |
3091 Lisp_Object temp; | |
3092 XFASTINT (temp) = command_loop_level + minibuf_level; | |
3093 return temp; | |
3094 } | |
3095 | |
3096 DEFUN ("open-dribble-file", Fopen_dribble_file, Sopen_dribble_file, 1, 1, | |
3097 "FOpen dribble file: ", | |
3098 "Start writing all keyboard characters to FILE.") | |
3099 (file) | |
3100 Lisp_Object file; | |
3101 { | |
3102 if (NILP (file)) | |
3103 { | |
3104 fclose (dribble); | |
3105 dribble = 0; | |
3106 } | |
3107 else | |
3108 { | |
3109 file = Fexpand_file_name (file, Qnil); | |
3110 dribble = fopen (XSTRING (file)->data, "w"); | |
3111 } | |
3112 return Qnil; | |
3113 } | |
3114 | |
3115 DEFUN ("discard-input", Fdiscard_input, Sdiscard_input, 0, 0, 0, | |
3116 "Discard the contents of the terminal input buffer.\n\ | |
3117 Also cancel any kbd macro being defined.") | |
3118 () | |
3119 { | |
3120 defining_kbd_macro = 0; | |
3121 update_mode_lines++; | |
3122 | |
3123 #if 0 | |
3124 unread_command_char = make_number (-1); | |
3125 #endif | |
3126 unread_command_char = Qnil; | |
3127 | |
3128 discard_tty_input (); | |
3129 | |
3130 kbd_fetch_ptr = kbd_store_ptr; | |
3131 input_pending = 0; | |
3132 | |
3133 return Qnil; | |
3134 } | |
3135 | |
3136 DEFUN ("suspend-emacs", Fsuspend_emacs, Ssuspend_emacs, 0, 1, "", | |
3137 "Stop Emacs and return to superior process. You can resume later.\n\ | |
3138 On systems that don't have job control, run a subshell instead.\n\n\ | |
3139 If optional arg STUFFSTRING is non-nil, its characters are stuffed\n\ | |
3140 to be read as terminal input by Emacs's superior shell.\n\ | |
3141 Before suspending, if `suspend-hook' is bound and value is non-nil\n\ | |
3142 call the value as a function of no args. Don't suspend if it returns non-nil.\n\ | |
3143 Otherwise, suspend normally and after resumption call\n\ | |
3144 `suspend-resume-hook' if that is bound and non-nil.\n\ | |
3145 \n\ | |
3146 Some operating systems cannot stop the Emacs process and resume it later.\n\ | |
3147 On such systems, Emacs will start a subshell and wait for it to exit.") | |
3148 (stuffstring) | |
3149 Lisp_Object stuffstring; | |
3150 { | |
3151 register Lisp_Object tem; | |
3152 int count = specpdl_ptr - specpdl; | |
3153 int old_height, old_width; | |
3154 int width, height; | |
3155 struct gcpro gcpro1; | |
3156 extern init_sys_modes (); | |
3157 | |
3158 if (!NILP (stuffstring)) | |
3159 CHECK_STRING (stuffstring, 0); | |
3160 GCPRO1 (stuffstring); | |
3161 | |
3162 /* Call value of suspend-hook | |
3163 if it is bound and value is non-nil. */ | |
3164 if (!NILP (Vrun_hooks)) | |
3165 { | |
3166 tem = call1 (Vrun_hooks, intern ("suspend-hook")); | |
3167 if (!EQ (tem, Qnil)) return Qnil; | |
3168 } | |
3169 | |
765 | 3170 get_frame_size (&old_width, &old_height); |
518 | 3171 reset_sys_modes (); |
3172 /* sys_suspend can get an error if it tries to fork a subshell | |
3173 and the system resources aren't available for that. */ | |
3174 record_unwind_protect (init_sys_modes, 0); | |
3175 stuff_buffered_input (stuffstring); | |
3176 sys_suspend (); | |
3177 unbind_to (count, Qnil); | |
3178 | |
3179 /* Check if terminal/window size has changed. | |
3180 Note that this is not useful when we are running directly | |
3181 with a window system; but suspend should be disabled in that case. */ | |
765 | 3182 get_frame_size (&width, &height); |
518 | 3183 if (width != old_width || height != old_height) |
765 | 3184 change_frame_size (height, width, 0); |
518 | 3185 |
3186 /* Call value of suspend-resume-hook | |
3187 if it is bound and value is non-nil. */ | |
3188 if (!NILP (Vrun_hooks)) | |
3189 call1 (Vrun_hooks, intern ("suspend-resume-hook")); | |
3190 | |
3191 UNGCPRO; | |
3192 return Qnil; | |
3193 } | |
3194 | |
3195 /* If STUFFSTRING is a string, stuff its contents as pending terminal input. | |
3196 Then in any case stuff anthing Emacs has read ahead and not used. */ | |
3197 | |
3198 stuff_buffered_input (stuffstring) | |
3199 Lisp_Object stuffstring; | |
3200 { | |
3201 register unsigned char *p; | |
3202 | |
3203 /* stuff_char works only in BSD, versions 4.2 and up. */ | |
3204 #ifdef BSD | |
3205 #ifndef BSD4_1 | |
3206 if (XTYPE (stuffstring) == Lisp_String) | |
3207 { | |
3208 register int count; | |
3209 | |
3210 p = XSTRING (stuffstring)->data; | |
3211 count = XSTRING (stuffstring)->size; | |
3212 while (count-- > 0) | |
3213 stuff_char (*p++); | |
3214 stuff_char ('\n'); | |
3215 } | |
3216 /* Anything we have read ahead, put back for the shell to read. */ | |
3217 while (kbd_fetch_ptr != kbd_store_ptr) | |
3218 { | |
3219 if (kbd_fetch_ptr == kbd_buffer + KBD_BUFFER_SIZE) | |
3220 kbd_fetch_ptr = kbd_buffer; | |
3221 if (kbd_fetch_ptr->kind == ascii_keystroke) | |
3222 stuff_char (XINT (kbd_fetch_ptr->code)); | |
3223 kbd_fetch_ptr++; | |
3224 } | |
3225 input_pending = 0; | |
3226 #endif | |
3227 #endif /* BSD and not BSD4_1 */ | |
3228 } | |
3229 | |
648 | 3230 set_waiting_for_input (time_to_clear) |
3231 EMACS_TIME *time_to_clear; | |
518 | 3232 { |
648 | 3233 input_available_clear_time = time_to_clear; |
518 | 3234 |
3235 /* Tell interrupt_signal to throw back to read_char, */ | |
3236 waiting_for_input = 1; | |
3237 | |
3238 /* If interrupt_signal was called before and buffered a C-g, | |
3239 make it run again now, to avoid timing error. */ | |
3240 if (!NILP (Vquit_flag)) | |
3241 quit_throw_to_read_char (); | |
3242 | |
3243 /* If alarm has gone off already, echo now. */ | |
3244 if (echo_flag) | |
3245 { | |
3246 echo (); | |
3247 echo_flag = 0; | |
3248 } | |
3249 } | |
3250 | |
3251 clear_waiting_for_input () | |
3252 { | |
3253 /* Tell interrupt_signal not to throw back to read_char, */ | |
3254 waiting_for_input = 0; | |
648 | 3255 input_available_clear_time = 0; |
518 | 3256 } |
3257 | |
3258 /* This routine is called at interrupt level in response to C-G. | |
3259 If interrupt_input, this is the handler for SIGINT. | |
3260 Otherwise, it is called from kbd_buffer_store_event, | |
3261 in handling SIGIO or SIGTINT. | |
3262 | |
3263 If `waiting_for_input' is non zero, then unless `echoing' is nonzero, | |
3264 immediately throw back to read_char. | |
3265 | |
3266 Otherwise it sets the Lisp variable quit-flag not-nil. | |
3267 This causes eval to throw, when it gets a chance. | |
3268 If quit-flag is already non-nil, it stops the job right away. */ | |
3269 | |
3270 SIGTYPE | |
3271 interrupt_signal () | |
3272 { | |
3273 char c; | |
3274 /* Must preserve main program's value of errno. */ | |
3275 int old_errno = errno; | |
3276 extern Lisp_Object Vwindow_system; | |
3277 | |
3278 #ifdef USG | |
3279 /* USG systems forget handlers when they are used; | |
3280 must reestablish each time */ | |
3281 signal (SIGINT, interrupt_signal); | |
3282 signal (SIGQUIT, interrupt_signal); | |
3283 #endif /* USG */ | |
3284 | |
3285 cancel_echoing (); | |
3286 | |
765 | 3287 if (!NILP (Vquit_flag) && FRAME_IS_TERMCAP (selected_frame)) |
518 | 3288 { |
3289 fflush (stdout); | |
3290 reset_sys_modes (); | |
3291 sigfree (); | |
3292 #ifdef SIGTSTP /* Support possible in later USG versions */ | |
3293 /* | |
3294 * On systems which can suspend the current process and return to the original | |
3295 * shell, this command causes the user to end up back at the shell. | |
3296 * The "Auto-save" and "Abort" questions are not asked until | |
3297 * the user elects to return to emacs, at which point he can save the current | |
3298 * job and either dump core or continue. | |
3299 */ | |
3300 sys_suspend (); | |
3301 #else | |
3302 #ifdef VMS | |
3303 if (sys_suspend () == -1) | |
3304 { | |
3305 printf ("Not running as a subprocess;\n"); | |
3306 printf ("you can continue or abort.\n"); | |
3307 } | |
3308 #else /* not VMS */ | |
3309 /* Perhaps should really fork an inferior shell? | |
3310 But that would not provide any way to get back | |
3311 to the original shell, ever. */ | |
3312 printf ("No support for stopping a process on this operating system;\n"); | |
3313 printf ("you can continue or abort.\n"); | |
3314 #endif /* not VMS */ | |
3315 #endif /* not SIGTSTP */ | |
3316 printf ("Auto-save? (y or n) "); | |
3317 fflush (stdout); | |
3318 if (((c = getchar ()) & ~040) == 'Y') | |
3319 Fdo_auto_save (Qnil, Qnil); | |
3320 while (c != '\n') c = getchar (); | |
3321 #ifdef VMS | |
3322 printf ("Abort (and enter debugger)? (y or n) "); | |
3323 #else /* not VMS */ | |
3324 printf ("Abort (and dump core)? (y or n) "); | |
3325 #endif /* not VMS */ | |
3326 fflush (stdout); | |
3327 if (((c = getchar ()) & ~040) == 'Y') | |
3328 abort (); | |
3329 while (c != '\n') c = getchar (); | |
3330 printf ("Continuing...\n"); | |
3331 fflush (stdout); | |
3332 init_sys_modes (); | |
3333 } | |
3334 else | |
3335 { | |
3336 /* If executing a function that wants to be interrupted out of | |
3337 and the user has not deferred quitting by binding `inhibit-quit' | |
3338 then quit right away. */ | |
3339 if (immediate_quit && NILP (Vinhibit_quit)) | |
3340 { | |
3341 immediate_quit = 0; | |
3342 sigfree (); | |
3343 Fsignal (Qquit, Qnil); | |
3344 } | |
3345 else | |
3346 /* Else request quit when it's safe */ | |
3347 Vquit_flag = Qt; | |
3348 } | |
3349 | |
3350 if (waiting_for_input && !echoing) | |
3351 quit_throw_to_read_char (); | |
3352 | |
3353 errno = old_errno; | |
3354 } | |
3355 | |
3356 /* Handle a C-g by making read_char return C-g. */ | |
3357 | |
3358 quit_throw_to_read_char () | |
3359 { | |
3360 quit_error_check (); | |
3361 sigfree (); | |
3362 /* Prevent another signal from doing this before we finish. */ | |
650 | 3363 clear_waiting_for_input (); |
518 | 3364 input_pending = 0; |
3365 | |
3366 #if 0 | |
3367 unread_command_char = make_number (-1); | |
3368 #endif | |
3369 unread_command_char = Qnil; | |
3370 | |
3371 _longjmp (getcjmp, 1); | |
3372 } | |
3373 | |
3374 DEFUN ("set-input-mode", Fset_input_mode, Sset_input_mode, 3, 4, 0, | |
3375 "Set mode of reading keyboard input.\n\ | |
695
e3fac20d3015
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
691
diff
changeset
|
3376 First arg INTERRUPT non-nil means use input interrupts;\n\ |
e3fac20d3015
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
691
diff
changeset
|
3377 nil means use CBREAK mode.\n\ |
e3fac20d3015
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
691
diff
changeset
|
3378 Second arg FLOW non-nil means use ^S/^Q flow control for output to terminal\n\ |
518 | 3379 (no effect except in CBREAK mode).\n\ |
695
e3fac20d3015
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
691
diff
changeset
|
3380 Third arg META non-nil means accept 8-bit input (for a Meta key).\n\ |
518 | 3381 Otherwise, the top bit is ignored, on the assumption it is parity.\n\ |
695
e3fac20d3015
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
691
diff
changeset
|
3382 Optional fourth arg QUIT if non-nil specifies character to use for quitting.") |
518 | 3383 (interrupt, flow, meta, quit) |
3384 Lisp_Object interrupt, flow, meta, quit; | |
3385 { | |
3386 if (!NILP (quit) | |
3387 && (XTYPE (quit) != Lisp_Int | |
3388 || XINT (quit) < 0 || XINT (quit) > 0400)) | |
3389 error ("set-input-mode: QUIT must be an ASCII character."); | |
3390 | |
3391 reset_sys_modes (); | |
3392 #ifdef SIGIO | |
3393 /* Note SIGIO has been undef'd if FIONREAD is missing. */ | |
3394 #ifdef NO_SOCK_SIGIO | |
3395 if (read_socket_hook) | |
3396 interrupt_input = 0; /* No interrupts if reading from a socket. */ | |
3397 else | |
3398 #endif /* NO_SOCK_SIGIO */ | |
3399 interrupt_input = !NILP (interrupt); | |
3400 #else /* not SIGIO */ | |
3401 interrupt_input = 0; | |
3402 #endif /* not SIGIO */ | |
3403 /* Our VMS input only works by interrupts, as of now. */ | |
3404 #ifdef VMS | |
3405 interrupt_input = 1; | |
3406 #endif | |
3407 flow_control = !NILP (flow); | |
3408 meta_key = !NILP (meta); | |
3409 if (!NILP (quit)) | |
3410 /* Don't let this value be out of range. */ | |
3411 quit_char = XINT (quit) & (meta_key ? 0377 : 0177); | |
3412 | |
3413 init_sys_modes (); | |
3414 return Qnil; | |
3415 } | |
3416 | |
3417 init_keyboard () | |
3418 { | |
3419 this_command_keys_size = 40; | |
3420 this_command_keys = | |
3421 (Lisp_Object *) xmalloc (this_command_keys_size * sizeof (Lisp_Object)); | |
3422 | |
3423 /* This is correct before outermost invocation of the editor loop */ | |
3424 command_loop_level = -1; | |
3425 immediate_quit = 0; | |
3426 quit_char = Ctl ('g'); | |
3427 unread_command_char = Qnil; | |
3428 recent_keys_index = 0; | |
3429 total_keys = 0; | |
3430 kbd_fetch_ptr = kbd_buffer; | |
3431 kbd_store_ptr = kbd_buffer; | |
3432 do_mouse_tracking = 0; | |
3433 input_pending = 0; | |
3434 | |
3435 if (!noninteractive) | |
3436 { | |
3437 signal (SIGINT, interrupt_signal); | |
3438 #ifdef HAVE_TERMIO | |
3439 /* For systems with SysV TERMIO, C-g is set up for both SIGINT and | |
3440 SIGQUIT and we can't tell which one it will give us. */ | |
3441 signal (SIGQUIT, interrupt_signal); | |
3442 #endif /* HAVE_TERMIO */ | |
3443 /* Note SIGIO has been undef'd if FIONREAD is missing. */ | |
3444 #ifdef SIGIO | |
3445 signal (SIGIO, input_available_signal); | |
3446 #endif SIGIO | |
3447 } | |
3448 | |
3449 /* Use interrupt input by default, if it works and noninterrupt input | |
3450 has deficiencies. */ | |
3451 | |
3452 #ifdef INTERRUPT_INPUT | |
3453 interrupt_input = 1; | |
3454 #else | |
3455 interrupt_input = 0; | |
3456 #endif | |
3457 | |
3458 /* Our VMS input only works by interrupts, as of now. */ | |
3459 #ifdef VMS | |
3460 interrupt_input = 1; | |
3461 #endif | |
3462 | |
3463 sigfree (); | |
3464 dribble = 0; | |
3465 | |
3466 if (keyboard_init_hook) | |
3467 (*keyboard_init_hook) (); | |
3468 | |
3469 #ifdef POLL_FOR_INPUT | |
3470 poll_suppress_count = 1; | |
3471 start_polling (); | |
3472 #endif | |
3473 } | |
3474 | |
3475 /* This type's only use is in syms_of_keyboard, to initialize the | |
3476 event header symbols and put properties on them. */ | |
3477 struct event_head { | |
3478 Lisp_Object *var; | |
3479 char *name; | |
3480 Lisp_Object *kind; | |
3481 }; | |
3482 | |
3483 struct event_head head_table[] = { | |
3484 &Qmouse_movement, "mouse-movement", &Qmouse_movement, | |
3485 &Qvscrollbar_part, "vscrollbar-part", &Qscrollbar_click, | |
3486 &Qvslider_part, "vslider-part", &Qscrollbar_click, | |
3487 &Qvthumbup_part, "vthumbup-part", &Qscrollbar_click, | |
3488 &Qvthumbdown_part, "vthumbdown-part", &Qscrollbar_click, | |
3489 &Qhscrollbar_part, "hscrollbar-part", &Qscrollbar_click, | |
3490 &Qhslider_part, "hslider-part", &Qscrollbar_click, | |
3491 &Qhthumbleft_part, "hthumbleft-part", &Qscrollbar_click, | |
3492 &Qhthumbright_part,"hthumbright-part", &Qscrollbar_click | |
3493 }; | |
3494 | |
3495 syms_of_keyboard () | |
3496 { | |
3497 Qself_insert_command = intern ("self-insert-command"); | |
3498 staticpro (&Qself_insert_command); | |
3499 | |
3500 Qforward_char = intern ("forward-char"); | |
3501 staticpro (&Qforward_char); | |
3502 | |
3503 Qbackward_char = intern ("backward-char"); | |
3504 staticpro (&Qbackward_char); | |
3505 | |
3506 Qdisabled = intern ("disabled"); | |
3507 staticpro (&Qdisabled); | |
3508 | |
3509 Qfunction_key = intern ("function-key"); | |
3510 staticpro (&Qfunction_key); | |
3511 Qmouse_movement = intern ("mouse-click"); | |
3512 staticpro (&Qmouse_click); | |
3513 Qmouse_movement = intern ("scrollbar-click"); | |
3514 staticpro (&Qmouse_movement); | |
3515 | |
3516 Qmode_line = intern ("mode-line"); | |
3517 staticpro (&Qmode_line); | |
732 | 3518 Qvertical_line = intern ("vertical-line"); |
3519 staticpro (&Qvertical_line); | |
518 | 3520 |
3521 Qevent_kind = intern ("event-type"); | |
3522 staticpro (&Qevent_kind); | |
3523 Qevent_unmodified = intern ("event-unmodified"); | |
3524 staticpro (&Qevent_unmodified); | |
3525 | |
3526 { | |
3527 struct event_head *p; | |
3528 | |
3529 for (p = head_table; | |
3530 p < head_table + (sizeof (head_table) / sizeof (head_table[0])); | |
3531 p++) | |
3532 { | |
3533 *p->var = intern (p->name); | |
3534 staticpro (p->var); | |
3535 Fput (*p->var, Qevent_kind, *p->kind); | |
3536 Fput (*p->var, Qevent_unmodified, *p->var); | |
3537 } | |
3538 } | |
3539 | |
3540 func_key_syms = Qnil; | |
3541 staticpro (&func_key_syms); | |
3542 | |
3543 mouse_syms = Qnil; | |
3544 staticpro (&mouse_syms); | |
3545 | |
3546 defsubr (&Sread_key_sequence); | |
3547 defsubr (&Srecursive_edit); | |
3548 defsubr (&Strack_mouse); | |
3549 defsubr (&Smouse_click_p); | |
3550 defsubr (&Sinput_pending_p); | |
3551 defsubr (&Scommand_execute); | |
3552 defsubr (&Srecent_keys); | |
3553 defsubr (&Sthis_command_keys); | |
3554 defsubr (&Ssuspend_emacs); | |
3555 defsubr (&Sabort_recursive_edit); | |
3556 defsubr (&Sexit_recursive_edit); | |
3557 defsubr (&Srecursion_depth); | |
3558 defsubr (&Stop_level); | |
3559 defsubr (&Sdiscard_input); | |
3560 defsubr (&Sopen_dribble_file); | |
3561 defsubr (&Sset_input_mode); | |
3562 defsubr (&Sexecute_extended_command); | |
3563 | |
3564 DEFVAR_LISP ("disabled-command-hook", &Vdisabled_command_hook, | |
3565 "Value is called instead of any command that is disabled\n\ | |
3566 (has a non-nil `disabled' property)."); | |
3567 | |
3568 DEFVAR_LISP ("last-command-char", &last_command_char, | |
3569 "Last terminal input key that was part of a command."); | |
3570 | |
3571 DEFVAR_LISP ("last-input-char", &last_input_char, | |
3572 "Last terminal input key."); | |
3573 | |
3574 DEFVAR_LISP ("unread-command-char", &unread_command_char, | |
3575 "Object to be read as next input from input stream, or nil if none."); | |
3576 | |
3577 DEFVAR_LISP ("meta-prefix-char", &meta_prefix_char, | |
3578 "Meta-prefix character code. Meta-foo as command input\n\ | |
3579 turns into this character followed by foo."); | |
3580 XSET (meta_prefix_char, Lisp_Int, 033); | |
3581 | |
3582 DEFVAR_LISP ("last-command", &last_command, | |
3583 "The last command executed. Normally a symbol with a function definition,\n\ | |
3584 but can be whatever was found in the keymap, or whatever the variable\n\ | |
3585 `this-command' was set to by that command."); | |
3586 last_command = Qnil; | |
3587 | |
3588 DEFVAR_LISP ("this-command", &this_command, | |
3589 "The command now being executed.\n\ | |
3590 The command can set this variable; whatever is put here\n\ | |
3591 will be in `last-command' during the following command."); | |
3592 this_command = Qnil; | |
3593 | |
3594 DEFVAR_INT ("auto-save-interval", &auto_save_interval, | |
3595 "*Number of keyboard input characters between auto-saves.\n\ | |
3596 Zero means disable autosaving due to number of characters typed."); | |
3597 auto_save_interval = 300; | |
3598 | |
3599 DEFVAR_LISP ("auto-save-timeout", &Vauto_save_timeout, | |
3600 "*Number of seconds idle time before auto-save.\n\ | |
687
e2b747dd6a6e
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
682
diff
changeset
|
3601 Zero or nil means disable auto-saving due to idleness.\n\ |
e2b747dd6a6e
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
682
diff
changeset
|
3602 After auto-saving due to this many seconds of idle time,\n\ |
701 | 3603 Emacs also does a garbage collection if that seems to be warranted."); |
518 | 3604 XFASTINT (Vauto_save_timeout) = 30; |
3605 | |
3606 DEFVAR_INT ("echo-keystrokes", &echo_keystrokes, | |
3607 "*Nonzero means echo unfinished commands after this many seconds of pause."); | |
3608 echo_keystrokes = 1; | |
3609 | |
3610 DEFVAR_INT ("polling-period", &polling_period, | |
3611 "*Interval between polling for input during Lisp execution.\n\ | |
3612 The reason for polling is to make C-g work to stop a running program.\n\ | |
3613 Polling is needed only when using X windows and SIGIO does not work.\n\ | |
3614 Polling is automatically disabled in all other cases."); | |
3615 polling_period = 2; | |
3616 | |
3617 DEFVAR_INT ("num-input-keys", &num_input_keys, | |
3618 "*Number of complete keys read from the keyboard so far."); | |
3619 num_input_keys = 0; | |
3620 | |
765 | 3621 DEFVAR_LISP ("last-event-frame", &Vlast_event_frame, |
3622 "*The frame in which the most recently read event occurred."); | |
3623 Vlast_event_frame = Qnil; | |
518 | 3624 |
3625 DEFVAR_LISP ("help-char", &help_char, | |
3626 "Character to recognize as meaning Help.\n\ | |
3627 When it is read, do `(eval help-form)', and display result if it's a string.\n\ | |
3628 If the value of `help-form' is nil, this char can be read normally."); | |
3629 XSET (help_char, Lisp_Int, Ctl ('H')); | |
3630 | |
3631 DEFVAR_LISP ("help-form", &Vhelp_form, | |
3632 "Form to execute when character help-char is read.\n\ | |
3633 If the form returns a string, that string is displayed.\n\ | |
3634 If `help-form' is nil, the help char is not recognized."); | |
3635 Vhelp_form = Qnil; | |
3636 | |
3637 DEFVAR_LISP ("top-level", &Vtop_level, | |
3638 "Form to evaluate when Emacs starts up.\n\ | |
3639 Useful to set before you dump a modified Emacs."); | |
3640 Vtop_level = Qnil; | |
3641 | |
3642 DEFVAR_LISP ("keyboard-translate-table", &Vkeyboard_translate_table, | |
3643 "String used as translate table for keyboard input, or nil.\n\ | |
3644 Each character is looked up in this string and the contents used instead.\n\ | |
3645 If string is of length N, character codes N and up are untranslated."); | |
3646 Vkeyboard_translate_table = Qnil; | |
3647 | |
3648 #ifdef HAVE_X_WINDOWS | |
3649 DEFVAR_LISP ("mouse-event-function", &Vmouse_event_function, | |
3650 "Function to call for each mouse event, after the event's definition.\n\ | |
3651 Called, if non-nil, with one argument, which is the event-list.\n\ | |
3652 See the variable `mouse-event' for the format of this list."); | |
3653 Vmouse_event_function = Qnil; | |
3654 | |
3655 DEFVAR_LISP ("mouse-left-hook", &Vmouse_left_hook, | |
3656 "Function to call when mouse leaves window. No arguments."); | |
3657 Vmouse_left_hook = Qnil; | |
3658 | |
765 | 3659 DEFVAR_LISP ("map-frame-hook", &Vmap_frame_hook, |
3660 "Function to call when frame is mapped. No arguments."); | |
3661 Vmap_frame_hook = Qnil; | |
3662 | |
3663 DEFVAR_LISP ("unmap-frame-hook", &Vunmap_frame_hook, | |
3664 "Function to call when frame is unmapped. No arguments."); | |
3665 Vunmap_frame_hook = Qnil; | |
518 | 3666 |
3667 DEFVAR_LISP ("mouse-motion-handler", &Vmouse_motion_handler, | |
3668 "Handler for motion events. No arguments."); | |
3669 Vmouse_motion_handler = Qnil; | |
3670 #endif | |
3671 | |
3672 DEFVAR_BOOL ("menu-prompting", &menu_prompting, | |
3673 "Non-nil means prompt with menus in echo area when appropriate.\n\ | |
3674 This is done when reading from a keymap that has a prompt string,\n\ | |
3675 for elements that have prompt strings."); | |
3676 menu_prompting = 1; | |
3677 | |
3678 DEFVAR_LISP ("menu-prompt-more-char", &menu_prompt_more_char, | |
3679 "Character to see next line of menu prompt.\n\ | |
3680 Type this character while in a menu prompt to rotate around the lines of it."); | |
3681 XSET (menu_prompt_more_char, Lisp_Int, ' '); | |
3682 } | |
3683 | |
3684 keys_of_keyboard () | |
3685 { | |
3686 initial_define_key (global_map, Ctl ('Z'), "suspend-emacs"); | |
3687 initial_define_key (control_x_map, Ctl ('Z'), "suspend-emacs"); | |
3688 initial_define_key (meta_map, Ctl ('C'), "exit-recursive-edit"); | |
3689 initial_define_key (global_map, Ctl (']'), "abort-recursive-edit"); | |
3690 initial_define_key (meta_map, 'x', "execute-extended-command"); | |
3691 } |