From d64b177ae9a333951fb1be5e16c41963d61f95ee Mon Sep 17 00:00:00 2001 From: Stefan Monnier Date: Mon, 5 Dec 2005 19:42:10 +0000 Subject: [PATCH] (Format of Keymaps): Remove mention of a quirk in full keymaps, since the quirk has been fixed. --- lispref/ChangeLog | 5 +++++ lispref/keymaps.texi | 18 +++++++----------- 2 files changed, 12 insertions(+), 11 deletions(-) diff --git a/lispref/ChangeLog b/lispref/ChangeLog index cf15441339..b42fd0b450 100644 --- a/lispref/ChangeLog +++ b/lispref/ChangeLog @@ -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 --git a/lispref/keymaps.texi b/lispref/keymaps.texi index 5509b35b79..40165963e3 100644 --- a/lispref/keymaps.texi +++ b/lispref/keymaps.texi @@ -158,17 +158,6 @@ character with code @var{n}. This is a compact way to record lots of 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 @@ This is called the @dfn{overall prompt string} and makes it possible to 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 -- 2.20.1