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: New section "Invoking Guile" for chapter "Programming in Scheme" Date: Sun, 24 Apr 2011 23:00:16 +0200 Message-ID: References: <8CDD0063C9BEB29-FC8-5987@web-mmc-d08.sysops.aol.com> <8CDD0D662A18273-1820-10289@webmail-m029.sysops.aol.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: dough.gmane.org 1303678834 24618 80.91.229.12 (24 Apr 2011 21:00:34 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sun, 24 Apr 2011 21:00:34 +0000 (UTC) Cc: guile-devel@gnu.org To: Mark Harig Original-X-From: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Sun Apr 24 23:00:30 2011 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 1QE6Pt-0002Vv-IW for guile-devel@m.gmane.org; Sun, 24 Apr 2011 23:00:29 +0200 Original-Received: from localhost ([::1]:51746 helo=lists2.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QE6Pt-00075B-6v for guile-devel@m.gmane.org; Sun, 24 Apr 2011 17:00:29 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]:35936) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QE6Pp-000756-Vh for guile-devel@gnu.org; Sun, 24 Apr 2011 17:00:26 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1QE6Po-0001WF-Qb for guile-devel@gnu.org; Sun, 24 Apr 2011 17:00:25 -0400 Original-Received: from a-pb-sasl-sd.pobox.com ([64.74.157.62]:39536 helo=sasl.smtp.pobox.com) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QE6Po-0001W4-Iz for guile-devel@gnu.org; Sun, 24 Apr 2011 17:00:24 -0400 Original-Received: from sasl.smtp.pobox.com (unknown [127.0.0.1]) by a-pb-sasl-sd.pobox.com (Postfix) with ESMTP id 32B5F4833; Sun, 24 Apr 2011 17:02:26 -0400 (EDT) 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=OeDqWUsbIfXN 2fl6UW3enPLT0Fg=; b=H5/aHJjbog15xcC8iiGVTMfewYyo0eCORsd79LQeVN9/ kBCwbZoJuNQeZtNpSvfsVwzKnmArvSst3GJU2GCBWUGYzWBqfHt252S8OXt4w2I1 UKb5CNvIk6lJ52ke+qIMhXrKHz7IUS3ibYFP/QcOV5J6VwPDon3rIyNXcwgmwqc= 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=OC+wPy w4+AiFFO3Qcu5iL6G/8feIYtwTeT7FUCAkfCUe/EW6Z08cxh5OlmBAtk42xpgb/G crr6b05n2ejIOzgagt3iuvaY1JOcMT4y0JfhD7vaa6mFoMCNs639C2WH4VINkznN 4tvh8FeHAWEFengad4f7w3SF64VUhRXtlF8FI= 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 1EBAE4824; Sun, 24 Apr 2011 17:02:24 -0400 (EDT) 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 536664823; Sun, 24 Apr 2011 17:02:22 -0400 (EDT) In-Reply-To: <8CDD0D662A18273-1820-10289@webmail-m029.sysops.aol.com> (Mark Harig's message of "Sun, 24 Apr 2011 16:36:12 -0400") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.2 (gnu/linux) X-Pobox-Relay-ID: 271D28FA-6EB6-11E0-ACF8-E8AB60295C12-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.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:12331 Archived-At: Hi Mark, Thanks for the revisions. On Sun 24 Apr 2011 22:36, Mark Harig writes: > On Sun, Apr 24, 2011 at 04:33:44PM +0200, Andy Wingo wrote: >> your patches should be "atomic" > > "3. No patch introduces a regression: after applying any > initial part of the series, the resulting project still > compiles and works, and has no bugs that it didn=E2=80=99t have > before." Right, at the end of applying all of your patches, I'm sure that's the case; however the first patch adds an @include without adding the appropriate file, so applying just the first patch without the following two would yield a project that doesn't compile. I just meant that you need to squish the first two or three of them together. I can do that when I apply them, though. By @itemx I just meant to do instead of: > +@item -s @var{script} @var{arg...} you would @item @var{script} @var{arg...} @itemx -s @var{script} @var{arg} The other option would be @item [-s] @var{script} @var{arg} which is not as clear IMO. I feel that it's important to have a good example up there, and making it clear that it's OK to just invoke Guile as "guile foo.scm" is important. But your description is good too. > +For compatibility with some versions of Guile 1.4, you can also use the > +form @code{(symbol ...)} (that is, a list of only symbols that doesn't > +start with @code{@@}), which is equivalent to @code{(@@ (symbol ...) > +main)}, or @code{(symbol ...) symbol} (that is, a list of only symbols > +followed by a symbol), which is equivalent to @code{(@@ (symbol ...) > +symbol)}. We recommend to use the equivalent forms directly since they > +correspond to the @code{(@@ ...)} read syntax that can be used in > +normal code. See @ref{Using Guile Modules} and @ref{Scripting > +Examples}. Again, probably worth eliding the deprecated 1.4 stuff... > +@item --auto-compile > +Compile source files automatically (default behavior). > + > +@vnew{2.0} > + > +@item --no-auto-compile > +Disable automatic source file compilation. > + > +@vnew{2.0} Need --fresh-auto-compile here too > +@item GUILE_AUTO_COMPILE > +@vindex GUILE_AUTO_COMPILE Need to note GUILE_AUTO_COMPILE=3Dfresh, and @ref to Compilation Best regards, Andy --=20 http://wingolog.org/