aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorChong Yidong2006-05-27 14:56:11 +0000
committerChong Yidong2006-05-27 14:56:11 +0000
commit917b82275619a43263eacf113e843fa68b7330da (patch)
treec6753b179425b420ed58079fb23e8f0b2b4229cc
parent63b9b239a6c2b8f9ecfbd2a0bec26c168db0407b (diff)
downloademacs-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/ChangeLog3
-rw-r--r--lispref/keymaps.texi25
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 @@
12006-05-27 Chong Yidong <cyd@stupidchicken.com> 12006-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
48or more input events that form a unit. The Emacs Lisp representation 48or more input events that form a unit. Input events include
49for a key sequence is a string or vector. Unless otherwise stated, 49characters, function keys, and mouse actions (@pxref{Input Events}).
50any Emacs Lisp function that accepts a key sequence as an argument can 50The Emacs Lisp representation for a key sequence is a string or
51handle both representations. 51vector. Unless otherwise stated, any Emacs Lisp function that accepts
52a 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
54stand for themselves; for example, @code{"a"} represents @kbd{a} and 55stand 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
157can be any Lisp objects, though only certain types are meaningful for
158execution by the command loop). Given an event (or an event type) and a
159keymap, Emacs can get the event's definition. Events include
160characters, function keys, and mouse actions (@pxref{Input Events}).
161
162 At any time, several primary keymaps are @dfn{active}---that is, in
163use for finding key bindings. These are the @dfn{global map}, which is
164shared by all buffers; the @dfn{local keymap}, which is usually
165associated with a specific major mode; and zero or more @dfn{minor mode
166keymaps}, which belong to currently enabled minor modes. (Not all minor
167modes have keymaps.) The local keymap bindings shadow (i.e., take
168precedence over) the corresponding global bindings. The minor mode
169keymaps shadow both local and global keymaps. @xref{Active Keymaps},
170for 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
173remaining elements of the list define the key bindings of the keymap. 158remaining elements of the list define the key bindings of the keymap.
174A symbol whose function definition is a keymap is also a keymap. Use 159A symbol whose function definition is a keymap is also a keymap. Use