From: Chong Yidong Date: Sat, 27 May 2006 14:56:11 +0000 (+0000) Subject: * keymaps.texi (Key Sequences): Link to input events definition. X-Git-Tag: emacs-pretest-22.0.90~2257 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=917b82275619a43263eacf113e843fa68b7330da;p=emacs.git * keymaps.texi (Key Sequences): Link to input events definition. (Format of Keymaps): Delete material duplicated in Keymap Basics. --- diff --git a/lispref/ChangeLog b/lispref/ChangeLog index b0f92cc27a1..84732110f59 100644 --- a/lispref/ChangeLog +++ b/lispref/ChangeLog @@ -1,5 +1,8 @@ 2006-05-27 Chong Yidong + * keymaps.texi (Key Sequences): Link to input events definition. + (Format of Keymaps): Delete material duplicated in Keymap Basics. + * files.texi (Changing Files): Document updated argument list for copy-file. 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}. @cindex key sequence A @dfn{key sequence}, or @dfn{key} for short, is a sequence of one -or more input events that form a unit. The Emacs Lisp representation -for a key sequence is a string or vector. Unless otherwise stated, -any Emacs Lisp function that accepts a key sequence as an argument can -handle both representations. +or more input events that form a unit. Input events include +characters, function keys, and mouse actions (@pxref{Input Events}). +The Emacs Lisp representation for a key sequence is a string or +vector. Unless otherwise stated, any Emacs Lisp function that accepts +a key sequence as an argument can handle both representations. In the string representation, alphanumeric characters ordinarily stand for themselves; for example, @code{"a"} represents @kbd{a} and @@ -153,22 +154,6 @@ for details. @cindex full keymap @cindex sparse keymap - A @dfn{keymap} is a table mapping event types to definitions (which -can be any Lisp objects, though only certain types are meaningful for -execution by the command loop). Given an event (or an event type) and a -keymap, Emacs can get the event's definition. Events include -characters, function keys, and mouse actions (@pxref{Input Events}). - - At any time, several primary keymaps are @dfn{active}---that is, in -use for finding key bindings. These are the @dfn{global map}, which is -shared by all buffers; the @dfn{local keymap}, which is usually -associated with a specific major mode; and zero or more @dfn{minor mode -keymaps}, which belong to currently enabled minor modes. (Not all minor -modes have keymaps.) The local keymap bindings shadow (i.e., take -precedence over) the corresponding global bindings. The minor mode -keymaps shadow both local and global keymaps. @xref{Active Keymaps}, -for details. - Each keymap is a list whose @sc{car} is the symbol @code{keymap}. The remaining elements of the list define the key bindings of the keymap. A symbol whose function definition is a keymap is also a keymap. Use