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 20:25:38 +0900 (JST) Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <200405121125.UAA11097@etlken.m17n.org> References: <200405121047.TAA10975@etlken.m17n.org> <20040512130729.FB5D.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 1084372112 14827 80.91.224.253 (12 May 2004 14:28:32 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Wed, 12 May 2004 14:28:32 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Wed May 12 16:28:09 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 1BNucR-0005cb-00 for ; Wed, 12 May 2004 16:21:59 +0200 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1BNucR-0008HN-00 for ; Wed, 12 May 2004 16:21:59 +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 1BNuQP-0002J2-Ce for emacs-devel@quimby.gnus.org; Wed, 12 May 2004 10:09:33 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.34) id 1BNrwU-0005wg-2y for emacs-devel@gnu.org; Wed, 12 May 2004 07:30:30 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.34) id 1BNrs9-0005Ao-1b for emacs-devel@gnu.org; Wed, 12 May 2004 07:26:34 -0400 Original-Received: from [192.47.44.130] (helo=tsukuba.m17n.org) by monty-python.gnu.org with esmtp (Exim 4.34) id 1BNrs8-0005AP-1B for emacs-devel@gnu.org; Wed, 12 May 2004 07:26:00 -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 i4CBPcP14245; Wed, 12 May 2004 20:25:38 +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 i4CBPc924894; Wed, 12 May 2004 20:25:38 +0900 (JST) Original-Received: (from handa@localhost) by etlken.m17n.org (8.8.8+Sun/3.7W-2001040620) id UAA11097; Wed, 12 May 2004 20:25:38 +0900 (JST) Original-To: jmbarranquero@wke.es In-reply-to: <20040512130729.FB5D.JMBARRANQUERO@wke.es> (message from Juanma Barranquero on Wed, 12 May 2004 13:10:14 +0200) 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:23247 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:23247 In article <20040512130729.FB5D.JMBARRANQUERO@wke.es>, Juanma Barranquero writes: > On Wed, 12 May 2004 19:47:58 +0900 (JST) > Kenichi Handa wrote: >> I prefer a shorter convention something like @NAME or $NAME. > The probability of a collision with current docstrings is much higher. > $NAME could happen easily in shell-related modules, and both in > perl-related ones. Really? I think it's very rare that a docstring of a funciton that has an argument NAME contains a reference to a shell/perl variable NAME in the form $NAME? I grepped "\$[a-z]" in etc/DOC but found none. The reason I prefer a shorter name is that I want to keep the first line of a docstring in a source code short because we can't fill it. And, if we use @var{NAME}, it's get a little bit difficult to check if the first line fits in 80 columns. --- Ken'ichi HANDA handa@m17n.org