[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Guile-commits] GNU Guile branch, stable-2.0, updated. v2.0.2-126-g7a1e1
From: |
Ludovic Courtès |
Subject: |
[Guile-commits] GNU Guile branch, stable-2.0, updated. v2.0.2-126-g7a1e193 |
Date: |
Tue, 27 Sep 2011 11:46:45 +0000 |
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
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Guile-commits] GNU Guile branch, stable-2.0, updated. v2.0.2-126-g7a1e193,
Ludovic Courtès <=