diff options
| author | Chong Yidong | 2006-05-27 14:56:11 +0000 |
|---|---|---|
| committer | Chong Yidong | 2006-05-27 14:56:11 +0000 |
| commit | 917b82275619a43263eacf113e843fa68b7330da (patch) | |
| tree | c6753b179425b420ed58079fb23e8f0b2b4229cc | |
| parent | 63b9b239a6c2b8f9ecfbd2a0bec26c168db0407b (diff) | |
| download | emacs-917b82275619a43263eacf113e843fa68b7330da.tar.gz emacs-917b82275619a43263eacf113e843fa68b7330da.zip | |
* keymaps.texi (Key Sequences): Link to input events definition.
(Format of Keymaps): Delete material duplicated in Keymap Basics.
| -rw-r--r-- | lispref/ChangeLog | 3 | ||||
| -rw-r--r-- | lispref/keymaps.texi | 25 |
2 files changed, 8 insertions, 20 deletions
diff --git a/lispref/ChangeLog b/lispref/ChangeLog index b0f92cc27a1..84732110f59 100644 --- a/lispref/ChangeLog +++ b/lispref/ChangeLog | |||
| @@ -1,5 +1,8 @@ | |||
| 1 | 2006-05-27 Chong Yidong <cyd@stupidchicken.com> | 1 | 2006-05-27 Chong Yidong <cyd@stupidchicken.com> |
| 2 | 2 | ||
| 3 | * keymaps.texi (Key Sequences): Link to input events definition. | ||
| 4 | (Format of Keymaps): Delete material duplicated in Keymap Basics. | ||
| 5 | |||
| 3 | * files.texi (Changing Files): Document updated argument list for | 6 | * files.texi (Changing Files): Document updated argument list for |
| 4 | copy-file. | 7 | copy-file. |
| 5 | 8 | ||
diff --git a/lispref/keymaps.texi b/lispref/keymaps.texi index ed67a028446..f6779b247d0 100644 --- a/lispref/keymaps.texi +++ b/lispref/keymaps.texi | |||
| @@ -45,10 +45,11 @@ found. The whole process is called @dfn{key lookup}. | |||
| 45 | @cindex key sequence | 45 | @cindex key sequence |
| 46 | 46 | ||
| 47 | A @dfn{key sequence}, or @dfn{key} for short, is a sequence of one | 47 | A @dfn{key sequence}, or @dfn{key} for short, is a sequence of one |
| 48 | or more input events that form a unit. The Emacs Lisp representation | 48 | or more input events that form a unit. Input events include |
| 49 | for a key sequence is a string or vector. Unless otherwise stated, | 49 | characters, function keys, and mouse actions (@pxref{Input Events}). |
| 50 | any Emacs Lisp function that accepts a key sequence as an argument can | 50 | The Emacs Lisp representation for a key sequence is a string or |
| 51 | handle both representations. | 51 | vector. Unless otherwise stated, any Emacs Lisp function that accepts |
| 52 | a key sequence as an argument can handle both representations. | ||
| 52 | 53 | ||
| 53 | In the string representation, alphanumeric characters ordinarily | 54 | In the string representation, alphanumeric characters ordinarily |
| 54 | stand for themselves; for example, @code{"a"} represents @kbd{a} and | 55 | stand for themselves; for example, @code{"a"} represents @kbd{a} and |
| @@ -153,22 +154,6 @@ for details. | |||
| 153 | @cindex full keymap | 154 | @cindex full keymap |
| 154 | @cindex sparse keymap | 155 | @cindex sparse keymap |
| 155 | 156 | ||
| 156 | A @dfn{keymap} is a table mapping event types to definitions (which | ||
| 157 | can be any Lisp objects, though only certain types are meaningful for | ||
| 158 | execution by the command loop). Given an event (or an event type) and a | ||
| 159 | keymap, Emacs can get the event's definition. Events include | ||
| 160 | characters, function keys, and mouse actions (@pxref{Input Events}). | ||
| 161 | |||
| 162 | At any time, several primary keymaps are @dfn{active}---that is, in | ||
| 163 | use for finding key bindings. These are the @dfn{global map}, which is | ||
| 164 | shared by all buffers; the @dfn{local keymap}, which is usually | ||
| 165 | associated with a specific major mode; and zero or more @dfn{minor mode | ||
| 166 | keymaps}, which belong to currently enabled minor modes. (Not all minor | ||
| 167 | modes have keymaps.) The local keymap bindings shadow (i.e., take | ||
| 168 | precedence over) the corresponding global bindings. The minor mode | ||
| 169 | keymaps shadow both local and global keymaps. @xref{Active Keymaps}, | ||
| 170 | for details. | ||
| 171 | |||
| 172 | Each keymap is a list whose @sc{car} is the symbol @code{keymap}. The | 157 | Each keymap is a list whose @sc{car} is the symbol @code{keymap}. The |
| 173 | remaining elements of the list define the key bindings of the keymap. | 158 | remaining elements of the list define the key bindings of the keymap. |
| 174 | A symbol whose function definition is a keymap is also a keymap. Use | 159 | A symbol whose function definition is a keymap is also a keymap. Use |