From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: David Kastrup Newsgroups: gmane.emacs.devel Subject: Re: new *Help* argument highlighting Date: 13 May 2004 19:33:46 +0200 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: References: <20040512103042.FB57.JMBARRANQUERO@wke.es> <20040512112914.FB5A.JMBARRANQUERO@wke.es> NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1084469852 10080 80.91.224.253 (13 May 2004 17:37:32 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Thu, 13 May 2004 17:37:32 +0000 (UTC) Cc: Juanma Barranquero , miles@lsi.nec.co.jp, emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Thu May 13 19:37:26 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 1BOK97-0001AD-00 for ; Thu, 13 May 2004 19:37:25 +0200 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1BOK96-0003HI-00 for ; Thu, 13 May 2004 19:37:24 +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 1BOK7C-0005xL-OL for emacs-devel@quimby.gnus.org; Thu, 13 May 2004 13:35:26 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.34) id 1BOK6O-0005st-20 for emacs-devel@gnu.org; Thu, 13 May 2004 13:34:36 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.34) id 1BOK5l-0005JK-2l for emacs-devel@gnu.org; Thu, 13 May 2004 13:34:33 -0400 Original-Received: from [199.232.76.164] (helo=fencepost.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.34) id 1BOK5k-0005JA-Qw for emacs-devel@gnu.org; Thu, 13 May 2004 13:33:56 -0400 Original-Received: from localhost ([127.0.0.1] helo=lola.goethe.zz) by fencepost.gnu.org with esmtp (Exim 4.34) id 1BOK5c-0005cI-ET; Thu, 13 May 2004 13:33:49 -0400 Original-To: rms@gnu.org In-Reply-To: Original-Lines: 19 User-Agent: Gnus/5.09 (Gnus v5.9.0) Emacs/21.3.50 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:23334 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:23334 Richard Stallman writes: > > but personally I think @var is reasonable enough, and > > docstrings are much more often viewed in *Help*. > > I *fully* agree. > > Perhaps we should abbreviate it to @v{..} for this purpose. > Saving even 2 characters will help the formatting of the > doc strings. Since doc strings should be formatted with something like 60 characters or so (I don't remember the exact size right now), it would take at least 3 mentions of @var{} in a single line before the normal terminal line width of 80 characters in the source code would get exceeded. -- David Kastrup, Kriemhildstr. 15, 44793 Bochum