From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.org!not-for-mail
From: Eli Zaretskii <eliz@gnu.org>
Newsgroups: gmane.emacs.devel
Subject: Re: rcirc manual
Date: Sun, 15 Jan 2006 21:48:30 +0200
Message-ID: <uvewl5l2p.fsf@gnu.org>
References: <87ek3hgunn.fsf@killalla.dreaming> <uek3cs78r.fsf@gnu.org>
	<jkmzi0m8md.fsf@glug.org> <u1wzcruk3.fsf@gnu.org>
	<m1ExXDb-0004EmC@rattlesnake.com> <umzhz19bs.fsf@gnu.org>
	<E1Ey2eC-0006ED-Er@fencepost.gnu.org>
Reply-To: Eli Zaretskii <eliz@gnu.org>
NNTP-Posting-Host: main.gmane.org
X-Trace: sea.gmane.org 1137354551 31728 80.91.229.2 (15 Jan 2006 19:49:11 GMT)
X-Complaints-To: usenet@sea.gmane.org
NNTP-Posting-Date: Sun, 15 Jan 2006 19:49:11 +0000 (UTC)
Cc: bob@rattlesnake.com, emacs-devel@gnu.org, karl@freefriends.org
Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Jan 15 20:49:07 2006
Return-path: <emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org>
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 1EyDrz-0002NK-J3
	for ged-emacs-devel@m.gmane.org; Sun, 15 Jan 2006 20:48:55 +0100
Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.43)
	id 1EyDuE-0001fp-W0
	for ged-emacs-devel@m.gmane.org; Sun, 15 Jan 2006 14:51:15 -0500
Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43)
	id 1EyDu2-0001fF-VT
	for emacs-devel@gnu.org; Sun, 15 Jan 2006 14:51:03 -0500
Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43)
	id 1EyDu1-0001er-CQ
	for emacs-devel@gnu.org; Sun, 15 Jan 2006 14:51:02 -0500
Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.43) id 1EyDu1-0001eo-96
	for emacs-devel@gnu.org; Sun, 15 Jan 2006 14:51:01 -0500
Original-Received: from [192.114.186.66] (helo=romy.inter.net.il)
	by monty-python.gnu.org with esmtp (Exim 4.34)
	id 1EyDxN-0001mY-Mu; Sun, 15 Jan 2006 14:54:29 -0500
Original-Received: from HOME-C4E4A596F7 (IGLD-84-228-138-7.inter.net.il [84.228.138.7])
	by romy.inter.net.il (MOS 3.7.3-GA)
	with ESMTP id DJL41505 (AUTH halo1);
	Sun, 15 Jan 2006 21:48:31 +0200 (IST)
Original-To: rms@gnu.org
In-reply-to: <E1Ey2eC-0006ED-Er@fencepost.gnu.org> (rms@gnu.org)
X-BeenThere: emacs-devel@gnu.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: "Emacs development discussions." <emacs-devel.gnu.org>
List-Unsubscribe: <http://lists.gnu.org/mailman/listinfo/emacs-devel>,
	<mailto:emacs-devel-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/pipermail/emacs-devel>
List-Post: <mailto:emacs-devel@gnu.org>
List-Help: <mailto:emacs-devel-request@gnu.org?subject=help>
List-Subscribe: <http://lists.gnu.org/mailman/listinfo/emacs-devel>,
	<mailto:emacs-devel-request@gnu.org?subject=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:49139
Archived-At: <http://permalink.gmane.org/gmane.emacs.devel/49139>

> From: "Richard M. Stallman" <rms@gnu.org>
> CC: bob@rattlesnake.com, karl@freefriends.org, emacs-devel@gnu.org
> Date: Sun, 15 Jan 2006 02:49:56 -0500
> 
>       For example, you
>     could use either @kbd{M-@key{x}} or @kbd{M-x} (since `x' ``describes a
>     key by name''), but the Texinfo manual doesn't touch this dilemma.
> 
> For key names that are spelled out, such as TAB, always use @key.
> That includes @kbd{M-@key{TAB}}.  You will see that in the Emacs
> manual.

That's mostly true, but the manual also has @kbd{TAB} and @kbd{C-c TAB},
for example.

In any case, the explanation in the Texinfo manual should be more
clear on this, IMHO.  It should explain what keys are suitable for
@key, and why.