From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: ludo@gnu.org (Ludovic =?UTF-8?Q?Court=C3=A8s?=) Newsgroups: gmane.lisp.guile.bugs Subject: bug#10522: Patch: Improve optional variable and keyword notation in manual Date: Sat, 04 Feb 2012 00:54:02 +0100 Message-ID: <87d39vjwx1.fsf__26302.5529370227$1328313277$gmane$org@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 1328313277 32093 80.91.229.3 (3 Feb 2012 23:54:37 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Fri, 3 Feb 2012 23:54:37 +0000 (UTC) Cc: b3timmons@speedymail.org, guile-devel , 10522@debbugs.gnu.org To: Andy Wingo Original-X-From: bug-guile-bounces+guile-bugs=m.gmane.org@gnu.org Sat Feb 04 00:54:35 2012 Return-path: Envelope-to: guile-bugs@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 1RtSxe-0004PO-PO for guile-bugs@m.gmane.org; Sat, 04 Feb 2012 00:54:34 +0100 Original-Received: from localhost ([::1]:33284 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RtSxe-0007tj-BF for guile-bugs@m.gmane.org; Fri, 03 Feb 2012 18:54:34 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]:38806) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RtSxb-0007tS-63 for bug-guile@gnu.org; Fri, 03 Feb 2012 18:54:32 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RtSxX-0003Ql-LU for bug-guile@gnu.org; Fri, 03 Feb 2012 18:54:31 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:49280) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RtSxX-0003Qh-HO for bug-guile@gnu.org; Fri, 03 Feb 2012 18:54:27 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1RtSy6-0000LO-80 for bug-guile@gnu.org; Fri, 03 Feb 2012 18:55:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: ludo@gnu.org (Ludovic =?UTF-8?Q?Court=C3=A8s?=) Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-guile@gnu.org Resent-Date: Fri, 03 Feb 2012 23:55:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 10522 X-GNU-PR-Package: guile X-GNU-PR-Keywords: Original-Received: via spool by 10522-submit@debbugs.gnu.org id=B10522.13283132851298 (code B ref 10522); Fri, 03 Feb 2012 23:55:02 +0000 Original-Received: (at 10522) by debbugs.gnu.org; 3 Feb 2012 23:54:45 +0000 Original-Received: from localhost ([127.0.0.1]:52903 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1RtSxp-0000Ks-7U for submit@debbugs.gnu.org; Fri, 03 Feb 2012 18:54:45 -0500 Original-Received: from xanadu.aquilenet.fr ([88.191.123.111]:52491) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1RtSxk-0000Ki-W3 for 10522@debbugs.gnu.org; Fri, 03 Feb 2012 18:54:44 -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 =?UTF-8?Q?Pluvi=C3=B4se?= an 220 de la =?UTF-8?Q?R=C3=A9volution?= 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-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-Received-From: 140.186.70.43 X-BeenThere: bug-guile@gnu.org List-Id: "Bug reports for GUILE, GNU's Ubiquitous Extension Language" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-guile-bounces+guile-bugs=m.gmane.org@gnu.org Original-Sender: bug-guile-bounces+guile-bugs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.lisp.guile.bugs:6190 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.