From mboxrd@z Thu Jan  1 00:00:00 1970
Path: main.gmane.org!not-for-mail
From: Richard Stallman <rms@gnu.org>
Newsgroups: gmane.emacs.devel
Subject: Re: mentioning variable aliases in `describe-variable'
Date: Tue, 16 Jul 2002 21:04:45 -0600 (MDT)
Sender: emacs-devel-admin@gnu.org
Message-ID: <200207170304.g6H34jg22787@aztec.santafe.edu>
References: <20020712121334.2E82.LEKTU@terra.es> <200207121525.g6CFPXc07608@rum.cs.yale.edu> <20020716131726.4190.LEKTU@terra.es>
Reply-To: rms@gnu.org
NNTP-Posting-Host: localhost.gmane.org
X-Trace: main.gmane.org 1026875228 21990 127.0.0.1 (17 Jul 2002 03:07:08 GMT)
X-Complaints-To: usenet@main.gmane.org
NNTP-Posting-Date: Wed, 17 Jul 2002 03:07:08 +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 17Uf9c-0005iQ-00
	for <emacs-devel@main.gmane.org>; Wed, 17 Jul 2002 05:07:04 +0200
Original-Received: from fencepost.gnu.org ([199.232.76.164])
	by quimby.gnus.org with esmtp (Exim 3.12 #1 (Debian))
	id 17UfKp-0000eB-00
	for <emacs-devel@quimby.gnus.org>; Wed, 17 Jul 2002 05:18: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 17Uf8F-0005qC-00; Tue, 16 Jul 2002 23:05:39 -0400
Original-Received: from pele.santafe.edu ([192.12.12.119])
	by fencepost.gnu.org with esmtp (Exim 3.35 #1 (Debian))
	id 17Uf7O-0005ng-00; Tue, 16 Jul 2002 23:04:46 -0400
Original-Received: from aztec.santafe.edu (aztec [192.12.12.49])
	by pele.santafe.edu (8.11.6+Sun/8.11.6) with ESMTP id g6H34mB24423;
	Tue, 16 Jul 2002 21:04:48 -0600 (MDT)
Original-Received: (from rms@localhost)
	by aztec.santafe.edu (8.10.2+Sun/8.9.3) id g6H34jg22787;
	Tue, 16 Jul 2002 21:04:45 -0600 (MDT)
X-Authentication-Warning: aztec.santafe.edu: rms set sender to rms@aztec using -f
Original-To: lektu@terra.es
In-Reply-To: <20020716131726.4190.LEKTU@terra.es> (message from Juanma
	Barranquero on Tue, 16 Jul 2002 13:31:35 +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:5812
X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:5812

    If it is a bug, AFAICS the only answers are either make `defalias' to
    add the arglist to the end of the docstring of aliased built-ins (messy,
    I think), or klugde `describe-function' to search the arglist of the
    primitive function if the alias has a docstring (ugh).

At present, only `describe-function' knows how to handle the argument
lists.  For builtin functions, the info is part of the doc string; for
Lisp functions, it is not.  Therefore, for alias functions as well, we
only need `describe-function' to handle the arglist.

Perhaps the best thing is simply to tell the user how to put in the
arglist info when making an alias for a builtin function.  That is
definitely a simple method.