From 6dd01ff617b3ee8ef8ad307a7776c2142f7f02ed Mon Sep 17 00:00:00 2001 From: Noam Postavsky Date: Sat, 6 Aug 2016 09:05:05 -0400 Subject: [PATCH v1] Document use of vectors in keymaps * doc/lispref/keymaps.texi (Format of Keymaps): Mention vector format (Bug #14797). --- doc/lispref/keymaps.texi | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/doc/lispref/keymaps.texi b/doc/lispref/keymaps.texi index f5d3811..a47d790 100644 --- a/doc/lispref/keymaps.texi +++ b/doc/lispref/keymaps.texi @@ -199,6 +199,14 @@ Format of Keymaps 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: element @var{n} is +the binding for the character with code @var{n}. 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 @cindex overall prompt string -- 2.8.0