From 3c9cb57c6fae57d3798298faecccd0402b4ddd9a Mon Sep 17 00:00:00 2001 From: Noam Postavsky Date: Sat, 6 Aug 2016 09:05:05 -0400 Subject: Document use of vectors in keymaps * doc/lispref/keymaps.texi (Format of Keymaps): Mention vector format (Bug #14797). --- doc/lispref/keymaps.texi | 17 +++++++++++++---- 1 file changed, 13 insertions(+), 4 deletions(-) (limited to 'doc') diff --git a/doc/lispref/keymaps.texi b/doc/lispref/keymaps.texi index f5d3811fae..2641ad0b6a 100644 --- a/doc/lispref/keymaps.texi +++ b/doc/lispref/keymaps.texi @@ -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 -- cgit v1.2.3