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: Syntax Parameters documentation for guile Date: Fri, 06 Jan 2012 19:47:50 +0100 Message-ID: <87mxa0llbd.fsf@pobox.com> References: <87pqff8f5g.fsf@Kagami.home> <20222.48501.219043.125940@winooski.ccs.neu.edu> <87sjjwz8u9.fsf@Kagami.home> <20227.40509.861506.889987@winooski.ccs.neu.edu> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: dough.gmane.org 1325875693 26498 80.91.229.12 (6 Jan 2012 18:48:13 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Fri, 6 Jan 2012 18:48:13 +0000 (UTC) Cc: Eli Barzilay , Guile Mailing List To: Ian Price Original-X-From: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Fri Jan 06 19:48:08 2012 Return-path: Envelope-to: guile-devel@m.gmane.org Original-Received: from lists.gnu.org ([140.186.70.17]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1RjEpe-0002Li-B9 for guile-devel@m.gmane.org; Fri, 06 Jan 2012 19:48:02 +0100 Original-Received: from localhost ([::1]:42025 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RjEpd-00060V-Gv for guile-devel@m.gmane.org; Fri, 06 Jan 2012 13:48:01 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]:50086) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RjEpZ-0005rp-NO for guile-devel@gnu.org; Fri, 06 Jan 2012 13:47:59 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RjEpY-0002X4-8y for guile-devel@gnu.org; Fri, 06 Jan 2012 13:47:57 -0500 Original-Received: from a-pb-sasl-sd.pobox.com ([74.115.168.62]:41683 helo=sasl.smtp.pobox.com) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RjEpX-0002Wu-UX for guile-devel@gnu.org; Fri, 06 Jan 2012 13:47:56 -0500 Original-Received: from sasl.smtp.pobox.com (unknown [127.0.0.1]) by a-pb-sasl-sd.pobox.com (Postfix) with ESMTP id 34C2F83D0; Fri, 6 Jan 2012 13:47:55 -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=C02sRPTBYd9KG+ll5LCkmChraMY=; b=J2Q66x mLoz63qIKE+ouEqc9HrRfLQttKznlJ2dFIa++hBROHCU0H0TKXRZo7D8ulHD5VTe m3dR1A+8X8FtmFd+1KKqy7yFcz4XuUad3W+UM0aGE7mtegcZghpuPEv+PwX/rQTD RXZDAjzW0RExnzJv6wqyHl+FBeP/1r8bqp97c= 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=fkJU26q1k5dcT6q5ME7rvcDjZQAIAv+i blnEyjh34FoUGVgIRJ+zbDtW4fWV7LZErY9Up43ELxPsKCRHRjYqfKbtLVUFGta3 /lhZt8J49l7iVs0zELRKPVMTTHLKyAABoAScKRQt9mszUXH0pgB3G2byIkPQaEpb dyQEROVdZGQ= 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 2DD5A83CF; Fri, 6 Jan 2012 13:47:55 -0500 (EST) Original-Received: from badger (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 8653B83CD; Fri, 6 Jan 2012 13:47:54 -0500 (EST) In-Reply-To: <20227.40509.861506.889987@winooski.ccs.neu.edu> (Eli Barzilay's message of "Tue, 3 Jan 2012 19:33:01 -0500") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.3 (gnu/linux) X-Pobox-Relay-ID: F1929A20-3896-11E1-A557-65B1DE995924-02397024!a-pb-sasl-sd.pobox.com X-detected-operating-system: by eggs.gnu.org: Solaris 10 (beta) X-Received-From: 74.115.168.62 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:13363 Archived-At: Hi Ian, Thanks for writing these docs, and thanks to Eli for commenting on them. I have pushed a couple commits to Guile that provide define-syntax-parameter and syntax-parameterize on the stable-2.0 branch, in addition to the support that was already there on master. Unlike the implementation on master, which correctly restricts syntax-parameterize to operate only on syntax parameters, stable-2.0's syntax-parameterize works on all bindings, for back compatibility with `fluid-let-syntax'. The point, of course, is to allow Guile 2.0 code to use the syntax parameter API, even if the implementation is only fully landed in Guile 2.2. That way when users upgrade, they don't have to change their code. I have deprecated fluid-let-syntax, so let's please not speak of it any more :-) On Wed 04 Jan 2012 01:33, Eli Barzilay writes: >> In case anyone else has any comments, the modified version is >> included below. Now I'm off to learn about texinfo :) > > (Ugh, medieval programming...) Goes along with the "guild" stuff, I guess :) Ian, just edit doc/ref/api-macros.texi. You don't need to know very much in the way of formatting; just follow the examples there and you'll be good. Thanks again! Andy -- http://wingolog.org/