Mercurial > hg > xemacs-beta
annotate src/event-stream.c @ 5120:d1247f3cc363 ben-lisp-object
latest work on lisp-object workspace;
more changes eliminating LCRECORD in place of LISP_OBJECT;
now compiles and runs.
| author | Ben Wing <ben@xemacs.org> |
|---|---|
| date | Mon, 28 Dec 2009 01:15:52 -0600 |
| parents | e0db3c197671 |
| children | 623d57b7fbe8 |
| rev | line source |
|---|---|
| 428 | 1 /* The portable interface to event streams. |
| 2 Copyright (C) 1991, 1992, 1993, 1994, 1995 Free Software Foundation, Inc. | |
| 3 Copyright (C) 1995 Board of Trustees, University of Illinois. | |
| 4 Copyright (C) 1995 Sun Microsystems, Inc. | |
|
5117
3742ea8250b5
Checking in final CVS version of workspace 'ben-lisp-object'
Ben Wing <ben@xemacs.org>
parents:
3025
diff
changeset
|
5 Copyright (C) 1995, 1996, 2001, 2002, 2003, 2005 Ben Wing. |
| 428 | 6 |
| 7 This file is part of XEmacs. | |
| 8 | |
| 9 XEmacs is free software; you can redistribute it and/or modify it | |
| 10 under the terms of the GNU General Public License as published by the | |
| 11 Free Software Foundation; either version 2, or (at your option) any | |
| 12 later version. | |
| 13 | |
| 14 XEmacs is distributed in the hope that it will be useful, but WITHOUT | |
| 15 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or | |
| 16 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License | |
| 17 for more details. | |
| 18 | |
| 19 You should have received a copy of the GNU General Public License | |
| 20 along with XEmacs; see the file COPYING. If not, write to | |
| 21 the Free Software Foundation, Inc., 59 Temple Place - Suite 330, | |
| 22 Boston, MA 02111-1307, USA. */ | |
| 23 | |
| 24 /* Synched up with: Not in FSF. */ | |
| 25 | |
| 442 | 26 /* Authorship: |
| 27 | |
| 28 Created 1991 by Jamie Zawinski. | |
| 29 A great deal of work over the ages by Ben Wing (Mule-ization for 19.12, | |
| 30 device abstraction for 19.12/19.13, async timers for 19.14, | |
| 31 rewriting of focus code for 19.12, pre-idle hook for 19.12, | |
| 32 redoing of signal and quit handling for 19.9 and 19.12, | |
| 33 misc-user events to clean up menu/scrollbar handling for 19.11, | |
| 34 function-key-map/key-translation-map/keyboard-translate-table for | |
| 35 19.13/19.14, open-dribble-file for 19.13, much other cleanup). | |
| 36 focus-follows-mouse from Chuck Thompson, 1995. | |
| 37 XIM stuff by Martin Buchholz, c. 1996?. | |
| 38 */ | |
| 39 | |
| 428 | 40 /* This file has been Mule-ized. */ |
| 41 | |
| 42 /* | |
| 43 * DANGER!! | |
| 44 * | |
| 45 * If you ever change ANYTHING in this file, you MUST run the | |
| 46 * testcases at the end to make sure that you haven't changed | |
| 47 * the semantics of recent-keys, last-input-char, or keyboard | |
| 48 * macros. You'd be surprised how easy it is to break this. | |
| 49 * | |
| 50 */ | |
| 51 | |
| 52 /* TODO: | |
| 1204 | 53 [This stuff is way too hard to maintain - needs rework.] |
| 54 I don't think it's that bad in the main. I've done a fair amount of | |
| 55 cleanup work over the ages; the only stuff that's probably still somewhat | |
| 56 messy is the command-builder handling, which is that way because it's | |
| 57 trying to be "compatible" with pseudo-standards established by Emacs | |
| 58 v18. | |
| 428 | 59 |
| 60 The command builder should deal only with key and button events. | |
| 61 Other command events should be able to come in the MIDDLE of a key | |
| 62 sequence, without disturbing the key sequence composition, or the | |
| 63 command builder structure representing it. | |
| 64 | |
| 65 Someone should rethink universal-argument and figure out how an | |
| 66 arbitrary command can influence the next command (universal-argument | |
| 67 or universal-coding-system-argument) or the next key (hyperify). | |
| 68 | |
| 69 Both C-h and Help in the middle of a key sequence should trigger | |
| 70 prefix-help-command. help-char is stupid. Maybe we need | |
| 71 keymap-of-last-resort? | |
| 72 | |
| 73 After prefix-help is run, one should be able to CONTINUE TYPING, | |
| 74 instead of RETYPING, the key sequence. | |
| 75 */ | |
| 76 | |
| 77 #include <config.h> | |
| 78 #include "lisp.h" | |
| 79 | |
| 80 #include "blocktype.h" | |
| 81 #include "buffer.h" | |
| 82 #include "commands.h" | |
| 872 | 83 #include "device-impl.h" |
| 428 | 84 #include "elhash.h" |
| 85 #include "events.h" | |
| 872 | 86 #include "frame-impl.h" |
| 428 | 87 #include "insdel.h" /* for buffer_reset_changes */ |
| 88 #include "keymap.h" | |
| 89 #include "lstream.h" | |
| 90 #include "macros.h" /* for defining_keyboard_macro */ | |
| 442 | 91 #include "menubar.h" /* #### for evil kludges. */ |
| 428 | 92 #include "process.h" |
| 1292 | 93 #include "profile.h" |
| 872 | 94 #include "window-impl.h" |
| 428 | 95 |
| 96 #include "sysdep.h" /* init_poll_for_quit() */ | |
| 97 #include "syssignal.h" /* SIGCHLD, etc. */ | |
| 98 #include "sysfile.h" | |
| 99 #include "systime.h" /* to set Vlast_input_time */ | |
| 100 | |
| 101 #include "file-coding.h" | |
| 102 | |
| 103 #include <errno.h> | |
| 104 | |
| 105 /* The number of keystrokes between auto-saves. */ | |
| 458 | 106 static Fixnum auto_save_interval; |
| 428 | 107 |
| 108 Lisp_Object Qundefined_keystroke_sequence; | |
| 563 | 109 Lisp_Object Qinvalid_key_binding; |
| 428 | 110 |
| 111 Lisp_Object Qcommand_event_p; | |
| 112 | |
| 113 /* Hooks to run before and after each command. */ | |
| 114 Lisp_Object Vpre_command_hook, Vpost_command_hook; | |
| 115 Lisp_Object Qpre_command_hook, Qpost_command_hook; | |
| 116 | |
| 442 | 117 /* See simple.el */ |
| 118 Lisp_Object Qhandle_pre_motion_command, Qhandle_post_motion_command; | |
| 119 | |
| 428 | 120 /* Hook run when XEmacs is about to be idle. */ |
| 121 Lisp_Object Qpre_idle_hook, Vpre_idle_hook; | |
| 122 | |
| 123 /* Control gratuitous keyboard focus throwing. */ | |
| 124 int focus_follows_mouse; | |
| 125 | |
| 444 | 126 /* When true, modifier keys are sticky. */ |
| 442 | 127 int modifier_keys_are_sticky; |
| 444 | 128 /* Modifier keys are sticky for this many milliseconds. */ |
| 129 Lisp_Object Vmodifier_keys_sticky_time; | |
| 130 | |
| 2828 | 131 /* If true, "Russian C-x processing" is enabled. */ |
| 132 int try_alternate_layouts_for_commands; | |
| 133 | |
| 444 | 134 /* Here FSF Emacs 20.7 defines Vpost_command_idle_hook, |
| 135 post_command_idle_delay, Vdeferred_action_list, and | |
| 136 Vdeferred_action_function, but we don't because that stuff is crap, | |
| 1315 | 137 and we're smarter than them, and their mommas are fat. */ |
| 444 | 138 |
| 139 /* FSF Emacs 20.7 also defines Vinput_method_function, | |
| 140 Qinput_method_exit_on_first_char and Qinput_method_use_echo_area. | |
| 1315 | 141 I don't know whether this should be imported or not. */ |
| 428 | 142 |
| 143 /* Non-nil disable property on a command means | |
| 144 do not execute it; call disabled-command-hook's value instead. */ | |
| 733 | 145 Lisp_Object Qdisabled; |
| 428 | 146 |
| 147 /* Last keyboard or mouse input event read as a command. */ | |
| 148 Lisp_Object Vlast_command_event; | |
| 149 | |
| 150 /* The nearest ASCII equivalent of the above. */ | |
| 151 Lisp_Object Vlast_command_char; | |
| 152 | |
| 153 /* Last keyboard or mouse event read for any purpose. */ | |
| 154 Lisp_Object Vlast_input_event; | |
| 155 | |
| 156 /* The nearest ASCII equivalent of the above. */ | |
| 157 Lisp_Object Vlast_input_char; | |
| 158 | |
| 159 Lisp_Object Vcurrent_mouse_event; | |
| 160 | |
| 161 /* This is fbound in cmdloop.el, see the commentary there */ | |
| 162 Lisp_Object Qcancel_mode_internal; | |
| 163 | |
| 164 /* If not Qnil, event objects to be read as the next command input */ | |
| 165 Lisp_Object Vunread_command_events; | |
| 166 Lisp_Object Vunread_command_event; /* obsoleteness support */ | |
| 167 | |
| 168 static Lisp_Object Qunread_command_events, Qunread_command_event; | |
| 169 | |
| 170 /* Previous command, represented by a Lisp object. | |
| 442 | 171 Does not include prefix commands and arg setting commands. */ |
| 428 | 172 Lisp_Object Vlast_command; |
| 173 | |
| 442 | 174 /* Contents of this-command-properties for the last command. */ |
| 175 Lisp_Object Vlast_command_properties; | |
| 176 | |
| 428 | 177 /* If a command sets this, the value goes into |
| 442 | 178 last-command for the next command. */ |
| 428 | 179 Lisp_Object Vthis_command; |
| 180 | |
| 442 | 181 /* If a command sets this, the value goes into |
| 182 last-command-properties for the next command. */ | |
| 183 Lisp_Object Vthis_command_properties; | |
| 184 | |
| 428 | 185 /* The value of point when the last command was executed. */ |
| 665 | 186 Charbpos last_point_position; |
| 428 | 187 |
| 188 /* The frame that was current when the last command was started. */ | |
| 189 Lisp_Object Vlast_selected_frame; | |
| 190 | |
| 191 /* The buffer that was current when the last command was started. */ | |
| 192 Lisp_Object last_point_position_buffer; | |
| 193 | |
| 194 /* A (16bit . 16bit) representation of the time of the last-command-event. */ | |
| 195 Lisp_Object Vlast_input_time; | |
| 196 | |
| 197 /* A (16bit 16bit usec) representation of the time | |
| 198 of the last-command-event. */ | |
| 199 Lisp_Object Vlast_command_event_time; | |
| 200 | |
| 201 /* Character to recognize as the help char. */ | |
| 202 Lisp_Object Vhelp_char; | |
| 203 | |
| 204 /* Form to execute when help char is typed. */ | |
| 205 Lisp_Object Vhelp_form; | |
| 206 | |
| 207 /* Command to run when the help character follows a prefix key. */ | |
| 208 Lisp_Object Vprefix_help_command; | |
| 209 | |
| 210 /* Flag to tell QUIT that some interesting occurrence (e.g. a keypress) | |
| 211 may have happened. */ | |
| 212 volatile int something_happened; | |
| 213 | |
| 214 /* Hash table to translate keysyms through */ | |
| 215 Lisp_Object Vkeyboard_translate_table; | |
| 216 | |
| 217 /* If control-meta-super-shift-X is undefined, try control-meta-super-x */ | |
| 218 Lisp_Object Vretry_undefined_key_binding_unshifted; | |
| 219 Lisp_Object Qretry_undefined_key_binding_unshifted; | |
| 220 | |
| 221 /* Console that corresponds to our controlling terminal */ | |
| 222 Lisp_Object Vcontrolling_terminal; | |
| 223 | |
| 224 /* An event (actually an event chain linked through event_next) or Qnil. | |
| 225 */ | |
| 226 Lisp_Object Vthis_command_keys; | |
| 227 Lisp_Object Vthis_command_keys_tail; | |
| 228 | |
| 229 /* #### kludge! */ | |
| 230 Lisp_Object Qauto_show_make_point_visible; | |
| 231 | |
| 232 /* File in which we write all commands we read; an lstream */ | |
| 233 static Lisp_Object Vdribble_file; | |
| 234 | |
| 235 /* Recent keys ring location; a vector of events or nil-s */ | |
| 236 Lisp_Object Vrecent_keys_ring; | |
| 237 int recent_keys_ring_size; | |
| 238 int recent_keys_ring_index; | |
| 239 | |
| 240 /* Boolean specifying whether keystrokes should be added to | |
| 241 recent-keys. */ | |
| 242 int inhibit_input_event_recording; | |
| 243 | |
| 430 | 244 Lisp_Object Qself_insert_defer_undo; |
| 245 | |
| 1268 | 246 int in_modal_loop; |
| 247 | |
| 248 /* the number of keyboard characters read. callint.c wants this. */ | |
| 249 Charcount num_input_chars; | |
| 428 | 250 |
| 1292 | 251 static Lisp_Object Qnext_event, Qdispatch_event, QSnext_event_internal; |
| 252 static Lisp_Object QSexecute_internal_event; | |
| 253 | |
| 428 | 254 #ifdef DEBUG_XEMACS |
| 458 | 255 Fixnum debug_emacs_events; |
| 428 | 256 |
| 257 static void | |
|
4528
726060ee587c
First draft of g++ 4.3 warning removal patch. Builds. *Needs ChangeLogs.*
Stephen J. Turnbull <stephen@xemacs.org>
parents:
4522
diff
changeset
|
258 external_debugging_print_event (const char *event_description, Lisp_Object event) |
| 428 | 259 { |
| 826 | 260 write_c_string (Qexternal_debugging_output, "("); |
| 261 write_c_string (Qexternal_debugging_output, event_description); | |
| 262 write_c_string (Qexternal_debugging_output, ") "); | |
| 428 | 263 print_internal (event, Qexternal_debugging_output, 1); |
| 826 | 264 write_c_string (Qexternal_debugging_output, "\n"); |
| 428 | 265 } |
| 266 #define DEBUG_PRINT_EMACS_EVENT(event_description, event) do { \ | |
| 267 if (debug_emacs_events) \ | |
| 268 external_debugging_print_event (event_description, event); \ | |
| 269 } while (0) | |
| 270 #else | |
| 271 #define DEBUG_PRINT_EMACS_EVENT(string, event) | |
| 272 #endif | |
| 273 | |
| 274 | |
| 275 /* The callback routines for the window system or terminal driver */ | |
| 276 struct event_stream *event_stream; | |
| 277 | |
| 2367 | 278 |
| 279 /* | |
| 280 | |
| 281 See also | |
| 282 | |
| 283 (Info-goto-node "(internals)Event Stream Callback Routines") | |
| 284 */ | |
| 1204 | 285 |
| 428 | 286 static Lisp_Object command_event_queue; |
| 287 static Lisp_Object command_event_queue_tail; | |
| 288 | |
| 1204 | 289 Lisp_Object dispatch_event_queue; |
| 290 static Lisp_Object dispatch_event_queue_tail; | |
| 291 | |
| 428 | 292 /* Nonzero means echo unfinished commands after this many seconds of pause. */ |
| 293 static Lisp_Object Vecho_keystrokes; | |
| 294 | |
| 295 /* The number of keystrokes since the last auto-save. */ | |
| 296 static int keystrokes_since_auto_save; | |
| 297 | |
| 298 /* Used by the C-g signal handler so that it will never "hard quit" | |
| 299 when waiting for an event. Otherwise holding down C-g could | |
| 300 cause a suspension back to the shell, which is generally | |
| 301 undesirable. (#### This doesn't fully work.) */ | |
| 302 | |
| 303 int emacs_is_blocking; | |
| 304 | |
| 305 /* Handlers which run during sit-for, sleep-for and accept-process-output | |
| 306 are not allowed to recursively call these routines. We record here | |
| 307 if we are in that situation. */ | |
| 308 | |
| 1268 | 309 static int recursive_sit_for; |
| 310 | |
| 311 static void pre_command_hook (void); | |
| 312 static void post_command_hook (void); | |
| 313 static void maybe_kbd_translate (Lisp_Object event); | |
| 314 static void push_this_command_keys (Lisp_Object event); | |
| 315 static void push_recent_keys (Lisp_Object event); | |
| 316 static void dribble_out_event (Lisp_Object event); | |
| 317 static void execute_internal_event (Lisp_Object event); | |
| 318 static int is_scrollbar_event (Lisp_Object event); | |
| 428 | 319 |
| 320 | |
| 321 /**********************************************************************/ | |
| 322 /* Command-builder object */ | |
| 323 /**********************************************************************/ | |
| 324 | |
| 325 #define XCOMMAND_BUILDER(x) \ | |
| 326 XRECORD (x, command_builder, struct command_builder) | |
| 771 | 327 #define wrap_command_builder(p) wrap_record (p, command_builder) |
| 428 | 328 #define COMMAND_BUILDERP(x) RECORDP (x, command_builder) |
| 329 #define CHECK_COMMAND_BUILDER(x) CHECK_RECORD (x, command_builder) | |
| 771 | 330 #define CONCHECK_COMMAND_BUILDER(x) CONCHECK_RECORD (x, command_builder) |
| 331 | |
| 1204 | 332 static const struct memory_description command_builder_description [] = { |
| 934 | 333 { XD_LISP_OBJECT, offsetof (struct command_builder, current_events) }, |
| 334 { XD_LISP_OBJECT, offsetof (struct command_builder, most_current_event) }, | |
| 335 { XD_LISP_OBJECT, offsetof (struct command_builder, last_non_munged_event) }, | |
| 336 { XD_LISP_OBJECT, offsetof (struct command_builder, console) }, | |
| 1204 | 337 { XD_LISP_OBJECT_ARRAY, offsetof (struct command_builder, first_mungeable_event), 2 }, |
| 934 | 338 { XD_END } |
| 339 }; | |
| 340 | |
| 428 | 341 static Lisp_Object |
| 342 mark_command_builder (Lisp_Object obj) | |
| 343 { | |
| 344 struct command_builder *builder = XCOMMAND_BUILDER (obj); | |
| 345 mark_object (builder->current_events); | |
| 346 mark_object (builder->most_current_event); | |
| 347 mark_object (builder->last_non_munged_event); | |
| 1204 | 348 mark_object (builder->first_mungeable_event[0]); |
| 349 mark_object (builder->first_mungeable_event[1]); | |
| 428 | 350 return builder->console; |
| 351 } | |
| 352 | |
| 353 static void | |
| 354 finalize_command_builder (void *header, int for_disksave) | |
| 355 { | |
| 356 if (!for_disksave) | |
| 357 { | |
| 771 | 358 struct command_builder *b = (struct command_builder *) header; |
| 359 if (b->echo_buf) | |
| 360 { | |
| 1726 | 361 xfree (b->echo_buf, Ibyte *); |
| 771 | 362 b->echo_buf = 0; |
| 363 } | |
| 428 | 364 } |
| 365 } | |
| 366 | |
|
5118
e0db3c197671
merge up to latest default branch, doesn't compile yet
Ben Wing <ben@xemacs.org>
diff
changeset
|
367 DEFINE_NODUMP_LISP_OBJECT ("command-builder", command_builder, |
|
e0db3c197671
merge up to latest default branch, doesn't compile yet
Ben Wing <ben@xemacs.org>
diff
changeset
|
368 mark_command_builder, |
|
e0db3c197671
merge up to latest default branch, doesn't compile yet
Ben Wing <ben@xemacs.org>
diff
changeset
|
369 internal_object_printer, |
|
e0db3c197671
merge up to latest default branch, doesn't compile yet
Ben Wing <ben@xemacs.org>
diff
changeset
|
370 finalize_command_builder, 0, 0, |
|
e0db3c197671
merge up to latest default branch, doesn't compile yet
Ben Wing <ben@xemacs.org>
diff
changeset
|
371 command_builder_description, |
|
e0db3c197671
merge up to latest default branch, doesn't compile yet
Ben Wing <ben@xemacs.org>
diff
changeset
|
372 struct command_builder); |
| 771 | 373 |
| 428 | 374 static void |
| 375 reset_command_builder_event_chain (struct command_builder *builder) | |
| 376 { | |
| 377 builder->current_events = Qnil; | |
| 378 builder->most_current_event = Qnil; | |
| 379 builder->last_non_munged_event = Qnil; | |
| 1204 | 380 builder->first_mungeable_event[0] = Qnil; |
| 381 builder->first_mungeable_event[1] = Qnil; | |
| 428 | 382 } |
| 383 | |
| 384 Lisp_Object | |
| 771 | 385 allocate_command_builder (Lisp_Object console, int with_echo_buf) |
| 428 | 386 { |
|
5117
3742ea8250b5
Checking in final CVS version of workspace 'ben-lisp-object'
Ben Wing <ben@xemacs.org>
parents:
3025
diff
changeset
|
387 Lisp_Object builder_obj = ALLOC_LISP_OBJECT (command_builder); |
| 771 | 388 struct command_builder *builder = XCOMMAND_BUILDER (builder_obj); |
| 428 | 389 |
| 390 builder->console = console; | |
| 391 reset_command_builder_event_chain (builder); | |
| 771 | 392 if (with_echo_buf) |
| 393 { | |
| 394 /* #### This badly needs to be turned into a Dynarr */ | |
| 395 builder->echo_buf_length = 300; /* #### Kludge */ | |
| 867 | 396 builder->echo_buf = xnew_array (Ibyte, builder->echo_buf_length); |
| 771 | 397 builder->echo_buf[0] = 0; |
| 398 } | |
| 399 else | |
| 400 { | |
| 401 builder->echo_buf_length = 0; | |
| 402 builder->echo_buf = NULL; | |
| 403 } | |
| 428 | 404 builder->echo_buf_index = -1; |
| 405 builder->self_insert_countdown = 0; | |
| 406 | |
| 407 return builder_obj; | |
| 408 } | |
| 409 | |
| 771 | 410 /* Copy or clone COLLAPSING (copy to NEW_BUILDINGS if non-zero, |
| 411 otherwise clone); but don't copy the echo-buf stuff. (The calling | |
| 412 routines don't need it and will reset it, and we would rather avoid | |
| 413 malloc.) */ | |
| 414 | |
| 415 static Lisp_Object | |
| 416 copy_command_builder (struct command_builder *collapsing, | |
| 417 struct command_builder *new_buildings) | |
| 418 { | |
| 419 if (!new_buildings) | |
| 420 new_buildings = XCOMMAND_BUILDER (allocate_command_builder (Qnil, 0)); | |
| 421 | |
| 3358 | 422 new_buildings->console = collapsing->console; |
| 423 | |
| 771 | 424 new_buildings->self_insert_countdown = collapsing->self_insert_countdown; |
| 425 | |
| 426 deallocate_event_chain (new_buildings->current_events); | |
| 427 new_buildings->current_events = | |
| 428 copy_event_chain (collapsing->current_events); | |
| 429 | |
| 430 new_buildings->most_current_event = | |
| 431 transfer_event_chain_pointer (collapsing->most_current_event, | |
| 432 collapsing->current_events, | |
| 433 new_buildings->current_events); | |
| 434 new_buildings->last_non_munged_event = | |
| 435 transfer_event_chain_pointer (collapsing->last_non_munged_event, | |
| 436 collapsing->current_events, | |
| 437 new_buildings->current_events); | |
| 1204 | 438 new_buildings->first_mungeable_event[0] = |
| 439 transfer_event_chain_pointer (collapsing->first_mungeable_event[0], | |
| 771 | 440 collapsing->current_events, |
| 441 new_buildings->current_events); | |
| 1204 | 442 new_buildings->first_mungeable_event[1] = |
| 443 transfer_event_chain_pointer (collapsing->first_mungeable_event[1], | |
| 771 | 444 collapsing->current_events, |
| 445 new_buildings->current_events); | |
| 446 | |
| 447 return wrap_command_builder (new_buildings); | |
| 448 } | |
| 449 | |
| 450 static void | |
| 451 free_command_builder (struct command_builder *builder) | |
| 452 { | |
| 453 if (builder->echo_buf) | |
| 454 { | |
| 1726 | 455 xfree (builder->echo_buf, Ibyte *); |
| 771 | 456 builder->echo_buf = NULL; |
| 457 } | |
|
5120
d1247f3cc363
latest work on lisp-object workspace;
Ben Wing <ben@xemacs.org>
parents:
5118
diff
changeset
|
458 FREE_LISP_OBJECT (wrap_command_builder (builder)); |
| 771 | 459 } |
| 460 | |
| 428 | 461 static void |
| 462 command_builder_append_event (struct command_builder *builder, | |
| 463 Lisp_Object event) | |
| 464 { | |
| 465 assert (EVENTP (event)); | |
| 466 | |
| 771 | 467 event = Fcopy_event (event, Qnil); |
| 428 | 468 if (EVENTP (builder->most_current_event)) |
| 469 XSET_EVENT_NEXT (builder->most_current_event, event); | |
| 470 else | |
| 471 builder->current_events = event; | |
| 472 | |
| 473 builder->most_current_event = event; | |
| 1204 | 474 if (NILP (builder->first_mungeable_event[0])) |
| 475 builder->first_mungeable_event[0] = event; | |
| 476 if (NILP (builder->first_mungeable_event[1])) | |
| 477 builder->first_mungeable_event[1] = event; | |
| 428 | 478 } |
| 479 | |
| 480 | |
| 481 /**********************************************************************/ | |
| 482 /* Low-level interfaces onto event methods */ | |
| 483 /**********************************************************************/ | |
| 484 | |
| 485 static void | |
| 1268 | 486 check_event_stream_ok (void) |
| 428 | 487 { |
| 488 if (!event_stream && noninteractive) | |
| 814 | 489 /* See comment in init_event_stream() */ |
| 490 init_event_stream (); | |
| 491 else assert (event_stream); | |
| 428 | 492 } |
| 493 | |
| 494 void | |
| 440 | 495 event_stream_handle_magic_event (Lisp_Event *event) |
| 428 | 496 { |
| 1268 | 497 check_event_stream_ok (); |
| 428 | 498 event_stream->handle_magic_event_cb (event); |
| 499 } | |
| 500 | |
| 788 | 501 void |
| 502 event_stream_format_magic_event (Lisp_Event *event, Lisp_Object pstream) | |
| 503 { | |
| 1268 | 504 check_event_stream_ok (); |
| 788 | 505 event_stream->format_magic_event_cb (event, pstream); |
| 506 } | |
| 507 | |
| 508 int | |
| 509 event_stream_compare_magic_event (Lisp_Event *e1, Lisp_Event *e2) | |
| 510 { | |
| 1268 | 511 check_event_stream_ok (); |
| 788 | 512 return event_stream->compare_magic_event_cb (e1, e2); |
| 513 } | |
| 514 | |
| 515 Hashcode | |
| 516 event_stream_hash_magic_event (Lisp_Event *e) | |
| 517 { | |
| 1268 | 518 check_event_stream_ok (); |
| 788 | 519 return event_stream->hash_magic_event_cb (e); |
| 520 } | |
| 521 | |
| 428 | 522 static int |
| 523 event_stream_add_timeout (EMACS_TIME timeout) | |
| 524 { | |
| 1268 | 525 check_event_stream_ok (); |
| 428 | 526 return event_stream->add_timeout_cb (timeout); |
| 527 } | |
| 528 | |
| 529 static void | |
| 530 event_stream_remove_timeout (int id) | |
| 531 { | |
| 1268 | 532 check_event_stream_ok (); |
| 428 | 533 event_stream->remove_timeout_cb (id); |
| 534 } | |
| 535 | |
| 536 void | |
| 537 event_stream_select_console (struct console *con) | |
| 538 { | |
| 1268 | 539 check_event_stream_ok (); |
| 428 | 540 if (!con->input_enabled) |
| 541 { | |
| 542 event_stream->select_console_cb (con); | |
| 543 con->input_enabled = 1; | |
| 544 } | |
| 545 } | |
| 546 | |
| 547 void | |
| 548 event_stream_unselect_console (struct console *con) | |
| 549 { | |
| 1268 | 550 check_event_stream_ok (); |
| 428 | 551 if (con->input_enabled) |
| 552 { | |
| 553 event_stream->unselect_console_cb (con); | |
| 554 con->input_enabled = 0; | |
| 555 } | |
| 556 } | |
| 557 | |
| 558 void | |
| 853 | 559 event_stream_select_process (Lisp_Process *proc, int doin, int doerr) |
| 428 | 560 { |
| 853 | 561 int cur_in, cur_err; |
| 562 | |
| 1268 | 563 check_event_stream_ok (); |
| 853 | 564 |
| 565 cur_in = get_process_selected_p (proc, 0); | |
| 566 if (cur_in) | |
| 567 doin = 0; | |
| 568 | |
| 569 if (!process_has_separate_stderr (wrap_process (proc))) | |
| 428 | 570 { |
| 853 | 571 doerr = 0; |
| 572 cur_err = 0; | |
| 573 } | |
| 574 else | |
| 575 { | |
| 576 cur_err = get_process_selected_p (proc, 1); | |
| 577 if (cur_err) | |
| 578 doerr = 0; | |
| 579 } | |
| 580 | |
| 581 if (doin || doerr) | |
| 582 { | |
| 583 event_stream->select_process_cb (proc, doin, doerr); | |
| 584 set_process_selected_p (proc, cur_in || doin, cur_err || doerr); | |
| 428 | 585 } |
| 586 } | |
| 587 | |
| 588 void | |
| 853 | 589 event_stream_unselect_process (Lisp_Process *proc, int doin, int doerr) |
| 428 | 590 { |
| 853 | 591 int cur_in, cur_err; |
| 592 | |
| 1268 | 593 check_event_stream_ok (); |
| 853 | 594 |
| 595 cur_in = get_process_selected_p (proc, 0); | |
| 596 if (!cur_in) | |
| 597 doin = 0; | |
| 598 | |
| 599 if (!process_has_separate_stderr (wrap_process (proc))) | |
| 428 | 600 { |
| 853 | 601 doerr = 0; |
| 602 cur_err = 0; | |
| 603 } | |
| 604 else | |
| 605 { | |
| 606 cur_err = get_process_selected_p (proc, 1); | |
| 607 if (!cur_err) | |
| 608 doerr = 0; | |
| 609 } | |
| 610 | |
| 611 if (doin || doerr) | |
| 612 { | |
| 613 event_stream->unselect_process_cb (proc, doin, doerr); | |
| 614 set_process_selected_p (proc, cur_in && !doin, cur_err && !doerr); | |
| 428 | 615 } |
| 616 } | |
| 617 | |
| 853 | 618 void |
| 619 event_stream_create_io_streams (void *inhandle, void *outhandle, | |
| 620 void *errhandle, Lisp_Object *instream, | |
| 621 Lisp_Object *outstream, | |
| 622 Lisp_Object *errstream, | |
| 623 USID *in_usid, | |
| 624 USID *err_usid, | |
| 625 int flags) | |
| 428 | 626 { |
| 1268 | 627 check_event_stream_ok (); |
| 853 | 628 event_stream->create_io_streams_cb |
| 629 (inhandle, outhandle, errhandle, instream, outstream, errstream, | |
| 630 in_usid, err_usid, flags); | |
| 428 | 631 } |
| 632 | |
| 853 | 633 void |
| 634 event_stream_delete_io_streams (Lisp_Object instream, | |
| 635 Lisp_Object outstream, | |
| 636 Lisp_Object errstream, | |
| 637 USID *in_usid, | |
| 638 USID *err_usid) | |
| 428 | 639 { |
| 1268 | 640 check_event_stream_ok (); |
| 853 | 641 event_stream->delete_io_streams_cb (instream, outstream, errstream, |
| 642 in_usid, err_usid); | |
| 428 | 643 } |
| 644 | |
| 442 | 645 static int |
| 646 event_stream_current_event_timestamp (struct console *c) | |
| 647 { | |
| 648 if (event_stream && event_stream->current_event_timestamp_cb) | |
| 649 return event_stream->current_event_timestamp_cb (c); | |
| 650 else | |
| 651 return 0; | |
| 652 } | |
| 428 | 653 |
| 654 | |
| 655 /**********************************************************************/ | |
| 656 /* Character prompting */ | |
| 657 /**********************************************************************/ | |
| 658 | |
| 659 static void | |
| 660 echo_key_event (struct command_builder *command_builder, | |
| 661 Lisp_Object event) | |
| 662 { | |
| 663 /* This function can GC */ | |
| 793 | 664 DECLARE_EISTRING_MALLOC (buf); |
| 428 | 665 Bytecount buf_index = command_builder->echo_buf_index; |
| 867 | 666 Ibyte *e; |
| 428 | 667 Bytecount len; |
| 668 | |
| 669 if (buf_index < 0) | |
| 670 { | |
| 671 buf_index = 0; /* We're echoing now */ | |
| 672 clear_echo_area (selected_frame (), Qnil, 0); | |
| 673 } | |
| 674 | |
| 934 | 675 format_event_object (buf, event, 1); |
| 793 | 676 len = eilen (buf); |
| 428 | 677 |
| 678 if (len + buf_index + 4 > command_builder->echo_buf_length) | |
| 793 | 679 { |
| 680 eifree (buf); | |
| 681 return; | |
| 682 } | |
| 428 | 683 e = command_builder->echo_buf + buf_index; |
| 793 | 684 memcpy (e, eidata (buf), len); |
| 428 | 685 e += len; |
| 793 | 686 eifree (buf); |
| 428 | 687 |
| 688 e[0] = ' '; | |
| 689 e[1] = '-'; | |
| 690 e[2] = ' '; | |
| 691 e[3] = 0; | |
| 692 | |
| 693 command_builder->echo_buf_index = buf_index + len + 1; | |
| 694 } | |
| 695 | |
| 696 static void | |
| 697 regenerate_echo_keys_from_this_command_keys (struct command_builder * | |
| 698 builder) | |
| 699 { | |
| 700 Lisp_Object event; | |
| 701 | |
| 702 builder->echo_buf_index = 0; | |
| 703 | |
| 704 EVENT_CHAIN_LOOP (event, Vthis_command_keys) | |
| 705 echo_key_event (builder, event); | |
| 706 } | |
| 707 | |
| 708 static void | |
| 709 maybe_echo_keys (struct command_builder *command_builder, int no_snooze) | |
| 710 { | |
| 711 /* This function can GC */ | |
| 712 double echo_keystrokes; | |
| 713 struct frame *f = selected_frame (); | |
| 853 | 714 int depth = begin_dont_check_for_quit (); |
| 715 | |
| 428 | 716 /* Message turns off echoing unless more keystrokes turn it on again. */ |
| 717 if (echo_area_active (f) && !EQ (Qcommand, echo_area_status (f))) | |
| 853 | 718 goto done; |
| 428 | 719 |
| 720 if (INTP (Vecho_keystrokes) || FLOATP (Vecho_keystrokes)) | |
| 721 echo_keystrokes = extract_float (Vecho_keystrokes); | |
| 722 else | |
| 723 echo_keystrokes = 0; | |
| 724 | |
| 725 if (minibuf_level == 0 | |
| 726 && echo_keystrokes > 0.0 | |
| 442 | 727 #if defined (HAVE_X_WINDOWS) && defined (LWLIB_MENUBARS_LUCID) |
| 728 && !x_kludge_lw_menu_active () | |
| 729 #endif | |
| 730 ) | |
| 428 | 731 { |
| 732 if (!no_snooze) | |
| 733 { | |
| 734 if (NILP (Fsit_for (Vecho_keystrokes, Qnil))) | |
| 735 /* input came in, so don't echo. */ | |
| 853 | 736 goto done; |
| 428 | 737 } |
| 738 | |
| 739 echo_area_message (f, command_builder->echo_buf, Qnil, 0, | |
| 740 /* not echo_buf_index. That doesn't include | |
| 741 the terminating " - ". */ | |
| 742 strlen ((char *) command_builder->echo_buf), | |
| 743 Qcommand); | |
| 744 } | |
| 853 | 745 |
| 746 done: | |
| 747 Vquit_flag = Qnil; /* see begin_dont_check_for_quit() */ | |
| 748 unbind_to (depth); | |
| 428 | 749 } |
| 750 | |
| 751 static void | |
| 752 reset_key_echo (struct command_builder *command_builder, | |
| 753 int remove_echo_area_echo) | |
| 754 { | |
| 755 /* This function can GC */ | |
| 756 struct frame *f = selected_frame (); | |
| 757 | |
| 757 | 758 if (command_builder) |
| 759 command_builder->echo_buf_index = -1; | |
| 428 | 760 |
| 761 if (remove_echo_area_echo) | |
| 762 clear_echo_area (f, Qcommand, 0); | |
| 763 } | |
| 764 | |
| 765 | |
| 766 /**********************************************************************/ | |
| 767 /* random junk */ | |
| 768 /**********************************************************************/ | |
| 769 | |
| 770 /* NB: The following auto-save stuff is in keyboard.c in FSFmacs, and | |
| 771 keystrokes_since_auto_save is equivalent to the difference between | |
| 772 num_nonmacro_input_chars and last_auto_save. */ | |
| 773 | |
| 444 | 774 /* When an auto-save happens, record the number of keystrokes, and |
| 775 don't do again soon. */ | |
| 428 | 776 |
| 777 void | |
| 778 record_auto_save (void) | |
| 779 { | |
| 780 keystrokes_since_auto_save = 0; | |
| 781 } | |
| 782 | |
| 783 /* Make an auto save happen as soon as possible at command level. */ | |
| 784 | |
| 785 void | |
| 786 force_auto_save_soon (void) | |
| 787 { | |
| 788 keystrokes_since_auto_save = 1 + max (auto_save_interval, 20); | |
| 789 } | |
| 790 | |
| 791 static void | |
| 792 maybe_do_auto_save (void) | |
| 793 { | |
| 794 /* This function can call lisp */ | |
| 795 keystrokes_since_auto_save++; | |
| 796 if (auto_save_interval > 0 && | |
| 797 keystrokes_since_auto_save > max (auto_save_interval, 20) && | |
| 1268 | 798 !detect_input_pending (1)) |
| 428 | 799 { |
| 800 Fdo_auto_save (Qnil, Qnil); | |
| 801 record_auto_save (); | |
| 802 } | |
| 803 } | |
| 804 | |
| 805 static Lisp_Object | |
| 806 print_help (Lisp_Object object) | |
| 807 { | |
| 808 Fprinc (object, Qnil); | |
| 809 return Qnil; | |
| 810 } | |
| 811 | |
| 812 static void | |
| 813 execute_help_form (struct command_builder *command_builder, | |
| 814 Lisp_Object event) | |
| 815 { | |
| 816 /* This function can GC */ | |
| 817 Lisp_Object help = Qnil; | |
| 818 int speccount = specpdl_depth (); | |
| 819 Bytecount buf_index = command_builder->echo_buf_index; | |
| 820 Lisp_Object echo = ((buf_index <= 0) | |
| 821 ? Qnil | |
| 822 : make_string (command_builder->echo_buf, | |
| 823 buf_index)); | |
| 824 struct gcpro gcpro1, gcpro2; | |
| 825 GCPRO2 (echo, help); | |
| 826 | |
|
4775
1d61580e0cf7
Remove Fsave_window_excursion from window.c, it's overridden by Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4718
diff
changeset
|
827 record_unwind_protect (Feval, |
|
1d61580e0cf7
Remove Fsave_window_excursion from window.c, it's overridden by Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4718
diff
changeset
|
828 list2 (Qset_window_configuration, |
|
1d61580e0cf7
Remove Fsave_window_excursion from window.c, it's overridden by Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4718
diff
changeset
|
829 call0 (Qcurrent_window_configuration))); |
| 428 | 830 reset_key_echo (command_builder, 1); |
| 831 | |
|
4677
8f1ee2d15784
Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4528
diff
changeset
|
832 help = IGNORE_MULTIPLE_VALUES (Feval (Vhelp_form)); |
| 428 | 833 if (STRINGP (help)) |
| 834 internal_with_output_to_temp_buffer (build_string ("*Help*"), | |
| 835 print_help, help, Qnil); | |
| 836 Fnext_command_event (event, Qnil); | |
| 837 /* Remove the help from the frame */ | |
| 771 | 838 unbind_to (speccount); |
| 428 | 839 /* Hmmmm. Tricky. The unbind restores an old window configuration, |
| 840 apparently bypassing any setting of windows_structure_changed. | |
| 841 So we need to set it so that things get redrawn properly. */ | |
| 842 /* #### This is massive overkill. Look at doing it better once the | |
| 843 new redisplay is fully in place. */ | |
| 844 { | |
| 845 Lisp_Object frmcons, devcons, concons; | |
| 846 FRAME_LOOP_NO_BREAK (frmcons, devcons, concons) | |
| 847 { | |
| 848 struct frame *f = XFRAME (XCAR (frmcons)); | |
| 849 MARK_FRAME_WINDOWS_STRUCTURE_CHANGED (f); | |
| 850 } | |
| 851 } | |
| 852 | |
| 853 redisplay (); | |
| 1204 | 854 if (event_matches_key_specifier_p (event, make_char (' '))) |
| 428 | 855 { |
| 856 /* Discard next key if it is a space */ | |
| 857 reset_key_echo (command_builder, 1); | |
| 858 Fnext_command_event (event, Qnil); | |
| 859 } | |
| 860 | |
| 861 command_builder->echo_buf_index = buf_index; | |
| 862 if (buf_index > 0) | |
| 863 memcpy (command_builder->echo_buf, | |
| 864 XSTRING_DATA (echo), buf_index + 1); /* terminating 0 */ | |
| 865 UNGCPRO; | |
| 866 } | |
| 867 | |
| 868 | |
| 869 /**********************************************************************/ | |
| 870 /* timeouts */ | |
| 871 /**********************************************************************/ | |
| 872 | |
| 593 | 873 /* NOTE: "Low-level" or "interval" timeouts are one-shot timeouts that |
| 874 measure single intervals. "High-level timeouts" or "wakeups" are | |
| 875 the objects generated by `add-timeout' or `add-async-timout' -- | |
| 876 they can fire repeatedly (and in fact can have a different initial | |
| 877 time and resignal time). Given the nature of both setitimer() and | |
| 878 select() -- i.e. all we get is a single one-shot timer -- we have | |
| 879 to decompose all high-level timeouts into a series of intervals or | |
| 880 low-level timeouts. | |
| 881 | |
| 882 Low-level timeouts are of two varieties: synchronous and asynchronous. | |
| 883 The former are handled at the window-system level, the latter in | |
| 884 signal.c. | |
| 885 */ | |
| 886 | |
| 887 /**** Low-level timeout helper functions. **** | |
| 428 | 888 |
| 889 These functions maintain a sorted list of one-shot timeouts (where | |
| 593 | 890 the timeouts are in absolute time so we never lose any time as a |
| 891 result of the delay between noting an interval and firing the next | |
| 892 one). They are intended for use by functions that need to convert | |
| 893 a list of absolute timeouts into a series of intervals to wait | |
| 894 for. */ | |
| 428 | 895 |
| 896 /* We ensure that 0 is never a valid ID, so that a value of 0 can be | |
| 897 used to indicate an absence of a timer. */ | |
| 898 static int low_level_timeout_id_tick; | |
| 899 | |
| 900 static struct low_level_timeout_blocktype | |
| 901 { | |
| 902 Blocktype_declare (struct low_level_timeout); | |
| 903 } *the_low_level_timeout_blocktype; | |
| 904 | |
| 905 /* Add a one-shot timeout at time TIME to TIMEOUT_LIST. Return | |
| 906 a unique ID identifying the timeout. */ | |
| 907 | |
| 908 int | |
| 909 add_low_level_timeout (struct low_level_timeout **timeout_list, | |
| 910 EMACS_TIME thyme) | |
| 911 { | |
| 912 struct low_level_timeout *tm; | |
| 913 struct low_level_timeout *t, **tt; | |
| 914 | |
| 915 /* Allocate a new time struct. */ | |
| 916 | |
| 917 tm = Blocktype_alloc (the_low_level_timeout_blocktype); | |
| 918 tm->next = NULL; | |
| 593 | 919 /* Don't just use ++low_level_timeout_id_tick, for the (admittedly |
| 920 rare) case in which numbers wrap around. */ | |
| 428 | 921 if (low_level_timeout_id_tick == 0) |
| 922 low_level_timeout_id_tick++; | |
| 923 tm->id = low_level_timeout_id_tick++; | |
| 924 tm->time = thyme; | |
| 925 | |
| 926 /* Add it to the queue. */ | |
| 927 | |
| 928 tt = timeout_list; | |
| 929 t = *tt; | |
| 930 while (t && EMACS_TIME_EQUAL_OR_GREATER (tm->time, t->time)) | |
| 931 { | |
| 932 tt = &t->next; | |
| 933 t = *tt; | |
| 934 } | |
| 935 tm->next = t; | |
| 936 *tt = tm; | |
| 937 | |
| 938 return tm->id; | |
| 939 } | |
| 940 | |
| 941 /* Remove the low-level timeout identified by ID from TIMEOUT_LIST. | |
| 942 If the timeout is not there, do nothing. */ | |
| 943 | |
| 944 void | |
| 945 remove_low_level_timeout (struct low_level_timeout **timeout_list, int id) | |
| 946 { | |
| 947 struct low_level_timeout *t, *prev; | |
| 948 | |
| 949 /* find it */ | |
| 950 | |
| 951 for (t = *timeout_list, prev = NULL; t && t->id != id; t = t->next) | |
| 952 prev = t; | |
| 953 | |
| 954 if (!t) | |
| 955 return; /* couldn't find it */ | |
| 956 | |
| 957 if (!prev) | |
| 958 *timeout_list = t->next; | |
| 959 else prev->next = t->next; | |
| 960 | |
| 961 Blocktype_free (the_low_level_timeout_blocktype, t); | |
| 962 } | |
| 963 | |
| 964 /* If there are timeouts on TIMEOUT_LIST, store the relative time | |
| 965 interval to the first timeout on the list into INTERVAL and | |
| 966 return 1. Otherwise, return 0. */ | |
| 967 | |
| 968 int | |
| 969 get_low_level_timeout_interval (struct low_level_timeout *timeout_list, | |
| 970 EMACS_TIME *interval) | |
| 971 { | |
| 972 if (!timeout_list) /* no timer events; block indefinitely */ | |
| 973 return 0; | |
| 974 else | |
| 975 { | |
| 976 EMACS_TIME current_time; | |
| 977 | |
| 978 /* The time to block is the difference between the first | |
| 979 (earliest) timer on the queue and the current time. | |
| 980 If that is negative, then the timer will fire immediately | |
| 981 but we still have to call select(), with a zero-valued | |
| 982 timeout: user events must have precedence over timer events. */ | |
| 983 EMACS_GET_TIME (current_time); | |
| 984 if (EMACS_TIME_GREATER (timeout_list->time, current_time)) | |
| 985 EMACS_SUB_TIME (*interval, timeout_list->time, | |
| 986 current_time); | |
| 987 else | |
| 988 EMACS_SET_SECS_USECS (*interval, 0, 0); | |
| 989 return 1; | |
| 990 } | |
| 991 } | |
| 992 | |
| 993 /* Pop the first (i.e. soonest) timeout off of TIMEOUT_LIST and return | |
| 994 its ID. Also, if TIME_OUT is not 0, store the absolute time of the | |
| 995 timeout into TIME_OUT. */ | |
| 996 | |
| 997 int | |
| 998 pop_low_level_timeout (struct low_level_timeout **timeout_list, | |
| 999 EMACS_TIME *time_out) | |
| 1000 { | |
| 1001 struct low_level_timeout *tm = *timeout_list; | |
| 1002 int id; | |
| 1003 | |
| 1004 assert (tm); | |
| 1005 id = tm->id; | |
| 1006 if (time_out) | |
| 1007 *time_out = tm->time; | |
| 1008 *timeout_list = tm->next; | |
| 1009 Blocktype_free (the_low_level_timeout_blocktype, tm); | |
| 1010 return id; | |
| 1011 } | |
| 1012 | |
| 1013 | |
| 593 | 1014 /**** High-level timeout functions. **** */ |
| 1015 | |
| 1016 /* We ensure that 0 is never a valid ID, so that a value of 0 can be | |
| 1017 used to indicate an absence of a timer. */ | |
| 428 | 1018 static int timeout_id_tick; |
| 1019 | |
| 1020 static Lisp_Object pending_timeout_list, pending_async_timeout_list; | |
| 1021 | |
| 1022 static Lisp_Object | |
| 1023 mark_timeout (Lisp_Object obj) | |
| 1024 { | |
| 440 | 1025 Lisp_Timeout *tm = XTIMEOUT (obj); |
| 428 | 1026 mark_object (tm->function); |
| 1027 return tm->object; | |
| 1028 } | |
| 1029 | |
| 1204 | 1030 static const struct memory_description timeout_description[] = { |
| 440 | 1031 { XD_LISP_OBJECT, offsetof (Lisp_Timeout, function) }, |
| 1032 { XD_LISP_OBJECT, offsetof (Lisp_Timeout, object) }, | |
| 428 | 1033 { XD_END } |
| 1034 }; | |
| 1035 | |
|
5118
e0db3c197671
merge up to latest default branch, doesn't compile yet
Ben Wing <ben@xemacs.org>
diff
changeset
|
1036 DEFINE_DUMPABLE_INTERNAL_LISP_OBJECT ("timeout", timeout, |
|
e0db3c197671
merge up to latest default branch, doesn't compile yet
Ben Wing <ben@xemacs.org>
diff
changeset
|
1037 mark_timeout, timeout_description, |
|
e0db3c197671
merge up to latest default branch, doesn't compile yet
Ben Wing <ben@xemacs.org>
diff
changeset
|
1038 Lisp_Timeout); |
| 428 | 1039 |
| 1040 /* Generate a timeout and return its ID. */ | |
| 1041 | |
| 1042 int | |
| 1043 event_stream_generate_wakeup (unsigned int milliseconds, | |
| 1044 unsigned int vanilliseconds, | |
| 1045 Lisp_Object function, Lisp_Object object, | |
| 1046 int async_p) | |
| 1047 { | |
|
5117
3742ea8250b5
Checking in final CVS version of workspace 'ben-lisp-object'
Ben Wing <ben@xemacs.org>
parents:
3025
diff
changeset
|
1048 Lisp_Object op = ALLOC_LISP_OBJECT (timeout); |
| 440 | 1049 Lisp_Timeout *timeout = XTIMEOUT (op); |
| 428 | 1050 EMACS_TIME current_time; |
| 1051 EMACS_TIME interval; | |
| 1052 | |
| 593 | 1053 /* Don't just use ++timeout_id_tick, for the (admittedly rare) case |
| 1054 in which numbers wrap around. */ | |
| 1055 if (timeout_id_tick == 0) | |
| 1056 timeout_id_tick++; | |
| 428 | 1057 timeout->id = timeout_id_tick++; |
| 1058 timeout->resignal_msecs = vanilliseconds; | |
| 1059 timeout->function = function; | |
| 1060 timeout->object = object; | |
| 1061 | |
| 1062 EMACS_GET_TIME (current_time); | |
| 1063 EMACS_SET_SECS_USECS (interval, milliseconds / 1000, | |
| 1064 1000 * (milliseconds % 1000)); | |
| 1065 EMACS_ADD_TIME (timeout->next_signal_time, current_time, interval); | |
| 1066 | |
| 1067 if (async_p) | |
| 1068 { | |
| 1069 timeout->interval_id = | |
| 593 | 1070 signal_add_async_interval_timeout (timeout->next_signal_time); |
| 1071 pending_async_timeout_list = | |
| 1072 noseeum_cons (op, pending_async_timeout_list); | |
| 428 | 1073 } |
| 1074 else | |
| 1075 { | |
| 1076 timeout->interval_id = | |
| 1077 event_stream_add_timeout (timeout->next_signal_time); | |
| 1078 pending_timeout_list = noseeum_cons (op, pending_timeout_list); | |
| 1079 } | |
| 1080 return timeout->id; | |
| 1081 } | |
| 1082 | |
| 1083 /* Given the INTERVAL-ID of a timeout just signalled, resignal the timeout | |
| 1084 as necessary and return the timeout's ID and function and object slots. | |
| 1085 | |
| 1086 This should be called as a result of receiving notice that a timeout | |
| 1087 has fired. INTERVAL-ID is *not* the timeout's ID, but is the ID that | |
| 1088 identifies this particular firing of the timeout. INTERVAL-ID's and | |
| 1089 timeout ID's are in separate number spaces and bear no relation to | |
| 1090 each other. The INTERVAL-ID is all that the event callback routines | |
| 1091 work with: they work only with one-shot intervals, not with timeouts | |
| 1092 that may fire repeatedly. | |
| 1093 | |
| 1094 NOTE: The returned FUNCTION and OBJECT are *not* GC-protected at all. | |
| 1095 */ | |
| 1096 | |
| 593 | 1097 int |
| 428 | 1098 event_stream_resignal_wakeup (int interval_id, int async_p, |
| 1099 Lisp_Object *function, Lisp_Object *object) | |
| 1100 { | |
| 1101 Lisp_Object op = Qnil, rest; | |
| 440 | 1102 Lisp_Timeout *timeout; |
| 428 | 1103 Lisp_Object *timeout_list; |
| 1104 struct gcpro gcpro1; | |
| 1105 int id; | |
| 1106 | |
| 1107 GCPRO1 (op); /* just in case ... because it's removed from the list | |
| 1108 for awhile. */ | |
| 1109 | |
| 1110 timeout_list = async_p ? &pending_async_timeout_list : &pending_timeout_list; | |
| 1111 | |
| 1112 /* Find the timeout on the list of pending ones. */ | |
| 1113 LIST_LOOP (rest, *timeout_list) | |
| 1114 { | |
| 1115 timeout = XTIMEOUT (XCAR (rest)); | |
| 1116 if (timeout->interval_id == interval_id) | |
| 1117 break; | |
| 1118 } | |
| 1119 | |
| 1120 assert (!NILP (rest)); | |
| 1121 op = XCAR (rest); | |
| 1122 timeout = XTIMEOUT (op); | |
| 1123 /* We make sure to snarf the data out of the timeout object before | |
| 1124 we free it with free_managed_lcrecord(). */ | |
| 1125 id = timeout->id; | |
| 1126 *function = timeout->function; | |
| 1127 *object = timeout->object; | |
| 1128 | |
| 1129 /* Remove this one from the list of pending timeouts */ | |
| 1130 *timeout_list = delq_no_quit_and_free_cons (op, *timeout_list); | |
| 1131 | |
| 1132 /* If this timeout wants to be resignalled, do it now. */ | |
| 1133 if (timeout->resignal_msecs) | |
| 1134 { | |
| 1135 EMACS_TIME current_time; | |
| 1136 EMACS_TIME interval; | |
| 1137 | |
| 1138 /* Determine the time that the next resignalling should occur. | |
| 1139 We do that by adding the interval time to the last signalled | |
| 1140 time until we get a time that's current. | |
| 1141 | |
| 1142 (This way, it doesn't matter if the timeout was signalled | |
| 1143 exactly when we asked for it, or at some time later.) | |
| 1144 */ | |
| 1145 EMACS_GET_TIME (current_time); | |
| 1146 EMACS_SET_SECS_USECS (interval, timeout->resignal_msecs / 1000, | |
| 1147 1000 * (timeout->resignal_msecs % 1000)); | |
| 1148 do | |
| 1149 { | |
| 1150 EMACS_ADD_TIME (timeout->next_signal_time, timeout->next_signal_time, | |
| 1151 interval); | |
| 1152 } while (EMACS_TIME_GREATER (current_time, timeout->next_signal_time)); | |
| 1153 | |
| 1154 if (async_p) | |
| 1155 timeout->interval_id = | |
| 593 | 1156 signal_add_async_interval_timeout (timeout->next_signal_time); |
| 428 | 1157 else |
| 1158 timeout->interval_id = | |
| 1159 event_stream_add_timeout (timeout->next_signal_time); | |
| 1160 /* Add back onto the list. Note that the effect of this | |
| 1161 is to move frequently-hit timeouts to the front of the | |
| 1162 list, which is a good thing. */ | |
| 1163 *timeout_list = noseeum_cons (op, *timeout_list); | |
| 1164 } | |
| 1165 else | |
|
5120
d1247f3cc363
latest work on lisp-object workspace;
Ben Wing <ben@xemacs.org>
parents:
5118
diff
changeset
|
1166 FREE_LISP_OBJECT (op); |
| 428 | 1167 |
| 1168 UNGCPRO; | |
| 1169 return id; | |
| 1170 } | |
| 1171 | |
| 1172 void | |
| 1173 event_stream_disable_wakeup (int id, int async_p) | |
| 1174 { | |
| 440 | 1175 Lisp_Timeout *timeout = 0; |
| 428 | 1176 Lisp_Object rest; |
| 1177 Lisp_Object *timeout_list; | |
| 1178 | |
| 1179 if (async_p) | |
| 1180 timeout_list = &pending_async_timeout_list; | |
| 1181 else | |
| 1182 timeout_list = &pending_timeout_list; | |
| 1183 | |
| 1184 /* Find the timeout on the list of pending ones, if it's still there. */ | |
| 1185 LIST_LOOP (rest, *timeout_list) | |
| 1186 { | |
| 1187 timeout = XTIMEOUT (XCAR (rest)); | |
| 1188 if (timeout->id == id) | |
| 1189 break; | |
| 1190 } | |
| 1191 | |
| 1192 /* If we found it, remove it from the list and disable the pending | |
| 1193 one-shot. */ | |
| 1194 if (!NILP (rest)) | |
| 1195 { | |
| 1196 Lisp_Object op = XCAR (rest); | |
| 1197 *timeout_list = | |
| 1198 delq_no_quit_and_free_cons (op, *timeout_list); | |
| 1199 if (async_p) | |
| 593 | 1200 signal_remove_async_interval_timeout (timeout->interval_id); |
| 428 | 1201 else |
| 1202 event_stream_remove_timeout (timeout->interval_id); | |
|
5120
d1247f3cc363
latest work on lisp-object workspace;
Ben Wing <ben@xemacs.org>
parents:
5118
diff
changeset
|
1203 FREE_LISP_OBJECT (op); |
| 428 | 1204 } |
| 1205 } | |
| 1206 | |
| 1207 static int | |
| 1208 event_stream_wakeup_pending_p (int id, int async_p) | |
| 1209 { | |
| 440 | 1210 Lisp_Timeout *timeout; |
| 428 | 1211 Lisp_Object rest; |
| 1212 Lisp_Object timeout_list; | |
| 1213 int found = 0; | |
| 1214 | |
| 1215 | |
| 1216 if (async_p) | |
| 1217 timeout_list = pending_async_timeout_list; | |
| 1218 else | |
| 1219 timeout_list = pending_timeout_list; | |
| 1220 | |
| 1221 /* Find the element on the list of pending ones, if it's still there. */ | |
| 1222 LIST_LOOP (rest, timeout_list) | |
| 1223 { | |
| 1224 timeout = XTIMEOUT (XCAR (rest)); | |
| 1225 if (timeout->id == id) | |
| 1226 { | |
| 1227 found = 1; | |
| 1228 break; | |
| 1229 } | |
| 1230 } | |
| 1231 | |
| 1232 return found; | |
| 1233 } | |
| 1234 | |
| 1235 | |
| 1236 /**** Lisp-level timeout functions. ****/ | |
| 1237 | |
| 1238 static unsigned long | |
| 1239 lisp_number_to_milliseconds (Lisp_Object secs, int allow_0) | |
| 1240 { | |
| 1241 double fsecs; | |
| 1242 CHECK_INT_OR_FLOAT (secs); | |
| 1243 fsecs = XFLOATINT (secs); | |
| 1244 if (fsecs < 0) | |
| 563 | 1245 invalid_argument ("timeout is negative", secs); |
| 428 | 1246 if (!allow_0 && fsecs == 0) |
| 563 | 1247 invalid_argument ("timeout is non-positive", secs); |
| 428 | 1248 if (fsecs >= (((unsigned int) 0xFFFFFFFF) / 1000)) |
| 563 | 1249 invalid_argument |
| 428 | 1250 ("timeout would exceed 32 bits when represented in milliseconds", secs); |
| 1251 | |
| 1252 return (unsigned long) (1000 * fsecs); | |
| 1253 } | |
| 1254 | |
| 1255 DEFUN ("add-timeout", Fadd_timeout, 3, 4, 0, /* | |
| 1256 Add a timeout, to be signaled after the timeout period has elapsed. | |
| 1257 SECS is a number of seconds, expressed as an integer or a float. | |
| 1258 FUNCTION will be called after that many seconds have elapsed, with one | |
| 1259 argument, the given OBJECT. If the optional RESIGNAL argument is provided, | |
| 1260 then after this timeout expires, `add-timeout' will automatically be called | |
| 1261 again with RESIGNAL as the first argument. | |
| 1262 | |
| 1263 This function returns an object which is the id number of this particular | |
| 1264 timeout. You can pass that object to `disable-timeout' to turn off the | |
| 1265 timeout before it has been signalled. | |
| 1266 | |
| 1267 NOTE: Id numbers as returned by this function are in a distinct namespace | |
| 1268 from those returned by `add-async-timeout'. This means that the same id | |
| 1269 number could refer to a pending synchronous timeout and a different pending | |
| 1270 asynchronous timeout, and that you cannot pass an id from `add-timeout' | |
| 1271 to `disable-async-timeout', or vice-versa. | |
| 1272 | |
| 1273 The number of seconds may be expressed as a floating-point number, in which | |
| 1274 case some fractional part of a second will be used. Caveat: the usable | |
| 1275 timeout granularity will vary from system to system. | |
| 1276 | |
| 1277 Adding a timeout causes a timeout event to be returned by `next-event', and | |
| 1278 the function will be invoked by `dispatch-event,' so if emacs is in a tight | |
| 1279 loop, the function will not be invoked until the next call to sit-for or | |
| 1280 until the return to top-level (the same is true of process filters). | |
| 1281 | |
| 1282 If you need to have a timeout executed even when XEmacs is in the midst of | |
| 1283 running Lisp code, use `add-async-timeout'. | |
| 1284 | |
| 1285 WARNING: if you are thinking of calling add-timeout from inside of a | |
| 1286 callback function as a way of resignalling a timeout, think again. There | |
| 1287 is a race condition. That's why the RESIGNAL argument exists. | |
| 1288 */ | |
| 1289 (secs, function, object, resignal)) | |
| 1290 { | |
| 1291 unsigned long msecs = lisp_number_to_milliseconds (secs, 0); | |
| 1292 unsigned long msecs2 = (NILP (resignal) ? 0 : | |
| 1293 lisp_number_to_milliseconds (resignal, 0)); | |
| 1294 int id; | |
| 1295 Lisp_Object lid; | |
| 1296 id = event_stream_generate_wakeup (msecs, msecs2, function, object, 0); | |
| 1297 lid = make_int (id); | |
| 2500 | 1298 if (id != XINT (lid)) ABORT (); |
| 428 | 1299 return lid; |
| 1300 } | |
| 1301 | |
| 1302 DEFUN ("disable-timeout", Fdisable_timeout, 1, 1, 0, /* | |
| 1303 Disable a timeout from signalling any more. | |
| 1304 ID should be a timeout id number as returned by `add-timeout'. If ID | |
| 1305 corresponds to a one-shot timeout that has already signalled, nothing | |
| 1306 will happen. | |
| 1307 | |
| 1308 It will not work to call this function on an id number returned by | |
| 1309 `add-async-timeout'. Use `disable-async-timeout' for that. | |
| 1310 */ | |
| 1311 (id)) | |
| 1312 { | |
| 1313 CHECK_INT (id); | |
| 1314 event_stream_disable_wakeup (XINT (id), 0); | |
| 1315 return Qnil; | |
| 1316 } | |
| 1317 | |
| 1318 DEFUN ("add-async-timeout", Fadd_async_timeout, 3, 4, 0, /* | |
| 1319 Add an asynchronous timeout, to be signaled after an interval has elapsed. | |
| 1320 SECS is a number of seconds, expressed as an integer or a float. | |
| 1321 FUNCTION will be called after that many seconds have elapsed, with one | |
| 1322 argument, the given OBJECT. If the optional RESIGNAL argument is provided, | |
| 1323 then after this timeout expires, `add-async-timeout' will automatically be | |
| 1324 called again with RESIGNAL as the first argument. | |
| 1325 | |
| 1326 This function returns an object which is the id number of this particular | |
| 1327 timeout. You can pass that object to `disable-async-timeout' to turn off | |
| 1328 the timeout before it has been signalled. | |
| 1329 | |
| 1330 NOTE: Id numbers as returned by this function are in a distinct namespace | |
| 1331 from those returned by `add-timeout'. This means that the same id number | |
| 1332 could refer to a pending synchronous timeout and a different pending | |
| 1333 asynchronous timeout, and that you cannot pass an id from | |
| 1334 `add-async-timeout' to `disable-timeout', or vice-versa. | |
| 1335 | |
| 1336 The number of seconds may be expressed as a floating-point number, in which | |
| 1337 case some fractional part of a second will be used. Caveat: the usable | |
| 1338 timeout granularity will vary from system to system. | |
| 1339 | |
| 1340 Adding an asynchronous timeout causes the function to be invoked as soon | |
| 1341 as the timeout occurs, even if XEmacs is in the midst of executing some | |
| 1342 other code. (This is unlike the synchronous timeouts added with | |
| 1343 `add-timeout', where the timeout will only be signalled when XEmacs is | |
| 1344 waiting for events, i.e. the next return to top-level or invocation of | |
| 1345 `sit-for' or related functions.) This means that the function that is | |
| 1346 called *must* not signal an error or change any global state (e.g. switch | |
| 1347 buffers or windows) except when locking code is in place to make sure | |
| 1348 that race conditions don't occur in the interaction between the | |
| 1349 asynchronous timeout function and other code. | |
| 1350 | |
| 1351 Under most circumstances, you should use `add-timeout' instead, as it is | |
| 1352 much safer. Asynchronous timeouts should only be used when such behavior | |
| 1353 is really necessary. | |
| 1354 | |
| 1355 Asynchronous timeouts are blocked and will not occur when `inhibit-quit' | |
| 1356 is non-nil. As soon as `inhibit-quit' becomes nil again, any pending | |
| 1357 asynchronous timeouts will get called immediately. (Multiple occurrences | |
| 1358 of the same asynchronous timeout are not queued, however.) While the | |
| 1359 callback function of an asynchronous timeout is invoked, `inhibit-quit' | |
| 1360 is automatically bound to non-nil, and thus other asynchronous timeouts | |
| 1361 will be blocked unless the callback function explicitly sets `inhibit-quit' | |
| 1362 to nil. | |
| 1363 | |
| 1364 WARNING: if you are thinking of calling `add-async-timeout' from inside of a | |
| 1365 callback function as a way of resignalling a timeout, think again. There | |
| 1366 is a race condition. That's why the RESIGNAL argument exists. | |
| 1367 */ | |
| 1368 (secs, function, object, resignal)) | |
| 1369 { | |
| 1370 unsigned long msecs = lisp_number_to_milliseconds (secs, 0); | |
| 1371 unsigned long msecs2 = (NILP (resignal) ? 0 : | |
| 1372 lisp_number_to_milliseconds (resignal, 0)); | |
| 1373 int id; | |
| 1374 Lisp_Object lid; | |
| 1375 id = event_stream_generate_wakeup (msecs, msecs2, function, object, 1); | |
| 1376 lid = make_int (id); | |
| 2500 | 1377 if (id != XINT (lid)) ABORT (); |
| 428 | 1378 return lid; |
| 1379 } | |
| 1380 | |
| 1381 DEFUN ("disable-async-timeout", Fdisable_async_timeout, 1, 1, 0, /* | |
| 1382 Disable an asynchronous timeout from signalling any more. | |
| 1383 ID should be a timeout id number as returned by `add-async-timeout'. If ID | |
| 1384 corresponds to a one-shot timeout that has already signalled, nothing | |
| 1385 will happen. | |
| 1386 | |
| 1387 It will not work to call this function on an id number returned by | |
| 1388 `add-timeout'. Use `disable-timeout' for that. | |
| 1389 */ | |
| 1390 (id)) | |
| 1391 { | |
| 1392 CHECK_INT (id); | |
| 1393 event_stream_disable_wakeup (XINT (id), 1); | |
| 1394 return Qnil; | |
| 1395 } | |
| 1396 | |
| 1397 | |
| 1398 /**********************************************************************/ | |
| 1399 /* enqueuing and dequeuing events */ | |
| 1400 /**********************************************************************/ | |
| 1401 | |
| 1402 /* Add an event to the back of the command-event queue: it will be the next | |
| 1403 event read after all pending events. This only works on keyboard, | |
| 1404 mouse-click, misc-user, and eval events. | |
| 1405 */ | |
| 1406 static void | |
| 1407 enqueue_command_event (Lisp_Object event) | |
| 1408 { | |
| 1409 enqueue_event (event, &command_event_queue, &command_event_queue_tail); | |
| 1410 } | |
| 1411 | |
| 1412 static Lisp_Object | |
| 1413 dequeue_command_event (void) | |
| 1414 { | |
| 1415 return dequeue_event (&command_event_queue, &command_event_queue_tail); | |
| 1416 } | |
| 1417 | |
| 1204 | 1418 void |
| 1419 enqueue_dispatch_event (Lisp_Object event) | |
| 1420 { | |
| 1421 enqueue_event (event, &dispatch_event_queue, &dispatch_event_queue_tail); | |
| 1422 } | |
| 1423 | |
| 1424 Lisp_Object | |
| 1425 dequeue_dispatch_event (void) | |
| 1426 { | |
| 1427 return dequeue_event (&dispatch_event_queue, &dispatch_event_queue_tail); | |
| 1428 } | |
| 1429 | |
| 428 | 1430 static void |
| 1431 enqueue_command_event_1 (Lisp_Object event_to_copy) | |
| 1432 { | |
| 853 | 1433 enqueue_command_event (Fcopy_event (event_to_copy, Qnil)); |
| 428 | 1434 } |
| 1435 | |
| 1436 void | |
| 1437 enqueue_magic_eval_event (void (*fun) (Lisp_Object), Lisp_Object object) | |
| 1438 { | |
| 1439 Lisp_Object event = Fmake_event (Qnil, Qnil); | |
| 934 | 1440 XSET_EVENT_TYPE (event, magic_eval_event); |
| 1441 /* channel for magic_eval events is nil */ | |
| 1204 | 1442 XSET_EVENT_MAGIC_EVAL_INTERNAL_FUNCTION (event, fun); |
| 1443 XSET_EVENT_MAGIC_EVAL_OBJECT (event, object); | |
| 428 | 1444 enqueue_command_event (event); |
| 1445 } | |
| 1446 | |
| 1447 DEFUN ("enqueue-eval-event", Fenqueue_eval_event, 2, 2, 0, /* | |
| 1448 Add an eval event to the back of the eval event queue. | |
| 1449 When this event is dispatched, FUNCTION (which should be a function | |
| 1450 of one argument) will be called with OBJECT as its argument. | |
| 1451 See `next-event' for a description of event types and how events | |
| 1452 are received. | |
| 1453 */ | |
| 1454 (function, object)) | |
| 1455 { | |
| 1456 Lisp_Object event = Fmake_event (Qnil, Qnil); | |
| 1457 | |
| 934 | 1458 XSET_EVENT_TYPE (event, eval_event); |
| 1459 /* channel for eval events is nil */ | |
| 1204 | 1460 XSET_EVENT_EVAL_FUNCTION (event, function); |
| 1461 XSET_EVENT_EVAL_OBJECT (event, object); | |
| 428 | 1462 enqueue_command_event (event); |
| 1463 | |
| 1464 return event; | |
| 1465 } | |
| 1466 | |
| 1467 Lisp_Object | |
| 1468 enqueue_misc_user_event (Lisp_Object channel, Lisp_Object function, | |
| 1469 Lisp_Object object) | |
| 1470 { | |
| 1471 Lisp_Object event = Fmake_event (Qnil, Qnil); | |
| 934 | 1472 XSET_EVENT_TYPE (event, misc_user_event); |
| 1473 XSET_EVENT_CHANNEL (event, channel); | |
| 1204 | 1474 XSET_EVENT_MISC_USER_FUNCTION (event, function); |
| 1475 XSET_EVENT_MISC_USER_OBJECT (event, object); | |
| 1476 XSET_EVENT_MISC_USER_BUTTON (event, 0); | |
| 1477 XSET_EVENT_MISC_USER_MODIFIERS (event, 0); | |
| 1478 XSET_EVENT_MISC_USER_X (event, -1); | |
| 1479 XSET_EVENT_MISC_USER_Y (event, -1); | |
| 428 | 1480 enqueue_command_event (event); |
| 1481 | |
| 1482 return event; | |
| 1483 } | |
| 1484 | |
| 1485 Lisp_Object | |
| 1486 enqueue_misc_user_event_pos (Lisp_Object channel, Lisp_Object function, | |
| 1487 Lisp_Object object, | |
| 1488 int button, int modifiers, int x, int y) | |
| 1489 { | |
| 1490 Lisp_Object event = Fmake_event (Qnil, Qnil); | |
| 1491 | |
| 934 | 1492 XSET_EVENT_TYPE (event, misc_user_event); |
| 1493 XSET_EVENT_CHANNEL (event, channel); | |
| 1204 | 1494 XSET_EVENT_MISC_USER_FUNCTION (event, function); |
| 1495 XSET_EVENT_MISC_USER_OBJECT (event, object); | |
| 1496 XSET_EVENT_MISC_USER_BUTTON (event, button); | |
| 1497 XSET_EVENT_MISC_USER_MODIFIERS (event, modifiers); | |
| 1498 XSET_EVENT_MISC_USER_X (event, x); | |
| 1499 XSET_EVENT_MISC_USER_Y (event, y); | |
| 428 | 1500 enqueue_command_event (event); |
| 1501 | |
| 1502 return event; | |
| 1503 } | |
| 1504 | |
| 1505 | |
| 1506 /**********************************************************************/ | |
| 1507 /* focus-event handling */ | |
| 1508 /**********************************************************************/ | |
| 1509 | |
| 1510 /* | |
| 1511 | |
| 2367 | 1512 See also |
| 1513 | |
| 1514 (Info-goto-node "(internals)Focus Handling") | |
| 428 | 1515 */ |
| 1516 | |
| 2367 | 1517 |
| 428 | 1518 static void |
| 1519 run_select_frame_hook (void) | |
| 1520 { | |
| 1521 run_hook (Qselect_frame_hook); | |
| 1522 } | |
| 1523 | |
| 1524 static void | |
| 1525 run_deselect_frame_hook (void) | |
| 1526 { | |
| 1527 run_hook (Qdeselect_frame_hook); | |
| 1528 } | |
| 1529 | |
| 1530 /* When select-frame is called and focus_follows_mouse is false, we want | |
| 1531 to tell the window system that the focus should be changed to point to | |
| 1532 the new frame. However, | |
| 1533 sometimes Lisp functions will temporarily change the selected frame | |
| 1534 (e.g. to call a function that operates on the selected frame), | |
| 1535 and it's annoying if this focus-change happens exactly when | |
| 1536 select-frame is called, because then you get some flickering of the | |
| 1537 window-manager border and perhaps other undesirable results. We | |
| 1538 really only want to change the focus when we're about to retrieve | |
| 1539 an event from the user. To do this, we keep track of the frame | |
| 1540 where the window-manager focus lies on, and just before waiting | |
| 1541 for user events, check the currently selected frame and change | |
| 1542 the focus as necessary. | |
| 1543 | |
| 1544 On the other hand, if focus_follows_mouse is true, we need to switch the | |
| 1545 selected frame back to the frame with window manager focus just before we | |
| 1546 execute the next command in Fcommand_loop_1, just as the selected buffer is | |
| 1547 reverted after a set-buffer. | |
| 1548 | |
| 1549 Both cases are handled by this function. It must be called as appropriate | |
| 1550 from these two places, depending on the value of focus_follows_mouse. */ | |
| 1551 | |
| 1552 void | |
| 1553 investigate_frame_change (void) | |
| 1554 { | |
| 1555 Lisp_Object devcons, concons; | |
| 1556 | |
| 1557 /* if the selected frame was changed, change the window-system | |
| 1558 focus to the new frame. We don't do it when select-frame was | |
| 1559 called, to avoid flickering and other unwanted side effects when | |
| 1560 the frame is just changed temporarily. */ | |
| 1561 DEVICE_LOOP_NO_BREAK (devcons, concons) | |
| 1562 { | |
| 1563 struct device *d = XDEVICE (XCAR (devcons)); | |
| 1564 Lisp_Object sel_frame = DEVICE_SELECTED_FRAME (d); | |
| 1565 | |
| 1566 /* You'd think that maybe we should use FRAME_WITH_FOCUS_REAL, | |
| 1567 but that can cause us to end up in an infinite loop focusing | |
| 1568 between two frames. It seems that since the call to `select-frame' | |
| 1569 in emacs_handle_focus_change_final() is based on the _FOR_HOOKS | |
| 1570 value, we need to do so too. */ | |
| 1571 if (!NILP (sel_frame) && | |
| 1572 !EQ (DEVICE_FRAME_THAT_OUGHT_TO_HAVE_FOCUS (d), sel_frame) && | |
| 1573 !NILP (DEVICE_FRAME_WITH_FOCUS_FOR_HOOKS (d)) && | |
| 1574 !EQ (DEVICE_FRAME_WITH_FOCUS_FOR_HOOKS (d), sel_frame)) | |
| 1575 { | |
| 1576 /* At this point, we know that the frame has been changed. Now, if | |
| 1577 * focus_follows_mouse is not set, we finish off the frame change, | |
| 1578 * so that user events will now come from the new frame. Otherwise, | |
| 1579 * if focus_follows_mouse is set, no gratuitous frame changing | |
| 1580 * should take place. Set the focus back to the frame which was | |
| 1581 * originally selected for user input. | |
| 1582 */ | |
| 1583 if (!focus_follows_mouse) | |
| 1584 { | |
| 1585 /* prevent us from issuing the same request more than once */ | |
| 1586 DEVICE_FRAME_THAT_OUGHT_TO_HAVE_FOCUS (d) = sel_frame; | |
| 1587 MAYBE_DEVMETH (d, focus_on_frame, (XFRAME (sel_frame))); | |
| 1588 } | |
| 1589 else | |
| 1590 { | |
| 1591 Lisp_Object old_frame = Qnil; | |
| 1592 | |
| 1593 /* #### Do we really want to check OUGHT ?? | |
| 1594 * It seems to make sense, though I have never seen us | |
| 1595 * get here and have it be non-nil. | |
| 1596 */ | |
| 1597 if (FRAMEP (DEVICE_FRAME_THAT_OUGHT_TO_HAVE_FOCUS (d))) | |
| 1598 old_frame = DEVICE_FRAME_THAT_OUGHT_TO_HAVE_FOCUS (d); | |
| 1599 else if (FRAMEP (DEVICE_FRAME_WITH_FOCUS_FOR_HOOKS (d))) | |
| 1600 old_frame = DEVICE_FRAME_WITH_FOCUS_FOR_HOOKS (d); | |
| 1601 | |
| 1602 /* #### Can old_frame ever be NIL? play it safe.. */ | |
| 1603 if (!NILP (old_frame)) | |
| 1604 { | |
| 1605 /* Fselect_frame is not really the right thing: it frobs the | |
| 1606 * buffer stack. But there's no easy way to do the right | |
| 1607 * thing, and this code already had this problem anyway. | |
| 1608 */ | |
| 1609 Fselect_frame (old_frame); | |
| 1610 } | |
| 1611 } | |
| 1612 } | |
| 1613 } | |
| 1614 } | |
| 1615 | |
| 1616 static Lisp_Object | |
| 1617 cleanup_after_missed_defocusing (Lisp_Object frame) | |
| 1618 { | |
| 1619 if (FRAMEP (frame) && FRAME_LIVE_P (XFRAME (frame))) | |
| 1620 Fselect_frame (frame); | |
| 1621 return Qnil; | |
| 1622 } | |
| 1623 | |
| 1624 void | |
| 1625 emacs_handle_focus_change_preliminary (Lisp_Object frame_inp_and_dev) | |
| 1626 { | |
| 1627 Lisp_Object frame = Fcar (frame_inp_and_dev); | |
| 1628 Lisp_Object device = Fcar (Fcdr (frame_inp_and_dev)); | |
| 1629 int in_p = !NILP (Fcdr (Fcdr (frame_inp_and_dev))); | |
| 1630 struct device *d; | |
| 1631 | |
| 1632 if (!DEVICE_LIVE_P (XDEVICE (device))) | |
| 1633 return; | |
| 1634 else | |
| 1635 d = XDEVICE (device); | |
| 1636 | |
| 1637 /* Any received focus-change notifications render invalid any | |
| 1638 pending focus-change requests. */ | |
| 1639 DEVICE_FRAME_THAT_OUGHT_TO_HAVE_FOCUS (d) = Qnil; | |
| 1640 if (in_p) | |
| 1641 { | |
| 1642 Lisp_Object focus_frame; | |
| 1643 | |
| 1644 if (!FRAME_LIVE_P (XFRAME (frame))) | |
| 1645 return; | |
| 1646 else | |
| 1647 focus_frame = DEVICE_FRAME_WITH_FOCUS_REAL (d); | |
| 1648 | |
| 1649 /* Mark the minibuffer as changed to make sure it gets updated | |
| 1650 properly if the echo area is active. */ | |
| 1651 { | |
| 1652 struct window *w = XWINDOW (FRAME_MINIBUF_WINDOW (XFRAME (frame))); | |
| 1653 MARK_WINDOWS_CHANGED (w); | |
| 1654 } | |
| 1655 | |
| 452 | 1656 if (FRAMEP (focus_frame) && FRAME_LIVE_P (XFRAME (focus_frame)) |
| 1657 && !EQ (frame, focus_frame)) | |
| 428 | 1658 { |
| 1659 /* Oops, we missed a focus-out event. */ | |
| 1660 DEVICE_FRAME_WITH_FOCUS_REAL (d) = Qnil; | |
| 1661 redisplay_redraw_cursor (XFRAME (focus_frame), 1); | |
| 1662 } | |
| 1663 DEVICE_FRAME_WITH_FOCUS_REAL (d) = frame; | |
| 1664 if (!EQ (frame, focus_frame)) | |
| 1665 { | |
| 1666 redisplay_redraw_cursor (XFRAME (frame), 1); | |
| 1667 } | |
| 1668 } | |
| 1669 else | |
| 1670 { | |
| 1671 /* We ignore the frame reported in the event. If it's different | |
| 1672 from where we think the focus was, oh well -- we messed up. | |
| 1673 Nonetheless, we pretend we were right, for sensible behavior. */ | |
| 1674 frame = DEVICE_FRAME_WITH_FOCUS_REAL (d); | |
| 1675 if (!NILP (frame)) | |
| 1676 { | |
| 1677 DEVICE_FRAME_WITH_FOCUS_REAL (d) = Qnil; | |
| 1678 | |
| 1679 if (FRAME_LIVE_P (XFRAME (frame))) | |
| 1680 redisplay_redraw_cursor (XFRAME (frame), 1); | |
| 1681 } | |
| 1682 } | |
| 1683 } | |
| 1684 | |
| 1685 /* Called from the window-system-specific code when we receive a | |
| 1686 notification that the focus lies on a particular frame. | |
| 1687 Argument is a cons: (frame . (device . in-p)) where in-p is non-nil | |
| 1688 for focus-in. | |
| 1689 */ | |
| 1690 void | |
| 1691 emacs_handle_focus_change_final (Lisp_Object frame_inp_and_dev) | |
| 1692 { | |
| 1693 Lisp_Object frame = Fcar (frame_inp_and_dev); | |
| 1694 Lisp_Object device = Fcar (Fcdr (frame_inp_and_dev)); | |
| 1695 int in_p = !NILP (Fcdr (Fcdr (frame_inp_and_dev))); | |
| 1696 struct device *d; | |
| 1697 int count; | |
| 1698 | |
| 1699 if (!DEVICE_LIVE_P (XDEVICE (device))) | |
| 1700 return; | |
| 1701 else | |
| 1702 d = XDEVICE (device); | |
| 1703 | |
| 1704 if (in_p) | |
| 1705 { | |
| 1706 Lisp_Object focus_frame; | |
| 1707 | |
| 1708 if (!FRAME_LIVE_P (XFRAME (frame))) | |
| 1709 return; | |
| 1710 else | |
| 1711 focus_frame = DEVICE_FRAME_WITH_FOCUS_FOR_HOOKS (d); | |
| 1712 | |
| 1713 DEVICE_FRAME_WITH_FOCUS_FOR_HOOKS (d) = frame; | |
| 1714 if (FRAMEP (focus_frame) && !EQ (frame, focus_frame)) | |
| 1715 { | |
| 1716 /* Oops, we missed a focus-out event. */ | |
| 1717 Fselect_frame (focus_frame); | |
| 1718 /* Do an unwind-protect in case an error occurs in | |
| 1719 the deselect-frame-hook */ | |
| 1720 count = specpdl_depth (); | |
| 1721 record_unwind_protect (cleanup_after_missed_defocusing, frame); | |
| 1722 run_deselect_frame_hook (); | |
| 771 | 1723 unbind_to (count); |
| 428 | 1724 /* the cleanup method changed the focus frame to nil, so |
| 1725 we need to reflect this */ | |
| 1726 focus_frame = Qnil; | |
| 1727 } | |
| 1728 else | |
| 1729 Fselect_frame (frame); | |
| 1730 if (!EQ (frame, focus_frame)) | |
| 1731 run_select_frame_hook (); | |
| 1732 } | |
| 1733 else | |
| 1734 { | |
| 1735 /* We ignore the frame reported in the event. If it's different | |
| 1736 from where we think the focus was, oh well -- we messed up. | |
| 1737 Nonetheless, we pretend we were right, for sensible behavior. */ | |
| 1738 frame = DEVICE_FRAME_WITH_FOCUS_FOR_HOOKS (d); | |
| 1739 if (!NILP (frame)) | |
| 1740 { | |
| 1741 DEVICE_FRAME_WITH_FOCUS_FOR_HOOKS (d) = Qnil; | |
| 1742 run_deselect_frame_hook (); | |
| 1743 } | |
| 1744 } | |
| 1745 } | |
| 1746 | |
| 1747 | |
| 1748 /**********************************************************************/ | |
| 1268 | 1749 /* input pending/quit checking */ |
| 1750 /**********************************************************************/ | |
| 1751 | |
| 1752 /* If HOW_MANY is 0, return true if there are any user or non-user events | |
| 1753 pending. If HOW_MANY is > 0, return true if there are that many *user* | |
| 1754 events pending, irrespective of non-user events. */ | |
| 1755 | |
| 1756 static int | |
| 1757 event_stream_event_pending_p (int how_many) | |
| 1758 { | |
| 1759 /* #### Hmmm ... There may be some duplication in "drain queue" and | |
| 1760 "event pending". Couldn't we just drain the queue and see what's in | |
| 1761 it, and not maybe need a separate event method for this? Would this | |
| 1762 work when HOW_MANY is 0? Maybe this would be slow? */ | |
| 1763 return event_stream && event_stream->event_pending_p (how_many); | |
| 1764 } | |
| 1765 | |
| 1766 static void | |
| 1767 event_stream_force_event_pending (struct frame *f) | |
| 1768 { | |
| 1769 if (event_stream->force_event_pending_cb) | |
| 1770 event_stream->force_event_pending_cb (f); | |
| 1771 } | |
| 1772 | |
| 1773 void | |
| 1774 event_stream_drain_queue (void) | |
| 1775 { | |
| 1318 | 1776 /* This can call Lisp */ |
| 1268 | 1777 if (event_stream && event_stream->drain_queue_cb) |
| 1778 event_stream->drain_queue_cb (); | |
| 1779 } | |
| 1780 | |
| 1781 /* Return non-zero if at least HOW_MANY user events are pending. */ | |
| 1782 int | |
| 1783 detect_input_pending (int how_many) | |
| 1784 { | |
| 1318 | 1785 /* This can call Lisp */ |
| 1268 | 1786 Lisp_Object event; |
| 1787 | |
| 1788 if (!NILP (Vunread_command_event)) | |
| 1789 how_many--; | |
| 1790 | |
| 1791 how_many -= XINT (Fsafe_length (Vunread_command_events)); | |
| 1792 | |
| 1793 if (how_many <= 0) | |
| 1794 return 1; | |
| 1795 | |
| 1796 EVENT_CHAIN_LOOP (event, command_event_queue) | |
| 1797 { | |
| 1798 if (XEVENT_TYPE (event) != eval_event | |
| 1799 && XEVENT_TYPE (event) != magic_eval_event) | |
| 1800 { | |
| 1801 how_many--; | |
| 1802 if (how_many <= 0) | |
| 1803 return 1; | |
| 1804 } | |
| 1805 } | |
| 1806 | |
| 1807 return event_stream_event_pending_p (how_many); | |
| 1808 } | |
| 1809 | |
| 1810 DEFUN ("input-pending-p", Finput_pending_p, 0, 0, 0, /* | |
| 1811 Return t if command input is currently available with no waiting. | |
| 1812 Actually, the value is nil only if we can be sure that no input is available. | |
| 1813 */ | |
| 1814 ()) | |
| 1815 { | |
| 1318 | 1816 /* This can call Lisp */ |
| 1268 | 1817 return detect_input_pending (1) ? Qt : Qnil; |
| 1818 } | |
| 1819 | |
| 1820 static int | |
| 1821 maybe_read_quit_event (Lisp_Event *event) | |
| 1822 { | |
| 1823 /* A C-g that came from `sigint_happened' will always come from the | |
| 1824 controlling terminal. If that doesn't exist, however, then the | |
| 1825 user manually sent us a SIGINT, and we pretend the C-g came from | |
| 1826 the selected console. */ | |
| 1827 struct console *con; | |
| 1828 | |
| 1829 if (CONSOLEP (Vcontrolling_terminal) && | |
| 1830 CONSOLE_LIVE_P (XCONSOLE (Vcontrolling_terminal))) | |
| 1831 con = XCONSOLE (Vcontrolling_terminal); | |
| 1832 else | |
| 1833 con = XCONSOLE (Fselected_console ()); | |
| 1834 | |
| 1835 if (sigint_happened) | |
| 1836 { | |
| 1837 sigint_happened = 0; | |
| 1838 Vquit_flag = Qnil; | |
| 1839 Fcopy_event (CONSOLE_QUIT_EVENT (con), wrap_event (event)); | |
| 1840 return 1; | |
| 1841 } | |
| 1842 return 0; | |
| 1843 } | |
| 1844 | |
| 1845 struct remove_quit_p_data | |
| 1846 { | |
| 1847 int critical; | |
| 1848 }; | |
| 1849 | |
| 1850 static int | |
| 1851 remove_quit_p_event (Lisp_Object ev, void *the_data) | |
| 1852 { | |
| 1853 struct remove_quit_p_data *data = (struct remove_quit_p_data *) the_data; | |
| 1854 struct console *con = event_console_or_selected (ev); | |
| 1855 | |
| 1856 if (XEVENT_TYPE (ev) == key_press_event) | |
| 1857 { | |
| 1858 if (event_matches_key_specifier_p (ev, CONSOLE_QUIT_EVENT (con))) | |
| 1859 return 1; | |
| 1860 if (event_matches_key_specifier_p (ev, | |
| 1861 CONSOLE_CRITICAL_QUIT_EVENT (con))) | |
| 1862 { | |
| 1863 data->critical = 1; | |
| 1864 return 1; | |
| 1865 } | |
| 1866 } | |
| 1867 | |
| 1868 return 0; | |
| 1869 } | |
| 1870 | |
| 1871 void | |
| 1872 event_stream_quit_p (void) | |
| 1873 { | |
| 1318 | 1874 /* This can call Lisp */ |
| 1268 | 1875 struct remove_quit_p_data data; |
| 1876 | |
| 1877 /* Quit checking cannot happen in modal loop. Because it attempts to | |
| 1878 retrieve and dispatch events, it will cause lots of problems if we try | |
| 1879 to do this when already in the process of doing this -- deadlocking | |
| 1880 under Windows, crashes in lwlib etc. under X due to non-reentrant | |
| 1881 code. This is automatically caught, however, in | |
| 1882 event_stream_drain_queue() (checks for in_modal_loop in the | |
| 1883 event-specific code). */ | |
| 1884 | |
| 1885 /* Drain queue so we can check for pending C-g events. */ | |
| 1886 event_stream_drain_queue (); | |
| 1887 data.critical = 0; | |
| 1888 | |
| 1889 if (map_event_chain_remove (remove_quit_p_event, | |
| 1890 &dispatch_event_queue, | |
| 1891 &dispatch_event_queue_tail, | |
| 1892 &data, MECR_DEALLOCATE_EVENT)) | |
| 1893 Vquit_flag = data.critical ? Qcritical : Qt; | |
| 1894 } | |
| 1895 | |
| 1896 Lisp_Object | |
| 1897 event_stream_protect_modal_loop (const char *error_string, | |
| 1898 Lisp_Object (*bfun) (void *barg), | |
| 1899 void *barg, int flags) | |
| 1900 { | |
| 1901 Lisp_Object tmp; | |
| 1902 | |
| 1903 ++in_modal_loop; | |
| 1904 tmp = call_trapping_problems (Qevent, error_string, flags, 0, bfun, barg); | |
| 1905 --in_modal_loop; | |
| 1906 | |
| 1907 return tmp; | |
| 1908 } | |
| 1909 | |
| 1910 | |
| 1911 /**********************************************************************/ | |
| 428 | 1912 /* retrieving the next event */ |
| 1913 /**********************************************************************/ | |
| 1914 | |
| 1915 static int in_single_console; | |
| 1916 | |
| 1917 /* #### These functions don't currently do anything. */ | |
| 1918 void | |
| 1919 single_console_state (void) | |
| 1920 { | |
| 1921 in_single_console = 1; | |
| 1922 } | |
| 1923 | |
| 1924 void | |
| 1925 any_console_state (void) | |
| 1926 { | |
| 1927 in_single_console = 0; | |
| 1928 } | |
| 1929 | |
| 1930 int | |
| 1931 in_single_console_state (void) | |
| 1932 { | |
| 1933 return in_single_console; | |
| 1934 } | |
| 1935 | |
| 1268 | 1936 static void |
| 1937 event_stream_next_event (Lisp_Event *event) | |
| 1938 { | |
| 1939 Lisp_Object event_obj; | |
| 1940 | |
| 1941 check_event_stream_ok (); | |
| 1942 | |
| 1943 event_obj = wrap_event (event); | |
| 1944 zero_event (event); | |
| 1945 /* SIGINT occurs when C-g was pressed on a TTY. (SIGINT might have | |
| 1946 been sent manually by the user, but we don't care; we treat it | |
| 1947 the same.) | |
| 1948 | |
| 1949 The SIGINT signal handler sets Vquit_flag as well as sigint_happened | |
| 1950 and write a byte on our "fake pipe", which unblocks us when we are | |
| 1951 waiting for an event. */ | |
| 1952 | |
| 1953 /* If SIGINT was received after we disabled quit checking (because | |
| 1954 we want to read C-g's as characters), but before we got a chance | |
| 1955 to start reading, notice it now and treat it as a character to be | |
| 1956 read. If above callers wanted this to be QUIT, they can | |
| 1957 determine this by comparing the event against quit-char. */ | |
| 1958 | |
| 1959 if (maybe_read_quit_event (event)) | |
| 1960 { | |
| 1961 DEBUG_PRINT_EMACS_EVENT ("SIGINT", event_obj); | |
| 1962 return; | |
| 1963 } | |
| 1964 | |
| 1965 /* If a longjmp() happens in the callback, we're screwed. | |
| 1966 Let's hope it doesn't. I think the code here is fairly | |
| 1967 clean and doesn't do this. */ | |
| 1968 emacs_is_blocking = 1; | |
| 1969 event_stream->next_event_cb (event); | |
| 1970 emacs_is_blocking = 0; | |
| 1971 | |
| 1972 /* Now check to see if C-g was pressed while we were blocking. | |
| 1973 We treat it as an event, just like above. */ | |
| 1974 if (maybe_read_quit_event (event)) | |
| 1975 { | |
| 1976 DEBUG_PRINT_EMACS_EVENT ("SIGINT", event_obj); | |
| 1977 return; | |
| 1978 } | |
| 1979 | |
| 1980 #ifdef DEBUG_XEMACS | |
| 1981 /* timeout events have more info set later, so | |
| 1982 print the event out in next_event_internal(). */ | |
| 1983 if (event->event_type != timeout_event) | |
| 1984 DEBUG_PRINT_EMACS_EVENT ("real", event_obj); | |
| 1985 #endif | |
| 1986 maybe_kbd_translate (event_obj); | |
| 1987 } | |
| 428 | 1988 |
| 853 | 1989 /* Read an event from the window system (or tty). If ALLOW_QUEUED is |
| 1990 non-zero, read from the command-event queue first. | |
| 1991 | |
| 1992 If C-g was pressed, this function will attempt to QUIT. If you want | |
| 1993 to read C-g as an event, wrap this function with a call to | |
| 1994 begin_dont_check_for_quit(), and set Vquit_flag to Qnil just before | |
| 1995 you unbind. In this case, TARGET_EVENT will contain a C-g. | |
| 1996 | |
| 1997 Note that even if you are interested in C-g doing QUIT, a caller of you | |
| 1998 might not be. | |
| 1999 */ | |
| 2000 | |
| 428 | 2001 static void |
| 2002 next_event_internal (Lisp_Object target_event, int allow_queued) | |
| 2003 { | |
| 2004 struct gcpro gcpro1; | |
| 1292 | 2005 PROFILE_DECLARE (); |
| 2006 | |
| 853 | 2007 QUIT; |
| 428 | 2008 |
| 1292 | 2009 PROFILE_RECORD_ENTERING_SECTION (QSnext_event_internal); |
| 2010 | |
| 428 | 2011 assert (NILP (XEVENT_NEXT (target_event))); |
| 2012 | |
| 2013 GCPRO1 (target_event); | |
| 2014 | |
| 2015 /* When focus_follows_mouse is nil, if a frame change took place, we need | |
| 2016 * to actually switch window manager focus to the selected window now. | |
| 2017 */ | |
| 2018 if (!focus_follows_mouse) | |
| 2019 investigate_frame_change (); | |
| 2020 | |
| 2021 if (allow_queued && !NILP (command_event_queue)) | |
| 2022 { | |
| 2023 Lisp_Object event = dequeue_command_event (); | |
| 2024 Fcopy_event (event, target_event); | |
| 2025 Fdeallocate_event (event); | |
| 2026 DEBUG_PRINT_EMACS_EVENT ("command event queue", target_event); | |
| 2027 } | |
| 2028 else | |
| 2029 { | |
| 440 | 2030 Lisp_Event *e = XEVENT (target_event); |
| 428 | 2031 |
| 2032 /* The command_event_queue was empty. Wait for an event. */ | |
| 2033 event_stream_next_event (e); | |
| 2034 /* If this was a timeout, then we need to extract some data | |
| 2035 out of the returned closure and might need to resignal | |
| 2036 it. */ | |
| 934 | 2037 if (EVENT_TYPE (e) == timeout_event) |
| 428 | 2038 { |
| 2039 Lisp_Object tristan, isolde; | |
| 2040 | |
| 1204 | 2041 SET_EVENT_TIMEOUT_ID_NUMBER (e, |
| 2042 event_stream_resignal_wakeup (EVENT_TIMEOUT_INTERVAL_ID (e), 0, &tristan, &isolde)); | |
| 2043 | |
| 2044 SET_EVENT_TIMEOUT_FUNCTION (e, tristan); | |
| 2045 SET_EVENT_TIMEOUT_OBJECT (e, isolde); | |
| 934 | 2046 /* next_event_internal() doesn't print out timeout events |
| 2047 because of the extra info we just set. */ | |
| 428 | 2048 DEBUG_PRINT_EMACS_EVENT ("real, timeout", target_event); |
| 2049 } | |
| 2050 | |
| 853 | 2051 /* If we read a ^G, then set quit-flag and try to QUIT. |
| 2052 This may be blocked (see above). | |
| 428 | 2053 */ |
| 934 | 2054 if (EVENT_TYPE (e) == key_press_event && |
| 428 | 2055 event_matches_key_specifier_p |
| 1204 | 2056 (target_event, CONSOLE_QUIT_EVENT (XCONSOLE (EVENT_CHANNEL (e))))) |
| 428 | 2057 { |
| 2058 Vquit_flag = Qt; | |
| 853 | 2059 QUIT; |
| 428 | 2060 } |
| 2061 } | |
| 2062 | |
| 2063 UNGCPRO; | |
| 1292 | 2064 |
| 2065 PROFILE_RECORD_EXITING_SECTION (QSnext_event_internal); | |
| 428 | 2066 } |
| 2067 | |
| 853 | 2068 void |
| 428 | 2069 run_pre_idle_hook (void) |
| 2070 { | |
| 1318 | 2071 /* This can call Lisp */ |
| 428 | 2072 if (!NILP (Vpre_idle_hook) |
| 1268 | 2073 && !detect_input_pending (1)) |
| 853 | 2074 safe_run_hook_trapping_problems |
| 1333 | 2075 (Qredisplay, Qpre_idle_hook, |
| 1268 | 2076 /* Quit is inhibited as a result of being within next-event so |
| 2077 we need to fix that. */ | |
| 2078 INHIBIT_EXISTING_PERMANENT_DISPLAY_OBJECT_DELETION | UNINHIBIT_QUIT); | |
| 428 | 2079 } |
| 2080 | |
| 2081 DEFUN ("next-event", Fnext_event, 0, 2, 0, /* | |
| 2082 Return the next available event. | |
| 2083 Pass this object to `dispatch-event' to handle it. | |
| 2084 In most cases, you will want to use `next-command-event', which returns | |
| 2085 the next available "user" event (i.e. keypress, button-press, | |
| 2086 button-release, or menu selection) instead of this function. | |
| 2087 | |
| 2088 If EVENT is non-nil, it should be an event object and will be filled in | |
| 2089 and returned; otherwise a new event object will be created and returned. | |
| 2090 If PROMPT is non-nil, it should be a string and will be displayed in the | |
| 2091 echo area while this function is waiting for an event. | |
| 2092 | |
| 2093 The next available event will be | |
| 2094 | |
| 2095 -- any events in `unread-command-events' or `unread-command-event'; else | |
| 2096 -- the next event in the currently executing keyboard macro, if any; else | |
| 442 | 2097 -- an event queued by `enqueue-eval-event', if any, or any similar event |
| 2098 queued internally, such as a misc-user event. (For example, when an item | |
| 2099 is selected from a menu or from a `question'-type dialog box, the item's | |
| 2100 callback is not immediately executed, but instead a misc-user event | |
| 2101 is generated and placed onto this queue; when it is dispatched, the | |
| 2102 callback is executed.) Else | |
| 428 | 2103 -- the next available event from the window system or terminal driver. |
| 2104 | |
| 2105 In the last case, this function will block until an event is available. | |
| 2106 | |
| 2107 The returned event will be one of the following types: | |
| 2108 | |
| 2109 -- a key-press event. | |
| 2110 -- a button-press or button-release event. | |
| 2111 -- a misc-user-event, meaning the user selected an item on a menu or used | |
| 2112 the scrollbar. | |
| 2113 -- a process event, meaning that output from a subprocess is available. | |
| 2114 -- a timeout event, meaning that a timeout has elapsed. | |
| 2115 -- an eval event, which simply causes a function to be executed when the | |
| 2116 event is dispatched. Eval events are generated by `enqueue-eval-event' | |
| 2117 or by certain other conditions happening. | |
| 2118 -- a magic event, indicating that some window-system-specific event | |
| 2119 happened (such as a focus-change notification) that must be handled | |
| 2120 synchronously with other events. `dispatch-event' knows what to do with | |
| 2121 these events. | |
| 2122 */ | |
| 2123 (event, prompt)) | |
| 2124 { | |
| 2125 /* This function can call lisp */ | |
| 2126 /* #### We start out using the selected console before an event | |
| 2127 is received, for echoing the partially completed command. | |
| 2128 This is most definitely wrong -- there needs to be a separate | |
| 2129 echo area for each console! */ | |
| 2130 struct console *con = XCONSOLE (Vselected_console); | |
| 2131 struct command_builder *command_builder = | |
| 2132 XCOMMAND_BUILDER (con->command_builder); | |
| 2133 int store_this_key = 0; | |
| 2134 struct gcpro gcpro1; | |
| 853 | 2135 int depth; |
| 1292 | 2136 PROFILE_DECLARE (); |
| 428 | 2137 |
| 2138 GCPRO1 (event); | |
| 853 | 2139 |
| 1268 | 2140 /* This is not strictly necessary. Trying to retrieve an event inside of |
| 2141 a modal loop can cause major problems (see event_stream_quit_p()), but | |
| 2142 the event-specific code knows about this and will make sure we don't | |
| 2143 do anything dangerous. However, if we've gotten here, it's highly | |
| 2144 likely that some code is trying to fetch user events (e.g. in custom | |
| 2145 dialog-box code), and will almost certainly deadlock, so it's probably | |
| 2146 best to error out. #### This could cause problems because there are | |
| 2147 (potentially, at least) legitimate reasons for calling next-event | |
| 2148 inside of a modal loop, in particular if the code is trying to search | |
| 2149 for a timeout event, which will still get retrieved in such a case. | |
| 2150 However, the code to error in such a case has already been present for | |
| 2151 a long time without obvious problems so leaving it in isn't so | |
| 1279 | 2152 bad. |
| 2153 | |
| 2154 #### I used to conditionalize on in_modal_loop but that fails utterly | |
| 2155 because event-msw.c specifically calls Fnext_event() inside of a modal | |
| 2156 loop to clear the dispatch queue. --ben */ | |
| 1315 | 2157 #ifdef HAVE_MENUBARS |
| 1279 | 2158 if (in_menu_callback) |
| 2159 invalid_operation ("Attempt to call next-event inside menu callback", | |
| 1268 | 2160 Qunbound); |
| 1315 | 2161 #endif /* HAVE_MENUBARS */ |
| 1268 | 2162 |
| 1292 | 2163 PROFILE_RECORD_ENTERING_SECTION (Qnext_event); |
| 2164 | |
| 853 | 2165 depth = begin_dont_check_for_quit (); |
| 428 | 2166 |
| 2167 if (NILP (event)) | |
| 2168 event = Fmake_event (Qnil, Qnil); | |
| 2169 else | |
| 2170 CHECK_LIVE_EVENT (event); | |
| 2171 | |
| 2172 if (!NILP (prompt)) | |
| 2173 { | |
| 2174 Bytecount len; | |
| 2175 CHECK_STRING (prompt); | |
| 2176 | |
| 2177 len = XSTRING_LENGTH (prompt); | |
| 2178 if (command_builder->echo_buf_length < len) | |
| 2179 len = command_builder->echo_buf_length - 1; | |
| 2180 memcpy (command_builder->echo_buf, XSTRING_DATA (prompt), len); | |
| 2181 command_builder->echo_buf[len] = 0; | |
| 2182 command_builder->echo_buf_index = len; | |
| 2183 echo_area_message (XFRAME (CONSOLE_SELECTED_FRAME (con)), | |
| 2184 command_builder->echo_buf, | |
| 2185 Qnil, 0, | |
| 2186 command_builder->echo_buf_index, | |
| 2187 Qcommand); | |
| 2188 } | |
| 2189 | |
| 2190 start_over_and_avoid_hosage: | |
| 2191 | |
| 2192 /* If there is something in unread-command-events, simply return it. | |
| 2193 But do some error checking to make sure the user hasn't put something | |
| 2194 in the unread-command-events that they shouldn't have. | |
| 2195 This does not update this-command-keys and recent-keys. | |
| 2196 */ | |
| 2197 if (!NILP (Vunread_command_events)) | |
| 2198 { | |
| 2199 if (!CONSP (Vunread_command_events)) | |
| 2200 { | |
| 2201 Vunread_command_events = Qnil; | |
| 563 | 2202 signal_error_1 (Qwrong_type_argument, |
| 428 | 2203 list3 (Qconsp, Vunread_command_events, |
| 2204 Qunread_command_events)); | |
| 2205 } | |
| 2206 else | |
| 2207 { | |
| 2208 Lisp_Object e = XCAR (Vunread_command_events); | |
| 2209 Vunread_command_events = XCDR (Vunread_command_events); | |
| 2210 if (!EVENTP (e) || !command_event_p (e)) | |
| 563 | 2211 signal_error_1 (Qwrong_type_argument, |
| 428 | 2212 list3 (Qcommand_event_p, e, Qunread_command_events)); |
| 853 | 2213 redisplay_no_pre_idle_hook (); |
| 428 | 2214 if (!EQ (e, event)) |
| 2215 Fcopy_event (e, event); | |
| 2216 DEBUG_PRINT_EMACS_EVENT ("unread-command-events", event); | |
| 2217 } | |
| 2218 } | |
| 2219 | |
| 2220 /* Do similar for unread-command-event (obsoleteness support). */ | |
| 2221 else if (!NILP (Vunread_command_event)) | |
| 2222 { | |
| 2223 Lisp_Object e = Vunread_command_event; | |
| 2224 Vunread_command_event = Qnil; | |
| 2225 | |
| 2226 if (!EVENTP (e) || !command_event_p (e)) | |
| 2227 { | |
| 563 | 2228 signal_error_1 (Qwrong_type_argument, |
| 428 | 2229 list3 (Qeventp, e, Qunread_command_event)); |
| 2230 } | |
| 2231 if (!EQ (e, event)) | |
| 2232 Fcopy_event (e, event); | |
| 853 | 2233 redisplay_no_pre_idle_hook (); |
| 428 | 2234 DEBUG_PRINT_EMACS_EVENT ("unread-command-event", event); |
| 2235 } | |
| 2236 | |
| 2237 /* If we're executing a keyboard macro, take the next event from that, | |
| 2238 and update this-command-keys and recent-keys. | |
| 2239 Note that the unread-command-events take precedence over kbd macros. | |
| 2240 */ | |
| 2241 else | |
| 2242 { | |
| 2243 if (!NILP (Vexecuting_macro)) | |
| 2244 { | |
| 853 | 2245 redisplay_no_pre_idle_hook (); |
| 428 | 2246 pop_kbd_macro_event (event); /* This throws past us at |
| 2247 end-of-macro. */ | |
| 2248 store_this_key = 1; | |
| 2249 DEBUG_PRINT_EMACS_EVENT ("keyboard macro", event); | |
| 2250 } | |
| 2251 /* Otherwise, read a real event, possibly from the | |
| 2252 command_event_queue, and update this-command-keys and | |
| 2253 recent-keys. */ | |
| 2254 else | |
| 2255 { | |
| 2256 redisplay (); | |
| 2257 next_event_internal (event, 1); | |
| 2258 store_this_key = 1; | |
| 2259 } | |
| 2260 } | |
| 2261 | |
| 853 | 2262 /* temporarily reenable quit checking here, because arbitrary lisp |
| 2263 is executed */ | |
| 2264 Vquit_flag = Qnil; /* see begin_dont_check_for_quit() */ | |
| 2265 unbind_to (depth); | |
| 428 | 2266 status_notify (); /* Notice process change */ |
| 853 | 2267 depth = begin_dont_check_for_quit (); |
| 428 | 2268 |
| 2269 /* Since we can free the most stuff here | |
| 2270 * (since this is typically called from | |
| 2271 * the command-loop top-level). */ | |
| 851 | 2272 if (need_to_check_c_alloca) |
| 2273 xemacs_c_alloca (0); /* Cause a garbage collection now */ | |
| 428 | 2274 |
| 2275 if (object_dead_p (XEVENT (event)->channel)) | |
| 2276 /* event_console_or_selected may crash if the channel is dead. | |
| 2277 Best just to eat it and get the next event. */ | |
| 2278 goto start_over_and_avoid_hosage; | |
| 2279 | |
| 2280 /* OK, now we can stop the selected-console kludge and use the | |
| 2281 actual console from the event. */ | |
| 2282 con = event_console_or_selected (event); | |
| 2283 command_builder = XCOMMAND_BUILDER (con->command_builder); | |
| 2284 | |
| 2285 switch (XEVENT_TYPE (event)) | |
| 2286 { | |
| 2287 case button_release_event: | |
| 2288 case misc_user_event: | |
| 2289 /* don't echo menu accelerator keys */ | |
| 2290 reset_key_echo (command_builder, 1); | |
| 2291 goto EXECUTE_KEY; | |
| 2292 case button_press_event: /* key or mouse input can trigger prompting */ | |
| 2293 goto STORE_AND_EXECUTE_KEY; | |
| 2294 case key_press_event: /* any key input can trigger autosave */ | |
| 2295 break; | |
| 898 | 2296 default: |
| 2297 goto RETURN; | |
| 428 | 2298 } |
| 2299 | |
| 853 | 2300 /* temporarily reenable quit checking here, because we could get stuck */ |
| 2301 Vquit_flag = Qnil; /* see begin_dont_check_for_quit() */ | |
| 2302 unbind_to (depth); | |
| 428 | 2303 maybe_do_auto_save (); |
| 853 | 2304 depth = begin_dont_check_for_quit (); |
| 2305 | |
| 428 | 2306 num_input_chars++; |
| 2307 STORE_AND_EXECUTE_KEY: | |
| 2308 if (store_this_key) | |
| 2309 { | |
| 2310 echo_key_event (command_builder, event); | |
| 2311 } | |
| 2312 | |
| 2313 EXECUTE_KEY: | |
| 2314 /* Store the last-input-event. The semantics of this is that it is | |
| 2315 the thing most recently returned by next-command-event. It need | |
| 2316 not have come from the keyboard or a keyboard macro, it may have | |
| 2317 come from unread-command-events. It's always a command-event (a | |
| 2318 key, click, or menu selection), never a motion or process event. | |
| 2319 */ | |
| 2320 if (!EVENTP (Vlast_input_event)) | |
| 2321 Vlast_input_event = Fmake_event (Qnil, Qnil); | |
| 2322 if (XEVENT_TYPE (Vlast_input_event) == dead_event) | |
| 2323 { | |
| 2324 Vlast_input_event = Fmake_event (Qnil, Qnil); | |
| 563 | 2325 invalid_state ("Someone deallocated last-input-event!", Qunbound); |
| 428 | 2326 } |
| 2327 if (! EQ (event, Vlast_input_event)) | |
| 2328 Fcopy_event (event, Vlast_input_event); | |
| 2329 | |
| 2330 /* last-input-char and last-input-time are derived from | |
| 2331 last-input-event. | |
| 2332 Note that last-input-char will never have its high-bit set, in an | |
| 2333 effort to sidestep the ambiguity between M-x and oslash. | |
| 2334 */ | |
| 2862 | 2335 Vlast_input_char = Fevent_to_character (Vlast_input_event, Qnil, Qnil, Qnil); |
| 428 | 2336 { |
| 2337 EMACS_TIME t; | |
| 2338 EMACS_GET_TIME (t); | |
| 2339 if (!CONSP (Vlast_input_time)) | |
| 2340 Vlast_input_time = Fcons (Qnil, Qnil); | |
| 2341 XCAR (Vlast_input_time) = make_int ((EMACS_SECS (t) >> 16) & 0xffff); | |
| 2342 XCDR (Vlast_input_time) = make_int ((EMACS_SECS (t) >> 0) & 0xffff); | |
| 2343 if (!CONSP (Vlast_command_event_time)) | |
| 2344 Vlast_command_event_time = list3 (Qnil, Qnil, Qnil); | |
| 2345 XCAR (Vlast_command_event_time) = | |
| 2346 make_int ((EMACS_SECS (t) >> 16) & 0xffff); | |
| 2347 XCAR (XCDR (Vlast_command_event_time)) = | |
| 2348 make_int ((EMACS_SECS (t) >> 0) & 0xffff); | |
| 2349 XCAR (XCDR (XCDR (Vlast_command_event_time))) | |
| 2350 = make_int (EMACS_USECS (t)); | |
| 2351 } | |
| 2352 /* If this key came from the keyboard or from a keyboard macro, then | |
| 2353 it goes into the recent-keys and this-command-keys vectors. | |
| 2354 If this key came from the keyboard, and we're defining a keyboard | |
| 2355 macro, then it goes into the macro. | |
| 2356 */ | |
| 2357 if (store_this_key) | |
| 2358 { | |
| 479 | 2359 if (!is_scrollbar_event (event)) /* #### not quite right, see |
| 2360 comment in execute_command_event */ | |
| 2361 push_this_command_keys (event); | |
| 428 | 2362 if (!inhibit_input_event_recording) |
| 2363 push_recent_keys (event); | |
| 2364 dribble_out_event (event); | |
| 2365 if (!NILP (con->defining_kbd_macro) && NILP (Vexecuting_macro)) | |
| 2366 { | |
| 2367 if (!EVENTP (command_builder->current_events)) | |
| 2368 finalize_kbd_macro_chars (con); | |
| 2369 store_kbd_macro_event (event); | |
| 2370 } | |
| 2371 } | |
| 853 | 2372 /* If this is the help char and there is a help form, then execute |
| 2373 the help form and swallow this character. Note that | |
| 2374 execute_help_form() calls Fnext_command_event(), which calls this | |
| 2375 function, as well as Fdispatch_event. */ | |
| 428 | 2376 if (!NILP (Vhelp_form) && |
| 1204 | 2377 event_matches_key_specifier_p (event, Vhelp_char)) |
| 853 | 2378 { |
| 2379 /* temporarily reenable quit checking here, because we could get stuck */ | |
| 2380 Vquit_flag = Qnil; /* see begin_dont_check_for_quit() */ | |
| 2381 unbind_to (depth); | |
| 2382 execute_help_form (command_builder, event); | |
| 2383 depth = begin_dont_check_for_quit (); | |
| 2384 } | |
| 428 | 2385 |
| 2386 RETURN: | |
| 853 | 2387 Vquit_flag = Qnil; /* see begin_dont_check_for_quit() */ |
| 2388 unbind_to (depth); | |
| 2389 | |
| 1292 | 2390 PROFILE_RECORD_EXITING_SECTION (Qnext_event); |
| 2391 | |
| 428 | 2392 UNGCPRO; |
| 853 | 2393 |
| 428 | 2394 return event; |
| 2395 } | |
| 2396 | |
| 2397 DEFUN ("next-command-event", Fnext_command_event, 0, 2, 0, /* | |
| 2398 Return the next available "user" event. | |
| 2399 Pass this object to `dispatch-event' to handle it. | |
| 2400 | |
| 2401 If EVENT is non-nil, it should be an event object and will be filled in | |
| 2402 and returned; otherwise a new event object will be created and returned. | |
| 2403 If PROMPT is non-nil, it should be a string and will be displayed in the | |
| 2404 echo area while this function is waiting for an event. | |
| 2405 | |
| 2406 The event returned will be a keyboard, mouse press, or mouse release event. | |
| 2407 If there are non-command events available (mouse motion, sub-process output, | |
| 2408 etc) then these will be executed (with `dispatch-event') and discarded. This | |
| 2409 function is provided as a convenience; it is roughly equivalent to the lisp code | |
| 2410 | |
| 2411 (while (progn | |
| 2412 (next-event event prompt) | |
| 2413 (not (or (key-press-event-p event) | |
| 2414 (button-press-event-p event) | |
| 2415 (button-release-event-p event) | |
| 2416 (misc-user-event-p event)))) | |
| 2417 (dispatch-event event)) | |
| 2418 | |
| 2419 but it also makes a provision for displaying keystrokes in the echo area. | |
| 2420 */ | |
| 2421 (event, prompt)) | |
| 2422 { | |
| 2423 /* This function can GC */ | |
| 2424 struct gcpro gcpro1; | |
| 2425 GCPRO1 (event); | |
| 934 | 2426 |
| 428 | 2427 maybe_echo_keys (XCOMMAND_BUILDER |
| 2428 (XCONSOLE (Vselected_console)-> | |
| 2429 command_builder), 0); /* #### This sucks bigtime */ | |
| 853 | 2430 |
| 428 | 2431 for (;;) |
| 2432 { | |
| 2433 event = Fnext_event (event, prompt); | |
| 2434 if (command_event_p (event)) | |
| 2435 break; | |
| 2436 else | |
| 2437 execute_internal_event (event); | |
| 2438 } | |
| 2439 UNGCPRO; | |
| 2440 return event; | |
| 2441 } | |
| 2442 | |
| 442 | 2443 DEFUN ("dispatch-non-command-events", Fdispatch_non_command_events, 0, 0, 0, /* |
| 2444 Dispatch any pending "magic" events. | |
| 2445 | |
| 2446 This function is useful for forcing the redisplay of native | |
| 2447 widgets. Normally these are redisplayed through a native window-system | |
| 2448 event encoded as magic event, rather than by the redisplay code. This | |
| 2449 function does not call redisplay or do any of the other things that | |
| 2450 `next-event' does. | |
| 2451 */ | |
| 2452 ()) | |
| 2453 { | |
| 2454 /* This function can GC */ | |
| 2455 Lisp_Object event = Qnil; | |
| 2456 struct gcpro gcpro1; | |
| 2457 GCPRO1 (event); | |
| 2458 event = Fmake_event (Qnil, Qnil); | |
| 2459 | |
| 2460 /* Make sure that there will be something in the native event queue | |
| 2461 so that externally managed things (e.g. widgets) get some CPU | |
| 2462 time. */ | |
| 2463 event_stream_force_event_pending (selected_frame ()); | |
| 2464 | |
| 2465 while (event_stream_event_pending_p (0)) | |
| 2466 { | |
| 2467 /* We're a generator of the command_event_queue, so we can't be a | |
| 2468 consumer as well. Also, we have no reason to consult the | |
| 2469 command_event_queue; there are only user and eval-events there, | |
| 2470 and we'd just have to put them back anyway. | |
| 2471 */ | |
| 2472 next_event_internal (event, 0); /* blocks */ | |
| 2473 if (XEVENT_TYPE (event) == magic_event || | |
| 2474 XEVENT_TYPE (event) == timeout_event || | |
| 2475 XEVENT_TYPE (event) == process_event || | |
| 2476 XEVENT_TYPE (event) == pointer_motion_event) | |
| 2477 execute_internal_event (event); | |
| 2478 else | |
| 2479 { | |
| 2480 enqueue_command_event_1 (event); | |
| 2481 break; | |
| 2482 } | |
| 2483 } | |
| 2484 | |
| 2485 Fdeallocate_event (event); | |
| 2486 UNGCPRO; | |
| 2487 return Qnil; | |
| 2488 } | |
| 2489 | |
| 428 | 2490 static void |
| 2491 reset_current_events (struct command_builder *command_builder) | |
| 2492 { | |
| 2493 Lisp_Object event = command_builder->current_events; | |
| 2494 reset_command_builder_event_chain (command_builder); | |
| 2495 if (EVENTP (event)) | |
| 2496 deallocate_event_chain (event); | |
| 2497 } | |
| 2498 | |
| 1268 | 2499 static int |
| 2286 | 2500 command_event_p_cb (Lisp_Object ev, void *UNUSED (the_data)) |
| 1268 | 2501 { |
| 2502 return command_event_p (ev); | |
| 2503 } | |
| 2504 | |
| 428 | 2505 DEFUN ("discard-input", Fdiscard_input, 0, 0, 0, /* |
| 2506 Discard any pending "user" events. | |
| 2507 Also cancel any kbd macro being defined. | |
| 2508 A user event is a key press, button press, button release, or | |
| 2509 "misc-user" event (menu selection or scrollbar action). | |
| 2510 */ | |
| 2511 ()) | |
| 2512 { | |
| 1318 | 2513 /* This can call Lisp */ |
| 1268 | 2514 Lisp_Object concons; |
| 2515 | |
| 2516 CONSOLE_LOOP (concons) | |
| 428 | 2517 { |
| 1268 | 2518 struct console *con = XCONSOLE (XCAR (concons)); |
| 2519 | |
| 2520 /* If a macro was being defined then we have to mark the modeline | |
| 2521 has changed to ensure that it gets updated correctly. */ | |
| 2522 if (!NILP (con->defining_kbd_macro)) | |
| 2523 MARK_MODELINE_CHANGED; | |
| 2524 con->defining_kbd_macro = Qnil; | |
| 2525 reset_current_events (XCOMMAND_BUILDER (con->command_builder)); | |
| 428 | 2526 } |
| 2527 | |
| 1268 | 2528 /* This function used to be a lot more complicated. Now, we just |
| 2529 drain the pending queue and discard all user events from the | |
| 2530 command and dispatch queues. */ | |
| 2531 event_stream_drain_queue (); | |
| 2532 | |
| 2533 map_event_chain_remove (command_event_p_cb, | |
| 2534 &dispatch_event_queue, &dispatch_event_queue_tail, | |
| 2535 0, MECR_DEALLOCATE_EVENT); | |
| 2536 map_event_chain_remove (command_event_p_cb, | |
| 2537 &command_event_queue, &command_event_queue_tail, | |
| 2538 0, MECR_DEALLOCATE_EVENT); | |
| 428 | 2539 |
| 2540 return Qnil; | |
| 2541 } | |
| 2542 | |
| 2543 | |
| 2544 /**********************************************************************/ | |
| 2545 /* pausing until an action occurs */ | |
| 2546 /**********************************************************************/ | |
| 2547 | |
| 2548 /* This is used in accept-process-output, sleep-for and sit-for. | |
| 2549 Before running any process_events in these routines, we set | |
| 1268 | 2550 recursive_sit_for to 1, and use this unwind protect to reset it to |
| 2551 Qnil upon exit. When recursive_sit_for is 1, calling sit-for will | |
| 428 | 2552 cause it to return immediately. |
| 2553 | |
| 2554 All of these routines install timeouts, so we clear the installed | |
| 2555 timeout as well. | |
| 2556 | |
| 2557 Note: It's very easy to break the desired behaviors of these | |
| 2558 3 routines. If you make any changes to anything in this area, run | |
| 2559 the regression tests at the bottom of the file. -- dmoore */ | |
| 2560 | |
| 2561 | |
| 2562 static Lisp_Object | |
| 2563 sit_for_unwind (Lisp_Object timeout_id) | |
| 2564 { | |
| 2565 if (!NILP(timeout_id)) | |
| 2566 Fdisable_timeout (timeout_id); | |
| 2567 | |
| 1268 | 2568 recursive_sit_for = 0; |
| 428 | 2569 return Qnil; |
| 2570 } | |
| 2571 | |
| 2572 /* #### Is (accept-process-output nil 3) supposed to be like (sleep-for 3)? | |
| 2573 */ | |
| 2574 | |
| 2575 DEFUN ("accept-process-output", Faccept_process_output, 0, 3, 0, /* | |
| 2576 Allow any pending output from subprocesses to be read by Emacs. | |
| 2577 It is read into the process' buffers or given to their filter functions. | |
| 2578 Non-nil arg PROCESS means do not return until some output has been received | |
| 2579 from PROCESS. Nil arg PROCESS means do not return until some output has | |
| 2580 been received from any process. | |
| 2581 If the second arg is non-nil, it is the maximum number of seconds to wait: | |
| 2582 this function will return after that much time even if no input has arrived | |
| 2583 from PROCESS. This argument may be a float, meaning wait some fractional | |
| 2584 part of a second. | |
| 2585 If the third arg is non-nil, it is a number of milliseconds that is added | |
| 2586 to the second arg. (This exists only for compatibility.) | |
| 2587 Return non-nil iff we received any output before the timeout expired. | |
| 2588 */ | |
| 2589 (process, timeout_secs, timeout_msecs)) | |
| 2590 { | |
| 2591 /* This function can GC */ | |
| 2592 struct gcpro gcpro1, gcpro2; | |
| 2593 Lisp_Object event = Qnil; | |
| 2594 Lisp_Object result = Qnil; | |
| 2595 int timeout_id = -1; | |
| 2596 int timeout_enabled = 0; | |
| 2597 int done = 0; | |
| 2598 struct buffer *old_buffer = current_buffer; | |
| 2599 int count; | |
| 2600 | |
| 2601 /* We preserve the current buffer but nothing else. If a focus | |
| 2602 change alters the selected window then the top level event loop | |
| 2603 will eventually alter current_buffer to match. In the mean time | |
| 2604 we don't want to mess up whatever called this function. */ | |
| 2605 | |
| 2606 if (!NILP (process)) | |
| 2607 CHECK_PROCESS (process); | |
| 2608 | |
| 2609 GCPRO2 (event, process); | |
| 2610 | |
| 2611 if (!NILP (timeout_secs) || !NILP (timeout_msecs)) | |
| 2612 { | |
| 2613 unsigned long msecs = 0; | |
| 2614 if (!NILP (timeout_secs)) | |
| 2615 msecs = lisp_number_to_milliseconds (timeout_secs, 1); | |
| 2616 if (!NILP (timeout_msecs)) | |
| 2617 { | |
| 2618 CHECK_NATNUM (timeout_msecs); | |
| 2619 msecs += XINT (timeout_msecs); | |
| 2620 } | |
| 2621 if (msecs) | |
| 2622 { | |
| 2623 timeout_id = event_stream_generate_wakeup (msecs, 0, Qnil, Qnil, 0); | |
| 2624 timeout_enabled = 1; | |
| 2625 } | |
| 2626 } | |
| 2627 | |
| 2628 event = Fmake_event (Qnil, Qnil); | |
| 2629 | |
| 2630 count = specpdl_depth (); | |
| 2631 record_unwind_protect (sit_for_unwind, | |
| 2632 timeout_enabled ? make_int (timeout_id) : Qnil); | |
| 1268 | 2633 recursive_sit_for = 1; |
| 428 | 2634 |
| 2635 while (!done && | |
| 2636 ((NILP (process) && timeout_enabled) || | |
| 2637 (NILP (process) && event_stream_event_pending_p (0)) || | |
| 2638 (!NILP (process)))) | |
| 2639 /* Calling detect_input_pending() is the wrong thing here, because | |
| 2640 that considers the Vunread_command_events and command_event_queue. | |
| 2641 We don't need to look at the command_event_queue because we are | |
| 2642 only interested in process events, which don't go on that. In | |
| 2643 fact, we can't read from it anyway, because we put stuff on it. | |
| 2644 | |
| 2645 Note that event_stream->event_pending_p must be called in such | |
| 2646 a way that it says whether any events *of any kind* are ready, | |
| 2647 not just user events, or (accept-process-output nil) will fail | |
| 2648 to dispatch any process events that may be on the queue. It is | |
| 2649 not clear to me that this is important, because the top-level | |
| 2650 loop will process it, and I don't think that there is ever a | |
| 2651 time when one calls accept-process-output with a nil argument | |
| 2652 and really need the processes to be handled. */ | |
| 2653 { | |
| 2654 /* If our timeout has arrived, we move along. */ | |
| 2655 if (timeout_enabled && !event_stream_wakeup_pending_p (timeout_id, 0)) | |
| 2656 { | |
| 2657 timeout_enabled = 0; | |
| 2658 done = 1; /* We're done. */ | |
| 2659 continue; /* Don't call next_event_internal */ | |
| 2660 } | |
| 2661 | |
| 2662 next_event_internal (event, 0); | |
| 2663 switch (XEVENT_TYPE (event)) | |
| 2664 { | |
| 2665 case process_event: | |
| 2666 { | |
| 2667 if (NILP (process) || | |
| 1204 | 2668 EQ (XEVENT_PROCESS_PROCESS (event), process)) |
| 428 | 2669 { |
| 2670 done = 1; | |
| 2671 /* RMS's version always returns nil when proc is nil, | |
| 2672 and only returns t if input ever arrived on proc. */ | |
| 2673 result = Qt; | |
| 2674 } | |
| 2675 | |
| 2676 execute_internal_event (event); | |
| 2677 break; | |
| 2678 } | |
| 2679 case timeout_event: | |
| 2680 /* We execute the event even if it's ours, and notice that it's | |
| 2681 happened above. */ | |
| 2682 case pointer_motion_event: | |
| 2683 case magic_event: | |
| 2684 { | |
| 2685 execute_internal_event (event); | |
| 2686 break; | |
| 2687 } | |
| 2688 default: | |
| 2689 { | |
| 2690 enqueue_command_event_1 (event); | |
| 2691 break; | |
| 2692 } | |
| 2693 } | |
| 2694 } | |
| 2695 | |
| 771 | 2696 unbind_to_1 (count, timeout_enabled ? make_int (timeout_id) : Qnil); |
| 428 | 2697 |
| 2698 Fdeallocate_event (event); | |
| 853 | 2699 |
| 2700 status_notify (); | |
| 2701 | |
| 428 | 2702 UNGCPRO; |
| 2703 current_buffer = old_buffer; | |
| 2704 return result; | |
| 2705 } | |
| 2706 | |
| 2707 DEFUN ("sleep-for", Fsleep_for, 1, 1, 0, /* | |
| 444 | 2708 Pause, without updating display, for SECONDS seconds. |
| 2709 SECONDS may be a float, allowing pauses for fractional parts of a second. | |
| 428 | 2710 |
| 2711 It is recommended that you never call sleep-for from inside of a process | |
| 444 | 2712 filter function or timer event (either synchronous or asynchronous). |
| 428 | 2713 */ |
| 2714 (seconds)) | |
| 2715 { | |
| 2716 /* This function can GC */ | |
| 2717 unsigned long msecs = lisp_number_to_milliseconds (seconds, 1); | |
| 2718 int id; | |
| 2719 Lisp_Object event = Qnil; | |
| 2720 int count; | |
| 2721 struct gcpro gcpro1; | |
| 2722 | |
| 2723 GCPRO1 (event); | |
| 2724 | |
| 2725 id = event_stream_generate_wakeup (msecs, 0, Qnil, Qnil, 0); | |
| 2726 event = Fmake_event (Qnil, Qnil); | |
| 2727 | |
| 2728 count = specpdl_depth (); | |
| 2729 record_unwind_protect (sit_for_unwind, make_int (id)); | |
| 1268 | 2730 recursive_sit_for = 1; |
| 428 | 2731 |
| 2732 while (1) | |
| 2733 { | |
| 2734 /* If our timeout has arrived, we move along. */ | |
| 2735 if (!event_stream_wakeup_pending_p (id, 0)) | |
| 2736 goto DONE_LABEL; | |
| 2737 | |
| 2738 /* We're a generator of the command_event_queue, so we can't be a | |
| 2739 consumer as well. We don't care about command and eval-events | |
| 2740 anyway. | |
| 2741 */ | |
| 2742 next_event_internal (event, 0); /* blocks */ | |
| 2743 switch (XEVENT_TYPE (event)) | |
| 2744 { | |
| 2745 case timeout_event: | |
| 2746 /* We execute the event even if it's ours, and notice that it's | |
| 2747 happened above. */ | |
| 2748 case process_event: | |
| 2749 case pointer_motion_event: | |
| 2750 case magic_event: | |
| 2751 { | |
| 2752 execute_internal_event (event); | |
| 2753 break; | |
| 2754 } | |
| 2755 default: | |
| 2756 { | |
| 2757 enqueue_command_event_1 (event); | |
| 2758 break; | |
| 2759 } | |
| 2760 } | |
| 2761 } | |
| 2762 DONE_LABEL: | |
| 771 | 2763 unbind_to_1 (count, make_int (id)); |
| 428 | 2764 Fdeallocate_event (event); |
| 2765 UNGCPRO; | |
| 2766 return Qnil; | |
| 2767 } | |
| 2768 | |
| 2769 DEFUN ("sit-for", Fsit_for, 1, 2, 0, /* | |
| 444 | 2770 Perform redisplay, then wait SECONDS seconds or until user input is available. |
| 2771 SECONDS may be a float, meaning a fractional part of a second. | |
| 2772 Optional second arg NODISPLAY non-nil means don't redisplay; just wait. | |
| 428 | 2773 Redisplay is preempted as always if user input arrives, and does not |
| 2774 happen if input is available before it starts. | |
| 2775 Value is t if waited the full time with no input arriving. | |
| 2776 | |
| 2777 If sit-for is called from within a process filter function or timer | |
| 2778 event (either synchronous or asynchronous) it will return immediately. | |
| 2779 */ | |
| 2780 (seconds, nodisplay)) | |
| 2781 { | |
| 2782 /* This function can GC */ | |
| 2783 unsigned long msecs = lisp_number_to_milliseconds (seconds, 1); | |
| 2784 Lisp_Object event, result; | |
| 2785 struct gcpro gcpro1; | |
| 2786 int id; | |
| 2787 int count; | |
| 2788 | |
| 2789 /* The unread-command-events count as pending input */ | |
| 2790 if (!NILP (Vunread_command_events) || !NILP (Vunread_command_event)) | |
| 2791 return Qnil; | |
| 2792 | |
| 2793 /* If the command-builder already has user-input on it (not eval events) | |
| 2794 then that means we're done too. | |
| 2795 */ | |
| 2796 if (!NILP (command_event_queue)) | |
| 2797 { | |
| 2798 EVENT_CHAIN_LOOP (event, command_event_queue) | |
| 2799 { | |
| 2800 if (command_event_p (event)) | |
| 2801 return Qnil; | |
| 2802 } | |
| 2803 } | |
| 2804 | |
| 2805 /* If we're in a macro, or noninteractive, or early in temacs, then | |
| 2806 don't wait. */ | |
| 2807 if (noninteractive || !NILP (Vexecuting_macro)) | |
| 2808 return Qnil; | |
| 2809 | |
| 2810 /* Recursive call from a filter function or timeout handler. */ | |
| 1268 | 2811 if (recursive_sit_for) |
| 428 | 2812 { |
| 2813 if (!event_stream_event_pending_p (1) && NILP (nodisplay)) | |
| 2814 redisplay (); | |
| 2815 return Qnil; | |
| 2816 } | |
| 2817 | |
| 2818 | |
| 2819 /* Otherwise, start reading events from the event_stream. | |
| 2820 Do this loop at least once even if (sit-for 0) so that we | |
| 2821 redisplay when no input pending. | |
| 2822 */ | |
| 2823 GCPRO1 (event); | |
| 2824 event = Fmake_event (Qnil, Qnil); | |
| 2825 | |
| 2826 /* Generate the wakeup even if MSECS is 0, so that existing timeout/etc. | |
| 2827 events get processed. The old (pre-19.12) code special-cased this | |
| 2828 and didn't generate a wakeup, but the resulting behavior was less than | |
| 2829 ideal; viz. the occurrence of (sit-for 0.001) scattered throughout | |
| 2830 the E-Lisp universe. */ | |
| 2831 | |
| 2832 id = event_stream_generate_wakeup (msecs, 0, Qnil, Qnil, 0); | |
| 2833 | |
| 2834 count = specpdl_depth (); | |
| 2835 record_unwind_protect (sit_for_unwind, make_int (id)); | |
| 1268 | 2836 recursive_sit_for = 1; |
| 428 | 2837 |
| 2838 while (1) | |
| 2839 { | |
| 2840 /* If there is no user input pending, then redisplay. | |
| 2841 */ | |
| 2842 if (!event_stream_event_pending_p (1) && NILP (nodisplay)) | |
| 2843 redisplay (); | |
| 2844 | |
| 2845 /* If our timeout has arrived, we move along. */ | |
| 2846 if (!event_stream_wakeup_pending_p (id, 0)) | |
| 2847 { | |
| 2848 result = Qt; | |
| 2849 goto DONE_LABEL; | |
| 2850 } | |
| 2851 | |
| 2852 /* We're a generator of the command_event_queue, so we can't be a | |
| 2853 consumer as well. In fact, we know there's nothing on the | |
| 2854 command_event_queue that we didn't just put there. | |
| 2855 */ | |
| 2856 next_event_internal (event, 0); /* blocks */ | |
| 2857 | |
| 2858 if (command_event_p (event)) | |
| 2859 { | |
| 2860 result = Qnil; | |
| 2861 goto DONE_LABEL; | |
| 2862 } | |
| 2863 switch (XEVENT_TYPE (event)) | |
| 2864 { | |
| 2865 case eval_event: | |
| 2866 { | |
| 2867 /* eval-events get delayed until later. */ | |
| 2868 enqueue_command_event (Fcopy_event (event, Qnil)); | |
| 2869 break; | |
| 2870 } | |
| 2871 | |
| 2872 case timeout_event: | |
| 2873 /* We execute the event even if it's ours, and notice that it's | |
| 2874 happened above. */ | |
| 2875 default: | |
| 2876 { | |
| 2877 execute_internal_event (event); | |
| 2878 break; | |
| 2879 } | |
| 2880 } | |
| 2881 } | |
| 2882 | |
| 2883 DONE_LABEL: | |
| 771 | 2884 unbind_to_1 (count, make_int (id)); |
| 428 | 2885 |
| 2886 /* Put back the event (if any) that made Fsit_for() exit before the | |
| 2887 timeout. Note that it is being added to the back of the queue, which | |
| 2888 would be inappropriate if there were any user events on the queue | |
| 2889 already: we would be misordering them. But we know that there are | |
| 2890 no user-events on the queue, or else we would not have reached this | |
| 2891 point at all. | |
| 2892 */ | |
| 2893 if (NILP (result)) | |
| 2894 enqueue_command_event (event); | |
| 2895 else | |
| 2896 Fdeallocate_event (event); | |
| 2897 | |
| 2898 UNGCPRO; | |
| 2899 return result; | |
| 2900 } | |
| 2901 | |
| 442 | 2902 /* This handy little function is used by select-x.c to wait for replies |
| 2903 from processes that aren't really processes (e.g. the X server) */ | |
| 428 | 2904 void |
| 2905 wait_delaying_user_input (int (*predicate) (void *arg), void *predicate_arg) | |
| 2906 { | |
| 2907 /* This function can GC */ | |
| 2908 Lisp_Object event = Fmake_event (Qnil, Qnil); | |
| 2909 struct gcpro gcpro1; | |
| 2910 GCPRO1 (event); | |
| 2911 | |
| 2912 while (!(*predicate) (predicate_arg)) | |
| 2913 { | |
| 2914 /* We're a generator of the command_event_queue, so we can't be a | |
| 2915 consumer as well. Also, we have no reason to consult the | |
| 2916 command_event_queue; there are only user and eval-events there, | |
| 2917 and we'd just have to put them back anyway. | |
| 2918 */ | |
| 2919 next_event_internal (event, 0); | |
| 2920 if (command_event_p (event) | |
| 2921 || (XEVENT_TYPE (event) == eval_event) | |
| 2922 || (XEVENT_TYPE (event) == magic_eval_event)) | |
| 2923 enqueue_command_event_1 (event); | |
| 2924 else | |
| 2925 execute_internal_event (event); | |
| 2926 } | |
| 2927 UNGCPRO; | |
| 2928 } | |
| 2929 | |
| 2930 | |
| 2931 /**********************************************************************/ | |
| 2932 /* dispatching events; command builder */ | |
| 2933 /**********************************************************************/ | |
| 2934 | |
| 2935 static void | |
| 2936 execute_internal_event (Lisp_Object event) | |
| 2937 { | |
| 1292 | 2938 PROFILE_DECLARE (); |
| 2939 | |
| 428 | 2940 /* events on dead channels get silently eaten */ |
| 2941 if (object_dead_p (XEVENT (event)->channel)) | |
| 2942 return; | |
| 2943 | |
| 1292 | 2944 PROFILE_RECORD_ENTERING_SECTION (QSexecute_internal_event); |
| 2945 | |
| 428 | 2946 /* This function can GC */ |
| 2947 switch (XEVENT_TYPE (event)) | |
| 2948 { | |
| 2949 case empty_event: | |
| 1292 | 2950 goto done; |
| 428 | 2951 |
| 2952 case eval_event: | |
| 2953 { | |
| 1204 | 2954 call1 (XEVENT_EVAL_FUNCTION (event), |
| 2955 XEVENT_EVAL_OBJECT (event)); | |
| 1292 | 2956 goto done; |
| 428 | 2957 } |
| 2958 | |
| 2959 case magic_eval_event: | |
| 2960 { | |
| 1204 | 2961 XEVENT_MAGIC_EVAL_INTERNAL_FUNCTION (event) |
| 2962 XEVENT_MAGIC_EVAL_OBJECT (event); | |
| 1292 | 2963 goto done; |
| 428 | 2964 } |
| 2965 | |
| 2966 case pointer_motion_event: | |
| 2967 { | |
| 2968 if (!NILP (Vmouse_motion_handler)) | |
| 2969 call1 (Vmouse_motion_handler, event); | |
| 1292 | 2970 goto done; |
| 428 | 2971 } |
| 2972 | |
| 2973 case process_event: | |
| 2974 { | |
| 1204 | 2975 Lisp_Object p = XEVENT_PROCESS_PROCESS (event); |
| 428 | 2976 Charcount readstatus; |
| 853 | 2977 int iter; |
| 2978 | |
| 2979 assert (PROCESSP (p)); | |
| 2980 for (iter = 0; iter < 2; iter++) | |
| 2981 { | |
| 2982 if (iter == 1 && !process_has_separate_stderr (p)) | |
| 2983 break; | |
| 2984 while ((readstatus = read_process_output (p, iter)) > 0) | |
| 2985 ; | |
| 2986 if (readstatus > 0) | |
| 2987 ; /* this clauses never gets executed but | |
| 2988 allows the #ifdefs to work cleanly. */ | |
| 428 | 2989 #ifdef EWOULDBLOCK |
| 853 | 2990 else if (readstatus == -1 && errno == EWOULDBLOCK) |
| 2991 ; | |
| 428 | 2992 #endif /* EWOULDBLOCK */ |
| 2993 #ifdef EAGAIN | |
| 853 | 2994 else if (readstatus == -1 && errno == EAGAIN) |
| 2995 ; | |
| 428 | 2996 #endif /* EAGAIN */ |
| 853 | 2997 else if ((readstatus == 0 && |
| 2998 /* Note that we cannot distinguish between no input | |
| 2999 available now and a closed pipe. | |
| 3000 With luck, a closed pipe will be accompanied by | |
| 3001 subprocess termination and SIGCHLD. */ | |
| 3002 (!network_connection_p (p) || | |
| 3003 /* | |
| 3004 When connected to ToolTalk (i.e. | |
| 3005 connected_via_filedesc_p()), it's not possible to | |
| 3006 reliably determine whether there is a message | |
| 3007 waiting for ToolTalk to receive. ToolTalk expects | |
| 3008 to have tt_message_receive() called exactly once | |
| 3009 every time the file descriptor becomes active, so | |
| 3010 the filter function forces this by returning 0. | |
| 3011 Emacs must not interpret this as a closed pipe. */ | |
| 3012 connected_via_filedesc_p (XPROCESS (p)))) | |
| 3013 | |
| 3014 /* On some OSs with ptys, when the process on one end of | |
| 3015 a pty exits, the other end gets an error reading with | |
| 3016 errno = EIO instead of getting an EOF (0 bytes read). | |
| 3017 Therefore, if we get an error reading and errno = | |
| 3018 EIO, just continue, because the child process has | |
| 3019 exited and should clean itself up soon (e.g. when we | |
| 3020 get a SIGCHLD). */ | |
| 535 | 3021 #ifdef EIO |
| 853 | 3022 || (readstatus == -1 && errno == EIO) |
| 428 | 3023 #endif |
| 535 | 3024 |
| 853 | 3025 ) |
| 3026 { | |
| 3027 /* Currently, we rely on SIGCHLD to indicate that the | |
| 3028 process has terminated. Unfortunately, on some systems | |
| 3029 the SIGCHLD gets missed some of the time. So we put an | |
| 3030 additional check in status_notify() to see whether a | |
| 3031 process has terminated. We must tell status_notify() | |
| 3032 to enable that check, and we do so now. */ | |
| 3033 kick_status_notify (); | |
| 3034 } | |
| 898 | 3035 else |
| 3036 { | |
| 3037 /* Deactivate network connection */ | |
| 3038 Lisp_Object status = Fprocess_status (p); | |
| 3039 if (EQ (status, Qopen) | |
| 3040 /* In case somebody changes the theory of whether to | |
| 3041 return open as opposed to run for network connection | |
| 3042 "processes"... */ | |
| 3043 || EQ (status, Qrun)) | |
| 3044 update_process_status (p, Qexit, 256, 0); | |
| 3045 deactivate_process (p); | |
| 3046 status_notify (); | |
| 3047 } | |
| 853 | 3048 |
| 3049 /* We must call status_notify here to allow the | |
| 3050 event_stream->unselect_process_cb to be run if appropriate. | |
| 3051 Otherwise, dead fds may be selected for, and we will get a | |
| 3052 continuous stream of process events for them. Since we don't | |
| 3053 return until all process events have been flushed, we would | |
| 3054 get stuck here, processing events on a process whose status | |
| 3025 | 3055 was `exit'. Call this after dispatch-event, or the fds will |
| 853 | 3056 have been closed before we read the last data from them. |
| 3057 It's safe for the filter to signal an error because | |
| 3058 status_notify() will be called on return to top-level. | |
| 3059 */ | |
| 3060 status_notify (); | |
| 428 | 3061 } |
| 1292 | 3062 goto done; |
| 428 | 3063 } |
| 3064 | |
| 3065 case timeout_event: | |
| 3066 { | |
| 440 | 3067 Lisp_Event *e = XEVENT (event); |
| 934 | 3068 |
| 1204 | 3069 if (!NILP (EVENT_TIMEOUT_FUNCTION (e))) |
| 3070 call1 (EVENT_TIMEOUT_FUNCTION (e), | |
| 3071 EVENT_TIMEOUT_OBJECT (e)); | |
| 1292 | 3072 goto done; |
| 428 | 3073 } |
| 3074 case magic_event: | |
| 3075 event_stream_handle_magic_event (XEVENT (event)); | |
| 1292 | 3076 goto done; |
| 428 | 3077 default: |
| 2500 | 3078 ABORT (); |
| 428 | 3079 } |
| 1292 | 3080 |
| 3081 done: | |
| 3082 PROFILE_RECORD_EXITING_SECTION (QSexecute_internal_event); | |
| 428 | 3083 } |
| 3084 | |
| 3085 | |
| 3086 | |
| 3087 static void | |
| 3088 this_command_keys_replace_suffix (Lisp_Object suffix, Lisp_Object chain) | |
| 3089 { | |
| 3090 Lisp_Object first_before_suffix = | |
| 3091 event_chain_find_previous (Vthis_command_keys, suffix); | |
| 3092 | |
| 3093 if (NILP (first_before_suffix)) | |
| 3094 Vthis_command_keys = chain; | |
| 3095 else | |
| 3096 XSET_EVENT_NEXT (first_before_suffix, chain); | |
| 3097 deallocate_event_chain (suffix); | |
| 3098 Vthis_command_keys_tail = event_chain_tail (chain); | |
| 3099 } | |
| 3100 | |
| 3101 static void | |
| 3102 command_builder_replace_suffix (struct command_builder *builder, | |
| 3103 Lisp_Object suffix, Lisp_Object chain) | |
| 3104 { | |
| 3105 Lisp_Object first_before_suffix = | |
| 3106 event_chain_find_previous (builder->current_events, suffix); | |
| 3107 | |
| 3108 if (NILP (first_before_suffix)) | |
| 3109 builder->current_events = chain; | |
| 3110 else | |
| 3111 XSET_EVENT_NEXT (first_before_suffix, chain); | |
| 3112 deallocate_event_chain (suffix); | |
| 3113 builder->most_current_event = event_chain_tail (chain); | |
| 3114 } | |
| 3115 | |
| 3116 static Lisp_Object | |
| 3117 command_builder_find_leaf_1 (struct command_builder *builder) | |
| 3118 { | |
| 3119 Lisp_Object event0 = builder->current_events; | |
| 3120 | |
| 3121 if (NILP (event0)) | |
| 3122 return Qnil; | |
| 3123 | |
| 3124 return event_binding (event0, 1); | |
| 3125 } | |
| 3126 | |
| 1268 | 3127 static void |
| 3128 maybe_kbd_translate (Lisp_Object event) | |
| 3129 { | |
| 3130 Ichar c; | |
| 3131 int did_translate = 0; | |
| 3132 | |
| 3133 if (XEVENT_TYPE (event) != key_press_event) | |
| 3134 return; | |
| 3135 if (!HASH_TABLEP (Vkeyboard_translate_table)) | |
| 3136 return; | |
| 3137 if (EQ (Fhash_table_count (Vkeyboard_translate_table), Qzero)) | |
| 3138 return; | |
| 3139 | |
| 2828 | 3140 c = event_to_character (event, 0, 0); |
| 1268 | 3141 if (c != -1) |
| 3142 { | |
| 3143 Lisp_Object traduit = Fgethash (make_char (c), Vkeyboard_translate_table, | |
| 3144 Qnil); | |
| 3145 if (!NILP (traduit) && SYMBOLP (traduit)) | |
| 3146 { | |
| 3147 XSET_EVENT_KEY_KEYSYM (event, traduit); | |
| 3148 XSET_EVENT_KEY_MODIFIERS (event, 0); | |
| 3149 did_translate = 1; | |
| 3150 } | |
| 3151 else if (CHARP (traduit)) | |
| 3152 { | |
| 3153 /* This used to call Fcharacter_to_event() directly into EVENT, | |
| 3154 but that can eradicate timestamps and other such stuff. | |
| 3155 This way is safer. */ | |
| 3156 Lisp_Object ev2 = Fmake_event (Qnil, Qnil); | |
| 3157 | |
| 3158 character_to_event (XCHAR (traduit), XEVENT (ev2), | |
|
4780
2fd201d73a92
Call character_to_event on characters received from XIM, event-Xt.c
Aidan Kehoe <kehoea@parhasard.net>
parents:
4775
diff
changeset
|
3159 XCONSOLE (XEVENT_CHANNEL (event)), |
|
2fd201d73a92
Call character_to_event on characters received from XIM, event-Xt.c
Aidan Kehoe <kehoea@parhasard.net>
parents:
4775
diff
changeset
|
3160 high_bit_is_meta, 1); |
| 1268 | 3161 XSET_EVENT_KEY_KEYSYM (event, XEVENT_KEY_KEYSYM (ev2)); |
| 3162 XSET_EVENT_KEY_MODIFIERS (event, XEVENT_KEY_MODIFIERS (ev2)); | |
| 3163 Fdeallocate_event (ev2); | |
| 3164 did_translate = 1; | |
| 3165 } | |
| 3166 } | |
| 3167 | |
| 3168 if (!did_translate) | |
| 3169 { | |
| 3170 Lisp_Object traduit = Fgethash (XEVENT_KEY_KEYSYM (event), | |
| 3171 Vkeyboard_translate_table, Qnil); | |
| 3172 if (!NILP (traduit) && SYMBOLP (traduit)) | |
| 3173 { | |
| 3174 XSET_EVENT_KEY_KEYSYM (event, traduit); | |
| 3175 did_translate = 1; | |
| 3176 } | |
| 3177 else if (CHARP (traduit)) | |
| 3178 { | |
| 3179 /* This used to call Fcharacter_to_event() directly into EVENT, | |
| 3180 but that can eradicate timestamps and other such stuff. | |
| 3181 This way is safer. */ | |
| 3182 Lisp_Object ev2 = Fmake_event (Qnil, Qnil); | |
| 3183 | |
| 3184 character_to_event (XCHAR (traduit), XEVENT (ev2), | |
|
4780
2fd201d73a92
Call character_to_event on characters received from XIM, event-Xt.c
Aidan Kehoe <kehoea@parhasard.net>
parents:
4775
diff
changeset
|
3185 XCONSOLE (XEVENT_CHANNEL (event)), |
|
2fd201d73a92
Call character_to_event on characters received from XIM, event-Xt.c
Aidan Kehoe <kehoea@parhasard.net>
parents:
4775
diff
changeset
|
3186 high_bit_is_meta, 1); |
| 1268 | 3187 XSET_EVENT_KEY_KEYSYM (event, XEVENT_KEY_KEYSYM (ev2)); |
| 3188 XSET_EVENT_KEY_MODIFIERS (event, | |
| 3189 XEVENT_KEY_MODIFIERS (event) | | |
| 3190 XEVENT_KEY_MODIFIERS (ev2)); | |
| 3191 | |
| 3192 Fdeallocate_event (ev2); | |
| 3193 did_translate = 1; | |
| 3194 } | |
| 3195 } | |
| 3196 | |
| 3197 #ifdef DEBUG_XEMACS | |
| 3198 if (did_translate) | |
| 3199 DEBUG_PRINT_EMACS_EVENT ("->keyboard-translate-table", event); | |
| 3200 #endif | |
| 3201 } | |
| 3202 | |
| 428 | 3203 /* See if we can do function-key-map or key-translation-map translation |
| 3204 on the current events in the command builder. If so, do this, and | |
| 771 | 3205 return the resulting binding, if any. |
| 3206 | |
| 3207 DID_MUNGE must be initialized before calling this function. If munging | |
| 3208 happened, DID_MUNGE will be non-zero; otherwise, it will be left alone. | |
| 3209 */ | |
| 428 | 3210 |
| 3211 static Lisp_Object | |
| 3212 munge_keymap_translate (struct command_builder *builder, | |
| 3213 enum munge_me_out_the_door munge, | |
| 771 | 3214 int has_normal_binding_p, int *did_munge) |
| 428 | 3215 { |
| 3216 Lisp_Object suffix; | |
| 3217 | |
| 1204 | 3218 EVENT_CHAIN_LOOP (suffix, builder->first_mungeable_event[munge]) |
| 428 | 3219 { |
| 3220 Lisp_Object result = munging_key_map_event_binding (suffix, munge); | |
| 3221 | |
| 3222 if (NILP (result)) | |
| 3223 continue; | |
| 3224 | |
| 3225 if (KEYMAPP (result)) | |
| 3226 { | |
| 3227 if (NILP (builder->last_non_munged_event) | |
| 3228 && !has_normal_binding_p) | |
| 3229 builder->last_non_munged_event = builder->most_current_event; | |
| 3230 } | |
| 3231 else | |
| 3232 builder->last_non_munged_event = Qnil; | |
| 3233 | |
| 3234 if (!KEYMAPP (result) && | |
| 3235 !VECTORP (result) && | |
| 3236 !STRINGP (result)) | |
| 3237 { | |
| 3238 struct gcpro gcpro1; | |
| 3239 GCPRO1 (suffix); | |
| 3240 result = call1 (result, Qnil); | |
| 3241 UNGCPRO; | |
| 3242 if (NILP (result)) | |
| 3243 return Qnil; | |
| 3244 } | |
| 3245 | |
| 3246 if (KEYMAPP (result)) | |
| 3247 return result; | |
| 3248 | |
| 3249 if (VECTORP (result) || STRINGP (result)) | |
| 3250 { | |
| 3251 Lisp_Object new_chain = key_sequence_to_event_chain (result); | |
| 3252 Lisp_Object tempev; | |
| 3253 | |
| 3254 /* If the first_mungeable_event of the other munger is | |
| 3255 within the events we're munging, then it will point to | |
| 3256 deallocated events afterwards, which is bad -- so make it | |
| 3257 point at the beginning of the munged events. */ | |
| 3258 EVENT_CHAIN_LOOP (tempev, suffix) | |
| 3259 { | |
| 3260 Lisp_Object *mungeable_event = | |
| 1204 | 3261 &builder->first_mungeable_event[1 - munge]; |
| 428 | 3262 if (EQ (tempev, *mungeable_event)) |
| 3263 { | |
| 3264 *mungeable_event = new_chain; | |
| 3265 break; | |
| 3266 } | |
| 3267 } | |
| 3268 | |
| 771 | 3269 /* Now munge the current event chain in the command builder. */ |
| 428 | 3270 command_builder_replace_suffix (builder, suffix, new_chain); |
| 1204 | 3271 builder->first_mungeable_event[munge] = Qnil; |
| 771 | 3272 |
| 3273 *did_munge = 1; | |
| 428 | 3274 |
| 793 | 3275 return command_builder_find_leaf_1 (builder); |
| 428 | 3276 } |
| 3277 | |
| 563 | 3278 signal_error (Qinvalid_key_binding, |
| 3279 (munge == MUNGE_ME_FUNCTION_KEY ? | |
| 3280 "Invalid binding in function-key-map" : | |
| 3281 "Invalid binding in key-translation-map"), | |
| 3282 result); | |
| 428 | 3283 } |
| 3284 | |
| 3285 return Qnil; | |
| 3286 } | |
| 3287 | |
| 2828 | 3288 /* Same as command_builder_find_leaf() below, but without offering the |
| 3289 platform-specific event code the opportunity to give a default binding of | |
| 3290 an unseen keysym to self-insert-command, and without the fallback to | |
| 3291 other keymaps for lookups that allows someone with a Cyrillic keyboard | |
| 3292 to pretend it's Qwerty for C-x C-f, for example. */ | |
| 771 | 3293 |
| 428 | 3294 static Lisp_Object |
| 2828 | 3295 command_builder_find_leaf_no_jit_binding (struct command_builder *builder, |
| 771 | 3296 int allow_misc_user_events_p, |
| 3297 int *did_munge) | |
| 428 | 3298 { |
| 3299 /* This function can GC */ | |
| 3300 Lisp_Object result; | |
| 3301 Lisp_Object evee = builder->current_events; | |
| 3302 | |
| 3303 if (XEVENT_TYPE (evee) == misc_user_event) | |
| 3304 { | |
| 3305 if (allow_misc_user_events_p && (NILP (XEVENT_NEXT (evee)))) | |
| 1204 | 3306 return list2 (XEVENT_EVAL_FUNCTION (evee), |
| 3307 XEVENT_EVAL_OBJECT (evee)); | |
| 428 | 3308 else |
| 3309 return Qnil; | |
| 3310 } | |
| 3311 | |
| 442 | 3312 /* if we're currently in a menu accelerator, check there for further |
| 3313 events */ | |
| 3314 /* #### fuck me! who wrote this crap? think "abstraction", baby. */ | |
| 771 | 3315 /* #### this horribly-written crap can mess with global state, which |
| 3316 this function should not do. i'm not fixing it now. someone | |
| 3317 needs to go and rewrite that shit correctly. --ben */ | |
| 1268 | 3318 #if defined (HAVE_X_WINDOWS) && defined (LWLIB_MENUBARS_LUCID) |
| 442 | 3319 if (x_kludge_lw_menu_active ()) |
| 428 | 3320 { |
| 3321 return command_builder_operate_menu_accelerator (builder); | |
| 3322 } | |
| 3323 else | |
| 3324 { | |
| 3325 result = Qnil; | |
| 3326 if (EQ (Vmenu_accelerator_enabled, Qmenu_force)) | |
| 3327 result = command_builder_find_menu_accelerator (builder); | |
| 3328 if (NILP (result)) | |
| 3329 #endif | |
| 3330 result = command_builder_find_leaf_1 (builder); | |
| 1268 | 3331 #if defined (HAVE_X_WINDOWS) && defined (LWLIB_MENUBARS_LUCID) |
| 428 | 3332 if (NILP (result) |
| 3333 && EQ (Vmenu_accelerator_enabled, Qmenu_fallback)) | |
| 3334 result = command_builder_find_menu_accelerator (builder); | |
| 3335 } | |
| 3336 #endif | |
| 3337 | |
| 3338 /* Check to see if we have a potential function-key-map match. */ | |
| 3339 if (NILP (result)) | |
| 771 | 3340 result = munge_keymap_translate (builder, MUNGE_ME_FUNCTION_KEY, 0, |
| 3341 did_munge); | |
| 3342 | |
| 428 | 3343 /* Check to see if we have a potential key-translation-map match. */ |
| 3344 { | |
| 3345 Lisp_Object key_translate_result = | |
| 3346 munge_keymap_translate (builder, MUNGE_ME_KEY_TRANSLATION, | |
| 771 | 3347 !NILP (result), did_munge); |
| 428 | 3348 if (!NILP (key_translate_result)) |
| 771 | 3349 result = key_translate_result; |
| 428 | 3350 } |
| 3351 | |
| 3352 if (!NILP (result)) | |
| 3353 return result; | |
| 3354 | |
| 3355 /* If key-sequence wasn't bound, we'll try some fallbacks. */ | |
| 3356 | |
| 3357 /* If we didn't find a binding, and the last event in the sequence is | |
| 3358 a shifted character, then try again with the lowercase version. */ | |
| 3359 | |
| 3360 if (XEVENT_TYPE (builder->most_current_event) == key_press_event | |
| 3361 && !NILP (Vretry_undefined_key_binding_unshifted)) | |
| 3362 { | |
| 1204 | 3363 if (event_upshifted_p (builder->most_current_event)) |
| 428 | 3364 { |
| 771 | 3365 Lisp_Object neubauten = copy_command_builder (builder, 0); |
| 3366 struct command_builder *neub = XCOMMAND_BUILDER (neubauten); | |
| 3367 struct gcpro gcpro1; | |
| 3368 | |
| 3369 GCPRO1 (neubauten); | |
| 1204 | 3370 downshift_event (event_chain_tail (neub->current_events)); |
| 771 | 3371 result = |
| 2828 | 3372 command_builder_find_leaf_no_jit_binding |
| 771 | 3373 (neub, allow_misc_user_events_p, did_munge); |
| 3374 | |
| 428 | 3375 if (!NILP (result)) |
| 771 | 3376 { |
| 3377 copy_command_builder (neub, builder); | |
| 3378 *did_munge = 1; | |
| 3379 } | |
| 3380 free_command_builder (neub); | |
| 3381 UNGCPRO; | |
| 3382 if (!NILP (result)) | |
| 428 | 3383 return result; |
| 3384 } | |
| 3385 } | |
| 3386 | |
| 3387 /* help-char is `auto-bound' in every keymap */ | |
| 3388 if (!NILP (Vprefix_help_command) && | |
| 1204 | 3389 event_matches_key_specifier_p (builder->most_current_event, Vhelp_char)) |
| 428 | 3390 return Vprefix_help_command; |
| 3391 | |
| 771 | 3392 return Qnil; |
| 3393 } | |
| 3394 | |
| 3395 /* Compare the current state of the command builder against the local and | |
| 3396 global keymaps, and return the binding. If there is no match, try again, | |
| 3397 case-insensitively. The return value will be one of: | |
| 3398 -- nil (there is no binding) | |
| 3399 -- a keymap (part of a command has been specified) | |
| 3400 -- a command (anything that satisfies `commandp'; this includes | |
| 3401 some symbols, lists, subrs, strings, vectors, and | |
| 3402 compiled-function objects) | |
| 3403 | |
| 3404 This may "munge" the current event chain in the command builder; | |
| 3405 i.e. the sequence might be mutated into a different sequence, | |
| 3406 which we then pretend is what the user actually typed instead of | |
| 3407 the passed-in sequence. This happens as a result of: | |
| 3408 | |
| 3409 -- key-translation-map changes | |
| 3410 -- function-key-map changes | |
| 3411 -- retry-undefined-key-binding-unshifted (q.v.) | |
| 3412 -- "Russian C-x problem" changes (see definition of struct key_data, | |
| 3413 events.h) | |
| 3414 | |
| 3415 DID_MUNGE must be initialized before calling this function. If munging | |
| 3416 happened, DID_MUNGE will be non-zero; otherwise, it will be left alone. | |
| 2828 | 3417 |
| 3418 (The above was Ben, I think.) | |
| 3419 | |
| 3420 It might be nice to have lookup-key call this function, directly or | |
| 3421 indirectly. Though it is arguably the right thing if lookup-key fails on | |
| 3422 a keysym that the X11 event code hasn't seen. There's no way to know if | |
| 3423 that keysym is generatable by the keyboard until it's generated, | |
| 3424 therefore there's no reasonable expectation that it be bound before it's | |
| 3425 generated--all the other default bindings depend on our knowing the | |
| 3426 keyboard layout and relying on it. And describe-key works without it, so | |
| 3427 I think we're fine. | |
| 3428 | |
| 3429 Some weirdness with this code--try this on a keyboard where X11 will | |
| 3430 produce ediaeresis with dead-diaeresis and e, but it's not produced by | |
| 3431 any other combination of keys on the keyboard; | |
| 3432 | |
| 3433 (defun ding-command () | |
| 3434 (interactive) | |
| 3435 (ding)) | |
| 3436 | |
| 3437 (define-key global-map 'ediaeresis 'ding-command) | |
| 3438 | |
| 3439 Now, pressing dead-diaeresis and then e will ding. Next; | |
| 3440 | |
| 3441 (define-key global-map 'ediaeresis 'self-insert-command) | |
| 3442 | |
| 3443 and press dead-diaeresis and then e. It'll give you "Invalid argument: | |
| 3444 typed key has no ASCII equivalent" Then; | |
| 3445 | |
| 3446 (define-key global-map 'ediaeresis nil) | |
| 3447 | |
| 3448 and press the combination again; it'll self-insert. The moral of the | |
| 3449 story is, if you want to suppress all bindings to a non-ASCII X11 key, | |
| 3450 bind it to a trivial no-op command, because the automatic mapping to | |
| 3451 self-insert-command will happen if there's no existing binding for the | |
| 3452 symbol. I can't see a way around this. -- Aidan Kehoe, 2005-05-14 */ | |
| 771 | 3453 |
| 3454 static Lisp_Object | |
| 3455 command_builder_find_leaf (struct command_builder *builder, | |
| 3456 int allow_misc_user_events_p, | |
| 3457 int *did_munge) | |
| 3458 { | |
| 3459 Lisp_Object result = | |
| 2828 | 3460 command_builder_find_leaf_no_jit_binding |
| 771 | 3461 (builder, allow_misc_user_events_p, did_munge); |
| 2828 | 3462 Lisp_Object event, console, channel, lookup_res; |
| 3463 int redolookup = 0, i; | |
| 771 | 3464 |
| 3465 if (!NILP (result)) | |
| 3466 return result; | |
| 3467 | |
| 2828 | 3468 /* If some of the events are keyboard events, and this is the first time |
| 3469 the platform event code has seen their keysyms--which will be the case | |
| 3470 the first time we see a composed keysym on X11, for example--offer it | |
| 3471 the chance to define them as a self-insert-command, and do the lookup | |
| 3472 again. | |
| 3473 | |
| 3474 This isn't Mule-specific; in a world where x-iso8859-1.el is gone, it's | |
| 3475 needed for non-Mule too. | |
| 3476 | |
| 3477 Probably this can just be limited to the checking the last | |
| 3478 keypress. */ | |
| 3479 | |
| 3480 EVENT_CHAIN_LOOP (event, builder->current_events) | |
| 3481 { | |
| 3482 /* We can ignore key release events because the preceding presses will | |
| 3483 have initiated the mapping. */ | |
| 3484 if (key_press_event != XEVENT_TYPE (event)) | |
| 3485 continue; | |
| 3486 | |
| 3487 channel = XEVENT_CHANNEL (event); | |
| 3488 if (object_dead_p (channel)) | |
| 3489 continue; | |
| 3490 | |
| 3491 console = CDFW_CONSOLE (channel); | |
| 3492 if (NILP (console)) | |
| 3493 console = Vselected_console; | |
| 3494 | |
| 3495 if (CONSOLE_LIVE_P(XCONSOLE(console))) | |
| 3496 { | |
| 3497 lookup_res = MAYBE_LISP_CONMETH(XCONSOLE(console), | |
| 3498 perhaps_init_unseen_key_defaults, | |
| 3499 (XCONSOLE(console), | |
| 3500 XEVENT_KEY_KEYSYM(event))); | |
| 3501 if (EQ(lookup_res, Qt)) | |
| 3502 { | |
| 3503 redolookup += 1; | |
| 3504 } | |
| 3505 } | |
| 3506 } | |
| 3507 | |
| 3508 if (redolookup) | |
| 428 | 3509 { |
| 2828 | 3510 result = command_builder_find_leaf_no_jit_binding |
| 3511 (builder, allow_misc_user_events_p, did_munge); | |
| 3512 if (!NILP (result)) | |
| 3513 { | |
| 3514 return result; | |
| 3515 } | |
| 3516 } | |
| 3517 | |
| 3518 /* The old composed-character-default-binding handling that used to be | |
| 3519 here was wrong--if a user wants to bind a given key to something other | |
| 3520 than self-insert-command, then they should go ahead and do it, we won't | |
| 3521 override it, and the sane thing to do with any key that has a known | |
| 3522 character correspondence is _always_ to default it to | |
| 3523 self-insert-command, nothing else. | |
| 3524 | |
| 3525 I'm adding the variable to control whether "Russian C-x processing" is | |
| 3526 used because I have a feeling that it's not always the most appropriate | |
| 3527 thing to do--in cases where people are using a non-Qwerty | |
| 3528 Roman-alphabet layout, do they really want C-x with some random letter | |
| 3529 to call `switch-to-buffer'? I can imagine that being very confusing, | |
| 3530 certainly for new users, and it might be that defaulting the value for | |
| 3531 `try-alternate-layouts-for-commands' as part of the language | |
| 3532 environment is the right thing to do, only defaulting to `t' for those | |
| 3533 languages that don't use the Roman alphabet. | |
| 3534 | |
| 3535 Much of that reasoning is tentative on my part, and feel free to change | |
| 3536 this code if you have more experience with the problem and an intuition | |
| 3537 that differs from mine. (Aidan Kehoe, 2005-05-29)*/ | |
| 3538 | |
| 3539 if (!try_alternate_layouts_for_commands) | |
| 3540 { | |
| 3541 return Qnil; | |
| 428 | 3542 } |
| 2828 | 3543 |
| 3544 if (key_press_event == XEVENT_TYPE (builder->most_current_event)) | |
| 3545 { | |
| 3546 Lisp_Object ev = builder->most_current_event, newbuilder; | |
| 3547 Ichar this_alternative; | |
| 3548 | |
| 3549 struct command_builder *newb; | |
| 3550 struct gcpro gcpro1; | |
| 3551 | |
| 3552 /* Ignore the value for CURRENT_LANGENV, because we've checked it | |
| 3553 already, above. */ | |
| 3554 for (i = KEYCHAR_CURRENT_LANGENV, ++i; i < KEYCHAR_LAST; ++i) | |
| 3555 { | |
| 3556 this_alternative = XEVENT_KEY_ALT_KEYCHARS(ev, i); | |
| 3557 | |
| 3558 if (0 == this_alternative) | |
| 3559 continue; | |
| 3560 | |
| 3561 newbuilder = copy_command_builder(builder, 0); | |
| 3562 GCPRO1(newbuilder); | |
| 3563 | |
| 3564 newb = XCOMMAND_BUILDER(newbuilder); | |
| 3565 | |
| 2830 | 3566 XSET_EVENT_KEY_KEYSYM(event_chain_tail |
| 3567 (XCOMMAND_BUILDER(newbuilder)->current_events), | |
| 2828 | 3568 make_char(this_alternative)); |
| 3569 | |
| 3570 result = command_builder_find_leaf_no_jit_binding | |
| 3571 (newb, allow_misc_user_events_p, did_munge); | |
| 3572 | |
| 3573 if (!NILP (result)) | |
| 3574 { | |
| 3575 copy_command_builder (newb, builder); | |
| 3576 *did_munge = 1; | |
| 3577 } | |
| 2830 | 3578 else if (event_upshifted_p |
| 3579 (XCOMMAND_BUILDER(newbuilder)->most_current_event) && | |
| 2828 | 3580 !NILP (Vretry_undefined_key_binding_unshifted) |
| 3581 && isascii(this_alternative)) | |
| 3582 { | |
| 2830 | 3583 downshift_event (event_chain_tail |
| 3584 (XCOMMAND_BUILDER(newbuilder)->current_events)); | |
| 3585 XSET_EVENT_KEY_KEYSYM(event_chain_tail | |
| 3586 (newb->current_events), | |
| 2828 | 3587 make_char(tolower(this_alternative))); |
| 3588 result = command_builder_find_leaf_no_jit_binding | |
| 3589 (newb, allow_misc_user_events_p, did_munge); | |
| 3590 } | |
| 3591 | |
| 3592 free_command_builder (newb); | |
| 3593 UNGCPRO; | |
| 3594 | |
| 3595 if (!NILP (result)) | |
| 3596 return result; | |
| 3597 } | |
| 3598 } | |
| 428 | 3599 |
| 3600 return Qnil; | |
| 3601 } | |
| 3602 | |
| 771 | 3603 /* Like command_builder_find_leaf but update this-command-keys and the |
| 3604 echo area as necessary when the current event chain was munged. */ | |
| 3605 | |
| 3606 static Lisp_Object | |
| 3607 command_builder_find_leaf_and_update_global_state (struct command_builder * | |
| 3608 builder, | |
| 3609 int | |
| 3610 allow_misc_user_events_p) | |
| 3611 { | |
| 3612 int did_munge = 0; | |
| 3613 int orig_length = event_chain_count (builder->current_events); | |
| 3614 Lisp_Object result = command_builder_find_leaf (builder, | |
| 3615 allow_misc_user_events_p, | |
| 3616 &did_munge); | |
| 3617 | |
| 3618 if (did_munge) | |
| 3619 { | |
| 3620 int tck_length = event_chain_count (Vthis_command_keys); | |
| 3621 | |
| 3622 /* We just assume that the events we just replaced are | |
| 3623 sitting in copied form at the end of this-command-keys. | |
| 3624 If the user did weird things with `dispatch-event' this | |
| 3625 may not be the case, but at least we make sure we won't | |
| 3626 crash. */ | |
| 3627 | |
| 3628 if (tck_length >= orig_length) | |
| 3629 { | |
| 3630 Lisp_Object new_chain = | |
| 3631 copy_event_chain (builder->current_events); | |
| 3632 this_command_keys_replace_suffix | |
| 3633 (event_chain_nth (Vthis_command_keys, tck_length - orig_length), | |
| 3634 new_chain); | |
| 3635 | |
| 3636 regenerate_echo_keys_from_this_command_keys (builder); | |
| 3637 } | |
| 3638 } | |
| 3639 | |
| 3640 if (NILP (result)) | |
| 3641 { | |
| 3642 /* If we read extra events attempting to match a function key but end | |
| 3643 up failing, then we release those events back to the command loop | |
| 3644 and fail on the original lookup. The released events will then be | |
| 3645 reprocessed in the context of the first part having failed. */ | |
| 3646 if (!NILP (builder->last_non_munged_event)) | |
| 3647 { | |
| 3648 Lisp_Object event0 = builder->last_non_munged_event; | |
| 3649 | |
| 3650 /* Put the commands back on the event queue. */ | |
| 3651 enqueue_event_chain (XEVENT_NEXT (event0), | |
| 3652 &command_event_queue, | |
| 3653 &command_event_queue_tail); | |
| 3654 | |
| 3655 /* Then remove them from the command builder. */ | |
| 3656 XSET_EVENT_NEXT (event0, Qnil); | |
| 3657 builder->most_current_event = event0; | |
| 3658 builder->last_non_munged_event = Qnil; | |
| 3659 } | |
| 3660 } | |
| 3661 | |
| 3662 return result; | |
| 3663 } | |
| 428 | 3664 |
| 3665 /* Every time a command-event (a key, button, or menu selection) is read by | |
| 3666 Fnext_event(), it is stored in the recent_keys_ring, in Vlast_input_event, | |
| 3667 and in Vthis_command_keys. (Eval-events are not stored there.) | |
| 3668 | |
| 3669 Every time a command is invoked, Vlast_command_event is set to the last | |
| 3670 event in the sequence. | |
| 3671 | |
| 3672 This means that Vthis_command_keys is really about "input read since the | |
| 3673 last command was executed" rather than about "what keys invoked this | |
| 3674 command." This is a little counterintuitive, but that's the way it | |
| 3675 has always worked. | |
| 3676 | |
| 3677 As an extra kink, the function read-key-sequence resets/updates the | |
| 3678 last-command-event and this-command-keys. It doesn't append to the | |
| 3679 command-keys as read-char does. Such are the pitfalls of having to | |
| 3680 maintain compatibility with a program for which the only specification | |
| 3681 is the code itself. | |
| 3682 | |
| 3683 (We could implement recent_keys_ring and Vthis_command_keys as the same | |
| 3684 data structure.) | |
| 3685 */ | |
| 3686 | |
| 3687 DEFUN ("recent-keys", Frecent_keys, 0, 1, 0, /* | |
| 3688 Return a vector of recent keyboard or mouse button events read. | |
| 3689 If NUMBER is non-nil, not more than NUMBER events will be returned. | |
| 3690 Change number of events stored using `set-recent-keys-ring-size'. | |
| 3691 | |
| 3692 This copies the event objects into a new vector; it is safe to keep and | |
| 3693 modify them. | |
| 3694 */ | |
| 3695 (number)) | |
| 3696 { | |
| 3697 struct gcpro gcpro1; | |
| 3698 Lisp_Object val = Qnil; | |
| 3699 int nwanted; | |
| 3700 int start, nkeys, i, j; | |
| 3701 GCPRO1 (val); | |
| 3702 | |
| 3703 if (NILP (number)) | |
| 3704 nwanted = recent_keys_ring_size; | |
| 3705 else | |
| 3706 { | |
| 3707 CHECK_NATNUM (number); | |
| 3708 nwanted = XINT (number); | |
| 3709 } | |
| 3710 | |
| 3711 /* Create the keys ring vector, if none present. */ | |
| 3712 if (NILP (Vrecent_keys_ring)) | |
| 3713 { | |
| 3714 Vrecent_keys_ring = make_vector (recent_keys_ring_size, Qnil); | |
| 3715 /* And return nothing in particular. */ | |
| 446 | 3716 RETURN_UNGCPRO (make_vector (0, Qnil)); |
| 428 | 3717 } |
| 3718 | |
| 3719 if (NILP (XVECTOR_DATA (Vrecent_keys_ring)[recent_keys_ring_index])) | |
| 3720 /* This means the vector has not yet wrapped */ | |
| 3721 { | |
| 3722 nkeys = recent_keys_ring_index; | |
| 3723 start = 0; | |
| 3724 } | |
| 3725 else | |
| 3726 { | |
| 3727 nkeys = recent_keys_ring_size; | |
| 3728 start = ((recent_keys_ring_index == nkeys) ? 0 : recent_keys_ring_index); | |
| 3729 } | |
| 3730 | |
| 3731 if (nwanted < nkeys) | |
| 3732 { | |
| 3733 start += nkeys - nwanted; | |
| 3734 if (start >= recent_keys_ring_size) | |
| 3735 start -= recent_keys_ring_size; | |
| 3736 nkeys = nwanted; | |
| 3737 } | |
| 3738 else | |
| 3739 nwanted = nkeys; | |
| 3740 | |
| 3741 val = make_vector (nwanted, Qnil); | |
| 3742 | |
| 3743 for (i = 0, j = start; i < nkeys; i++) | |
| 3744 { | |
| 3745 Lisp_Object e = XVECTOR_DATA (Vrecent_keys_ring)[j]; | |
| 3746 | |
| 3747 if (NILP (e)) | |
| 2500 | 3748 ABORT (); |
| 428 | 3749 XVECTOR_DATA (val)[i] = Fcopy_event (e, Qnil); |
| 3750 if (++j >= recent_keys_ring_size) | |
| 3751 j = 0; | |
| 3752 } | |
| 3753 UNGCPRO; | |
| 3754 return val; | |
| 3755 } | |
| 3756 | |
| 3757 | |
| 3758 DEFUN ("recent-keys-ring-size", Frecent_keys_ring_size, 0, 0, 0, /* | |
| 3759 The maximum number of events `recent-keys' can return. | |
| 3760 */ | |
| 3761 ()) | |
| 3762 { | |
| 3763 return make_int (recent_keys_ring_size); | |
| 3764 } | |
| 3765 | |
| 3766 DEFUN ("set-recent-keys-ring-size", Fset_recent_keys_ring_size, 1, 1, 0, /* | |
| 3767 Set the maximum number of events to be stored internally. | |
| 3768 */ | |
| 3769 (size)) | |
| 3770 { | |
| 3771 Lisp_Object new_vector = Qnil; | |
| 3772 int i, j, nkeys, start, min; | |
| 3773 struct gcpro gcpro1; | |
| 3774 | |
| 3775 CHECK_INT (size); | |
| 3776 if (XINT (size) <= 0) | |
| 563 | 3777 invalid_argument ("Recent keys ring size must be positive", size); |
| 428 | 3778 if (XINT (size) == recent_keys_ring_size) |
| 3779 return size; | |
| 3780 | |
| 446 | 3781 GCPRO1 (new_vector); |
| 428 | 3782 new_vector = make_vector (XINT (size), Qnil); |
| 3783 | |
| 3784 if (NILP (Vrecent_keys_ring)) | |
| 3785 { | |
| 3786 Vrecent_keys_ring = new_vector; | |
| 446 | 3787 RETURN_UNGCPRO (size); |
| 428 | 3788 } |
| 3789 | |
| 3790 if (NILP (XVECTOR_DATA (Vrecent_keys_ring)[recent_keys_ring_index])) | |
| 3791 /* This means the vector has not yet wrapped */ | |
| 3792 { | |
| 3793 nkeys = recent_keys_ring_index; | |
| 3794 start = 0; | |
| 3795 } | |
| 3796 else | |
| 3797 { | |
| 3798 nkeys = recent_keys_ring_size; | |
| 3799 start = ((recent_keys_ring_index == nkeys) ? 0 : recent_keys_ring_index); | |
| 3800 } | |
| 3801 | |
| 3802 if (XINT (size) > nkeys) | |
| 3803 min = nkeys; | |
| 3804 else | |
| 3805 min = XINT (size); | |
| 3806 | |
| 3807 for (i = 0, j = start; i < min; i++) | |
| 3808 { | |
| 3809 XVECTOR_DATA (new_vector)[i] = XVECTOR_DATA (Vrecent_keys_ring)[j]; | |
| 3810 if (++j >= recent_keys_ring_size) | |
| 3811 j = 0; | |
| 3812 } | |
| 3813 recent_keys_ring_size = XINT (size); | |
| 3814 recent_keys_ring_index = (i < recent_keys_ring_size) ? i : 0; | |
| 3815 | |
| 3816 Vrecent_keys_ring = new_vector; | |
| 3817 | |
| 3818 UNGCPRO; | |
| 3819 return size; | |
| 3820 } | |
| 3821 | |
| 3822 /* Vthis_command_keys having value Qnil means that the next time | |
| 3823 push_this_command_keys is called, it should start over. | |
| 3824 The times at which the command-keys are reset | |
| 3825 (instead of merely being augmented) are pretty counterintuitive. | |
| 3826 (More specifically: | |
| 3827 | |
| 3828 -- We do not reset this-command-keys when we finish reading a | |
| 3829 command. This is because some commands (e.g. C-u) act | |
| 3830 like command prefixes; they signal this by setting prefix-arg | |
| 3831 to non-nil. | |
| 3832 -- Therefore, we reset this-command-keys when we finish | |
| 3833 executing a command, unless prefix-arg is set. | |
| 3834 -- However, if we ever do a non-local exit out of a command | |
| 3835 loop (e.g. an error in a command), we need to reset | |
| 3836 this-command-keys. We do this by calling reset_this_command_keys() | |
| 3837 from cmdloop.c, whenever an error causes an invocation of the | |
| 3838 default error handler, and whenever there's a throw to top-level.) | |
| 3839 */ | |
| 3840 | |
| 3841 void | |
| 3842 reset_this_command_keys (Lisp_Object console, int clear_echo_area_p) | |
| 3843 { | |
| 757 | 3844 if (!NILP (console)) |
| 3845 { | |
| 3846 /* console is nil if we just deleted the console as a result of C-x 5 | |
| 3847 0. Unfortunately things are currently in a messy situation where | |
| 3848 some stuff is console-local and other stuff isn't, so we need to | |
| 3849 do everything that's not console-local. */ | |
| 3850 struct command_builder *command_builder = | |
| 3851 XCOMMAND_BUILDER (XCONSOLE (console)->command_builder); | |
| 3852 | |
| 3853 reset_key_echo (command_builder, clear_echo_area_p); | |
| 3854 reset_current_events (command_builder); | |
| 3855 } | |
| 3856 else | |
| 3857 reset_key_echo (0, clear_echo_area_p); | |
| 428 | 3858 |
| 3859 deallocate_event_chain (Vthis_command_keys); | |
| 3860 Vthis_command_keys = Qnil; | |
| 3861 Vthis_command_keys_tail = Qnil; | |
| 3862 } | |
| 3863 | |
| 3864 static void | |
| 3865 push_this_command_keys (Lisp_Object event) | |
| 3866 { | |
| 3025 | 3867 Lisp_Object new_ = Fmake_event (Qnil, Qnil); |
| 3868 | |
| 3869 Fcopy_event (event, new_); | |
| 3870 enqueue_event (new_, &Vthis_command_keys, &Vthis_command_keys_tail); | |
| 428 | 3871 } |
| 3872 | |
| 3873 /* The following two functions are used in call-interactively, | |
| 3874 for the @ and e specifications. We used to just use | |
| 3875 `current-mouse-event' (i.e. the last mouse event in this-command-keys), | |
| 3876 but FSF does it more generally so we follow their lead. */ | |
| 3877 | |
| 3878 Lisp_Object | |
| 3879 extract_this_command_keys_nth_mouse_event (int n) | |
| 3880 { | |
| 3881 Lisp_Object event; | |
| 3882 | |
| 3883 EVENT_CHAIN_LOOP (event, Vthis_command_keys) | |
| 3884 { | |
| 3885 if (EVENTP (event) | |
| 3886 && (XEVENT_TYPE (event) == button_press_event | |
| 3887 || XEVENT_TYPE (event) == button_release_event | |
| 3888 || XEVENT_TYPE (event) == misc_user_event)) | |
| 3889 { | |
| 3890 if (!n) | |
| 3891 { | |
| 2500 | 3892 /* must copy to avoid an ABORT() in next_event_internal() */ |
| 428 | 3893 if (!NILP (XEVENT_NEXT (event))) |
| 3894 return Fcopy_event (event, Qnil); | |
| 3895 else | |
| 3896 return event; | |
| 3897 } | |
| 3898 n--; | |
| 3899 } | |
| 3900 } | |
| 3901 | |
| 3902 return Qnil; | |
| 3903 } | |
| 3904 | |
| 3905 Lisp_Object | |
| 3906 extract_vector_nth_mouse_event (Lisp_Object vector, int n) | |
| 3907 { | |
| 3908 int i; | |
| 3909 int len = XVECTOR_LENGTH (vector); | |
| 3910 | |
| 3911 for (i = 0; i < len; i++) | |
| 3912 { | |
| 3913 Lisp_Object event = XVECTOR_DATA (vector)[i]; | |
| 3914 if (EVENTP (event)) | |
| 3915 switch (XEVENT_TYPE (event)) | |
| 3916 { | |
| 3917 case button_press_event : | |
| 3918 case button_release_event : | |
| 3919 case misc_user_event : | |
| 3920 if (n == 0) | |
| 3921 return event; | |
| 3922 n--; | |
| 3923 break; | |
| 3924 default: | |
| 3925 continue; | |
| 3926 } | |
| 3927 } | |
| 3928 | |
| 3929 return Qnil; | |
| 3930 } | |
| 3931 | |
| 3932 static void | |
| 3933 push_recent_keys (Lisp_Object event) | |
| 3934 { | |
| 3935 Lisp_Object e; | |
| 3936 | |
| 3937 if (NILP (Vrecent_keys_ring)) | |
| 3938 Vrecent_keys_ring = make_vector (recent_keys_ring_size, Qnil); | |
| 3939 | |
| 3940 e = XVECTOR_DATA (Vrecent_keys_ring) [recent_keys_ring_index]; | |
| 3941 | |
| 3942 if (NILP (e)) | |
| 3943 { | |
| 3944 e = Fmake_event (Qnil, Qnil); | |
| 3945 XVECTOR_DATA (Vrecent_keys_ring) [recent_keys_ring_index] = e; | |
| 3946 } | |
| 3947 Fcopy_event (event, e); | |
| 3948 if (++recent_keys_ring_index == recent_keys_ring_size) | |
| 3949 recent_keys_ring_index = 0; | |
| 3950 } | |
| 3951 | |
| 3952 | |
| 3953 static Lisp_Object | |
| 3954 current_events_into_vector (struct command_builder *command_builder) | |
| 3955 { | |
| 3956 Lisp_Object vector; | |
| 3957 Lisp_Object event; | |
| 3958 int n = event_chain_count (command_builder->current_events); | |
| 3959 | |
| 3960 /* Copy the vector and the events in it. */ | |
| 3961 /* No need to copy the events, since they're already copies, and | |
| 3962 nobody other than the command-builder has pointers to them */ | |
| 3963 vector = make_vector (n, Qnil); | |
| 3964 n = 0; | |
| 3965 EVENT_CHAIN_LOOP (event, command_builder->current_events) | |
| 3966 XVECTOR_DATA (vector)[n++] = event; | |
| 3967 reset_command_builder_event_chain (command_builder); | |
| 3968 return vector; | |
| 3969 } | |
| 3970 | |
| 3971 | |
| 3972 /* | |
| 3973 Given the current state of the command builder and a new command event | |
| 3974 that has just been dispatched: | |
| 3975 | |
| 3976 -- add the event to the event chain forming the current command | |
| 3977 (doing meta-translation as necessary) | |
| 3978 -- return the binding of this event chain; this will be one of: | |
| 3979 -- nil (there is no binding) | |
| 3980 -- a keymap (part of a command has been specified) | |
| 3981 -- a command (anything that satisfies `commandp'; this includes | |
| 3982 some symbols, lists, subrs, strings, vectors, and | |
| 3983 compiled-function objects) | |
| 3984 */ | |
| 3985 static Lisp_Object | |
| 3986 lookup_command_event (struct command_builder *command_builder, | |
| 3987 Lisp_Object event, int allow_misc_user_events_p) | |
| 3988 { | |
| 3989 /* This function can GC */ | |
| 3990 struct frame *f = selected_frame (); | |
| 3991 /* Clear output from previous command execution */ | |
| 3992 if (!EQ (Qcommand, echo_area_status (f)) | |
| 3993 /* but don't let mouse-up clear what mouse-down just printed */ | |
| 3994 && (XEVENT (event)->event_type != button_release_event)) | |
| 3995 clear_echo_area (f, Qnil, 0); | |
| 3996 | |
| 3997 /* Add the given event to the command builder. | |
| 3998 Extra hack: this also updates the recent_keys_ring and Vthis_command_keys | |
| 3999 vectors to translate "ESC x" to "M-x" (for any "x" of course). | |
| 4000 */ | |
| 4001 { | |
| 4002 Lisp_Object recent = command_builder->most_current_event; | |
| 4003 | |
| 4004 if (EVENTP (recent) | |
| 1204 | 4005 && event_matches_key_specifier_p (recent, Vmeta_prefix_char)) |
| 428 | 4006 { |
| 440 | 4007 Lisp_Event *e; |
| 428 | 4008 /* When we see a sequence like "ESC x", pretend we really saw "M-x". |
| 4009 DoubleThink the recent-keys and this-command-keys as well. */ | |
| 4010 | |
| 4011 /* Modify the previous most-recently-pushed event on the command | |
| 4012 builder to be a copy of this one with the meta-bit set instead of | |
| 4013 pushing a new event. | |
| 4014 */ | |
| 4015 Fcopy_event (event, recent); | |
| 4016 e = XEVENT (recent); | |
| 934 | 4017 if (EVENT_TYPE (e) == key_press_event) |
| 1204 | 4018 SET_EVENT_KEY_MODIFIERS (e, EVENT_KEY_MODIFIERS (e) | |
| 4019 XEMACS_MOD_META); | |
| 934 | 4020 else if (EVENT_TYPE (e) == button_press_event |
| 4021 || EVENT_TYPE (e) == button_release_event) | |
| 1204 | 4022 SET_EVENT_BUTTON_MODIFIERS (e, EVENT_BUTTON_MODIFIERS (e) | |
| 4023 XEMACS_MOD_META); | |
| 428 | 4024 else |
| 2500 | 4025 ABORT (); |
| 428 | 4026 |
| 4027 { | |
| 4028 int tckn = event_chain_count (Vthis_command_keys); | |
| 4029 if (tckn >= 2) | |
| 4030 /* ??? very strange if it's < 2. */ | |
| 4031 this_command_keys_replace_suffix | |
| 4032 (event_chain_nth (Vthis_command_keys, tckn - 2), | |
| 4033 Fcopy_event (recent, Qnil)); | |
| 4034 } | |
| 4035 | |
| 4036 regenerate_echo_keys_from_this_command_keys (command_builder); | |
| 4037 } | |
| 4038 else | |
| 771 | 4039 command_builder_append_event (command_builder, event); |
| 428 | 4040 } |
| 4041 | |
| 4042 { | |
| 771 | 4043 Lisp_Object leaf = |
| 4044 command_builder_find_leaf_and_update_global_state | |
| 4045 (command_builder, | |
| 4046 allow_misc_user_events_p); | |
| 428 | 4047 struct gcpro gcpro1; |
| 4048 GCPRO1 (leaf); | |
| 4049 | |
| 4050 if (KEYMAPP (leaf)) | |
| 4051 { | |
| 442 | 4052 #if defined (HAVE_X_WINDOWS) && defined (LWLIB_MENUBARS_LUCID) |
| 4053 if (!x_kludge_lw_menu_active ()) | |
| 4054 #else | |
| 4055 if (1) | |
| 4056 #endif | |
| 428 | 4057 { |
| 4058 Lisp_Object prompt = Fkeymap_prompt (leaf, Qt); | |
| 4059 if (STRINGP (prompt)) | |
| 4060 { | |
| 4061 /* Append keymap prompt to key echo buffer */ | |
| 4062 int buf_index = command_builder->echo_buf_index; | |
| 4063 Bytecount len = XSTRING_LENGTH (prompt); | |
| 4064 | |
| 4065 if (len + buf_index + 1 <= command_builder->echo_buf_length) | |
| 4066 { | |
| 867 | 4067 Ibyte *echo = command_builder->echo_buf + buf_index; |
| 428 | 4068 memcpy (echo, XSTRING_DATA (prompt), len); |
| 4069 echo[len] = 0; | |
| 4070 } | |
| 4071 maybe_echo_keys (command_builder, 1); | |
| 4072 } | |
| 4073 else | |
| 4074 maybe_echo_keys (command_builder, 0); | |
| 4075 } | |
| 853 | 4076 /* #### i don't trust this at all. --ben */ |
| 4077 #if 0 | |
| 442 | 4078 else if (!NILP (Vquit_flag)) |
| 4079 { | |
| 4080 /* if quit happened during menu acceleration, pretend we read it */ | |
| 4081 struct console *con = XCONSOLE (Fselected_console ()); | |
| 1204 | 4082 |
| 4083 enqueue_command_event (Fcopy_event (CONSOLE_QUIT_EVENT (con), | |
| 4084 Qnil)); | |
| 442 | 4085 Vquit_flag = Qnil; |
| 4086 } | |
| 853 | 4087 #endif |
| 428 | 4088 } |
| 4089 else if (!NILP (leaf)) | |
| 4090 { | |
| 4091 if (EQ (Qcommand, echo_area_status (f)) | |
| 4092 && command_builder->echo_buf_index > 0) | |
| 4093 { | |
| 4094 /* If we had been echoing keys, echo the last one (without | |
| 4095 the trailing dash) and redisplay before executing the | |
| 4096 command. */ | |
| 4097 command_builder->echo_buf[command_builder->echo_buf_index] = 0; | |
| 4098 maybe_echo_keys (command_builder, 1); | |
| 4099 Fsit_for (Qzero, Qt); | |
| 4100 } | |
| 4101 } | |
| 4102 RETURN_UNGCPRO (leaf); | |
| 4103 } | |
| 4104 } | |
| 4105 | |
| 479 | 4106 static int |
| 4107 is_scrollbar_event (Lisp_Object event) | |
| 4108 { | |
| 516 | 4109 #ifdef HAVE_SCROLLBARS |
| 479 | 4110 Lisp_Object fun; |
| 4111 | |
| 934 | 4112 if (XEVENT_TYPE (event) != misc_user_event) |
| 4113 return 0; | |
| 1204 | 4114 fun = XEVENT_MISC_USER_FUNCTION (event); |
| 479 | 4115 |
| 4116 return (EQ (fun, Qscrollbar_line_up) || | |
| 4117 EQ (fun, Qscrollbar_line_down) || | |
| 4118 EQ (fun, Qscrollbar_page_up) || | |
| 4119 EQ (fun, Qscrollbar_page_down) || | |
| 4120 EQ (fun, Qscrollbar_to_top) || | |
| 4121 EQ (fun, Qscrollbar_to_bottom) || | |
| 4122 EQ (fun, Qscrollbar_vertical_drag) || | |
| 4123 EQ (fun, Qscrollbar_char_left) || | |
| 4124 EQ (fun, Qscrollbar_char_right) || | |
| 4125 EQ (fun, Qscrollbar_page_left) || | |
| 4126 EQ (fun, Qscrollbar_page_right) || | |
| 4127 EQ (fun, Qscrollbar_to_left) || | |
| 4128 EQ (fun, Qscrollbar_to_right) || | |
| 4129 EQ (fun, Qscrollbar_horizontal_drag)); | |
| 516 | 4130 #else |
| 4131 return 0; | |
| 4132 #endif /* HAVE_SCROLLBARS */ | |
| 479 | 4133 } |
| 4134 | |
| 428 | 4135 static void |
| 4136 execute_command_event (struct command_builder *command_builder, | |
| 4137 Lisp_Object event) | |
| 4138 { | |
| 4139 /* This function can GC */ | |
| 4140 struct console *con = XCONSOLE (command_builder->console); | |
| 4141 struct gcpro gcpro1; | |
| 4142 | |
| 4143 GCPRO1 (event); /* event may be freshly created */ | |
| 444 | 4144 |
| 479 | 4145 /* #### This call to is_scrollbar_event() isn't quite right, but |
| 4146 fixing properly it requires more work than can go into 21.4. | |
| 4147 (We really need to split out menu, scrollbar, dialog, and other | |
| 4148 types of events from misc-user, and put the remaining ones in a | |
| 4149 new `user-eval' type that behaves like an eval event but is a | |
| 4150 user event and thus has all of its semantics -- e.g. being | |
| 4151 delayed during `accept-process-output' and similar wait states.) | |
| 4152 | |
| 4153 The real issue here is that "user events" and "command events" | |
| 4154 are not the same thing, but are very much confused in | |
| 4155 event-stream.c. User events are, essentially, any event that | |
| 4156 should be delayed by accept-process-output, should terminate a | |
| 4157 sit-for, etc. -- basically, any event that needs to be processed | |
| 4158 synchronously with key and mouse events. Command events are | |
| 4159 those that participate in command building; scrollbar events | |
| 4160 clearly don't belong because they should be transparent in a | |
| 4161 sequence like C-x @ h <scrollbar-drag> x, which used to cause a | |
| 4162 crash before checks similar to the is_scrollbar_event() call were | |
| 4163 added. Do other events belong with scrollbar events? I'm not | |
| 4164 sure; we need to categorize all misc-user events and see what | |
| 4165 their semantics are. | |
| 4166 | |
| 4167 (You might ask, why do scrollbar events need to be user events? | |
| 4168 That's a good question. The answer seems to be that they can | |
| 4169 change point, and having this happen asynchronously would be a | |
| 4170 very bad idea. According to the "proper" functioning of | |
| 4171 scrollbars, this should not happen, but XEmacs does not allow | |
| 4172 point to go outside of the window.) | |
| 4173 | |
| 4174 Scrollbar events and similar non-command events should obviously | |
| 4175 not be recorded in this-command-keys, so we need to check for | |
| 4176 this in next-event. | |
| 4177 | |
| 4178 #### We call reset_current_events() twice in this function -- | |
| 4179 #### here, and later as a result of reset_this_command_keys(). | |
| 4180 #### This is almost certainly wrong; need to figure out what's | |
| 4181 #### correct. | |
| 4182 | |
| 4183 #### We need to figure out what's really correct w.r.t. scrollbar | |
| 4184 #### events. With these new fixes in, it actually works to do | |
| 4185 #### C-x <scrollbar-drag> 5 2, but the key echo gets messed up | |
| 4186 #### (starts over at 5). We really need to be special-casing | |
| 4187 #### scrollbar events at a lower level, and not really passing | |
| 4188 #### them through the command builder at all. (e.g. do scrollbar | |
| 4189 #### events belong in macros??? doubtful; probably only the | |
| 4190 #### point movement, if any, belongs, special-cased as a | |
| 4191 #### pseudo-issued M-x goto-char command). #### Need more work | |
| 4192 #### here. Do this when separating out scrollbar events. | |
| 4193 */ | |
| 4194 | |
| 4195 if (!is_scrollbar_event (event)) | |
| 444 | 4196 reset_current_events (command_builder); |
| 428 | 4197 |
| 4198 switch (XEVENT (event)->event_type) | |
| 4199 { | |
| 4200 case key_press_event: | |
| 4201 Vcurrent_mouse_event = Qnil; | |
| 4202 break; | |
| 4203 case button_press_event: | |
| 4204 case button_release_event: | |
| 4205 case misc_user_event: | |
| 4206 Vcurrent_mouse_event = Fcopy_event (event, Qnil); | |
| 4207 break; | |
| 4208 default: break; | |
| 4209 } | |
| 4210 | |
| 4211 /* Store the last-command-event. The semantics of this is that it | |
| 4212 is the last event most recently involved in command-lookup. */ | |
| 4213 if (!EVENTP (Vlast_command_event)) | |
| 4214 Vlast_command_event = Fmake_event (Qnil, Qnil); | |
| 4215 if (XEVENT (Vlast_command_event)->event_type == dead_event) | |
| 4216 { | |
| 4217 Vlast_command_event = Fmake_event (Qnil, Qnil); | |
| 563 | 4218 invalid_state ("Someone deallocated the last-command-event!", Qunbound); |
| 428 | 4219 } |
| 4220 | |
| 4221 if (! EQ (event, Vlast_command_event)) | |
| 4222 Fcopy_event (event, Vlast_command_event); | |
| 4223 | |
| 4224 /* Note that last-command-char will never have its high-bit set, in | |
| 4225 an effort to sidestep the ambiguity between M-x and oslash. */ | |
| 4226 Vlast_command_char = Fevent_to_character (Vlast_command_event, | |
| 2862 | 4227 Qnil, Qnil, Qnil); |
| 428 | 4228 |
| 4229 /* Actually call the command, with all sorts of hair to preserve or clear | |
| 4230 the echo-area and region as appropriate and call the pre- and post- | |
| 4231 command-hooks. */ | |
| 4232 { | |
| 4233 int old_kbd_macro = con->kbd_macro_end; | |
| 4234 struct window *w = XWINDOW (Fselected_window (Qnil)); | |
| 4235 | |
| 4236 /* We're executing a new command, so the old value is irrelevant. */ | |
| 4237 zmacs_region_stays = 0; | |
| 4238 | |
| 4239 /* If the previous command tried to force a specific window-start, | |
| 4240 reset the flag in case this command moves point far away from | |
| 4241 that position. Also, reset the window's buffer's change | |
| 4242 information so that we don't trigger an incremental update. */ | |
| 4243 if (w->force_start) | |
| 4244 { | |
| 4245 w->force_start = 0; | |
| 4246 buffer_reset_changes (XBUFFER (w->buffer)); | |
| 4247 } | |
| 4248 | |
| 4249 pre_command_hook (); | |
| 4250 | |
| 934 | 4251 if (XEVENT_TYPE (event) == misc_user_event) |
| 4252 { | |
| 1204 | 4253 call1 (XEVENT_MISC_USER_FUNCTION (event), |
| 4254 XEVENT_MISC_USER_OBJECT (event)); | |
| 934 | 4255 } |
| 428 | 4256 else |
| 4257 { | |
| 4258 Fcommand_execute (Vthis_command, Qnil, Qnil); | |
| 4259 } | |
| 4260 | |
| 4261 post_command_hook (); | |
| 4262 | |
| 757 | 4263 /* Console might have been deleted by command */ |
| 4264 if (CONSOLE_LIVE_P (con) && !NILP (con->prefix_arg)) | |
| 428 | 4265 { |
| 4266 /* Commands that set the prefix arg don't update last-command, don't | |
| 4267 reset the echoing state, and don't go into keyboard macros unless | |
| 444 | 4268 followed by another command. Also don't quit here. */ |
| 4269 int speccount = specpdl_depth (); | |
| 4270 specbind (Qinhibit_quit, Qt); | |
| 428 | 4271 maybe_echo_keys (command_builder, 0); |
| 771 | 4272 unbind_to (speccount); |
| 428 | 4273 |
| 4274 /* If we're recording a keyboard macro, and the last command | |
| 4275 executed set a prefix argument, then decrement the pointer to | |
| 4276 the "last character really in the macro" to be just before this | |
| 4277 command. This is so that the ^U in "^U ^X )" doesn't go onto | |
| 4278 the end of macro. */ | |
| 4279 if (!NILP (con->defining_kbd_macro)) | |
| 4280 con->kbd_macro_end = old_kbd_macro; | |
| 4281 } | |
| 4282 else | |
| 4283 { | |
| 4284 /* Start a new command next time */ | |
| 4285 Vlast_command = Vthis_command; | |
| 442 | 4286 Vlast_command_properties = Vthis_command_properties; |
| 4287 Vthis_command_properties = Qnil; | |
| 4288 | |
| 428 | 4289 /* Emacs 18 doesn't unconditionally clear the echoed keystrokes, |
| 4290 so we don't either */ | |
| 479 | 4291 |
| 4292 if (!is_scrollbar_event (event)) | |
| 771 | 4293 reset_this_command_keys (CONSOLE_LIVE_P (con) ? wrap_console (con) |
| 757 | 4294 : Qnil, 0); |
| 428 | 4295 } |
| 4296 } | |
| 4297 | |
| 4298 UNGCPRO; | |
| 4299 } | |
| 4300 | |
| 4301 /* Run the pre command hook. */ | |
| 4302 | |
| 4303 static void | |
| 4304 pre_command_hook (void) | |
| 4305 { | |
| 4306 last_point_position = BUF_PT (current_buffer); | |
| 793 | 4307 last_point_position_buffer = wrap_buffer (current_buffer); |
| 428 | 4308 /* This function can GC */ |
| 853 | 4309 safe_run_hook_trapping_problems |
| 1333 | 4310 (Qcommand, Qpre_command_hook, |
| 4311 INHIBIT_EXISTING_PERMANENT_DISPLAY_OBJECT_DELETION); | |
| 442 | 4312 |
| 4313 /* This is a kludge, but necessary; see simple.el */ | |
| 4314 call0 (Qhandle_pre_motion_command); | |
| 428 | 4315 } |
| 4316 | |
| 4317 /* Run the post command hook. */ | |
| 4318 | |
| 4319 static void | |
| 4320 post_command_hook (void) | |
| 4321 { | |
| 4322 /* This function can GC */ | |
| 4323 /* Turn off region highlighting unless this command requested that | |
| 4324 it be left on, or we're in the minibuffer. We don't turn it off | |
| 4325 when we're in the minibuffer so that things like M-x write-region | |
| 4326 still work! | |
| 4327 | |
| 4328 This could be done via a function on the post-command-hook, but | |
| 4329 we don't want the user to accidentally remove it. | |
| 4330 */ | |
| 4331 | |
| 4332 Lisp_Object win = Fselected_window (Qnil); | |
| 4333 | |
| 4334 /* If the last command deleted the frame, `win' might be nil. | |
| 4335 It seems safest to do nothing in this case. */ | |
| 442 | 4336 /* Note: Someone added the following comment and put #if 0's around |
| 4337 this code, not realizing that doing this invites a crash in the | |
| 4338 line after. */ | |
| 440 | 4339 /* #### This doesn't really fix the problem, |
| 428 | 4340 if delete-frame is called by some hook */ |
| 4341 if (NILP (win)) | |
| 4342 return; | |
| 442 | 4343 |
| 4344 /* This is a kludge, but necessary; see simple.el */ | |
| 4345 call0 (Qhandle_post_motion_command); | |
| 428 | 4346 |
| 4347 if (! zmacs_region_stays | |
| 4348 && (!MINI_WINDOW_P (XWINDOW (win)) | |
| 4349 || EQ (zmacs_region_buffer (), WINDOW_BUFFER (XWINDOW (win))))) | |
| 4350 zmacs_deactivate_region (); | |
| 4351 else | |
| 4352 zmacs_update_region (); | |
| 4353 | |
| 853 | 4354 safe_run_hook_trapping_problems |
| 1333 | 4355 (Qcommand, Qpost_command_hook, |
|
4718
a27de91ae83c
Don't prevent display objects from being deleted for `post-command-hook'.
Mike Sperber <sperber@deinprogramm.de>
parents:
4677
diff
changeset
|
4356 0); |
| 853 | 4357 |
| 4358 #if 0 /* FSF Emacs */ | |
| 4359 if (!NILP (current_buffer->mark_active)) | |
| 4360 { | |
| 4361 if (!NILP (Vdeactivate_mark) && !NILP (Vtransient_mark_mode)) | |
| 4362 { | |
| 4363 current_buffer->mark_active = Qnil; | |
| 4364 run_hook (intern ("deactivate-mark-hook")); | |
| 4365 } | |
| 4366 else if (current_buffer != prev_buffer || | |
| 4367 BUF_MODIFF (current_buffer) != prev_modiff) | |
| 4368 run_hook (intern ("activate-mark-hook")); | |
| 4369 } | |
| 4370 #endif /* FSF Emacs */ | |
| 428 | 4371 |
| 4372 /* #### Kludge!!! This is necessary to make sure that things | |
| 4373 are properly positioned even if post-command-hook moves point. | |
| 4374 #### There should be a cleaner way of handling this. */ | |
| 4375 call0 (Qauto_show_make_point_visible); | |
| 4376 } | |
| 4377 | |
| 4378 | |
| 4379 DEFUN ("dispatch-event", Fdispatch_event, 1, 1, 0, /* | |
| 444 | 4380 Given an event object EVENT as returned by `next-event', execute it. |
| 428 | 4381 |
| 4382 Key-press, button-press, and button-release events get accumulated | |
| 4383 until a complete key sequence (see `read-key-sequence') is reached, | |
| 4384 at which point the sequence is looked up in the current keymaps and | |
| 4385 acted upon. | |
| 4386 | |
| 4387 Mouse motion events cause the low-level handling function stored in | |
| 4388 `mouse-motion-handler' to be called. (There are very few circumstances | |
| 4389 under which you should change this handler. Use `mode-motion-hook' | |
| 4390 instead.) | |
| 4391 | |
| 4392 Menu, timeout, and eval events cause the associated function or handler | |
| 4393 to be called. | |
| 4394 | |
| 4395 Process events cause the subprocess's output to be read and acted upon | |
| 4396 appropriately (see `start-process'). | |
| 4397 | |
| 4398 Magic events are handled as necessary. | |
| 4399 */ | |
| 4400 (event)) | |
| 4401 { | |
| 4402 /* This function can GC */ | |
| 4403 struct command_builder *command_builder; | |
| 440 | 4404 Lisp_Event *ev; |
| 428 | 4405 Lisp_Object console; |
| 4406 Lisp_Object channel; | |
| 1292 | 4407 PROFILE_DECLARE (); |
| 428 | 4408 |
| 4409 CHECK_LIVE_EVENT (event); | |
| 4410 ev = XEVENT (event); | |
| 4411 | |
| 4412 /* events on dead channels get silently eaten */ | |
| 4413 channel = EVENT_CHANNEL (ev); | |
| 4414 if (object_dead_p (channel)) | |
| 4415 return Qnil; | |
| 4416 | |
| 1292 | 4417 PROFILE_RECORD_ENTERING_SECTION (Qdispatch_event); |
| 4418 | |
| 428 | 4419 /* Some events don't have channels (e.g. eval events). */ |
| 4420 console = CDFW_CONSOLE (channel); | |
| 4421 if (NILP (console)) | |
| 4422 console = Vselected_console; | |
| 4423 else if (!EQ (console, Vselected_console)) | |
| 4424 Fselect_console (console); | |
| 4425 | |
| 4426 command_builder = XCOMMAND_BUILDER (XCONSOLE (console)->command_builder); | |
| 934 | 4427 switch (XEVENT_TYPE (event)) |
| 428 | 4428 { |
| 4429 case button_press_event: | |
| 4430 case button_release_event: | |
| 4431 case key_press_event: | |
| 4432 { | |
| 4433 Lisp_Object leaf = lookup_command_event (command_builder, event, 1); | |
| 4434 | |
| 4435 if (KEYMAPP (leaf)) | |
| 4436 /* Incomplete key sequence */ | |
| 4437 break; | |
| 4438 if (NILP (leaf)) | |
| 4439 { | |
| 4440 /* At this point, we know that the sequence is not bound to a | |
| 4441 command. Normally, we beep and print a message informing the | |
| 4442 user of this. But we do not beep or print a message when: | |
| 4443 | |
| 4444 o the last event in this sequence is a mouse-up event; or | |
| 4445 o the last event in this sequence is a mouse-down event and | |
| 4446 there is a binding for the mouse-up version. | |
| 4447 | |
| 4448 That is, if the sequence ``C-x button1'' is typed, and is not | |
| 4449 bound to a command, but the sequence ``C-x button1up'' is bound | |
| 4450 to a command, we do not complain about the ``C-x button1'' | |
| 4451 sequence. If neither ``C-x button1'' nor ``C-x button1up'' is | |
| 4452 bound to a command, then we complain about the ``C-x button1'' | |
| 4453 sequence, but later will *not* complain about the | |
| 4454 ``C-x button1up'' sequence, which would be redundant. | |
| 4455 | |
| 4456 This is pretty hairy, but I think it's the most intuitive | |
| 4457 behavior. | |
| 4458 */ | |
| 4459 Lisp_Object terminal = command_builder->most_current_event; | |
| 4460 | |
| 4461 if (XEVENT_TYPE (terminal) == button_press_event) | |
| 4462 { | |
| 4463 int no_bitching; | |
| 4464 /* Temporarily pretend the last event was an "up" instead of a | |
| 4465 "down", and look up its binding. */ | |
| 4466 XEVENT_TYPE (terminal) = button_release_event; | |
| 4467 /* If the "up" version is bound, don't complain. */ | |
| 4468 no_bitching | |
| 771 | 4469 = !NILP (command_builder_find_leaf_and_update_global_state |
| 4470 (command_builder, 0)); | |
| 428 | 4471 /* Undo the temporary changes we just made. */ |
| 4472 XEVENT_TYPE (terminal) = button_press_event; | |
| 4473 if (no_bitching) | |
| 4474 { | |
| 4475 /* Pretend this press was not seen (treat as a prefix) */ | |
| 4476 if (EQ (command_builder->current_events, terminal)) | |
| 4477 { | |
| 4478 reset_current_events (command_builder); | |
| 4479 } | |
| 4480 else | |
| 4481 { | |
| 4482 Lisp_Object eve; | |
| 4483 | |
| 4484 EVENT_CHAIN_LOOP (eve, command_builder->current_events) | |
| 4485 if (EQ (XEVENT_NEXT (eve), terminal)) | |
| 4486 break; | |
| 4487 | |
| 4488 Fdeallocate_event (command_builder-> | |
| 4489 most_current_event); | |
| 4490 XSET_EVENT_NEXT (eve, Qnil); | |
| 4491 command_builder->most_current_event = eve; | |
| 4492 } | |
| 4493 maybe_echo_keys (command_builder, 1); | |
| 4494 break; | |
| 4495 } | |
| 4496 } | |
| 4497 | |
| 4498 /* Complain that the typed sequence is not defined, if this is the | |
| 4499 kind of sequence that warrants a complaint. */ | |
| 4500 XCONSOLE (console)->defining_kbd_macro = Qnil; | |
| 4501 XCONSOLE (console)->prefix_arg = Qnil; | |
| 4502 /* Don't complain about undefined button-release events */ | |
| 4503 if (XEVENT_TYPE (terminal) != button_release_event) | |
| 4504 { | |
| 4505 Lisp_Object keys = current_events_into_vector (command_builder); | |
| 4506 struct gcpro gcpro1; | |
| 4507 | |
| 4508 /* Run the pre-command-hook before barfing about an undefined | |
| 4509 key. */ | |
| 4510 Vthis_command = Qnil; | |
| 4511 GCPRO1 (keys); | |
| 4512 pre_command_hook (); | |
| 4513 UNGCPRO; | |
| 4514 /* The post-command-hook doesn't run. */ | |
| 4515 Fsignal (Qundefined_keystroke_sequence, list1 (keys)); | |
| 4516 } | |
| 4517 /* Reset the command builder for reading the next sequence. */ | |
| 4518 reset_this_command_keys (console, 1); | |
| 4519 } | |
| 4520 else /* key sequence is bound to a command */ | |
| 4521 { | |
| 430 | 4522 int magic_undo = 0; |
| 4523 int magic_undo_count = 20; | |
| 4524 | |
| 428 | 4525 Vthis_command = leaf; |
| 430 | 4526 |
| 428 | 4527 /* Don't push an undo boundary if the command set the prefix arg, |
| 4528 or if we are executing a keyboard macro, or if in the | |
| 4529 minibuffer. If the command we are about to execute is | |
| 4530 self-insert, it's tricky: up to 20 consecutive self-inserts may | |
| 4531 be done without an undo boundary. This counter is reset as | |
| 4532 soon as a command other than self-insert-command is executed. | |
| 430 | 4533 |
| 442 | 4534 Programmers can also use the `self-insert-defer-undo' |
| 4535 property to install that behavior on functions other | |
| 430 | 4536 than `self-insert-command', or to change the magic |
| 442 | 4537 number 20 to something else. #### DOCUMENT THIS! */ |
| 430 | 4538 |
| 4539 if (SYMBOLP (leaf)) | |
| 4540 { | |
| 4541 Lisp_Object prop = Fget (leaf, Qself_insert_defer_undo, Qnil); | |
| 4542 if (NATNUMP (prop)) | |
| 4543 magic_undo = 1, magic_undo_count = XINT (prop); | |
| 4544 else if (!NILP (prop)) | |
| 4545 magic_undo = 1; | |
| 4546 else if (EQ (leaf, Qself_insert_command)) | |
| 4547 magic_undo = 1; | |
| 4548 } | |
| 4549 | |
| 4550 if (!magic_undo) | |
| 428 | 4551 command_builder->self_insert_countdown = 0; |
| 4552 if (NILP (XCONSOLE (console)->prefix_arg) | |
| 4553 && NILP (Vexecuting_macro) | |
| 4554 && command_builder->self_insert_countdown == 0) | |
| 4555 Fundo_boundary (); | |
| 4556 | |
| 430 | 4557 if (magic_undo) |
| 428 | 4558 { |
| 4559 if (--command_builder->self_insert_countdown < 0) | |
| 430 | 4560 command_builder->self_insert_countdown = magic_undo_count; |
| 428 | 4561 } |
| 4562 execute_command_event | |
| 4563 (command_builder, | |
| 444 | 4564 internal_equal (event, command_builder->most_current_event, 0) |
| 428 | 4565 ? event |
| 4566 /* Use the translated event that was most recently seen. | |
| 4567 This way, last-command-event becomes f1 instead of | |
| 4568 the P from ESC O P. But we must copy it, else we'll | |
| 4569 lose when the command-builder events are deallocated. */ | |
| 444 | 4570 : Fcopy_event (command_builder->most_current_event, Qnil)); |
| 428 | 4571 } |
| 4572 break; | |
| 4573 } | |
| 4574 case misc_user_event: | |
| 4575 { | |
| 4576 /* Jamie said: | |
| 4577 | |
| 4578 We could just always use the menu item entry, whatever it is, but | |
| 4579 this might break some Lisp code that expects `this-command' to | |
| 4580 always contain a symbol. So only store it if this is a simple | |
| 4581 `call-interactively' sort of menu item. | |
| 4582 | |
| 4583 But this is bogus. `this-command' could be a string or vector | |
| 4584 anyway (for keyboard macros). There's even one instance | |
| 4585 (in pending-del.el) of `this-command' getting set to a cons | |
| 4586 (a lambda expression). So in the `eval' case I'll just | |
| 4587 convert it into a lambda expression. | |
| 4588 */ | |
| 1204 | 4589 if (EQ (XEVENT_MISC_USER_FUNCTION (event), Qcall_interactively) |
| 4590 && SYMBOLP (XEVENT_MISC_USER_OBJECT (event))) | |
| 4591 Vthis_command = XEVENT_MISC_USER_OBJECT (event); | |
| 4592 else if (EQ (XEVENT_MISC_USER_FUNCTION (event), Qeval)) | |
| 934 | 4593 Vthis_command = |
| 1204 | 4594 Fcons (Qlambda, Fcons (Qnil, XEVENT_MISC_USER_OBJECT (event))); |
| 4595 else if (SYMBOLP (XEVENT_MISC_USER_FUNCTION (event))) | |
| 934 | 4596 /* A scrollbar command or the like. */ |
| 1204 | 4597 Vthis_command = XEVENT_MISC_USER_FUNCTION (event); |
| 428 | 4598 else |
| 4599 /* Huh? */ | |
| 4600 Vthis_command = Qnil; | |
| 4601 | |
| 4602 /* clear the echo area */ | |
| 4603 reset_key_echo (command_builder, 1); | |
| 4604 | |
| 4605 command_builder->self_insert_countdown = 0; | |
| 4606 if (NILP (XCONSOLE (console)->prefix_arg) | |
| 4607 && NILP (Vexecuting_macro) | |
| 4608 && !EQ (minibuf_window, Fselected_window (Qnil))) | |
| 4609 Fundo_boundary (); | |
| 4610 execute_command_event (command_builder, event); | |
| 4611 break; | |
| 4612 } | |
| 4613 default: | |
| 4614 execute_internal_event (event); | |
| 4615 break; | |
| 4616 } | |
| 1292 | 4617 |
| 4618 PROFILE_RECORD_EXITING_SECTION (Qdispatch_event); | |
| 428 | 4619 return Qnil; |
| 4620 } | |
| 4621 | |
| 4622 DEFUN ("read-key-sequence", Fread_key_sequence, 1, 3, 0, /* | |
| 4623 Read a sequence of keystrokes or mouse clicks. | |
| 4624 Returns a vector of the event objects read. The vector and the event | |
| 444 | 4625 objects it contains are freshly created (and so will not be side-effected |
| 428 | 4626 by subsequent calls to this function). |
| 4627 | |
| 4628 The sequence read is sufficient to specify a non-prefix command starting | |
| 4629 from the current local and global keymaps. A C-g typed while in this | |
| 4630 function is treated like any other character, and `quit-flag' is not set. | |
| 4631 | |
| 4632 First arg PROMPT is a prompt string. If nil, do not prompt specially. | |
| 444 | 4633 |
| 4634 Second optional arg CONTINUE-ECHO non-nil means this key echoes as a | |
| 4635 continuation of the previous key. | |
| 4636 | |
| 4637 Third optional arg DONT-DOWNCASE-LAST non-nil means do not convert the | |
| 4638 last event to lower case. (Normally any upper case event is converted | |
| 4639 to lower case if the original event is undefined and the lower case | |
| 4640 equivalent is defined.) This argument is provided mostly for FSF | |
| 4641 compatibility; the equivalent effect can be achieved more generally by | |
| 4642 binding `retry-undefined-key-binding-unshifted' to nil around the call | |
| 4643 to `read-key-sequence'. | |
| 428 | 4644 |
| 4645 If the user selects a menu item while we are prompting for a key-sequence, | |
| 4646 the returned value will be a vector of a single menu-selection event. | |
| 4647 An error will be signalled if you pass this value to `lookup-key' or a | |
| 4648 related function. | |
| 4649 | |
| 4650 `read-key-sequence' checks `function-key-map' for function key | |
| 444 | 4651 sequences, where they wouldn't conflict with ordinary bindings. |
| 4652 See `function-key-map' for more details. | |
| 428 | 4653 */ |
| 4654 (prompt, continue_echo, dont_downcase_last)) | |
| 4655 { | |
| 4656 /* This function can GC */ | |
| 4657 struct console *con = XCONSOLE (Vselected_console); /* #### correct? | |
| 4658 Probably not -- see | |
| 4659 comment in | |
| 4660 next-event */ | |
| 4661 struct command_builder *command_builder = | |
| 4662 XCOMMAND_BUILDER (con->command_builder); | |
| 4663 Lisp_Object result; | |
| 4664 Lisp_Object event = Fmake_event (Qnil, Qnil); | |
| 4665 int speccount = specpdl_depth (); | |
| 4666 struct gcpro gcpro1; | |
| 4667 GCPRO1 (event); | |
| 4668 | |
| 707 | 4669 record_unwind_protect (Fset_buffer, Fcurrent_buffer ()); |
| 428 | 4670 if (!NILP (prompt)) |
| 4671 CHECK_STRING (prompt); | |
| 4672 /* else prompt = Fkeymap_prompt (current_buffer->keymap); may GC */ | |
| 4673 QUIT; | |
| 4674 | |
| 4675 if (NILP (continue_echo)) | |
| 771 | 4676 reset_this_command_keys (wrap_console (con), 1); |
| 428 | 4677 |
| 4678 if (!NILP (dont_downcase_last)) | |
| 4679 specbind (Qretry_undefined_key_binding_unshifted, Qnil); | |
| 4680 | |
| 4681 for (;;) | |
| 4682 { | |
| 4683 Fnext_event (event, prompt); | |
| 4684 /* restore the selected-console damage */ | |
| 4685 con = event_console_or_selected (event); | |
| 4686 command_builder = XCOMMAND_BUILDER (con->command_builder); | |
| 4687 if (! command_event_p (event)) | |
| 4688 execute_internal_event (event); | |
| 4689 else | |
| 4690 { | |
| 934 | 4691 if (XEVENT_TYPE (event) == misc_user_event) |
| 428 | 4692 reset_current_events (command_builder); |
| 4693 result = lookup_command_event (command_builder, event, 1); | |
| 4694 if (!KEYMAPP (result)) | |
| 4695 { | |
| 4696 result = current_events_into_vector (command_builder); | |
| 4697 reset_key_echo (command_builder, 0); | |
| 4698 break; | |
| 4699 } | |
| 4700 prompt = Qnil; | |
| 4701 } | |
| 4702 } | |
| 4703 | |
| 4704 Fdeallocate_event (event); | |
| 771 | 4705 RETURN_UNGCPRO (unbind_to_1 (speccount, result)); |
| 428 | 4706 } |
| 4707 | |
| 4708 DEFUN ("this-command-keys", Fthis_command_keys, 0, 0, 0, /* | |
| 4709 Return a vector of the keyboard or mouse button events that were used | |
| 4710 to invoke this command. This copies the vector and the events; it is safe | |
| 4711 to keep and modify them. | |
| 4712 */ | |
| 4713 ()) | |
| 4714 { | |
| 4715 Lisp_Object event; | |
| 4716 Lisp_Object result; | |
| 4717 int len; | |
| 4718 | |
| 4719 if (NILP (Vthis_command_keys)) | |
| 4720 return make_vector (0, Qnil); | |
| 4721 | |
| 4722 len = event_chain_count (Vthis_command_keys); | |
| 4723 | |
| 4724 result = make_vector (len, Qnil); | |
| 4725 len = 0; | |
| 4726 EVENT_CHAIN_LOOP (event, Vthis_command_keys) | |
| 4727 XVECTOR_DATA (result)[len++] = Fcopy_event (event, Qnil); | |
| 4728 return result; | |
| 4729 } | |
| 4730 | |
| 4731 DEFUN ("reset-this-command-lengths", Freset_this_command_lengths, 0, 0, 0, /* | |
| 4732 Used for complicated reasons in `universal-argument-other-key'. | |
| 4733 | |
| 4734 `universal-argument-other-key' rereads the event just typed. | |
| 4735 It then gets translated through `function-key-map'. | |
| 4736 The translated event gets included in the echo area and in | |
| 4737 the value of `this-command-keys' in addition to the raw original event. | |
| 4738 That is not right. | |
| 4739 | |
| 4740 Calling this function directs the translated event to replace | |
| 4741 the original event, so that only one version of the event actually | |
| 430 | 4742 appears in the echo area and in the value of `this-command-keys'. |
| 428 | 4743 */ |
| 4744 ()) | |
| 4745 { | |
| 4746 /* #### I don't understand this at all, so currently it does nothing. | |
| 4747 If there is ever a problem, maybe someone should investigate. */ | |
| 4748 return Qnil; | |
| 4749 } | |
| 4750 | |
| 4751 | |
| 4752 static void | |
| 4753 dribble_out_event (Lisp_Object event) | |
| 4754 { | |
| 4755 if (NILP (Vdribble_file)) | |
| 4756 return; | |
| 4757 | |
| 934 | 4758 if (XEVENT_TYPE (event) == key_press_event && |
| 1204 | 4759 !XEVENT_KEY_MODIFIERS (event)) |
| 934 | 4760 { |
| 1204 | 4761 Lisp_Object keysym = XEVENT_KEY_KEYSYM (event); |
| 4762 if (CHARP (XEVENT_KEY_KEYSYM (event))) | |
| 428 | 4763 { |
| 867 | 4764 Ichar ch = XCHAR (keysym); |
| 4765 Ibyte str[MAX_ICHAR_LEN]; | |
| 4766 Bytecount len = set_itext_ichar (str, ch); | |
| 428 | 4767 Lstream_write (XLSTREAM (Vdribble_file), str, len); |
| 4768 } | |
| 826 | 4769 else if (string_char_length (XSYMBOL (keysym)->name) == 1) |
| 428 | 4770 /* one-char key events are printed with just the key name */ |
| 4771 Fprinc (keysym, Vdribble_file); | |
| 4772 else if (EQ (keysym, Qreturn)) | |
| 4773 Lstream_putc (XLSTREAM (Vdribble_file), '\n'); | |
| 4774 else if (EQ (keysym, Qspace)) | |
| 4775 Lstream_putc (XLSTREAM (Vdribble_file), ' '); | |
| 4776 else | |
| 4777 Fprinc (event, Vdribble_file); | |
| 4778 } | |
| 4779 else | |
| 4780 Fprinc (event, Vdribble_file); | |
| 4781 Lstream_flush (XLSTREAM (Vdribble_file)); | |
| 4782 } | |
| 4783 | |
| 4784 DEFUN ("open-dribble-file", Fopen_dribble_file, 1, 1, | |
| 4785 "FOpen dribble file: ", /* | |
| 444 | 4786 Start writing all keyboard characters to a dribble file called FILENAME. |
| 4787 If FILENAME is nil, close any open dribble file. | |
| 428 | 4788 */ |
| 444 | 4789 (filename)) |
| 428 | 4790 { |
| 4791 /* This function can GC */ | |
| 4792 /* XEmacs change: always close existing dribble file. */ | |
| 4793 /* FSFmacs uses FILE *'s here. With lstreams, that's unnecessary. */ | |
| 4794 if (!NILP (Vdribble_file)) | |
| 4795 { | |
| 4796 Lstream_close (XLSTREAM (Vdribble_file)); | |
| 4797 Vdribble_file = Qnil; | |
| 4798 } | |
| 444 | 4799 if (!NILP (filename)) |
| 428 | 4800 { |
| 4801 int fd; | |
| 4802 | |
| 444 | 4803 filename = Fexpand_file_name (filename, Qnil); |
| 771 | 4804 fd = qxe_open (XSTRING_DATA (filename), |
| 4805 O_WRONLY | O_TRUNC | O_CREAT | OPEN_BINARY, | |
| 4806 CREAT_MODE); | |
| 428 | 4807 if (fd < 0) |
| 563 | 4808 report_file_error ("Unable to create dribble file", filename); |
| 428 | 4809 Vdribble_file = make_filedesc_output_stream (fd, 0, 0, LSTR_CLOSING); |
| 4810 #ifdef MULE | |
| 4811 Vdribble_file = | |
| 771 | 4812 make_coding_output_stream |
| 4813 (XLSTREAM (Vdribble_file), | |
| 800 | 4814 Qescape_quoted, CODING_ENCODE, 0); |
| 428 | 4815 #endif |
| 4816 } | |
| 4817 return Qnil; | |
| 4818 } | |
| 4819 | |
| 4820 | |
| 442 | 4821 |
| 4822 DEFUN ("current-event-timestamp", Fcurrent_event_timestamp, 0, 1, 0, /* | |
| 4823 Return the current event timestamp of the window system associated with CONSOLE. | |
| 4824 CONSOLE defaults to the selected console if omitted. | |
| 4825 */ | |
| 4826 (console)) | |
| 4827 { | |
| 4828 struct console *c = decode_console (console); | |
| 4829 int tiempo = event_stream_current_event_timestamp (c); | |
| 4830 | |
| 4831 /* This junk is so that timestamps don't get to be negative, but contain | |
| 4832 as many bits as this particular emacs will allow. | |
| 4833 */ | |
| 2039 | 4834 return make_int (EMACS_INT_MAX & tiempo); |
| 442 | 4835 } |
| 4836 | |
| 4837 | |
| 428 | 4838 /************************************************************************/ |
| 4839 /* initialization */ | |
| 4840 /************************************************************************/ | |
| 4841 | |
| 4842 void | |
| 4843 syms_of_event_stream (void) | |
| 4844 { | |
|
5117
3742ea8250b5
Checking in final CVS version of workspace 'ben-lisp-object'
Ben Wing <ben@xemacs.org>
parents:
3025
diff
changeset
|
4845 INIT_LISP_OBJECT (command_builder); |
|
3742ea8250b5
Checking in final CVS version of workspace 'ben-lisp-object'
Ben Wing <ben@xemacs.org>
parents:
3025
diff
changeset
|
4846 INIT_LISP_OBJECT (timeout); |
| 442 | 4847 |
| 563 | 4848 DEFSYMBOL (Qdisabled); |
| 4849 DEFSYMBOL (Qcommand_event_p); | |
| 4850 | |
| 4851 DEFERROR_STANDARD (Qundefined_keystroke_sequence, Qsyntax_error); | |
| 4852 DEFERROR_STANDARD (Qinvalid_key_binding, Qinvalid_state); | |
| 428 | 4853 |
| 4854 DEFSUBR (Frecent_keys); | |
| 4855 DEFSUBR (Frecent_keys_ring_size); | |
| 4856 DEFSUBR (Fset_recent_keys_ring_size); | |
| 4857 DEFSUBR (Finput_pending_p); | |
| 4858 DEFSUBR (Fenqueue_eval_event); | |
| 4859 DEFSUBR (Fnext_event); | |
| 4860 DEFSUBR (Fnext_command_event); | |
| 4861 DEFSUBR (Fdiscard_input); | |
| 4862 DEFSUBR (Fsit_for); | |
| 4863 DEFSUBR (Fsleep_for); | |
| 4864 DEFSUBR (Faccept_process_output); | |
| 4865 DEFSUBR (Fadd_timeout); | |
| 4866 DEFSUBR (Fdisable_timeout); | |
| 4867 DEFSUBR (Fadd_async_timeout); | |
| 4868 DEFSUBR (Fdisable_async_timeout); | |
| 4869 DEFSUBR (Fdispatch_event); | |
| 442 | 4870 DEFSUBR (Fdispatch_non_command_events); |
| 428 | 4871 DEFSUBR (Fread_key_sequence); |
| 4872 DEFSUBR (Fthis_command_keys); | |
| 4873 DEFSUBR (Freset_this_command_lengths); | |
| 4874 DEFSUBR (Fopen_dribble_file); | |
| 442 | 4875 DEFSUBR (Fcurrent_event_timestamp); |
| 428 | 4876 |
| 563 | 4877 DEFSYMBOL (Qpre_command_hook); |
| 4878 DEFSYMBOL (Qpost_command_hook); | |
| 4879 DEFSYMBOL (Qunread_command_events); | |
| 4880 DEFSYMBOL (Qunread_command_event); | |
| 4881 DEFSYMBOL (Qpre_idle_hook); | |
| 4882 DEFSYMBOL (Qhandle_pre_motion_command); | |
| 4883 DEFSYMBOL (Qhandle_post_motion_command); | |
| 4884 DEFSYMBOL (Qretry_undefined_key_binding_unshifted); | |
| 4885 DEFSYMBOL (Qauto_show_make_point_visible); | |
| 4886 | |
| 4887 DEFSYMBOL (Qself_insert_defer_undo); | |
| 4888 DEFSYMBOL (Qcancel_mode_internal); | |
| 1292 | 4889 |
| 4890 DEFSYMBOL (Qnext_event); | |
| 4891 DEFSYMBOL (Qdispatch_event); | |
| 428 | 4892 } |
| 4893 | |
| 4894 void | |
| 4895 reinit_vars_of_event_stream (void) | |
| 4896 { | |
| 4897 recent_keys_ring_index = 0; | |
| 4898 recent_keys_ring_size = 100; | |
| 4899 num_input_chars = 0; | |
| 4900 the_low_level_timeout_blocktype = | |
| 4901 Blocktype_new (struct low_level_timeout_blocktype); | |
| 4902 something_happened = 0; | |
| 1268 | 4903 recursive_sit_for = 0; |
| 4904 in_modal_loop = 0; | |
| 428 | 4905 } |
| 4906 | |
| 4907 void | |
| 4908 vars_of_event_stream (void) | |
| 4909 { | |
| 4910 Vrecent_keys_ring = Qnil; | |
| 4911 staticpro (&Vrecent_keys_ring); | |
| 4912 | |
| 4913 Vthis_command_keys = Qnil; | |
| 4914 staticpro (&Vthis_command_keys); | |
| 4915 Vthis_command_keys_tail = Qnil; | |
| 1204 | 4916 dump_add_root_lisp_object (&Vthis_command_keys_tail); |
| 428 | 4917 |
| 4918 command_event_queue = Qnil; | |
| 4919 staticpro (&command_event_queue); | |
| 4920 command_event_queue_tail = Qnil; | |
| 1204 | 4921 dump_add_root_lisp_object (&command_event_queue_tail); |
| 4922 | |
| 4923 dispatch_event_queue = Qnil; | |
| 4924 staticpro (&dispatch_event_queue); | |
| 4925 dispatch_event_queue_tail = Qnil; | |
| 4926 dump_add_root_lisp_object (&dispatch_event_queue_tail); | |
| 428 | 4927 |
| 4928 Vlast_selected_frame = Qnil; | |
| 4929 staticpro (&Vlast_selected_frame); | |
| 4930 | |
| 4931 pending_timeout_list = Qnil; | |
| 4932 staticpro (&pending_timeout_list); | |
| 4933 | |
| 4934 pending_async_timeout_list = Qnil; | |
| 4935 staticpro (&pending_async_timeout_list); | |
| 4936 | |
| 4937 last_point_position_buffer = Qnil; | |
| 4938 staticpro (&last_point_position_buffer); | |
| 4939 | |
| 1292 | 4940 QSnext_event_internal = build_string ("next_event_internal()"); |
| 4941 staticpro (&QSnext_event_internal); | |
| 4942 QSexecute_internal_event = build_string ("execute_internal_event()"); | |
| 4943 staticpro (&QSexecute_internal_event); | |
| 4944 | |
| 428 | 4945 DEFVAR_LISP ("echo-keystrokes", &Vecho_keystrokes /* |
| 4946 *Nonzero means echo unfinished commands after this many seconds of pause. | |
| 4947 */ ); | |
| 4948 Vecho_keystrokes = make_int (1); | |
| 4949 | |
| 4950 DEFVAR_INT ("auto-save-interval", &auto_save_interval /* | |
| 4951 *Number of keyboard input characters between auto-saves. | |
| 4952 Zero means disable autosaving due to number of characters typed. | |
| 4953 See also the variable `auto-save-timeout'. | |
| 4954 */ ); | |
| 4955 auto_save_interval = 300; | |
| 4956 | |
| 4957 DEFVAR_LISP ("pre-command-hook", &Vpre_command_hook /* | |
| 4958 Function or functions to run before every command. | |
| 4959 This may examine the `this-command' variable to find out what command | |
| 4960 is about to be run, or may change it to cause a different command to run. | |
| 853 | 4961 Errors while running the hook are caught and turned into warnings. |
| 428 | 4962 */ ); |
| 4963 Vpre_command_hook = Qnil; | |
| 4964 | |
| 4965 DEFVAR_LISP ("post-command-hook", &Vpost_command_hook /* | |
| 4966 Function or functions to run after every command. | |
| 4967 This may examine the `this-command' variable to find out what command | |
| 4968 was just executed. | |
| 4969 */ ); | |
| 4970 Vpost_command_hook = Qnil; | |
| 4971 | |
| 4972 DEFVAR_LISP ("pre-idle-hook", &Vpre_idle_hook /* | |
| 4973 Normal hook run when XEmacs it about to be idle. | |
| 4974 This occurs whenever it is going to block, waiting for an event. | |
| 4975 This generally happens as a result of a call to `next-event', | |
| 4976 `next-command-event', `sit-for', `sleep-for', `accept-process-output', | |
| 853 | 4977 or `get-selection'. Errors while running the hook are caught and |
| 4978 turned into warnings. | |
| 428 | 4979 */ ); |
| 4980 Vpre_idle_hook = Qnil; | |
| 4981 | |
| 4982 DEFVAR_BOOL ("focus-follows-mouse", &focus_follows_mouse /* | |
| 4983 *Variable to control XEmacs behavior with respect to focus changing. | |
| 4984 If this variable is set to t, then XEmacs will not gratuitously change | |
| 4985 the keyboard focus. XEmacs cannot in general detect when this mode is | |
| 4986 used by the window manager, so it is up to the user to set it. | |
| 4987 */ ); | |
| 4988 focus_follows_mouse = 0; | |
| 4989 | |
| 4990 DEFVAR_LISP ("last-command-event", &Vlast_command_event /* | |
| 4991 Last keyboard or mouse button event that was part of a command. This | |
| 4992 variable is off limits: you may not set its value or modify the event that | |
| 4993 is its value, as it is destructively modified by `read-key-sequence'. If | |
| 4994 you want to keep a pointer to this value, you must use `copy-event'. | |
| 4995 */ ); | |
| 4996 Vlast_command_event = Qnil; | |
| 4997 | |
| 4998 DEFVAR_LISP ("last-command-char", &Vlast_command_char /* | |
| 4999 If the value of `last-command-event' is a keyboard event, then | |
| 5000 this is the nearest ASCII equivalent to it. This is the value that | |
| 5001 `self-insert-command' will put in the buffer. Remember that there is | |
| 5002 NOT a 1:1 mapping between keyboard events and ASCII characters: the set | |
| 5003 of keyboard events is much larger, so writing code that examines this | |
| 5004 variable to determine what key has been typed is bad practice, unless | |
| 5005 you are certain that it will be one of a small set of characters. | |
| 5006 */ ); | |
| 5007 Vlast_command_char = Qnil; | |
| 5008 | |
| 5009 DEFVAR_LISP ("last-input-event", &Vlast_input_event /* | |
| 5010 Last keyboard or mouse button event received. This variable is off | |
| 5011 limits: you may not set its value or modify the event that is its value, as | |
| 5012 it is destructively modified by `next-event'. If you want to keep a pointer | |
| 5013 to this value, you must use `copy-event'. | |
| 5014 */ ); | |
| 5015 Vlast_input_event = Qnil; | |
| 5016 | |
| 5017 DEFVAR_LISP ("current-mouse-event", &Vcurrent_mouse_event /* | |
| 5018 The mouse-button event which invoked this command, or nil. | |
| 5019 This is usually what `(interactive "e")' returns. | |
| 5020 */ ); | |
| 5021 Vcurrent_mouse_event = Qnil; | |
| 5022 | |
| 5023 DEFVAR_LISP ("last-input-char", &Vlast_input_char /* | |
| 5024 If the value of `last-input-event' is a keyboard event, then | |
| 5025 this is the nearest ASCII equivalent to it. Remember that there is | |
| 5026 NOT a 1:1 mapping between keyboard events and ASCII characters: the set | |
| 5027 of keyboard events is much larger, so writing code that examines this | |
| 5028 variable to determine what key has been typed is bad practice, unless | |
| 5029 you are certain that it will be one of a small set of characters. | |
| 5030 */ ); | |
| 5031 Vlast_input_char = Qnil; | |
| 5032 | |
| 5033 DEFVAR_LISP ("last-input-time", &Vlast_input_time /* | |
| 5034 The time (in seconds since Jan 1, 1970) of the last-command-event, | |
| 5035 represented as a cons of two 16-bit integers. This is destructively | |
| 5036 modified, so copy it if you want to keep it. | |
| 5037 */ ); | |
| 5038 Vlast_input_time = Qnil; | |
| 5039 | |
| 5040 DEFVAR_LISP ("last-command-event-time", &Vlast_command_event_time /* | |
| 5041 The time (in seconds since Jan 1, 1970) of the last-command-event, | |
| 5042 represented as a list of three integers. The first integer contains | |
| 5043 the most significant 16 bits of the number of seconds, and the second | |
| 5044 integer contains the least significant 16 bits. The third integer | |
| 5045 contains the remainder number of microseconds, if the current system | |
| 5046 supports microsecond clock resolution. This list is destructively | |
| 5047 modified, so copy it if you want to keep it. | |
| 5048 */ ); | |
| 5049 Vlast_command_event_time = Qnil; | |
| 5050 | |
| 5051 DEFVAR_LISP ("unread-command-events", &Vunread_command_events /* | |
| 5052 List of event objects to be read as next command input events. | |
| 5053 This can be used to simulate the receipt of events from the user. | |
| 5054 Normally this is nil. | |
| 5055 Events are removed from the front of this list. | |
| 5056 */ ); | |
| 5057 Vunread_command_events = Qnil; | |
| 5058 | |
| 5059 DEFVAR_LISP ("unread-command-event", &Vunread_command_event /* | |
| 5060 Obsolete. Use `unread-command-events' instead. | |
| 5061 */ ); | |
| 5062 Vunread_command_event = Qnil; | |
| 5063 | |
| 5064 DEFVAR_LISP ("last-command", &Vlast_command /* | |
| 5065 The last command executed. Normally a symbol with a function definition, | |
| 5066 but can be whatever was found in the keymap, or whatever the variable | |
| 5067 `this-command' was set to by that command. | |
| 5068 */ ); | |
| 5069 Vlast_command = Qnil; | |
| 5070 | |
| 5071 DEFVAR_LISP ("this-command", &Vthis_command /* | |
| 5072 The command now being executed. | |
| 5073 The command can set this variable; whatever is put here | |
| 5074 will be in `last-command' during the following command. | |
| 5075 */ ); | |
| 5076 Vthis_command = Qnil; | |
| 5077 | |
| 442 | 5078 DEFVAR_LISP ("last-command-properties", &Vlast_command_properties /* |
| 5079 Value of `this-command-properties' for the last command. | |
| 5080 Used by commands to help synchronize consecutive commands, in preference | |
| 5081 to looking at `last-command' directly. | |
| 5082 */ ); | |
| 5083 Vlast_command_properties = Qnil; | |
| 5084 | |
| 5085 DEFVAR_LISP ("this-command-properties", &Vthis_command_properties /* | |
| 5086 Properties set by the current command. | |
| 5087 At the beginning of each command, the current value of this variable is | |
| 5088 copied to `last-command-properties', and then it is set to nil. Use `putf' | |
| 5089 to add properties to this variable. Commands should use this to communicate | |
| 5090 with pre/post-command hooks, subsequent commands, wrapping commands, etc. | |
| 5091 in preference to looking at and/or setting `this-command'. | |
| 5092 */ ); | |
| 5093 Vthis_command_properties = Qnil; | |
| 5094 | |
| 428 | 5095 DEFVAR_LISP ("help-char", &Vhelp_char /* |
| 5096 Character to recognize as meaning Help. | |
| 5097 When it is read, do `(eval help-form)', and display result if it's a string. | |
| 5098 If the value of `help-form' is nil, this char can be read normally. | |
| 5099 This can be any form recognized as a single key specifier. | |
| 5100 The help-char cannot be a negative number in XEmacs. | |
| 5101 */ ); | |
| 5102 Vhelp_char = make_char (8); /* C-h */ | |
| 5103 | |
| 5104 DEFVAR_LISP ("help-form", &Vhelp_form /* | |
| 5105 Form to execute when character help-char is read. | |
| 5106 If the form returns a string, that string is displayed. | |
| 5107 If `help-form' is nil, the help char is not recognized. | |
| 5108 */ ); | |
| 5109 Vhelp_form = Qnil; | |
| 5110 | |
| 5111 DEFVAR_LISP ("prefix-help-command", &Vprefix_help_command /* | |
| 5112 Command to run when `help-char' character follows a prefix key. | |
| 5113 This command is used only when there is no actual binding | |
| 5114 for that character after that prefix key. | |
| 5115 */ ); | |
| 5116 Vprefix_help_command = Qnil; | |
| 5117 | |
| 5118 DEFVAR_CONST_LISP ("keyboard-translate-table", &Vkeyboard_translate_table /* | |
| 5119 Hash table used as translate table for keyboard input. | |
| 5120 Use `keyboard-translate' to portably add entries to this table. | |
| 5121 Each key-press event is looked up in this table as follows: | |
| 5122 | |
| 5123 -- If an entry maps a symbol to a symbol, then a key-press event whose | |
| 5124 keysym is the former symbol (with any modifiers at all) gets its | |
| 5125 keysym changed and its modifiers left alone. This is useful for | |
| 5126 dealing with non-standard X keyboards, such as the grievous damage | |
| 5127 that Sun has inflicted upon the world. | |
| 442 | 5128 -- If an entry maps a symbol to a character, then a key-press event |
| 5129 whose keysym is the former symbol (with any modifiers at all) gets | |
| 5130 changed into a key-press event matching the latter character, and the | |
| 5131 resulting modifiers are the union of the original and new modifiers. | |
| 428 | 5132 -- If an entry maps a character to a character, then a key-press event |
| 5133 matching the former character gets converted to a key-press event | |
| 5134 matching the latter character. This is useful on ASCII terminals | |
| 5135 for (e.g.) making C-\\ look like C-s, to get around flow-control | |
| 5136 problems. | |
| 5137 -- If an entry maps a character to a symbol, then a key-press event | |
| 5138 matching the character gets converted to a key-press event whose | |
| 5139 keysym is the given symbol and which has no modifiers. | |
| 442 | 5140 |
| 5141 Here's an example: This makes typing parens and braces easier by rerouting | |
| 5142 their positions to eliminate the need to use the Shift key. | |
| 5143 | |
| 5144 (keyboard-translate ?[ ?() | |
| 5145 (keyboard-translate ?] ?)) | |
| 5146 (keyboard-translate ?{ ?[) | |
| 5147 (keyboard-translate ?} ?]) | |
| 5148 (keyboard-translate 'f11 ?{) | |
| 5149 (keyboard-translate 'f12 ?}) | |
| 428 | 5150 */ ); |
| 5151 | |
| 5152 DEFVAR_LISP ("retry-undefined-key-binding-unshifted", | |
| 5153 &Vretry_undefined_key_binding_unshifted /* | |
| 5154 If a key-sequence which ends with a shifted keystroke is undefined | |
| 5155 and this variable is non-nil then the command lookup is retried again | |
| 5156 with the last key unshifted. (e.g. C-X C-F would be retried as C-X C-f.) | |
| 5157 If lookup still fails, a normal error is signalled. In general, | |
| 5158 you should *bind* this, not set it. | |
| 5159 */ ); | |
| 5160 Vretry_undefined_key_binding_unshifted = Qt; | |
| 5161 | |
| 442 | 5162 DEFVAR_BOOL ("modifier-keys-are-sticky", &modifier_keys_are_sticky /* |
| 5163 *Non-nil makes modifier keys sticky. | |
| 5164 This means that you can release the modifier key before pressing down | |
| 5165 the key that you wish to be modified. Although this is non-standard | |
| 5166 behavior, it is recommended because it reduces the strain on your hand, | |
| 5167 thus reducing the incidence of the dreaded Emacs-pinky syndrome. | |
| 444 | 5168 |
| 5169 Modifier keys are sticky within the inverval specified by | |
| 5170 `modifier-keys-sticky-time'. | |
| 442 | 5171 */ ); |
| 5172 modifier_keys_are_sticky = 0; | |
| 5173 | |
| 444 | 5174 DEFVAR_LISP ("modifier-keys-sticky-time", &Vmodifier_keys_sticky_time /* |
| 5175 *Modifier keys are sticky within this many milliseconds. | |
| 5176 If you don't want modifier keys sticking to be bounded, set this to | |
| 5177 non-integer value. | |
| 5178 | |
| 5179 This variable has no effect when `modifier-keys-are-sticky' is nil. | |
| 5180 Currently only implemented under X Window System. | |
| 5181 */ ); | |
| 5182 Vmodifier_keys_sticky_time = make_int (500); | |
| 5183 | |
| 428 | 5184 Vcontrolling_terminal = Qnil; |
| 5185 staticpro (&Vcontrolling_terminal); | |
| 5186 | |
| 5187 Vdribble_file = Qnil; | |
| 5188 staticpro (&Vdribble_file); | |
| 5189 | |
| 5190 #ifdef DEBUG_XEMACS | |
| 5191 DEFVAR_INT ("debug-emacs-events", &debug_emacs_events /* | |
| 5192 If non-zero, display debug information about Emacs events that XEmacs sees. | |
| 5193 Information is displayed on stderr. | |
| 5194 | |
| 5195 Before the event, the source of the event is displayed in parentheses, | |
| 5196 and is one of the following: | |
| 5197 | |
| 5198 \(real) A real event from the window system or | |
| 5199 terminal driver, as far as XEmacs can tell. | |
| 5200 | |
| 5201 \(keyboard macro) An event generated from a keyboard macro. | |
| 5202 | |
| 5203 \(unread-command-events) An event taken from `unread-command-events'. | |
| 5204 | |
| 5205 \(unread-command-event) An event taken from `unread-command-event'. | |
| 5206 | |
| 5207 \(command event queue) An event taken from an internal queue. | |
| 5208 Events end up on this queue when | |
| 5209 `enqueue-eval-event' is called or when | |
| 5210 user or eval events are received while | |
| 5211 XEmacs is blocking (e.g. in `sit-for', | |
| 5212 `sleep-for', or `accept-process-output', | |
| 5213 or while waiting for the reply to an | |
| 5214 X selection). | |
| 5215 | |
| 5216 \(->keyboard-translate-table) The result of an event translated through | |
| 5217 keyboard-translate-table. Note that in | |
| 5218 this case, two events are printed even | |
| 5219 though only one is really generated. | |
| 5220 | |
| 5221 \(SIGINT) A faked C-g resulting when XEmacs receives | |
| 5222 a SIGINT (e.g. C-c was pressed in XEmacs' | |
| 5223 controlling terminal or the signal was | |
| 5224 explicitly sent to the XEmacs process). | |
| 5225 */ ); | |
| 5226 debug_emacs_events = 0; | |
| 5227 #endif | |
| 5228 | |
| 2828 | 5229 DEFVAR_BOOL ("inhibit-input-event-recording", |
| 5230 &inhibit_input_event_recording /* | |
| 428 | 5231 Non-nil inhibits recording of input-events to recent-keys ring. |
| 5232 */ ); | |
| 5233 inhibit_input_event_recording = 0; | |
| 771 | 5234 |
| 428 | 5235 Vkeyboard_translate_table = |
| 5236 make_lisp_hash_table (100, HASH_TABLE_NON_WEAK, HASH_TABLE_EQ); | |
| 2828 | 5237 |
| 5238 DEFVAR_BOOL ("try-alternate-layouts-for-commands", | |
| 5239 &try_alternate_layouts_for_commands /* | |
| 5240 Non-nil means that if looking up a command from a sequence of keys typed by | |
| 5241 the user would otherwise fail, try it again with some other keyboard | |
| 5242 layout. On X11, the only alternative to the default mapping is American | |
| 5243 QWERTY; on Windows, other mappings may be available, depending on things | |
| 5244 like the default language environment for the current user, for the system, | |
| 5245 &c. | |
| 5246 | |
| 5247 With a Russian keyboard layout on X11, for example, this means that | |
| 5248 C-Cyrillic_che C-Cyrillic_a, if you haven't given that sequence a binding | |
| 5249 yourself, will invoke `find-file.' This is because `Cyrillic_che' is | |
| 5250 physically where `x' is, and `Cyrillic_a' is where `f' is, on an American | |
| 5251 Qwerty layout, and, of course, C-x C-f is a default emacs binding for that | |
| 5252 command. | |
| 5253 */ ); | |
| 5254 try_alternate_layouts_for_commands = 1; | |
| 428 | 5255 } |
| 5256 | |
| 5257 void | |
| 5258 init_event_stream (void) | |
| 5259 { | |
| 814 | 5260 /* Normally we don't initialize the event stream when running a bare |
| 5261 temacs (the check for initialized) because it may do various things | |
| 5262 (e.g. under Xt) that we don't want any traces of in a dumped xemacs. | |
| 5263 However, sometimes we need to process events in a bare temacs (in | |
| 5264 particular, when make-docfile.el is executed); so we initialize as | |
| 5265 necessary in check_event_stream_ok(). */ | |
| 428 | 5266 if (initialized) |
| 5267 { | |
| 5268 #ifdef HAVE_UNIXOID_EVENT_LOOP | |
| 5269 init_event_unixoid (); | |
| 5270 #endif | |
| 5271 #ifdef HAVE_X_WINDOWS | |
| 5272 if (!strcmp (display_use, "x")) | |
| 5273 init_event_Xt_late (); | |
| 5274 else | |
| 5275 #endif | |
| 462 | 5276 #ifdef HAVE_GTK |
| 5277 if (!strcmp (display_use, "gtk")) | |
| 5278 init_event_gtk_late (); | |
| 5279 else | |
| 5280 #endif | |
| 428 | 5281 #ifdef HAVE_MS_WINDOWS |
| 5282 if (!strcmp (display_use, "mswindows")) | |
| 5283 init_event_mswindows_late (); | |
| 5284 else | |
| 5285 #endif | |
| 5286 { | |
| 5287 /* For TTY's, use the Xt event loop if we can; it allows | |
| 5288 us to later open an X connection. */ | |
| 5289 #if defined (HAVE_MS_WINDOWS) && (!defined (HAVE_TTY) \ | |
| 5290 || (defined (HAVE_MSG_SELECT) \ | |
| 5291 && !defined (DEBUG_TTY_EVENT_STREAM))) | |
| 5292 init_event_mswindows_late (); | |
| 5293 #elif defined (HAVE_X_WINDOWS) && !defined (DEBUG_TTY_EVENT_STREAM) | |
| 5294 init_event_Xt_late (); | |
| 5295 #elif defined (HAVE_TTY) | |
| 5296 init_event_tty_late (); | |
| 5297 #endif | |
| 5298 } | |
| 5299 init_interrupts_late (); | |
| 5300 } | |
| 5301 } | |
| 5302 | |
| 5303 | |
| 5304 /* | |
| 853 | 5305 #### this comment is at least 8 years old and some may no longer apply. |
| 5306 | |
| 428 | 5307 useful testcases for v18/v19 compatibility: |
| 5308 | |
| 5309 (defun foo () | |
| 5310 (interactive) | |
| 5311 (setq unread-command-event (character-to-event ?A (allocate-event))) | |
| 5312 (setq x (list (read-char) | |
| 5313 ; (read-key-sequence "") ; try it with and without this | |
| 5314 last-command-char last-input-char | |
| 5315 (recent-keys) (this-command-keys)))) | |
| 5316 (global-set-key "\^Q" 'foo) | |
| 5317 | |
| 5318 without the read-key-sequence: | |
| 444 | 5319 ^Q ==> (?A ?\^Q ?A [... ^Q] [^Q]) |
| 5320 ^U^U^Q ==> (?A ?\^Q ?A [... ^U ^U ^Q] [^U ^U ^Q]) | |
| 5321 ^U^U^U^G^Q ==> (?A ?\^Q ?A [... ^U ^U ^U ^G ^Q] [^Q]) | |
| 428 | 5322 |
| 5323 with the read-key-sequence: | |
| 444 | 5324 ^Qb ==> (?A [b] ?\^Q ?b [... ^Q b] [b]) |
| 5325 ^U^U^Qb ==> (?A [b] ?\^Q ?b [... ^U ^U ^Q b] [b]) | |
| 5326 ^U^U^U^G^Qb ==> (?A [b] ?\^Q ?b [... ^U ^U ^U ^G ^Q b] [b]) | |
| 428 | 5327 |
| 5328 ;the evi-mode command "4dlj.j.j.j.j.j." is also a good testcase (gag) | |
| 5329 | |
| 5330 ;(setq x (list (read-char) quit-flag))^J^G | |
| 5331 ;(let ((inhibit-quit t)) (setq x (list (read-char) quit-flag)))^J^G | |
| 5332 ;for BOTH, x should get set to (7 t), but no result should be printed. | |
| 444 | 5333 ;; #### According to the doc of quit-flag, second test should return |
| 5334 ;; (?\^G nil). Accidentaly XEmacs returns correct value. However, | |
| 5335 ;; XEmacs 21.1.12 and 21.2.36 both fails on first test. | |
| 428 | 5336 |
| 5337 ;also do this: make two frames, one viewing "*scratch*", the other "foo". | |
| 5338 ;in *scratch*, type (sit-for 20)^J | |
| 5339 ;wait a couple of seconds, move cursor to foo, type "a" | |
| 5340 ;a should be inserted in foo. Cursor highlighting should not change in | |
| 5341 ;the meantime. | |
| 5342 | |
| 5343 ;do it with sleep-for. move cursor into foo, then back into *scratch* | |
| 5344 ;before typing. | |
| 5345 ;repeat also with (accept-process-output nil 20) | |
| 5346 | |
| 5347 ;make sure ^G aborts sit-for, sleep-for and accept-process-output: | |
| 5348 | |
| 5349 (defun tst () | |
| 5350 (list (condition-case c | |
| 5351 (sleep-for 20) | |
| 5352 (quit c)) | |
| 5353 (read-char))) | |
| 5354 | |
| 444 | 5355 (tst)^Ja^G ==> ((quit) ?a) with no signal |
| 5356 (tst)^J^Ga ==> ((quit) ?a) with no signal | |
| 5357 (tst)^Jabc^G ==> ((quit) ?a) with no signal, and "bc" inserted in buffer | |
| 428 | 5358 |
| 5359 ; with sit-for only do the 2nd test. | |
| 5360 ; Do all 3 tests with (accept-process-output nil 20) | |
| 5361 | |
| 5362 Do this: | |
| 5363 (setq enable-recursive-minibuffers t | |
| 5364 minibuffer-max-depth nil) | |
| 5365 ESC ESC ESC ESC - there are now two minibuffers active | |
| 5366 C-g C-g C-g - there should be active 0, not 1 | |
| 5367 Similarly: | |
| 5368 C-x C-f ~ / ? - wait for "Making completion list..." to display | |
| 5369 C-g - wait for "Quit" to display | |
| 5370 C-g - minibuffer should not be active | |
| 5371 however C-g before "Quit" is displayed should leave minibuffer active. | |
| 5372 | |
| 5373 ;do it all in both v18 and v19 and make sure all results are the same. | |
| 5374 ;all of these cases matter a lot, but some in quite subtle ways. | |
| 5375 */ | |
| 5376 | |
| 5377 /* | |
| 5378 Additional test cases for accept-process-output, sleep-for, sit-for. | |
| 5379 Be sure you do all of the above checking for C-g and focus, too! | |
| 5380 | |
| 5381 ; Make sure that timer handlers are run during, not after sit-for: | |
| 5382 (defun timer-check () | |
| 5383 (add-timeout 2 '(lambda (ignore) (message "timer ran")) nil) | |
| 5384 (sit-for 5) | |
| 5385 (message "after sit-for")) | |
| 5386 | |
| 5387 ; The first message should appear after 2 seconds, and the final message | |
| 5388 ; 3 seconds after that. | |
| 5389 ; repeat above test with (sleep-for 5) and (accept-process-output nil 5) | |
| 5390 | |
| 5391 | |
| 5392 | |
| 5393 ; Make sure that process filters are run during, not after sit-for. | |
| 5394 (defun fubar () | |
| 5395 (message "sit-for = %s" (sit-for 30))) | |
| 5396 (add-hook 'post-command-hook 'fubar) | |
| 5397 | |
| 5398 ; Now type M-x shell RET | |
| 5399 ; wait for the shell prompt then send: ls RET | |
| 5400 ; the output of ls should fill immediately, and not wait 30 seconds. | |
| 5401 | |
| 5402 ; repeat above test with (sleep-for 30) and (accept-process-output nil 30) | |
| 5403 | |
| 5404 | |
| 5405 | |
| 5406 ; Make sure that recursive invocations return immediately: | |
| 5407 (defmacro test-diff-time (start end) | |
| 5408 `(+ (* (- (car ,end) (car ,start)) 65536.0) | |
| 5409 (- (cadr ,end) (cadr ,start)) | |
| 5410 (/ (- (caddr ,end) (caddr ,start)) 1000000.0))) | |
| 5411 | |
| 5412 (defun testee (ignore) | |
| 5413 (sit-for 10)) | |
| 5414 | |
| 5415 (defun test-them () | |
| 5416 (let ((start (current-time)) | |
| 5417 end) | |
| 5418 (add-timeout 2 'testee nil) | |
| 5419 (sit-for 5) | |
| 5420 (add-timeout 2 'testee nil) | |
| 5421 (sleep-for 5) | |
| 5422 (add-timeout 2 'testee nil) | |
| 5423 (accept-process-output nil 5) | |
| 5424 (setq end (current-time)) | |
| 5425 (test-diff-time start end))) | |
| 5426 | |
| 5427 (test-them) should sit for 15 seconds. | |
| 5428 Repeat with testee set to sleep-for and accept-process-output. | |
| 5429 These should each delay 36 seconds. | |
| 5430 | |
| 5431 */ |