Mercurial > emacs
diff lispref/keymaps.texi @ 67325:f1f8e75ca4ae
(Format of Keymaps): Remove mention of a quirk
in full keymaps, since the quirk has been fixed.
author | Stefan Monnier <monnier@iro.umontreal.ca> |
---|---|
date | Mon, 05 Dec 2005 19:42:10 +0000 |
parents | e836425ee789 |
children | 9b969687ff7c |
line wrap: on
line diff
--- a/lispref/keymaps.texi Mon Dec 05 17:11:21 2005 +0000 +++ b/lispref/keymaps.texi Mon Dec 05 19:42:10 2005 +0000 @@ -158,17 +158,6 @@ bindings. A keymap with such a char-table is called a @dfn{full keymap}. Other keymaps are called @dfn{sparse keymaps}. -When a keymap contains a char-table vector, it always defines a -binding for each character without modifiers. However, if the binding -is @code{nil}, it doesn't constitute a definition. @code{nil} takes -precedence over a default binding or a binding in the parent keymap. -So in a full keymap, default bindings are not meaningful for -characters without modifiers. They can still apply to characters with -modifier bits and to non-character events. A binding of @code{nil} -does @emph{not} override lower-precedence keymaps; thus, if the local -map gives a binding of @code{nil}, Emacs uses the binding from the -global map. - @item @var{string} @cindex keymap prompt string @cindex overall prompt string @@ -178,6 +167,13 @@ use the keymap as a menu. @xref{Defining Menus}. @end table +When the binding is @code{nil}, it doesn't constitute a definition +but it does take precedence over a default binding or a binding in the +parent keymap. On the other hand, a binding of @code{nil} does +@emph{not} override lower-precedence keymaps; thus, if the local map +gives a binding of @code{nil}, Emacs uses the binding from the +global map. + @cindex meta characters lookup Keymaps do not directly record bindings for the meta characters. Instead, meta characters are regarded for purposes of key lookup as