[Guile-commits] GNU Guile branch, stable-2.0, updated. v2.0.2-126-g7a1e193

[Ludovic Courtès]

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=7a1e193710ff3efa63ddd665a627c682ccec5ce6

The branch, stable-2.0 has been updated
       via  7a1e193710ff3efa63ddd665a627c682ccec5ce6 (commit)
       via  7af1ba2f6c4d4bcd4fbf0214384551f9b8208d4a (commit)
      from  153ca1d2391115f1428837b9465bce89c76691de (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 7a1e193710ff3efa63ddd665a627c682ccec5ce6
Author: Ludovic Courtès <address@hidden>
Date:   Tue Sep 27 13:46:35 2011 +0200

    doc: Update (ice-9 match) reference.
    
    * doc/ref/match.texi (Pattern Matching): Document `***', `..1', and
      `__1'; remove `..k' and `__k'.  Reported by Chris K. Jester-Young.

commit 7af1ba2f6c4d4bcd4fbf0214384551f9b8208d4a
Author: Ludovic Courtès <address@hidden>
Date:   Tue Sep 27 13:41:21 2011 +0200

    doc: Fix typesetting of function definitions in "Accessing Modules from C".
    
    * doc/ref/api-modules.texi (Accessing Modules from C): Use the phrase "C
      Function" instead of "C Procedure".  Enclose multiple-word type names
      in braces.  Reported by Dale P. Smith.

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

Summary of changes:
 doc/ref/api-modules.texi |   62 +++++++++++++++++++++++-----------------------
 doc/ref/match.texi       |    7 +++-
 2 files changed, 36 insertions(+), 33 deletions(-)

diff --git a/doc/ref/api-modules.texi b/doc/ref/api-modules.texi
index 3feced4..33c9819 100644
--- a/doc/ref/api-modules.texi
+++ b/doc/ref/api-modules.texi
@@ -919,28 +919,28 @@ can also work with modules from C, but it is more 
cumbersome.
 
 The following procedures are available.
 
address@hidden {C Procedure} SCM scm_current_module ()
address@hidden {C Function} SCM scm_current_module ()
 Return the module that is the @emph{current module}.
 @end deftypefn
 
address@hidden {C Procedure} SCM scm_set_current_module (SCM @var{module})
address@hidden {C Function} SCM scm_set_current_module (SCM @var{module})
 Set the current module to @var{module} and return the previous current
 module.
 @end deftypefn
 
address@hidden {C Procedure} SCM scm_c_call_with_current_module (SCM 
@var{module}, SCM (address@hidden)(void *), void address@hidden)
address@hidden {C Function} SCM scm_c_call_with_current_module (SCM 
@var{module}, SCM (address@hidden)(void *), void address@hidden)
 Call @var{func} and make @var{module} the current module during the
 call.  The argument @var{data} is passed to @var{func}.  The return
 value of @code{scm_c_call_with_current_module} is the return value of
 @var{func}.
 @end deftypefn
 
address@hidden SCM scm_public_variable (SCM @var{module_name}, SCM @var{name})
address@hidden SCM scm_c_public_variable (const char * @var{module_name}, const 
char * @var{name})
address@hidden {C Function} SCM scm_public_variable (SCM @var{module_name}, SCM 
@var{name})
address@hidden {C Function} SCM scm_c_public_variable ({const char 
address@hidden, {const char address@hidden)
 Find a the variable bound to the symbol @var{name} in the public
 interface of the module named @var{module_name}.
 
- @var{module_name} should be a list of symbols, when represented as a
address@hidden should be a list of symbols, when represented as a
 Scheme object, or a space-separated string, in the @code{const char *}
 case.  See @code{scm_c_define_module} below, for more examples.
 
@@ -948,17 +948,17 @@ Signals an error if no module was found with the given 
name.  If
 @var{name} is not bound in the module, just returns @code{#f}.
 @end deftypefn
 
address@hidden SCM scm_private_variable (SCM @var{module_name}, SCM @var{name})
address@hidden SCM scm_c_private_variable (const char * @var{module_name}, 
const char * @var{name})
address@hidden {C Function} SCM scm_private_variable (SCM @var{module_name}, 
SCM @var{name})
address@hidden {C Function} SCM scm_c_private_variable ({const char 
address@hidden, {const char address@hidden)
 Like @code{scm_public_variable}, but looks in the internals of the
 module named @var{module_name} instead of the public interface.
 Logically, these procedures should only be called on modules you write.
 @end deftypefn
 
address@hidden SCM scm_public_lookup (SCM @var{module_name}, SCM @var{name})
address@hidden SCM scm_c_public_lookup (const char * @var{module_name}, const 
char * @var{name})
address@hidden SCM scm_private_lookup (SCM @var{module_name}, SCM @var{name})
address@hidden SCM scm_c_private_lookup (const char * @var{module_name}, const 
char * @var{name})
address@hidden {C Function} SCM scm_public_lookup (SCM @var{module_name}, SCM 
@var{name})
address@hidden {C Function} SCM scm_c_public_lookup ({const char 
address@hidden, {const char address@hidden)
address@hidden {C Function} SCM scm_private_lookup (SCM @var{module_name}, SCM 
@var{name})
address@hidden {C Function} SCM scm_c_private_lookup ({const char 
address@hidden, {const char address@hidden)
 Like @code{scm_public_variable} or @code{scm_private_variable}, but if
 the @var{name} is not bound in the module, signals an error.  Returns a
 variable, always.
@@ -977,10 +977,10 @@ SCM my_eval_string (SCM str)
 @end example
 @end deftypefn
 
address@hidden SCM scm_public_ref (SCM @var{module_name}, SCM @var{name})
address@hidden SCM scm_c_public_ref (const char * @var{module_name}, const char 
* @var{name})
address@hidden SCM scm_private_ref (SCM @var{module_name}, SCM @var{name})
address@hidden SCM scm_c_private_ref (const char * @var{module_name}, const 
char * @var{name})
address@hidden {C Function} SCM scm_public_ref (SCM @var{module_name}, SCM 
@var{name})
address@hidden {C Function} SCM scm_c_public_ref ({const char address@hidden, 
{const char address@hidden)
address@hidden {C Function} SCM scm_private_ref (SCM @var{module_name}, SCM 
@var{name})
address@hidden {C Function} SCM scm_c_private_ref ({const char address@hidden, 
{const char address@hidden)
 Like @code{scm_public_lookup} or @code{scm_private_lookup}, but
 additionally dereferences the variable.  If the variable object is
 unbound, signals an error.  Returns the value bound to @var{name} in
@@ -991,50 +991,50 @@ In addition, there are a number of other lookup-related 
procedures.  We
 suggest that you use the @code{scm_public_} and @code{scm_private_}
 family of procedures instead, if possible.
 
address@hidden {C Procedure} SCM scm_c_lookup (const char address@hidden)
address@hidden {C Function} SCM scm_c_lookup ({const char address@hidden)
 Return the variable bound to the symbol indicated by @var{name} in the
 current module.  If there is no such binding or the symbol is not
 bound to a variable, signal an error.
 @end deftypefn
 
address@hidden {C Procedure} SCM scm_lookup (SCM @var{name})
address@hidden {C Function} SCM scm_lookup (SCM @var{name})
 Like @code{scm_c_lookup}, but the symbol is specified directly.
 @end deftypefn
 
address@hidden {C Procedure} SCM scm_c_module_lookup (SCM @var{module}, const 
char address@hidden)
address@hidden {C Procedure} SCM scm_module_lookup (SCM @var{module}, SCM 
@var{name})
address@hidden {C Function} SCM scm_c_module_lookup (SCM @var{module}, {const 
char address@hidden)
address@hidden {C Function} SCM scm_module_lookup (SCM @var{module}, SCM 
@var{name})
 Like @code{scm_c_lookup} and @code{scm_lookup}, but the specified
 module is used instead of the current one.
 @end deftypefn
 
address@hidden {C Procedure} SCM scm_module_variable (SCM @var{module}, SCM 
@var{name})
address@hidden {C Function} SCM scm_module_variable (SCM @var{module}, SCM 
@var{name})
 Like @code{scm_module_lookup}, but if the binding does not exist, just
 returns @code{#f} instead of raising an error.
 @end deftypefn
 
 To define a value, use @code{scm_define}:
 
address@hidden {C Procedure} SCM scm_c_define (const char address@hidden, SCM 
@var{val})
address@hidden {C Function} SCM scm_c_define ({const char address@hidden, SCM 
@var{val})
 Bind the symbol indicated by @var{name} to a variable in the current
 module and set that variable to @var{val}.  When @var{name} is already
 bound to a variable, use that.  Else create a new variable.
 @end deftypefn
 
address@hidden {C Procedure} SCM scm_define (SCM @var{name}, SCM @var{val})
address@hidden {C Function} SCM scm_define (SCM @var{name}, SCM @var{val})
 Like @code{scm_c_define}, but the symbol is specified directly.
 @end deftypefn
 
address@hidden {C Procedure} SCM scm_c_module_define (SCM @var{module}, const 
char address@hidden, SCM @var{val})
address@hidden {C Procedure} SCM scm_module_define (SCM @var{module}, SCM 
@var{name}, SCM @var{val})
address@hidden {C Function} SCM scm_c_module_define (SCM @var{module}, {const 
char address@hidden, SCM @var{val})
address@hidden {C Function} SCM scm_module_define (SCM @var{module}, SCM 
@var{name}, SCM @var{val})
 Like @code{scm_c_define} and @code{scm_define}, but the specified
 module is used instead of the current one.
 @end deftypefn
 
address@hidden {C Procedure} SCM scm_module_reverse_lookup (SCM @var{module}, 
SCM @var{variable})
address@hidden {C Function} SCM scm_module_reverse_lookup (SCM @var{module}, 
SCM @var{variable})
 Find the symbol that is bound to @var{variable} in @var{module}.  When no such 
binding is found, return @var{#f}.
 @end deftypefn
 
address@hidden {C Procedure} SCM scm_c_define_module (const char 
address@hidden, void (address@hidden)(void *), void address@hidden)
address@hidden {C Function} SCM scm_c_define_module ({const char 
address@hidden, void (address@hidden)(void *), void address@hidden)
 Define a new module named @var{name} and make it current while
 @var{init} is called, passing it @var{data}.  Return the module.
 
@@ -1046,25 +1046,25 @@ When there already exists a module named @var{name}, it 
is used
 unchanged, otherwise, an empty module is created.
 @end deftypefn
 
address@hidden {C Procedure} SCM scm_c_resolve_module (const char 
address@hidden)
address@hidden {C Function} SCM scm_c_resolve_module ({const char 
address@hidden)
 Find the module name @var{name} and return it.  When it has not
 already been defined, try to auto-load it.  When it can't be found
 that way either, create an empty module.  The name is interpreted as
 for @code{scm_c_define_module}.
 @end deftypefn
 
address@hidden {C Procedure} SCM scm_resolve_module (SCM @var{name})
address@hidden {C Function} SCM scm_resolve_module (SCM @var{name})
 Like @code{scm_c_resolve_module}, but the name is given as a real list
 of symbols.
 @end deftypefn
 
address@hidden {C Procedure} SCM scm_c_use_module (const char address@hidden)
address@hidden {C Function} SCM scm_c_use_module ({const char address@hidden)
 Add the module named @var{name} to the uses list of the current
 module, as with @code{(use-modules @var{name})}.  The name is
 interpreted as for @code{scm_c_define_module}.
 @end deftypefn
 
address@hidden {C Procedure} SCM scm_c_export (const char address@hidden, ...)
address@hidden {C Function} SCM scm_c_export ({const char address@hidden, ...)
 Add the bindings designated by @var{name}, ... to the public interface
 of the current module.  The list of names is terminated by
 @code{NULL}.
diff --git a/doc/ref/match.texi b/doc/ref/match.texi
index b6acf14..05e6642 100644
--- a/doc/ref/match.texi
+++ b/doc/ref/match.texi
@@ -122,11 +122,14 @@ pat ::= identifier                      anything, and 
binds identifier
       | (set! identifier)               anything, and binds setter
       | (get! identifier)               anything, and binds getter
       | `qp                             a quasi-pattern
+      | (identifier *** pat)            matches pat in a tree and binds
+                                        identifier to the path leading
+                                        to the object that matches pat
 
 ooo ::= ...                             zero or more
       | ___                             zero or more
-      | ..k                             k or more
-      | __k                             k or more
+      | ..1                             1 or more
+      | __1                             1 or more
 
         quasi-patterns:                 matches:
 


hooks/post-receive
-- 
GNU Guile