# HG changeset patch # User Stefan Monnier # Date 1133811730 0 # Node ID f1f8e75ca4ae903962cfd5ee1bf5446d25ef1353 # Parent dd208be1124e2aea0392cc66284570a1f43f3e20 (Format of Keymaps): Remove mention of a quirk in full keymaps, since the quirk has been fixed. diff -r dd208be1124e -r f1f8e75ca4ae lispref/ChangeLog --- a/lispref/ChangeLog Mon Dec 05 17:11:21 2005 +0000 +++ b/lispref/ChangeLog Mon Dec 05 19:42:10 2005 +0000 @@ -1,3 +1,8 @@ +2005-12-05 Stefan Monnier + + * keymaps.texi (Format of Keymaps): Remove mention of a quirk + in full keymaps, since the quirk has been fixed. + 2005-12-03 Eli Zaretskii * hooks.texi (Standard Hooks): Add index entries. Mention diff -r dd208be1124e -r f1f8e75ca4ae lispref/keymaps.texi --- 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