[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [Guile-commits] GNU Guile branch, master, updated. release_1-9-10-13

From: Ludovic Courtès
Subject: Re: [Guile-commits] GNU Guile branch, master, updated. release_1-9-10-135-g7119448
Date: Sat, 22 May 2010 22:50:04 +0200
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/23.2 (gnu/linux)

Hi Julian,

Thanks for the nice R6RS doc!  Looks to me like it’s both a good
tutorial and a convenient reference.

Some nitpicking:

"Julian Graham" <address@hidden> writes:

> +have the option to create modules using the portable ``library'' form

Should be @code{library}.

> +libraries created in this format by other programmers.  Guile's R6RS 
> +libraries implementation takes advantage of the flexibility built 

“library implementation” rather?

> +into the module system by expanding the R6RS library form into a 
> +corresponding Guile ``define-module'' form that specifies equivalent


> +Central to the mechanics of R6RS libraries is the concept of import
> +and export ``levels,'' which control the visibility of bindings at


> +Guile's libraries implementation uses a technique called ``implicit 

@dfn{implicit phasing}

> +phasing'' (see @cite{Implicit Phasing for R6RS Libraries} by 
> +Abdulaziz Ghuloum and R. Kent Dybvig), which allows the expander and

This is a non-free document (ACM...) so I think we should not refer to
it.  Perhaps instead this could read along the lines of:

  ... a technique called @dfn{implicit phasing} (first described by
  Abdulaziz Ghuloum and R. Kent Dybvig) ...


> +Each @var{import-spec} must be either an ``import set'' (see below) 

@dfn{import set}

> address@hidden syntax import import-spec ...

I’d rather use address@hidden {Scheme Syntax}’ or address@hidden {Syntax}’ but 
forms are also found in the manual.


reply via email to

[Prev in Thread] Current Thread [Next in Thread]