From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Andy Wingo Newsgroups: gmane.lisp.guile.devel Subject: Re: [PATCH] Possible Documentation Fix Date: Sun, 30 Jan 2011 13:27:09 +0100 Message-ID: References: NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: dough.gmane.org 1296391048 7230 80.91.229.12 (30 Jan 2011 12:37:28 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sun, 30 Jan 2011 12:37:28 +0000 (UTC) Cc: guile-devel@gnu.org To: Noah Lavine Original-X-From: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Sun Jan 30 13:37:22 2011 Return-path: Envelope-to: guile-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1PjWWv-0008Pw-Tz for guile-devel@m.gmane.org; Sun, 30 Jan 2011 13:37:22 +0100 Original-Received: from localhost ([127.0.0.1]:60626 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PjWWu-0002rF-TD for guile-devel@m.gmane.org; Sun, 30 Jan 2011 07:37:21 -0500 Original-Received: from [140.186.70.92] (port=50211 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PjWWo-0002p4-CD for guile-devel@gnu.org; Sun, 30 Jan 2011 07:37:15 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PjWWn-0002cT-9o for guile-devel@gnu.org; Sun, 30 Jan 2011 07:37:14 -0500 Original-Received: from a-pb-sasl-sd.pobox.com ([64.74.157.62]:56962 helo=sasl.smtp.pobox.com) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PjWWn-0002cP-86 for guile-devel@gnu.org; Sun, 30 Jan 2011 07:37:13 -0500 Original-Received: from sasl.smtp.pobox.com (unknown [127.0.0.1]) by a-pb-sasl-sd.pobox.com (Postfix) with ESMTP id CEBE032D3; Sun, 30 Jan 2011 07:38:04 -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; s=sasl; bh=qu2CPo4kylc4ZHYgVhBrG5/6yYk=; b=NpTPJg 1JBq/8zfSYvdAetwfsQHH1RfaTpYTbsEdtHOGp+B5FZdVw6/L6wFtqJKfe4wCOwf GsOBAOLThTlclowAtmS4YLVtSqCvUHxyEWaF+awPjNN5vHNnJZ2ortG5oFlWppuQ G0FLBVGTlshbruKlr4aR0JNWNJsXVYMGdTutM= 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; q=dns; s=sasl; b=fwCjOhg6Pgq8ZAs1ogXvigOyjpWhe2oB My1ggn6OFqCnhCB0WXJVTONZZyjhgwQABi3NVbAv6LQVVBt2xm0JDU6vRV7H0V2F 4MoKdkOLlxTc4fsvEx7eAy0pz7BSzWcfLPeAFJ6mpctHiHi7+w7cX2Wzv2DsQJPb tGF96EJu3Mo= Original-Received: from a-pb-sasl-sd.pobox.com (unknown [127.0.0.1]) by a-pb-sasl-sd.pobox.com (Postfix) with ESMTP id B7BDB32D2; Sun, 30 Jan 2011 07:38:03 -0500 (EST) Original-Received: from unquote.localdomain (unknown [90.164.198.39]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by a-pb-sasl-sd.pobox.com (Postfix) with ESMTPSA id 2333732D1; Sun, 30 Jan 2011 07:38:01 -0500 (EST) In-Reply-To: (Noah Lavine's message of "Sat, 29 Jan 2011 13:08:50 -0500") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.2 (gnu/linux) X-Pobox-Relay-ID: C7DA3AA2-2C6D-11E0-961E-BC4EF3E828EC-02397024!a-pb-sasl-sd.pobox.com X-detected-operating-system: by eggs.gnu.org: Solaris 10 (beta) X-Received-From: 64.74.157.62 X-BeenThere: guile-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Developers list for Guile, the GNU extensibility library" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Errors-To: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.lisp.guile.devel:11422 Archived-At: Hi Noah, Thanks for the review and patch! On Sat 29 Jan 2011 19:08, Noah Lavine writes: > Could someone who understands syntax-case better than I do please > review it for correctness? It is correct, but I kinda liked the explicit mention of pattern variable environments in the original. In syntax expansion, there are lexical variables, bound in lexical environments, and pattern variables, bound in syntax-expansion environments. The confusion addressed by that paragraph was to treat a lexical variable as a pattern variable. Also: > +The reason this doesn't work is that the binding of @code{'it} established in No need to quote symbols that are in @code{}. Do you still think the discussion of environments is distracting? Documentation should ulitimately be for users, and if the original text is not useful at all, by all means we should change it. Andy -- http://wingolog.org/