From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Richard Stallman 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: 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: 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 ; 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 ; 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 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." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-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.