comparison src/keymap.c @ 2027:71477bc21fe8

[xemacs-hg @ 2004-04-19 06:40:42 by stephent] keymap docstrings <87fzb0xywc.fsf@tleepslib.sk.tsukuba.ac.jp> finder-inf mode fix <87brloxyk2.fsf@tleepslib.sk.tsukuba.ac.jp>
author stephent
date Mon, 19 Apr 2004 06:40:45 +0000
parents a8d8f419b459
children 04bc9d2f42c7
comparison
equal deleted inserted replaced
2026:ca02e61c9829 2027:71477bc21fe8
4421 4421
4422 Fset (Qminor_mode_map_alist, Qnil); 4422 Fset (Qminor_mode_map_alist, Qnil);
4423 4423
4424 DEFVAR_LISP ("key-translation-map", &Vkey_translation_map /* 4424 DEFVAR_LISP ("key-translation-map", &Vkey_translation_map /*
4425 Keymap of key translations that can override keymaps. 4425 Keymap of key translations that can override keymaps.
4426 This keymap works like `function-key-map', but comes after that, 4426
4427 This keymap works like `function-key-map', but is searched before it,
4427 and applies even for keys that have ordinary bindings. 4428 and applies even for keys that have ordinary bindings.
4429
4430 The `read-key-sequence' function replaces any subsequence bound by
4431 `key-translation-map' with its binding. More precisely, when the active
4432 keymaps have no binding for the current key sequence but
4433 `key-translation-map' binds a suffix of the sequence to a vector or string,
4434 `read-key-sequence' replaces the matching suffix with its binding, and
4435 continues with the new sequence. See `key-binding' for details.
4436
4437 The events that come from bindings in `key-translation-map' are not
4438 themselves looked up in `key-translation-map'.
4439
4440 #### FIXME: stolen from `function-key-map'; need better example.
4441 #### I guess you could implement a Dvorak keyboard with this?
4442 For example, suppose `key-translation-map' binds `ESC O P' to [f1].
4443 Typing `ESC O P' to `read-key-sequence' would return
4444 \[#<keypress-event f1>]. Typing `C-x ESC O P' would return
4445 \[#<keypress-event control-X> #<keypress-event f1>]. If [f1]
4446 were a prefix key, typing `ESC O P x' would return
4447 \[#<keypress-event f1> #<keypress-event x>].
4428 */ ); 4448 */ );
4429 Vkey_translation_map = Qnil; 4449 Vkey_translation_map = Qnil;
4430 4450
4431 DEFVAR_LISP ("global-tty-map", &Vglobal_tty_map /* 4451 DEFVAR_LISP ("global-tty-map", &Vglobal_tty_map /*
4432 Global keymap that applies only to TTY's. 4452 Global keymap that applies only to TTY's.