comparison lispref/keymaps.texi @ 39794:30c76f38ad7b

Describe the meaning of a nil binding.

39793:1d5b7d31671f

@var{n} is the binding for the character with code @var{n}.  This is a
compact way to record lots of bindings.  A keymap with such a vector is
called a @dfn{full keymap}.  Other keymaps are called @dfn{sparse
keymaps}.

When a keymap contains a vector, it always defines a binding for each
@sc{ascii} character, even if the vector contains @code{nil} for that
character.  Such a binding of @code{nil} overrides any default key
binding in the keymap, for @sc{ascii} characters.  However, default
bindings are still meaningful for events other than @sc{ascii}

39794:30c76f38ad7b

@var{n} is the binding for the character with code @var{n}.  This is a
compact way to record lots of bindings.  A keymap with such a vector is
called a @dfn{full keymap}.  Other keymaps are called @dfn{sparse
keymaps}.

A @code{nil} binding is used to mean that a key is explicitly not bound.
Just like any other binding, it takes precedence over a default binding
or a binding in the parent keymap, but on the other hand, it does not
take precedence over keymaps of lower priority.

When a keymap contains a vector, it always defines a binding for each
@sc{ascii} character, even if the vector contains @code{nil} for that
character.  Such a binding of @code{nil} overrides any default key
binding in the keymap, for @sc{ascii} characters.  However, default
bindings are still meaningful for events other than @sc{ascii}