procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Document use of vectors in keymaps

Browse source 
* doc/lispref/keymaps.texi (Format of Keymaps): Mention vector
format (Bug #14797).
This commit is contained in:
Noam Postavsky 2016-08-06 09:05:05 -04:00
parent d841a03c5e
commit 3c9cb57c6f
1 changed files with 13 additions and 4 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

17
doc/lispref/keymaps.texi
View file

@ -194,10 +194,19 @@ explicitly bound to @code{nil} (see below).
@item @var{char-table}
If an element of a keymap is a char-table, it counts as holding
bindings for all character events with no modifier bits
(@pxref{modifier bits}): element @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 char-table is called a @dfn{full
keymap}. Other keymaps are called @dfn{sparse keymaps}.
(@pxref{modifier bits}): the element whose index is @var{c} is the
binding for the character @var{c}. 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}.
@item @var{vector}
This kind of element is similar to a char-table: the element whose
index is @var{c} is the binding for the character @var{c}. Since the
range of characters that can be bound this way is limited by the
vector size, and vector creation allocates space for all character
codes from 0 up, this format should not be used except for creating
menu keymaps (@pxref{Menu Keymaps}), where the bindings themselves
don't matter.
@item @var{string}
@cindex keymap prompt string