[Guile-commits] GNU Guile branch, master, updated. release_1-9-14-175-g09cb3ae

[Andy Wingo]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "GNU Guile".

http://git.savannah.gnu.org/cgit/guile.git/commit/?id=09cb3ae237f6563bc5d3189562cfc841784751f2

The branch, master has been updated
       via  09cb3ae237f6563bc5d3189562cfc841784751f2 (commit)
      from  71d0152e66628dac89d9103c60d91706fb98bba5 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit 09cb3ae237f6563bc5d3189562cfc841784751f2
Author: Noah Lavine <address@hidden>
Date:   Wed Feb 2 09:52:10 2011 -0500

    macro documentation fixup
    
    * doc/ref/api-macros.texi: make the difference between pattern variables
      and lexical variables a bit clearer.

-----------------------------------------------------------------------

Summary of changes:
 doc/ref/api-macros.texi |   13 ++++++++-----
 1 files changed, 8 insertions(+), 5 deletions(-)

diff --git a/doc/ref/api-macros.texi b/doc/ref/api-macros.texi
index 1fbfa24..5f15fb7 100644
--- a/doc/ref/api-macros.texi
+++ b/doc/ref/api-macros.texi
@@ -574,11 +574,14 @@ Here's another solution that doesn't work:
              (if it then else)))))))
 @end example
 
-The reason that this one doesn't work is that there are really two environments
-at work here -- the environment of pattern variables, as bound by
address@hidden, and the environment of lexical variables, as bound by normal
-Scheme. Here we need to introduce a piece of Scheme's environment into that of
-the syntax expander, and we can do so using @code{syntax-case} itself:
+The reason that this one doesn't work is that there are really two
+environments at work here -- the environment of pattern variables, as
+bound by @code{syntax-case}, and the environment of lexical variables,
+as bound by normal Scheme. The outer let form establishes a binding in
+the environment of lexical variables, but the inner let form is inside a
+syntax form, where only pattern variables will be substituted. Here we
+need to introduce a piece of the lexical environment into the pattern
+variable environment, and we can do so using @code{syntax-case} itself:
 
 @example
 ;; works, but is obtuse


hooks/post-receive
-- 
GNU Guile