aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorRichard M. Stallman2006-11-06 16:10:21 +0000
committerRichard M. Stallman2006-11-06 16:10:21 +0000
commit002732bb52d971016f0d8610974df9c2271440e8 (patch)
tree2d29573f5eff08983eacec9d3298e8f5878b9a4f
parent68621fd40e02f08dc0bcfda58ee338f334863996 (diff)
downloademacs-002732bb52d971016f0d8610974df9c2271440e8.tar.gz
emacs-002732bb52d971016f0d8610974df9c2271440e8.zip
Avoid use of "binding" to mean a relation;
use it only to refer to the meaning associated with a key.
-rw-r--r--lispref/keymaps.texi32
1 files changed, 17 insertions, 15 deletions
diff --git a/lispref/keymaps.texi b/lispref/keymaps.texi
index 1f017b1f43e..a9b9ca2d512 100644
--- a/lispref/keymaps.texi
+++ b/lispref/keymaps.texi
@@ -8,12 +8,12 @@
8@chapter Keymaps 8@chapter Keymaps
9@cindex keymap 9@cindex keymap
10 10
11 The bindings between input events and commands are recorded in data 11 The command bindings of input events are recorded in data structures
12structures called @dfn{keymaps}. Each binding in a keymap associates 12called @dfn{keymaps}. Each entry in a keymap associates (or
13(or @dfn{binds}) an individual event type, either to another keymap or to 13@dfn{binds}) an individual event type, either to another keymap or to
14a command. When an event type is bound to a keymap, that keymap is used 14a command. When an event type is bound to a keymap, that keymap is
15to look up the next input event; this continues until a command is 15used to look up the next input event; this continues until a command
16found. The whole process is called @dfn{key lookup}. 16is found. The whole process is called @dfn{key lookup}.
17 17
18@menu 18@menu
19* Key Sequences:: Key sequences as Lisp objects. 19* Key Sequences:: Key sequences as Lisp objects.
@@ -32,7 +32,7 @@ found. The whole process is called @dfn{key lookup}.
32* Key Lookup:: Finding a key's binding in one keymap. 32* Key Lookup:: Finding a key's binding in one keymap.
33* Functions for Key Lookup:: How to request key lookup. 33* Functions for Key Lookup:: How to request key lookup.
34* Changing Key Bindings:: Redefining a key in a keymap. 34* Changing Key Bindings:: Redefining a key in a keymap.
35* Remapping Commands:: Bindings that translate one command to another. 35* Remapping Commands:: A keymap can translate one command to another.
36* Translation Keymaps:: Keymaps for translating sequences of events. 36* Translation Keymaps:: Keymaps for translating sequences of events.
37* Key Binding Commands:: Interactive interfaces for redefining keys. 37* Key Binding Commands:: Interactive interfaces for redefining keys.
38* Scanning Keymaps:: Looking through all keymaps, for printing help. 38* Scanning Keymaps:: Looking through all keymaps, for printing help.
@@ -382,19 +382,21 @@ definition is a keymap; the same symbol appears in the new copy.
382@dfn{parent keymap}. Such a keymap looks like this: 382@dfn{parent keymap}. Such a keymap looks like this:
383 383
384@example 384@example
385(keymap @var{bindings}@dots{} . @var{parent-keymap}) 385(keymap @var{elements}@dots{} . @var{parent-keymap})
386@end example 386@end example
387 387
388@noindent 388@noindent
389The effect is that this keymap inherits all the bindings of 389The effect is that this keymap inherits all the bindings of
390@var{parent-keymap}, whatever they may be at the time a key is looked up, 390@var{parent-keymap}, whatever they may be at the time a key is looked up,
391but can add to them or override them with @var{bindings}. 391but can add to them or override them with @var{elements}.
392 392
393If you change the bindings in @var{parent-keymap} using @code{define-key} 393If you change the bindings in @var{parent-keymap} using
394or other key-binding functions, these changes are visible in the 394@code{define-key} or other key-binding functions, these changed
395inheriting keymap unless shadowed by @var{bindings}. The converse is 395bindings are visible in the inheriting keymap, unless shadowed by the
396not true: if you use @code{define-key} to change the inheriting keymap, 396bindings made by @var{elements}. The converse is not true: if you use
397that affects @var{bindings}, but has no effect on @var{parent-keymap}. 397@code{define-key} to change bindings in the inheriting keymap, these
398changes are recorded in @var{elements}, but have no effect on
399@var{parent-keymap}.
398 400
399The proper way to construct a keymap with a parent is to use 401The proper way to construct a keymap with a parent is to use
400@code{set-keymap-parent}; if you have code that directly constructs a 402@code{set-keymap-parent}; if you have code that directly constructs a