From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: ludo@gnu.org (Ludovic =?iso-8859-1?Q?Court=E8s?=) Newsgroups: gmane.lisp.guile.devel Subject: Re: bug#10522: Patch: Improve optional variable and keyword notation in manual Date: Sat, 04 Feb 2012 00:54:02 +0100 Message-ID: <87d39vjwx1.fsf@gnu.org> References: <87d3ajh1lt.fsf@goof.localdomain> <87obtgjbag.fsf@pobox.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: dough.gmane.org 1328313260 32001 80.91.229.3 (3 Feb 2012 23:54:20 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Fri, 3 Feb 2012 23:54:20 +0000 (UTC) Cc: b3timmons@speedymail.org, guile-devel , 10522@debbugs.gnu.org To: Andy Wingo Original-X-From: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Sat Feb 04 00:54:15 2012 Return-path: Envelope-to: guile-devel@m.gmane.org Original-Received: from lists.gnu.org ([140.186.70.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1RtSxL-0004EK-72 for guile-devel@m.gmane.org; Sat, 04 Feb 2012 00:54:15 +0100 Original-Received: from localhost ([::1]:33151 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RtSxK-0007ov-GA for guile-devel@m.gmane.org; Fri, 03 Feb 2012 18:54:14 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]:59258) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RtSxF-0007od-Gr for guile-devel@gnu.org; Fri, 03 Feb 2012 18:54:13 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RtSxB-0003Ni-Pl for guile-devel@gnu.org; Fri, 03 Feb 2012 18:54:09 -0500 Original-Received: from xanadu.aquilenet.fr ([88.191.123.111]:52244) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RtSxB-0003Na-LB for guile-devel@gnu.org; Fri, 03 Feb 2012 18:54:05 -0500 Original-Received: from localhost (xanadu.aquilenet.fr [127.0.0.1]) by xanadu.aquilenet.fr (Postfix) with ESMTP id 2300C2077; Sat, 4 Feb 2012 00:54:04 +0100 (CET) Original-Received: from xanadu.aquilenet.fr ([127.0.0.1]) by localhost (xanadu.aquilenet.fr [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 2ogrvwDjSgmo; Sat, 4 Feb 2012 00:54:04 +0100 (CET) Original-Received: from pluto (126.1-64-87.adsl-dyn.isp.belgacom.be [87.64.1.126]) by xanadu.aquilenet.fr (Postfix) with ESMTPSA id 51E42A7A; Sat, 4 Feb 2012 00:54:03 +0100 (CET) X-URL: http://www.fdn.fr/~lcourtes/ X-Revolutionary-Date: 16 =?iso-8859-1?Q?Pluvi=F4se?= an 220 de la =?iso-8859-1?Q?R=E9volution?= X-PGP-Key-ID: 0xEA52ECF4 X-PGP-Key: http://www.fdn.fr/~lcourtes/ludovic.asc X-PGP-Fingerprint: 83C4 F8E5 10A3 3B4C 5BEA D15D 77DD 95E2 EA52 ECF4 X-OS: x86_64-unknown-linux-gnu In-Reply-To: <87obtgjbag.fsf@pobox.com> (Andy Wingo's message of "Fri, 03 Feb 2012 14:28:55 +0100") User-Agent: Gnus/5.110018 (No Gnus v0.18) Emacs/24.0.93 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 88.191.123.111 X-BeenThere: guile-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Developers list for Guile, the GNU extensibility library" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Original-Sender: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.lisp.guile.devel:13796 Archived-At: Hello! :-) Andy Wingo skribis: > On Mon 16 Jan 2012 20:46, Bake Timmons writes: >> -@deffn {Scheme Procedure} resolve-module name [autoload=3D#t] [version= =3D#f] [#:ensure=3D#t] >> +@deffn {Scheme Procedure} resolve-module name [autoload=3D#t [version= =3D#f]] @ >> + [#:ensure ensure=3D#t] > > Nesting the optional arguments in brackets can get a bit ugly. It is > precise but verbose. But I suppose we should not encourage interfaces > with many optional arguments, so perhaps it is a moot point. Indeed. > Also, it seems pedantic to repeat the keyword arguments (once as > keyword, once as identifier). Surely #:foo=3Dbar is unambiguous? That=E2=80=99s what I would think. Perhaps the people behind bug-texinfo@gnu.org have something to say about this kind of thing, since there are other Lispy packages out there with similar features? Thanks, Ludo=E2=80=99.