From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Kenichi Handa Newsgroups: gmane.emacs.devel Subject: Re: new *Help* argument highlighting Date: Wed, 12 May 2004 19:47:58 +0900 (JST) Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <200405121047.TAA10975@etlken.m17n.org> References: <20040511000920.AE85.LEKTU@mi.madritel.es> <20040510222621.GC12917@fencepost> <20040511100137.75F6.JMBARRANQUERO@wke.es> NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 (generated by SEMI 1.14.3 - "Ushinoya") Content-Type: text/plain; charset=US-ASCII X-Trace: sea.gmane.org 1084365530 28504 80.91.224.253 (12 May 2004 12:38:50 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Wed, 12 May 2004 12:38:50 +0000 (UTC) Cc: jmbarranquero@wke.es, rms@gnu.org, emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Wed May 12 14:38:32 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 1BNt0K-0005dC-00 for ; Wed, 12 May 2004 14:38:32 +0200 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1BNt0K-0006Jv-00 for ; Wed, 12 May 2004 14:38:32 +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 1BNsrP-0002SV-T9 for emacs-devel@quimby.gnus.org; Wed, 12 May 2004 08:29:20 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.34) id 1BNrwA-0005v0-FS for emacs-devel@gnu.org; Wed, 12 May 2004 07:30:10 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.34) id 1BNrij-0004HQ-HA for emacs-devel@gnu.org; Wed, 12 May 2004 07:16:49 -0400 Original-Received: from [192.47.44.130] (helo=tsukuba.m17n.org) by monty-python.gnu.org with esmtp (Exim 4.34) id 1BNrHN-0001Ex-CL; Wed, 12 May 2004 06:48:02 -0400 Original-Received: from fs.m17n.org (fs.m17n.org [192.47.44.2]) by tsukuba.m17n.org (8.11.6p2/8.11.6) with ESMTP id i4CAlxP13380; Wed, 12 May 2004 19:47:59 +0900 (JST) Original-Received: from etlken.m17n.org (etlken.m17n.org [192.47.44.125]) by fs.m17n.org (8.11.6p2/8.11.6) with ESMTP id i4CAlw924321; Wed, 12 May 2004 19:47:58 +0900 (JST) Original-Received: (from handa@localhost) by etlken.m17n.org (8.8.8+Sun/3.7W-2001040620) id TAA10975; Wed, 12 May 2004 19:47:58 +0900 (JST) Original-To: miles@gnu.org In-reply-to: (message from Miles Bader on 12 May 2004 17:15:00 +0900) User-Agent: SEMI/1.14.3 (Ushinoya) FLIM/1.14.2 (Yagi-Nishiguchi) APEL/10.2 Emacs/21.3 (sparc-sun-solaris2.6) MULE/5.0 (SAKAKI) 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:23238 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:23238 In article , Miles Bader writes: >> That sounds like a good idea. It would be more reliable than assuming >> that upper-case words are argument names. > Why not use the texinfo convention, @var{name} ? Nice & easy to parse, > unlikely to occur in a docstring, and pretty understandable even if > _not_ translated into propertized text. It might also make it easier > when updating a docstring and the manual at the same time. > There are probably other @-escapes which could be useful for docstrings too. I prefer a shorter convention something like @NAME or $NAME. --- Ken'ichi HANDA handa@m17n.org