From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: npostavs@users.sourceforge.net Newsgroups: gmane.emacs.bugs Subject: bug#14797: 24.3.50; new, undocumented menu structure using VECTORS? Date: Sat, 06 Aug 2016 09:09:50 -0400 Message-ID: <87d1lm6o2p.fsf@users.sourceforge.net> References: <6b4ca396-4d2b-4719-8b1e-1ef9eb6f5610@default> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" X-Trace: blaine.gmane.org 1470489022 31036 195.159.176.226 (6 Aug 2016 13:10:22 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sat, 6 Aug 2016 13:10:22 +0000 (UTC) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.93 (gnu/linux) Cc: Stefan Monnier , 14797@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Aug 06 15:10:18 2016 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bW1Mn-0007JQ-Ef for geb-bug-gnu-emacs@m.gmane.org; Sat, 06 Aug 2016 15:10:17 +0200 Original-Received: from localhost ([::1]:49426 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bW1Mk-0004am-7K for geb-bug-gnu-emacs@m.gmane.org; Sat, 06 Aug 2016 09:10:14 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:37389) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bW1Me-0004Xd-Dw for bug-gnu-emacs@gnu.org; Sat, 06 Aug 2016 09:10:09 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bW1MY-0006Wp-DP for bug-gnu-emacs@gnu.org; Sat, 06 Aug 2016 09:10:07 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:59912) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bW1MY-0006Wl-8r for bug-gnu-emacs@gnu.org; Sat, 06 Aug 2016 09:10:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1bW1MY-0007vc-0N for bug-gnu-emacs@gnu.org; Sat, 06 Aug 2016 09:10:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: npostavs@users.sourceforge.net Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 06 Aug 2016 13:10:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 14797 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 14797-submit@debbugs.gnu.org id=B14797.147048899030452 (code B ref 14797); Sat, 06 Aug 2016 13:10:01 +0000 Original-Received: (at 14797) by debbugs.gnu.org; 6 Aug 2016 13:09:50 +0000 Original-Received: from localhost ([127.0.0.1]:57209 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bW1ML-0007v1-Vi for submit@debbugs.gnu.org; Sat, 06 Aug 2016 09:09:50 -0400 Original-Received: from mail-io0-f181.google.com ([209.85.223.181]:36210) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bW1MK-0007uk-UL; Sat, 06 Aug 2016 09:09:49 -0400 Original-Received: by mail-io0-f181.google.com with SMTP id b62so322529122iod.3; Sat, 06 Aug 2016 06:09:48 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version; bh=so5lf1y8qad4CTPdvJMzcBjs7AjzCUaCxLsKMm7QY0s=; b=jGsdipV+jJxinc3pGJGdeG3nfGVRz/WcSpcidyWP8JboolOEyg0dRJMPLDoopnNKqN Zth0hvD4Hou6lpo3vhwQv8XwdX+tEype7jJ9RCQ0iBD1Do3eXFY/IUBjLYn4oyNcT5v/ vaHF9YWCfywVRgkEhf78H5wtVoBLGQTplQEtiJx2XB17Dps8mascy0BkuGarVTfCrSIf 0ymTJtyBv4a7+yidOGfpoJfdJHxYmP3s3qzNNzNkz4f216gRFMfsHsFzvwln2YpiYfan /F0YFJmMrQYPmId+RykG3FR/paiPX9NszftEBVeXV+WlBTFEMX+WE4Cmv6WKyUbnVf/H v1iw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:sender:from:to:cc:subject:references:date :in-reply-to:message-id:user-agent:mime-version; bh=so5lf1y8qad4CTPdvJMzcBjs7AjzCUaCxLsKMm7QY0s=; b=FthMQ2UljG99StKoEEYTWKxjGoUa0aYtO6bow75q+1LcplONYBY7mXN/xjGzBJ7uZs 6h9U5kAaPB6tzAdDeLnG3Vp4GJ9m9pcOnLcg5J00JcJ28dEwIk9T/zn2aywZCqnmxWjp 8dXbJ/lVIxC2ObcuN+/stcXWHWgSxgoKcySwzhcwPy129A9sPKyvhWNRsQngt9PWZqcr PQJR4mGZHlWM1FEP2ykIriMA4MDH2zf3D7YZjF46+1EO3rbib8H17iiz+8+1VAT+iDna FQtSrDoCCjuNzjMwyAaunfMnwaN21AMUD4n1f8EVzbD8uLgqlHaTUOYzMLYwIzvqOGap KKYA== X-Gm-Message-State: AEkoouuh0w2PjOpKkPwSCEKrT4mnThE7KYWhmU3kjBQV1zMP2e48JpNx8s/iztLAIHysfg== X-Received: by 10.107.15.229 with SMTP id 98mr40415252iop.123.1470488983566; Sat, 06 Aug 2016 06:09:43 -0700 (PDT) Original-Received: from zony (206-188-64-44.cpe.distributel.net. [206.188.64.44]) by smtp.googlemail.com with ESMTPSA id i191sm6017940itf.13.2016.08.06.06.09.42 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sat, 06 Aug 2016 06:09:42 -0700 (PDT) In-Reply-To: (Drew Adams's message of "Fri, 5 Jul 2013 08:17:57 -0700 (PDT)") X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:121895 Archived-At: --=-=-= Content-Type: text/plain tags 14797 patch quit Drew Adams writes: > What was gained by this? I guess it's for efficiency? Anyway, it might as well be documented, how about this: --=-=-= Content-Type: text/plain Content-Disposition: inline; filename=v1-0001-Document-use-of-vectors-in-keymaps.patch Content-Description: patch >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 --=-=-=--