GNU bug report logs - #14797
24.3.50; new, undocumented menu structure using VECTORS?

Previous Next

Full log

Message #31 received at 14797 <at> debbugs.gnu.org (full text, mbox):

From: Noam Postavsky <npostavs <at> users.sourceforge.net>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: Stefan Monnier <monnier <at> iro.umontreal.ca>,
 Drew Adams <drew.adams <at> oracle.com>, 14797 <at> debbugs.gnu.org
Subject: Re: bug#14797: 24.3.50;
 new, undocumented menu structure using VECTORS?
Date: Sat, 6 Aug 2016 11:42:14 -0400

On Sat, Aug 6, 2016 at 10:42 AM, Eli Zaretskii <eliz <at> gnu.org> wrote:
>> From: npostavs <at> users.sourceforge.net
>> Date: Sat, 06 Aug 2016 09:09:50 -0400
>> Cc: Stefan Monnier <monnier <at> iro.umontreal.ca>, 14797 <at> debbugs.gnu.org
>>
>> --- 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
>
> LGTM, except that "the character with code N" could use some better
> wording.  How about
>
>   ... element whose index is @var{c} is the binding for the character
>   @var{c}.
>
> instead?

Sure. I guess the char-table paragraph should use the same wording, right?

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.