From mboxrd@z Thu Jan  1 00:00:00 1970
Path: main.gmane.org!not-for-mail
From: Juanma Barranquero <lektu@mi.madritel.es>
Newsgroups: gmane.emacs.devel
Subject: Re: Weird &key arglists in ibuf-macs.el
Date: Mon, 10 May 2004 19:11:49 +0200
Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org
Message-ID: <20040510191001.A874.LEKTU@mi.madritel.es>
References: <20040510142830.5C84.JMBARRANQUERO@wke.es>
	<?fnord?871xls71wz.fsf@ID-97657.usr.dfncis.de>
NNTP-Posting-Host: deer.gmane.org
Mime-Version: 1.0
Content-Type: text/plain; charset="US-ASCII"
Content-Transfer-Encoding: 7bit
X-Trace: sea.gmane.org 1084209282 11524 80.91.224.253 (10 May 2004 17:14:42 GMT)
X-Complaints-To: usenet@sea.gmane.org
NNTP-Posting-Date: Mon, 10 May 2004 17:14:42 +0000 (UTC)
Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Mon May 10 19:14:20 2004
Return-path: <emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org>
Original-Received: from quimby.gnus.org ([80.91.224.244])
	by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian))
	id 1BNEM8-0006G9-00
	for <emacs-devel@deer.gmane.org>; Mon, 10 May 2004 19:14:20 +0200
Original-Received: from monty-python.gnu.org ([199.232.76.173])
	by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian))
	id 1BNEM7-0006Gb-01
	for <emacs-devel@quimby.gnus.org>; Mon, 10 May 2004 19:14:19 +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 1BNEKk-00011R-2e
	for emacs-devel@quimby.gnus.org; Mon, 10 May 2004 13:12:54 -0400
Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.34)
	id 1BNEKL-00010t-2Q
	for emacs-devel@gnu.org; Mon, 10 May 2004 13:12:29 -0400
Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.34)
	id 1BNEJj-0000u5-SJ
	for emacs-devel@gnu.org; Mon, 10 May 2004 13:12:22 -0400
Original-Received: from [62.81.186.19] (helo=smtp09.retemail.es)
	by monty-python.gnu.org with esmtp (Exim 4.34) id 1BNEJj-0000tU-4n
	for emacs-devel@gnu.org; Mon, 10 May 2004 13:11:51 -0400
Original-Received: from [127.0.0.1] ([213.37.34.3]) by smtp09.retemail.es
	(InterMail vM.5.01.05.32 201-253-122-126-132-20030307) with ESMTP
	id <20040510171148.JJKR25645.smtp09.retemail.es@[127.0.0.1]>;
	Mon, 10 May 2004 19:11:48 +0200
Original-To: Lawrence Mitchell <wence@gmx.li>,
 emacs-devel@gnu.org
In-Reply-To: <?fnord?871xls71wz.fsf@ID-97657.usr.dfncis.de>
X-Mailer: Becky! ver. 2.09.01 [en]
X-BeenThere: emacs-devel@gnu.org
X-Mailman-Version: 2.1.4
Precedence: list
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>
List-Post: <mailto:emacs-devel@gnu.org>
List-Help: <mailto:emacs-devel-request@gnu.org?subject=help>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/emacs-devel>,
	<mailto:emacs-devel-request@gnu.org?subject=subscribe>
Errors-To: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org
Xref: main.gmane.org gmane.emacs.devel:23047
X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:23047

On Mon, 10 May 2004 16:11:08 +0100, Lawrence Mitchell <wence@gmx.li> wrote:

> It is legal, see section 3.4.4.1 of the hyperspec <URL:
> http://www.lispworks.com/reference/HyperSpec/Body/03_dda.htm>.

Ah, very interesting, thanks.

> The thing to do here is to explicitly write the arglist in the
> end of the docstring.

Yes, I've seen (and sometimes, added) a few of these, mostly in cases
where

  (function ARG1 &optional ARG2)

is better explained as

  (function ARG1 ARG2 [OTHERARGS]...)

                                                           /L/e/k/t/u