From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Andy Wingo Newsgroups: gmane.lisp.guile.bugs Subject: bug#10522: Patch: Improve optional variable and keyword notation in manual Date: Sat, 09 Mar 2013 09:25:21 +0100 Message-ID: <871ubp56a6.fsf__17310.2729990662$1362817617$gmane$org@pobox.com> References: <87d3ajh1lt.fsf@goof.localdomain> <87obtgjbag.fsf@pobox.com> <876219egqv.fsf@pobox.com> <871ubwg6kf.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: ger.gmane.org 1362817591 18451 80.91.229.3 (9 Mar 2013 08:26:31 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 9 Mar 2013 08:26:31 +0000 (UTC) Cc: guile-devel , 10522@debbugs.gnu.org To: Daniel Hartwig Original-X-From: bug-guile-bounces+guile-bugs=m.gmane.org@gnu.org Sat Mar 09 09:26:55 2013 Return-path: Envelope-to: guile-bugs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1UEF7H-0006i8-CC for guile-bugs@m.gmane.org; Sat, 09 Mar 2013 09:26:55 +0100 Original-Received: from localhost ([::1]:54593 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UEF6v-0000ZG-E3 for guile-bugs@m.gmane.org; Sat, 09 Mar 2013 03:26:33 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:53135) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UEF6n-0000Ym-Ms for bug-guile@gnu.org; Sat, 09 Mar 2013 03:26:30 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UEF6i-0000m8-T3 for bug-guile@gnu.org; Sat, 09 Mar 2013 03:26:25 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:36663) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UEF6i-0000m4-Q2 for bug-guile@gnu.org; Sat, 09 Mar 2013 03:26:20 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1UEF7O-0001o9-9K for bug-guile@gnu.org; Sat, 09 Mar 2013 03:27:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Andy Wingo Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-guile@gnu.org Resent-Date: Sat, 09 Mar 2013 08:27: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.13628175686880 (code B ref 10522); Sat, 09 Mar 2013 08:27:02 +0000 Original-Received: (at 10522) by debbugs.gnu.org; 9 Mar 2013 08:26:08 +0000 Original-Received: from localhost ([127.0.0.1]:40770 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1UEF6W-0001mv-F0 for submit@debbugs.gnu.org; Sat, 09 Mar 2013 03:26:08 -0500 Original-Received: from a-pb-sasl-quonix.pobox.com ([208.72.237.25]:49584 helo=sasl.smtp.pobox.com) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1UEF6U-0001mo-5h for 10522@debbugs.gnu.org; Sat, 09 Mar 2013 03:26:06 -0500 Original-Received: from sasl.smtp.pobox.com (unknown [127.0.0.1]) by a-pb-sasl-quonix.pobox.com (Postfix) with ESMTP id E435ECC8A; Sat, 9 Mar 2013 03:25:23 -0500 (EST) DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=pobox.com; h=from:to:cc :subject:references:date:in-reply-to:message-id:mime-version :content-type:content-transfer-encoding; s=sasl; bh=ua4JZFAQ65nY ONkCEV/YAnc/N7g=; b=TVAIxuLTQWMksDiQeGXs9Q9c4slp9cJKSAeEc5WpaiBa J/y1heViqMMwyEJekSoyzZC2EN/cXPPZRif+82gAFEQrQ9L9OLQ2nEa945vmF2tv Fun3uYnN5IQ44Db64S/nJeHy4PaIhdNIrf/QEsleoGZVnydE3pYX/2ap24SwXrk= DomainKey-Signature: a=rsa-sha1; c=nofws; d=pobox.com; h=from:to:cc :subject:references:date:in-reply-to:message-id:mime-version :content-type:content-transfer-encoding; q=dns; s=sasl; b=bjzJp6 atCe1+a0mLigkBfxnup/usgyeEah6+EXiIbOc83/V/YRTFlxSxcwZ+WKm85+xSn2 Y+i+WFpYDnVuJ1RCY+Zn5tvqdZEk6dpNXkqPHiTt7l+dE0dgv6eyrsD20as2eNRr De0oofgW6P4kXXTeV9PdjVvOlxbZywL7hVWjQ= Original-Received: from a-pb-sasl-quonix.pobox.com (unknown [127.0.0.1]) by a-pb-sasl-quonix.pobox.com (Postfix) with ESMTP id DBA2FCC89; Sat, 9 Mar 2013 03:25:23 -0500 (EST) Original-Received: from badger (unknown [88.160.190.192]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by a-pb-sasl-quonix.pobox.com (Postfix) with ESMTPSA id 61B56CC88; Sat, 9 Mar 2013 03:25:23 -0500 (EST) In-Reply-To: (Daniel Hartwig's message of "Sat, 9 Mar 2013 09:58:47 +0800") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.2 (gnu/linux) X-Pobox-Relay-ID: E35789AA-8892-11E2-A6EB-59240E5B5709-02397024!a-pb-sasl-quonix.pobox.com 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.x 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:6895 Archived-At: On Sat 09 Mar 2013 02:58, Daniel Hartwig writes: > -- Scheme Procedure: eval-string string [#:module=3D#f] [#:file=3D#f] > [#:line=3D#f] [#:column=3D#f] [#:lang=3D(current-language)] > [#:compile?=3D#f] > > we see that there is some potential confusion between the close, > unescaped (as with @code, =E2=80=98=E2=80=99) nesting of the parens/brack= ets. Should we remove the brackets entirely? i.e -- Scheme Procedure: eval-string string #:module=3D#f #:file=3D#f #:line=3D#f #:column=3D#f #:lang=3D(current-language) #:compile?=3D#f Or with @code{}: -- Scheme Procedure: eval-string string #:module=3D=E2=80=98#f=E2=80=99 #:= file=3D=E2=80=98#f=E2=80=99 #:line=3D=E2=80=98#f=E2=80=99 #:column=3D=E2=80=98#f=E2=80=99 #:l= ang=3D=E2=80=98(current-language)=E2=80=99 #:compile?=3D=E2=80=98#f=E2=80=99 Dunno, just throwing more ideas out there... Andy --=20 http://wingolog.org/