From mboxrd@z Thu Jan  1 00:00:00 1970
Path: main.gmane.org!not-for-mail
From: John Paul Wallington <jpw@shootybangbang.com>
Newsgroups: gmane.emacs.devel
Subject: Re: mentioning variable aliases in `describe-variable'
Date: Fri, 12 Jul 2002 09:47:24 +0100
Sender: emacs-devel-admin@gnu.org
Message-ID: <E17Sw5E-000204-00@bundalo.shootybangbang.com>
References: <E17SDzj-0000sL-00@bundalo.shootybangbang.com>
	<200207111925.g6BJPuO03928@rum.cs.yale.edu>
	<20020712091229.2E79.LEKTU@terra.es>
	<E17SvHH-0001yM-00@bundalo.shootybangbang.com> <buohej5s7dc.fsf@mcspd15.ucom.lsi.nec.co.jp>
NNTP-Posting-Host: localhost.gmane.org
X-Trace: main.gmane.org 1026463352 25335 127.0.0.1 (12 Jul 2002 08:42:32 GMT)
X-Complaints-To: usenet@main.gmane.org
NNTP-Posting-Date: Fri, 12 Jul 2002 08:42:32 +0000 (UTC)
Cc: lektu@terra.es, monnier+gnu/emacs@rum.cs.yale.edu,
	emacs-devel@gnu.org
Return-path: <emacs-devel-admin@gnu.org>
Original-Received: from quimby.gnus.org ([80.91.224.244])
	by main.gmane.org with esmtp (Exim 3.33 #1 (Debian))
	id 17Sw0W-0006aW-00
	for <emacs-devel@main.gmane.org>; Fri, 12 Jul 2002 10:42:32 +0200
Original-Received: from fencepost.gnu.org ([199.232.76.164])
	by quimby.gnus.org with esmtp (Exim 3.12 #1 (Debian))
	id 17SwAJ-0003GM-00
	for <emacs-devel@quimby.gnus.org>; Fri, 12 Jul 2002 10:52:39 +0200
Original-Received: from localhost ([127.0.0.1] helo=fencepost.gnu.org)
	by fencepost.gnu.org with esmtp (Exim 3.35 #1 (Debian))
	id 17Sw1B-0005z5-00; Fri, 12 Jul 2002 04:43:13 -0400
Original-Received: from imailg1.svr.pol.co.uk ([195.92.195.179])
	by fencepost.gnu.org with esmtp (Exim 3.35 #1 (Debian))
	id 17Sw0X-0005wf-00; Fri, 12 Jul 2002 04:42:33 -0400
Original-Received: from modem-28.calaquendi.dialup.pol.co.uk ([62.136.144.28] helo=bundalo.shootybangbang.com)
	by imailg1.svr.pol.co.uk with esmtp (Exim 3.35 #1)
	id 17Sw0R-0003ph-00; Fri, 12 Jul 2002 09:42:28 +0100
Original-Received: from jpw by bundalo.shootybangbang.com with local (Exim 3.32 #1 (Debian))
	id 17Sw5E-000204-00; Fri, 12 Jul 2002 09:47:24 +0100
Original-To: miles@gnu.org
In-Reply-To: <buohej5s7dc.fsf@mcspd15.ucom.lsi.nec.co.jp> (message from Miles
	Bader on 12 Jul 2002 17:00:47 +0900)
Errors-To: emacs-devel-admin@gnu.org
X-BeenThere: emacs-devel@gnu.org
X-Mailman-Version: 2.0.11
Precedence: bulk
List-Help: <mailto:emacs-devel-request@gnu.org?subject=help>
List-Post: <mailto:emacs-devel@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/emacs-devel>,
	<mailto:emacs-devel-request@gnu.org?subject=subscribe>
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/>
Xref: main.gmane.org gmane.emacs.devel:5695
X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:5695

> > > And speaking of that: why does `describe-variable' put that useless
> > > "Documentation:" header? `describe-function' does not do it, i.e.:
> > 
> > I think for variables with big values, like `global-map', it makes sense.
> 
> Why?  If you mean `because it matches the Value: label used below', I'm
> not sure why it matters.
> 
> I agree with Juanma; `Documentation:' is just an ugly and useless wart.

I guess it does look cleaner without it.

-- 
John Paul Wallington