From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: drew.adams@oracle.com: bug in read-kbd-macro Date: Wed, 27 Sep 2006 06:33:44 +0300 Message-ID: References: Reply-To: Eli Zaretskii NNTP-Posting-Host: main.gmane.org X-Trace: sea.gmane.org 1159328061 21152 80.91.229.2 (27 Sep 2006 03:34:21 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Wed, 27 Sep 2006 03:34:21 +0000 (UTC) Cc: karl@freefriends.org, emacs-devel@gnu.org, bojohan+news@dd.chalmers.se Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Sep 27 05:34:18 2006 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1GSQBP-0005tK-SA for ged-emacs-devel@m.gmane.org; Wed, 27 Sep 2006 05:34:04 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1GSQBO-0005OU-W2 for ged-emacs-devel@m.gmane.org; Tue, 26 Sep 2006 23:34:03 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1GSQBD-0005Nt-J8 for emacs-devel@gnu.org; Tue, 26 Sep 2006 23:33:51 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1GSQBD-0005Nd-3Q for emacs-devel@gnu.org; Tue, 26 Sep 2006 23:33:51 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1GSQBC-0005Na-Mp for emacs-devel@gnu.org; Tue, 26 Sep 2006 23:33:50 -0400 Original-Received: from [192.114.186.20] (helo=nitzan.inter.net.il) by monty-python.gnu.org with esmtp (Exim 4.52) id 1GSQFy-0004hD-J3 for emacs-devel@gnu.org; Tue, 26 Sep 2006 23:38:46 -0400 Original-Received: from HOME-C4E4A596F7 (IGLD-84-229-212-201.inter.net.il [84.229.212.201]) by nitzan.inter.net.il (MOS 3.7.3-GA) with ESMTP id ETJ29133 (AUTH halo1); Wed, 27 Sep 2006 06:33:43 +0300 (IDT) Original-To: "Drew Adams" In-reply-to: X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:60260 Archived-At: > From: "Drew Adams" > Cc: , , > > Date: Tue, 26 Sep 2006 17:18:37 -0700 > > The UI notation is not the same as the manual notation. What is ``the UI notation''? > You, I think, are speaking of consistency within the manual. Yes. > > 2. It's useful to have the same notation for both online > and printed manual, in general. > > Given how @key is typeset in the printed version, this is > clearly impossible, except in the graphics session of Emacs, > and then only if we hide the text of the Info file and show > some image in its stead. > > No; it is possible. Just do the opposite: bring the printed > version into line with the online version, even the non-graphic > (i.e. console) version, by using `next' for both. I think this is silly. The printed version is more powerful than a plain text version, and there's no need to go to the lowest common denominator just for consistency's sake. It's good enough that the two are sufficiently similar. Btw, @var causes its argument to be typeset in italics in the printed version, but in the Info version it produces UPPERCASE. Would you suggest to typeset it in upper-case in the printed manual as well, for consistency's sake? It's absurd, I think. > I explained (in the part that you omitted) that separation by > spaces (e.g. `p r i o r' vs `prior') is an alternative convention > for a key sequence, which disambiguates the two just as well The problem is not how to show sequence of keys, the problem is how to prevent the user from erroneously interpreting "Type `FOO'" as meaning that she should type those literal characters. It's about possible reader's confusion, not about our notation.