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: Emacs manual: correct @code to @kbd Date: Mon, 08 Jun 2009 23:01:52 -0400 Message-ID: References: Reply-To: Eli Zaretskii NNTP-Posting-Host: lo.gmane.org X-Trace: ger.gmane.org 1244516526 20502 80.91.229.12 (9 Jun 2009 03:02:06 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 9 Jun 2009 03:02:06 +0000 (UTC) Cc: emacs-devel@gnu.org To: "Aaron S. Hawley" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Jun 09 05:02:03 2009 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1MDrb8-0005Qt-2V for ged-emacs-devel@m.gmane.org; Tue, 09 Jun 2009 05:02:02 +0200 Original-Received: from localhost ([127.0.0.1]:48336 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MDrb7-0001BQ-FS for ged-emacs-devel@m.gmane.org; Mon, 08 Jun 2009 23:02:01 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1MDrb2-0001BK-Gt for emacs-devel@gnu.org; Mon, 08 Jun 2009 23:01:56 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1MDraz-0001AX-2S for emacs-devel@gnu.org; Mon, 08 Jun 2009 23:01:56 -0400 Original-Received: from [199.232.76.173] (port=48895 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MDray-0001AT-Q7 for emacs-devel@gnu.org; Mon, 08 Jun 2009 23:01:52 -0400 Original-Received: from fencepost.gnu.org ([140.186.70.10]:43423) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1MDray-0004Rd-Ck for emacs-devel@gnu.org; Mon, 08 Jun 2009 23:01:52 -0400 Original-Received: from eliz by fencepost.gnu.org with local (Exim 4.67) (envelope-from ) id 1MDray-0005Fa-A2; Mon, 08 Jun 2009 23:01:52 -0400 In-reply-to: (aaron.s.hawley@gmail.com) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6, seldom 2.4 (older, 4) 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:111386 Archived-At: > Date: Mon, 8 Jun 2009 14:58:52 -0400 > From: "Aaron S. Hawley" > > I found a dozen places in the Emacs manual where the markup should be > @kbd and not @code. > > Here's a patch. Thanks. However, some of your corrections are wrong. For example, this: > --- doc/emacs/custom.texi 4 Jun 2009 03:13:28 -0000 1.22 > +++ doc/emacs/custom.texi 8 Jun 2009 18:49:57 -0000 > @@ -1706,7 +1706,7 @@ > @end example > > When the key sequence includes function keys or mouse button events, > -or non-@acronym{ASCII} characters such as @code{C-=} or @code{H-a}, > +or non-@acronym{ASCII} characters such as @kbd{C-=} or @kbd{H-a}, Since this talks about _characters_, not keystrokes, @kdb is inappropriate here, I think. > -the current alternative with a special color; type @code{C-@key{SPC}} > +the current alternative with a special color; type @kbd{C-SPC} This should be @kbd{C-@key{SPC}}, because we don't want "SPC to be confused for the 3 characters S P C. Thanks again for working on this.