diff options
| author | Richard M. Stallman | 2006-11-06 16:10:21 +0000 |
|---|---|---|
| committer | Richard M. Stallman | 2006-11-06 16:10:21 +0000 |
| commit | 002732bb52d971016f0d8610974df9c2271440e8 (patch) | |
| tree | 2d29573f5eff08983eacec9d3298e8f5878b9a4f | |
| parent | 68621fd40e02f08dc0bcfda58ee338f334863996 (diff) | |
| download | emacs-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.texi | 32 |
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 |
| 12 | structures called @dfn{keymaps}. Each binding in a keymap associates | 12 | called @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 |
| 14 | a command. When an event type is bound to a keymap, that keymap is used | 14 | a command. When an event type is bound to a keymap, that keymap is |
| 15 | to look up the next input event; this continues until a command is | 15 | used to look up the next input event; this continues until a command |
| 16 | found. The whole process is called @dfn{key lookup}. | 16 | is 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 |
| 389 | The effect is that this keymap inherits all the bindings of | 389 | The 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, |
| 391 | but can add to them or override them with @var{bindings}. | 391 | but can add to them or override them with @var{elements}. |
| 392 | 392 | ||
| 393 | If you change the bindings in @var{parent-keymap} using @code{define-key} | 393 | If you change the bindings in @var{parent-keymap} using |
| 394 | or other key-binding functions, these changes are visible in the | 394 | @code{define-key} or other key-binding functions, these changed |
| 395 | inheriting keymap unless shadowed by @var{bindings}. The converse is | 395 | bindings are visible in the inheriting keymap, unless shadowed by the |
| 396 | not true: if you use @code{define-key} to change the inheriting keymap, | 396 | bindings made by @var{elements}. The converse is not true: if you use |
| 397 | that affects @var{bindings}, but has no effect on @var{parent-keymap}. | 397 | @code{define-key} to change bindings in the inheriting keymap, these |
| 398 | changes are recorded in @var{elements}, but have no effect on | ||
| 399 | @var{parent-keymap}. | ||
| 398 | 400 | ||
| 399 | The proper way to construct a keymap with a parent is to use | 401 | The 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 |