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: compiler.texi: Compiling to the virtual machine Date: Thu, 15 Jan 2009 23:03:20 +0100 Message-ID: References: <87fxjmltab.fsf@gnu.org> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1232060742 11386 80.91.229.12 (15 Jan 2009 23:05:42 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 15 Jan 2009 23:05:42 +0000 (UTC) Cc: guile-devel@gnu.org To: ludo@gnu.org (Ludovic =?utf-8?Q?Court=C3=A8s?=) Original-X-From: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Fri Jan 16 00:06:53 2009 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.50) id 1LNbHi-0002Hf-GR for guile-devel@m.gmane.org; Fri, 16 Jan 2009 00:06:08 +0100 Original-Received: from localhost ([127.0.0.1]:42014 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LNbGP-0007hY-Ge for guile-devel@m.gmane.org; Thu, 15 Jan 2009 18:04:37 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1LNauw-0007VF-6q for guile-devel@gnu.org; Thu, 15 Jan 2009 17:42:26 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1LNauv-0007Ua-7A for guile-devel@gnu.org; Thu, 15 Jan 2009 17:42:25 -0500 Original-Received: from [199.232.76.173] (port=49744 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LNauv-0007UP-2w for guile-devel@gnu.org; Thu, 15 Jan 2009 17:42:25 -0500 Original-Received: from a-sasl-fastnet.sasl.smtp.pobox.com ([207.106.133.19]:65093 helo=sasl.smtp.pobox.com) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1LNauo-0002qP-8M; Thu, 15 Jan 2009 17:42:18 -0500 Original-Received: from localhost.localdomain (unknown [127.0.0.1]) by a-sasl-fastnet.sasl.smtp.pobox.com (Postfix) with ESMTP id C32639062C; Thu, 15 Jan 2009 17:42:14 -0500 (EST) Original-Received: from unquote (unknown [83.44.191.6]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by a-sasl-fastnet.sasl.smtp.pobox.com (Postfix) with ESMTPSA id 299B89062B; Thu, 15 Jan 2009 17:42:12 -0500 (EST) In-Reply-To: <87fxjmltab.fsf@gnu.org> ("Ludovic =?utf-8?Q?Court=C3=A8s=22'?= =?utf-8?Q?s?= message of "Tue, 13 Jan 2009 23:45:16 +0100") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.0.60 (gnu/linux) X-Pobox-Relay-ID: C16D3AEC-E355-11DD-BE8C-5720C92D7133-02397024!a-sasl-fastnet.pobox.com X-detected-operating-system: by monty-python.gnu.org: Solaris 10 (beta) 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:8030 Archived-At: Hi Ludo, Thanks for the review, it's appreciated. I've incorporated your vm.texi changes and will push shortly. On Tue 13 Jan 2009 23:45, ludo@gnu.org (Ludovic Court=C3=A8s) writes: > s/toplevel/top-level/ Ooh, this one is painful -- I feel like if it changes in the docs it should change in the code too. Do you really think this is the right thing? top-level-ref ? ? > s/runtime/run-time/ So, to me: "run-time" sounds better as an adjective, and as a noun meaning "when code is executed"; and "runtime" sounds better for "the libguile runtime". I've sprinkled appropriate changes. Let me know if it still reads wrong. > s/e.g./e.g.,/ To me, s/e.g./for example/ is an idempotent transformation. So if the clause after "e.g." is short, no comma necessary. Otherwise you need a comma for breath. But maybe it is a snooty style. >> @node Extending the Compiler >> @subsection Extending the Compiler > > I like this section. :-) Hah! Junkie :-) >> recommended papers: Dybvig's HOCS, Ghuloum's compiler paper. Ah yes, this was an oversight. I'll fix. Thanks again! Andy --=20 http://wingolog.org/