[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] Changes to emacs/lispref/keymaps.texi,v
From: |
Richard M. Stallman |
Subject: |
[Emacs-diffs] Changes to emacs/lispref/keymaps.texi,v |
Date: |
Fri, 15 Sep 2006 01:04:15 +0000 |
CVSROOT: /cvsroot/emacs
Module name: emacs
Changes by: Richard M. Stallman <rms> 06/09/15 01:04:15
Index: keymaps.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/lispref/keymaps.texi,v
retrieving revision 1.86
retrieving revision 1.87
diff -u -b -r1.86 -r1.87
--- keymaps.texi 11 Sep 2006 14:34:16 -0000 1.86
+++ keymaps.texi 15 Sep 2006 01:04:15 -0000 1.87
@@ -569,35 +569,12 @@
of them are @dfn{active}, meaning that they participate in the
interpretation of user input. All the active keymaps are used
together to determine what command to execute when a key is entered.
-Emacs searches these keymaps one by one, in a standard order, until it
-finds a binding in one of the keymaps.
Normally the active keymaps are the @code{keymap} property keymap,
the keymaps of any enabled minor modes, the current buffer's local
-keymap, and the global keymap, in that order. Therefore, Emacs
-searches for each input key sequence in all these keymaps. Here is a
-pseudo-Lisp description of how this process works:
-
address@hidden
-(or (if overriding-terminal-local-map
- (@var{find-in} overriding-terminal-local-map)
- (if overriding-local-map
- (@var{find-in} overriding-local-map)
- (or (@var{find-in} (get-text-property (point) 'keymap))
- (@var{find-in-any} emulation-mode-map-alists)
- (@var{find-in-any} minor-mode-overriding-map-alist)
- (@var{find-in-any} minor-mode-map-alist)
- (if (get-text-property (point) 'local-map)
- (@var{find-in} (get-text-property (point) 'local-map))
- (@var{find-in} (current-local-map))))))
- (@var{find-in} (current-global-map)))
address@hidden lisp
-
address@hidden
-Here, the pseudo-function @var{find-in} means to look up the key
-sequence in a single map, and @var{find-in-any} means to search the
-appropriate keymaps from an alist. (Searching a single keymap for a
-binding is called @dfn{key lookup}; see @ref{Key Lookup}.)
+keymap, and the global keymap, in that order. Emacs searches for each
+input key sequence in all these keymaps. @xref{Searching Keymaps},
+for more details of this procedure.
The @dfn{global keymap} holds the bindings of keys that are defined
regardless of the current buffer, such as @kbd{C-f}. The variable
@@ -687,9 +664,10 @@
@node Searching Keymaps
@section Searching the Active Keymaps
- After translation of event subsequences (@pxref{Translation Keymaps})
-Emacs looks for them in the active keymaps. Here is a pseudo-Lisp
-description of the order in which the active keymaps are searched:
+ After translation of event subsequences (@pxref{Translation
+Keymaps}) Emacs looks for them in the active keymaps. Here is a
+pseudo-Lisp description of the order and conditions for searching
+them:
@lisp
(or (if overriding-terminal-local-map
@@ -709,6 +687,8 @@
@noindent
The @var{find-in} and @var{find-in-any} are pseudo functions that
search in one keymap and in an alist of keymaps, respectively.
+(Searching a single keymap for a binding is called @dfn{key lookup};
+see @ref{Key Lookup}.)
@enumerate
@item
- [Emacs-diffs] Changes to emacs/lispref/keymaps.texi,v, Chong Yidong, 2006/09/10
- [Emacs-diffs] Changes to emacs/lispref/keymaps.texi,v, Richard M. Stallman, 2006/09/11
- [Emacs-diffs] Changes to emacs/lispref/keymaps.texi,v,
Richard M. Stallman <=
- [Emacs-diffs] Changes to emacs/lispref/keymaps.texi,v, David Kastrup, 2006/09/15
- [Emacs-diffs] Changes to emacs/lispref/keymaps.texi,v, Richard M. Stallman, 2006/09/15
- [Emacs-diffs] Changes to emacs/lispref/keymaps.texi,v, Richard M. Stallman, 2006/09/18
- [Emacs-diffs] Changes to emacs/lispref/keymaps.texi,v, David Kastrup, 2006/09/19