From mboxrd@z Thu Jan  1 00:00:00 1970
Path: main.gmane.org!not-for-mail
From: Juanma Barranquero <lektu@terra.es>
Newsgroups: gmane.emacs.devel
Subject: Re: mentioning variable aliases in `describe-variable'
Date: Fri, 12 Jul 2002 09:18:34 +0200
Sender: emacs-devel-admin@gnu.org
Message-ID: <20020712091229.2E79.LEKTU@terra.es>
References: <E17SDzj-0000sL-00@bundalo.shootybangbang.com> <200207111925.g6BJPuO03928@rum.cs.yale.edu>
NNTP-Posting-Host: localhost.gmane.org
Mime-Version: 1.0
Content-Type: text/plain; charset="US-ASCII"
Content-Transfer-Encoding: 7bit
X-Trace: main.gmane.org 1026458321 16479 127.0.0.1 (12 Jul 2002 07:18:41 GMT)
X-Complaints-To: usenet@main.gmane.org
NNTP-Posting-Date: Fri, 12 Jul 2002 07:18:41 +0000 (UTC)
Cc: John Paul Wallington <jpw@shootybangbang.com>, 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 17SuhM-0004Hf-00
	for <emacs-devel@main.gmane.org>; Fri, 12 Jul 2002 09:18:40 +0200
Original-Received: from fencepost.gnu.org ([199.232.76.164])
	by quimby.gnus.org with esmtp (Exim 3.12 #1 (Debian))
	id 17Sur8-0001QE-00
	for <emacs-devel@quimby.gnus.org>; Fri, 12 Jul 2002 09:28:46 +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 17Suht-0001TK-00; Fri, 12 Jul 2002 03:19:13 -0400
Original-Received: from [62.22.27.141] (helo=mail.peoplecall.com)
	by fencepost.gnu.org with esmtp (Exim 3.35 #1 (Debian))
	id 17Suhb-0001T7-00
	for <emacs-devel@gnu.org>; Fri, 12 Jul 2002 03:18:55 -0400
Original-Received: from [62.22.27.143] (jbarranquero.ofi.peoplecall.com [62.22.27.143])
	by mail.peoplecall.com (8.11.6/8.11.6) with ESMTP id g6C7IVM00808;
	Fri, 12 Jul 2002 09:18:33 +0200
Original-To: "Stefan Monnier" <monnier+gnu/emacs@rum.cs.yale.edu>
In-Reply-To: <200207111925.g6BJPuO03928@rum.cs.yale.edu>
X-Mailer: Becky! ver. 2.05
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:5690
X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:5690

On Thu, 11 Jul 2002 15:25:55 -0400, "Stefan Monnier" <monnier+gnu/emacs@rum.cs.yale.edu> wrote:

> Go for it, although I'd personally put the info near the
> first line (as is done for function aliases) rather than near
> the bottom.

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.



                                                           /L/e/k/t/u