From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#3516: 23.0.94; function key names in Info Date: Thu, 11 Jun 2009 06:42:20 -0400 Message-ID: References: Reply-To: Eli Zaretskii , 3516@emacsbugs.donarmstrong.com NNTP-Posting-Host: lo.gmane.org X-Trace: ger.gmane.org 1244717867 23093 80.91.229.12 (11 Jun 2009 10:57:47 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 11 Jun 2009 10:57:47 +0000 (UTC) Cc: 3516@emacsbugs.donarmstrong.com To: "Drew Adams" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Jun 11 12:57:42 2009 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1MEhyX-0000qU-Q2 for geb-bug-gnu-emacs@m.gmane.org; Thu, 11 Jun 2009 12:57:42 +0200 Original-Received: from localhost ([127.0.0.1]:51567 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MEhyX-00052A-66 for geb-bug-gnu-emacs@m.gmane.org; Thu, 11 Jun 2009 06:57:41 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1MEhyQ-0004zN-Ry for bug-gnu-emacs@gnu.org; Thu, 11 Jun 2009 06:57:34 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1MEhyG-0004om-HF for bug-gnu-emacs@gnu.org; Thu, 11 Jun 2009 06:57:29 -0400 Original-Received: from [199.232.76.173] (port=49836 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MEhyE-0004o5-8g for bug-gnu-emacs@gnu.org; Thu, 11 Jun 2009 06:57:22 -0400 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:44892) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1MEhyD-0005Fs-E0 for bug-gnu-emacs@gnu.org; Thu, 11 Jun 2009 06:57:21 -0400 Original-Received: from rzlab.ucr.edu (rzlab.ucr.edu [127.0.0.1]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n5BAvJ9L007825; Thu, 11 Jun 2009 03:57:19 -0700 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.14.3/8.14.3/Submit) id n5BAo4eh006510; Thu, 11 Jun 2009 03:50:04 -0700 X-Loop: owner@emacsbugs.donarmstrong.com Resent-From: Eli Zaretskii Resent-To: bug-submit-list@donarmstrong.com Resent-CC: Emacs Bugs Resent-Date: Thu, 11 Jun 2009 10:50:04 +0000 Resent-Message-ID: Resent-Sender: owner@emacsbugs.donarmstrong.com X-Emacs-PR-Message: followup 3516 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Original-Received: via spool by 3516-submit@emacsbugs.donarmstrong.com id=B3516.12447169455741 (code B ref 3516); Thu, 11 Jun 2009 10:50:04 +0000 Original-Received: (at 3516) by emacsbugs.donarmstrong.com; 11 Jun 2009 10:42:25 +0000 X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. Original-Received: from fencepost.gnu.org (fencepost.gnu.org [140.186.70.10]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n5BAgLnl005731 for <3516@emacsbugs.donarmstrong.com>; Thu, 11 Jun 2009 03:42:22 -0700 Original-Received: from eliz by fencepost.gnu.org with local (Exim 4.67) (envelope-from ) id 1MEhjg-0003cL-6A; Thu, 11 Jun 2009 06:42:20 -0400 In-reply-to: (drew.adams@oracle.com) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 2) Resent-Date: Thu, 11 Jun 2009 06:57:29 -0400 X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:28649 Archived-At: > From: "Drew Adams" > Date: Wed, 10 Jun 2009 15:33:50 -0700 > > > > We see things like , , , and without single > > > quotes. Similarly, in other parts of the manual. > > > > > > Shouldn't those be `', `', `', and `'? > > > > > > We use `C-x ' here, and we use `C-x', but not `'. > > > Likewise, we use `C-h' (which should be ` C-h', BTW), > > > but not `'. > > > > > > The notation used does not seem consistent. > > > Why write "(`C-h' or )", instead of "(`C-h' or `')"? > > > > Please show here the Texinfo sources, not just the text from the Info > > manual. I'm not saying that all you report is necessarily correct, > > but it could be: ESC and RET are both characters and keys. In the > > character context, ESC and RET are correct, while in the key context, > > `' and `' are correct (the latter comes from @key, and I > > don't remember now whether @key produces the quotes in addition to > > <..>). > > I don't have the Texinfo sources. > > I'm just an Emacs user reporting what seems to be an Emacs bug - in Info. You are more than "just a user", Drew, let's be honest. Anyway, at least provide these quotes with context. Grepping through Info files for "" and the likes is no fun. Since you already look at the surrounding text, pasting it into the bug report should be easy. > For my part, I was referring to (or trying to refer to) passages that talk about > keys, not characters. To me, key sequences should be wrapped in `...', even when > they have <...>. To me, the key sequence should be written `' even if the > character is written SPC. We use and such likes for keyboard keys that are labeled with more than a single character. The issue here is to prevent confusion on the reader's part between a single key labeled "ESC" and a sequence of 3 keys E, S, C. When a key is labeled with a single character, this confusion cannot happen, so <..> is not used in that case, because it would just make the reading harder with no good reason. Likewise, key sequences such as C-k are not single keys, you actually use 2 or more keys to type them. So <..> is inappropriate in that context as well. Thus, single keys and key sequences get different markup.