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 08:55:47 +0100
Sender: emacs-devel-admin@gnu.org
Message-ID: <E17SvHH-0001yM-00@bundalo.shootybangbang.com>
References: <E17SDzj-0000sL-00@bundalo.shootybangbang.com> <200207111925.g6BJPuO03928@rum.cs.yale.edu> <20020712091229.2E79.LEKTU@terra.es>
NNTP-Posting-Host: localhost.gmane.org
X-Trace: main.gmane.org 1026460248 19591 127.0.0.1 (12 Jul 2002 07:50:48 GMT)
X-Complaints-To: usenet@main.gmane.org
NNTP-Posting-Date: Fri, 12 Jul 2002 07:50:48 +0000 (UTC)
Cc: 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 17SvCS-00055s-00
	for <emacs-devel@main.gmane.org>; Fri, 12 Jul 2002 09:50:48 +0200
Original-Received: from fencepost.gnu.org ([199.232.76.164])
	by quimby.gnus.org with esmtp (Exim 3.12 #1 (Debian))
	id 17SvME-00027o-00
	for <emacs-devel@quimby.gnus.org>; Fri, 12 Jul 2002 10:00:55 +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 17SvCr-0003VL-00; Fri, 12 Jul 2002 03:51:13 -0400
Original-Received: from mail7.svr.pol.co.uk ([195.92.193.21])
	by fencepost.gnu.org with esmtp (Exim 3.35 #1 (Debian))
	id 17SvCY-0003Tz-00
	for <emacs-devel@gnu.org>; Fri, 12 Jul 2002 03:50:54 -0400
Original-Received: from modem-71.ancalagon.dialup.pol.co.uk ([62.136.107.199] helo=bundalo.shootybangbang.com)
	by mail7.svr.pol.co.uk with esmtp (Exim 3.35 #1)
	id 17SvCT-0001ve-00; Fri, 12 Jul 2002 08:50:49 +0100
Original-Received: from jpw by bundalo.shootybangbang.com with local (Exim 3.32 #1 (Debian))
	id 17SvHH-0001yM-00; Fri, 12 Jul 2002 08:55:47 +0100
Original-To: lektu@terra.es
In-Reply-To: <20020712091229.2E79.LEKTU@terra.es> (message from Juanma
	Barranquero on Fri, 12 Jul 2002 09:18:34 +0200)
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:5692
X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:5692

> And speaking of that: why does `describe-variable' put that useless
> "Documentation:" header? `describe-function' does not do it, i.e.:
> 
> > auto-save-hook's value is nil
> > 
> > Documentation:
> > Normal hook run just before auto-saving.
> > 
> > Defined in `files'.
> 
> vs.
> 
> > assq-delete-all is a compiled Lisp function in `subr'.
> > (assq-delete-all KEY ALIST)
> > 
> > Delete from ALIST all elements whose car is KEY.
> > Return the modified alist.

I think for variables with big values, like `global-map', it makes sense.

-- 
John Paul Wallington