From mboxrd@z Thu Jan  1 00:00:00 1970
Path: main.gmane.org!not-for-mail
From: Richard Stallman <rms@gnu.org>
Newsgroups: gmane.emacs.devel
Subject: Re: new *Help* argument highlighting
Date: Wed, 12 May 2004 03:51:17 -0400
Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org
Message-ID: <E1BNoWL-0002xq-Vp@fencepost.gnu.org>
References: <20040511000920.AE85.LEKTU@mi.madritel.es>
	<20040510222621.GC12917@fencepost>
	<20040511100137.75F6.JMBARRANQUERO@wke.es>
Reply-To: rms@gnu.org
NNTP-Posting-Host: deer.gmane.org
X-Trace: sea.gmane.org 1084348575 20209 80.91.224.253 (12 May 2004 07:56:15 GMT)
X-Complaints-To: usenet@sea.gmane.org
NNTP-Posting-Date: Wed, 12 May 2004 07:56:15 +0000 (UTC)
Cc: miles@gnu.org, emacs-devel@gnu.org
Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Wed May 12 09:56:07 2004
Return-path: <emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org>
Original-Received: from quimby.gnus.org ([80.91.224.244])
	by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian))
	id 1BNob0-0006lq-00
	for <emacs-devel@deer.gmane.org>; Wed, 12 May 2004 09:56:06 +0200
Original-Received: from monty-python.gnu.org ([199.232.76.173])
	by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian))
	id 1BNob0-0000eI-00
	for <emacs-devel@quimby.gnus.org>; Wed, 12 May 2004 09:56:06 +0200
Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org)
	by monty-python.gnu.org with esmtp (Exim 4.34)
	id 1BNoYt-0001Xz-JP
	for emacs-devel@quimby.gnus.org; Wed, 12 May 2004 03:53:55 -0400
Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.34)
	id 1BNoWt-0000rc-O9
	for emacs-devel@gnu.org; Wed, 12 May 2004 03:51:51 -0400
Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.34)
	id 1BNoWM-0000i3-MN
	for emacs-devel@gnu.org; Wed, 12 May 2004 03:51:49 -0400
Original-Received: from [199.232.76.164] (helo=fencepost.gnu.org)
	by monty-python.gnu.org with esmtp (Exim 4.34) id 1BNoWM-0000hy-Go
	for emacs-devel@gnu.org; Wed, 12 May 2004 03:51:18 -0400
Original-Received: from rms by fencepost.gnu.org with local (Exim 4.34)
	id 1BNoWL-0002xq-Vp; Wed, 12 May 2004 03:51:18 -0400
Original-To: Juanma Barranquero <jmbarranquero@wke.es>
In-reply-to: <20040511100137.75F6.JMBARRANQUERO@wke.es> (message from Juanma
	Barranquero on Tue, 11 May 2004 10:11:35 +0200)
X-BeenThere: emacs-devel@gnu.org
X-Mailman-Version: 2.1.4
Precedence: list
List-Id: "Emacs development discussions." <emacs-devel.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/emacs-devel>,
	<mailto:emacs-devel-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.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://mail.gnu.org/mailman/listinfo/emacs-devel>,
	<mailto:emacs-devel-request@gnu.org?subject=subscribe>
Errors-To: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org
Xref: main.gmane.org gmane.emacs.devel:23220
X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:23220

    Aside: for this to work, docstring writers still have to use the ALLCAPS
    convention for arguments; I wonder if we could introduce (sometime after
    21.[45], obviously :) a new (additional) convention to mark arguments in
    the docstring, so less guesswork is needed.

That sounds like a good idea.  It would be more reliable than assuming
that upper-case words are argument names.