From debbugs-submit-bounces@debbugs.gnu.org Sat Oct 08 02:46:57 2011 Received: (at submit) by debbugs.gnu.org; 8 Oct 2011 06:46:58 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RCQgR-0001S9-VV for submit@debbugs.gnu.org; Sat, 08 Oct 2011 02:46:57 -0400 Received: from eggs.gnu.org ([140.186.70.92]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RCQgN-0001Rw-BB for submit@debbugs.gnu.org; Sat, 08 Oct 2011 02:46:52 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RCQfy-0004Z9-Ok for submit@debbugs.gnu.org; Sat, 08 Oct 2011 02:46:27 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-4.7 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_MED, RP_MATCHES_RCVD,UNPARSEABLE_RELAY autolearn=unavailable version=3.3.1 Received: from lists.gnu.org ([140.186.70.17]:58202) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RCQfy-0004Z5-Kv for submit@debbugs.gnu.org; Sat, 08 Oct 2011 02:46:26 -0400 Received: from eggs.gnu.org ([140.186.70.92]:53065) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RCQfx-0003rt-RB for bug-gnu-emacs@gnu.org; Sat, 08 Oct 2011 02:46:26 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RCQfw-0004Ym-TI for bug-gnu-emacs@gnu.org; Sat, 08 Oct 2011 02:46:25 -0400 Received: from acsinet15.oracle.com ([141.146.126.227]:27191) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RCQfw-0004Ya-OR for bug-gnu-emacs@gnu.org; Sat, 08 Oct 2011 02:46:24 -0400 Received: from acsinet21.oracle.com (acsinet21.oracle.com [141.146.126.237]) by acsinet15.oracle.com (Switch-3.4.4/Switch-3.4.4) with ESMTP id p986kL4q029987 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Sat, 8 Oct 2011 06:46:23 GMT Received: from acsmt356.oracle.com (acsmt356.oracle.com [141.146.40.156]) by acsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id p986kLiJ029008 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Sat, 8 Oct 2011 06:46:21 GMT Received: from abhmt109.oracle.com (abhmt109.oracle.com [141.146.116.61]) by acsmt356.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id p986kGT8025104 for ; Sat, 8 Oct 2011 01:46:16 -0500 Received: from dradamslap1 (/10.159.53.18) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Fri, 07 Oct 2011 23:46:15 -0700 From: "Drew Adams" To: Subject: 24.0.50; doc string of `key-description' Date: Fri, 7 Oct 2011 23:46:14 -0700 Message-ID: <6DA9B5FF8FD64B779DE793C512752D88@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 Thread-Index: AcyFhflTkIMKTrnjQXKMOuARhjJQIg== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6109 X-Source-IP: acsinet21.oracle.com [141.146.126.237] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090204.4E8FF1BF.00DD:SCFMA922111,ss=1,re=-4.000,fgs=0 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 1) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 140.186.70.17 X-Spam-Score: -6.2 (------) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.2 (------) The doc string dates from before Emacs 21. It was correct then but has been incorrect ever since the nutty decision in Emacs 21 to add angle brackets around function keys. emacs -Q (setq toto (read-key-sequence "k: ")) Hold the Control key and hit the Insert key. (key-description toto) => "" >From the doc string: "Control characters turn into "C-foo" sequences, meta into "M-foo", spaces are put between sequence elements, etc." Since Emacs 21 that needs to be changed to "" and "", since "foo" is obviously the name of a function key (more than one character in the name). And of course it would be better not to use "foo" at all, but to use an example like that in the Elisp manual: (elisp) `Describing Characters' is accurate. In GNU Emacs 24.0.50.1 (i386-mingw-nt5.1.2600) of 2011-09-19 on 3249CTO Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (4.5) --no-opt' From debbugs-submit-bounces@debbugs.gnu.org Sun Mar 11 13:39:21 2012 Received: (at 9700) by debbugs.gnu.org; 11 Mar 2012 17:39:22 +0000 Received: from localhost ([127.0.0.1]:45238 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1S6mjp-0005md-JT for submit@debbugs.gnu.org; Sun, 11 Mar 2012 13:39:21 -0400 Received: from fencepost.gnu.org ([208.118.235.10]:42856) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1S6mje-0005mM-5z for 9700@debbugs.gnu.org; Sun, 11 Mar 2012 13:39:20 -0400 Received: from bb116-14-103-36.singnet.com.sg ([116.14.103.36]:58668 helo=ulysses) by fencepost.gnu.org with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1S6mGm-0006m0-Jj; Sun, 11 Mar 2012 13:09:21 -0400 From: Chong Yidong To: "Drew Adams" Subject: Re: bug#9700: 24.0.50; doc string of `key-description' References: <6DA9B5FF8FD64B779DE793C512752D88@us.oracle.com> Date: Mon, 12 Mar 2012 01:09:12 +0800 In-Reply-To: <6DA9B5FF8FD64B779DE793C512752D88@us.oracle.com> (Drew Adams's message of "Fri, 7 Oct 2011 23:46:14 -0700") Message-ID: <87boo3uksn.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.94 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -6.9 (------) X-Debbugs-Envelope-To: 9700 Cc: 9700@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.9 (------) "Drew Adams" writes: > "Control characters turn into "C-foo" sequences, meta into "M-foo", > spaces are put between sequence elements, etc." > > Since Emacs 21 that needs to be changed to "" and "", > since "foo" is obviously the name of a function key (more than one > character in the name). No, these are not referring to function keys. I tweaked the docstring to make this clearer. From debbugs-submit-bounces@debbugs.gnu.org Sun Mar 11 13:39:26 2012 Received: (at control) by debbugs.gnu.org; 11 Mar 2012 17:39:26 +0000 Received: from localhost ([127.0.0.1]:45241 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1S6mjt-0005ms-VE for submit@debbugs.gnu.org; Sun, 11 Mar 2012 13:39:26 -0400 Received: from fencepost.gnu.org ([208.118.235.10]:42860) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1S6mjs-0005ml-34 for control@debbugs.gnu.org; Sun, 11 Mar 2012 13:39:24 -0400 Received: from bb116-14-103-36.singnet.com.sg ([116.14.103.36]:58669 helo=ulysses) by fencepost.gnu.org with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1S6mH2-0006mS-Sl for control@debbugs.gnu.org; Sun, 11 Mar 2012 13:09:37 -0400 From: Chong Yidong To: control@debbugs.gnu.org Subject: close 9700 Date: Mon, 12 Mar 2012 01:09:25 +0800 Message-ID: <87fwdff4je.fsf@gnu.org> MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -6.9 (------) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.9 (------) close 9700 thanks From debbugs-submit-bounces@debbugs.gnu.org Sun Mar 11 14:27:49 2012 Received: (at 9700) by debbugs.gnu.org; 11 Mar 2012 18:27:49 +0000 Received: from localhost ([127.0.0.1]:45280 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1S6nUi-0008Tx-Hs for submit@debbugs.gnu.org; Sun, 11 Mar 2012 14:27:49 -0400 Received: from rcsinet15.oracle.com ([148.87.113.117]:35896) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1S6nUg-0008To-7O for 9700@debbugs.gnu.org; Sun, 11 Mar 2012 14:27:47 -0400 Received: from ucsinet21.oracle.com (ucsinet21.oracle.com [156.151.31.93]) by rcsinet15.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id q2BHvw3J013282 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sun, 11 Mar 2012 17:57:59 GMT Received: from acsmt356.oracle.com (acsmt356.oracle.com [141.146.40.156]) by ucsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id q2BHvvIF021620 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Sun, 11 Mar 2012 17:57:58 GMT Received: from abhmt107.oracle.com (abhmt107.oracle.com [141.146.116.59]) by acsmt356.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q2BHvvli029121; Sun, 11 Mar 2012 12:57:57 -0500 Received: from dradamslap1 (/10.159.40.129) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sun, 11 Mar 2012 10:57:56 -0700 From: "Drew Adams" To: "'Chong Yidong'" References: <6DA9B5FF8FD64B779DE793C512752D88@us.oracle.com> <87boo3uksn.fsf@gnu.org> Subject: RE: bug#9700: 24.0.50; doc string of `key-description' Date: Sun, 11 Mar 2012 10:57:49 -0700 Message-ID: <75403474087F43D1B8A2FCCE53605D14@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 In-Reply-To: <87boo3uksn.fsf@gnu.org> Thread-Index: Acz/qbnhjsZ0jbdVQkCtHa39BFk9nAABSJDg X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: ucsinet21.oracle.com [156.151.31.93] X-CT-RefId: str=0001.0A090202.4F5CE7A7.008F,ss=1,re=0.000,fgs=0 X-Spam-Score: -6.9 (------) X-Debbugs-Envelope-To: 9700 Cc: 9700@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.9 (------) > > "Control characters turn into "C-foo" sequences, meta into "M-foo", > > spaces are put between sequence elements, etc." > > > > Since Emacs 21 that needs to be changed to "" and "", > > since "foo" is obviously the name of a function key (more than one > > character in the name). > > No, these are not referring to function keys. I tweaked the docstring > to make this clearer. I have not seen your fix yet. b Bt clearly as they were written they did refer to function keys (no spaces: `f o o'). As far as control and meta are concerned, it would be clear enough if you wrote just "C-" and "M-". Dunno if that's what you did. However, it is not enough to mention that control goes to `C-', meta to `M-', and spaces are used as separators - and then end with "etc." That is far too incomplete. A more complete description should be given explicitly (including handling of function keys with angle brackets). Or (preferably) it should (after the "etc.") just do what the doc for `kbd' does. It can simply state that the return value is a value that would be acceptable to `kbd'. Or it can repeat what the `kbd' doc string says: "the format used for saving keyboard macros (see `edmacro-mode')." The point is that `key-description' needs to clearly let users know about the format of the returned description, one way or another. It is not acceptable to punt with "etc.". From unknown Sat Aug 16 15:56:32 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Mon, 09 Apr 2012 11:24:03 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator