[Guile-commits] GNU Guile branch, stable-2.0, updated. v2.0.0-13-g27643d7

[Neil Jerram]

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=27643d70976b1d5cf2ecea50cf11130654c01ba4

The branch, stable-2.0 has been updated
       via  27643d70976b1d5cf2ecea50cf11130654c01ba4 (commit)
       via  bba1a2c73d93a1b47712151ea9b0d28953e517e7 (commit)
      from  ed478161f38b3c1bbe2a37a18e0b49d92f399df0 (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 27643d70976b1d5cf2ecea50cf11130654c01ba4
Author: Neil Jerram <address@hidden>
Date:   Fri Feb 18 22:53:57 2011 +0000

    Remove unneeded fixme
    
    * doc/ref/goops.texi (Class Definition Protocol): Removed `*fixme
      Need to insert something here about checking that the value is not
      unbound'.  It's a fine detail, and also I imagine there could be a
      valid application that would choose to allow SCM_GOOPS_UNBOUND
      values to escape through here.

commit bba1a2c73d93a1b47712151ea9b0d28953e517e7
Author: Neil Jerram <address@hidden>
Date:   Fri Feb 18 22:46:02 2011 +0000

    Tidy up remaining bits of the MOP section
    
    * doc/ref/goops.texi (Method Definition): Unindent text about
      define-method invoking add-method!.
      (Method Definition Internals): Add @noindent's.
      (Generic Function Invocation): Add intro text, and tidy up the tree.

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

Summary of changes:
 doc/ref/goops.texi |   65 +++++++++++++++++++++++++++------------------------
 1 files changed, 34 insertions(+), 31 deletions(-)

diff --git a/doc/ref/goops.texi b/doc/ref/goops.texi
index fc114f2..c6d272e 100644
--- a/doc/ref/goops.texi
+++ b/doc/ref/goops.texi
@@ -2387,15 +2387,14 @@ address@hidden
 @item
 @code{compute-getter-method @var{class} @var{gns}} (generic)
 
address@hidden calls @code{compute-getter-method} for each of the class's
-slots (as determined by @code{compute-slots}) that includes a
address@hidden calls @code{compute-getter-method} for each of the
+class's slots (as determined by @code{compute-slots}) that includes a
 @code{#:getter} or @code{#:accessor} slot option.  @var{gns} is the
-element of the @var{class} metaobject's @code{getters-n-setters} slot that
-specifies how the slot in question is referenced and set, as described
-above under @code{compute-get-n-set}.  The applied method should create
-and return a method that is specialized for instances of type @var{class}
-and uses the get closure to retrieve the slot's value.  [ *fixme  Need
-to insert something here about checking that the value is not unbound. ]
+element of the @var{class} metaobject's @code{getters-n-setters} slot
+that specifies how the slot in question is referenced and set, as
+described above under @code{compute-get-n-set}.  The applied method
+should create and return a method that is specialized for instances of
+type @var{class} and uses the get closure to retrieve the slot's value.
 @code{initialize} uses @code{add-method!} to add the returned method to
 the generic function named by the slot definition's @code{#:getter} or
 @code{#:accessor} option.
@@ -2522,7 +2521,9 @@ and/or after calling @code{(next-method)} for the 
standard behaviour.
 @itemize @bullet
 @item
 @code{add-method! @var{target} @var{method}} (generic)
address@hidden itemize
 
address@hidden
 @code{define-method} invokes the @code{add-method!} generic function to
 handle adding the new method to a variety of possible targets.  GOOPS
 includes methods to handle @var{target} as
@@ -2540,12 +2541,12 @@ a primitive generic (@pxref{Extending Primitives})
 
 By defining further methods for @code{add-method!}, you can
 theoretically handle adding methods to further types of target.
address@hidden itemize
+
 
 @node Method Definition Internals
 @subsection Method Definition Internals
 
address@hidden
address@hidden:
 
 @itemize @bullet
 @item
@@ -2575,7 +2576,8 @@ The @var{parameter} and @var{body} parameters should be 
as for
 define-method}).
 @end deffn
 
address@hidden
address@hidden
address@hidden:
 
 @itemize @bullet
 @item
@@ -2601,6 +2603,7 @@ parameter combinations to which this method will be 
applicable.
 function parameters when this method is invoked.
 @end deffn
 
address@hidden
 @code{make-method} is a simple wrapper around @code{make} with metaclass
 @code{<method>}.
 
@@ -2701,48 +2704,48 @@ accessor, passing the setter generic function as the 
value of the
 @node Generic Function Invocation
 @subsection Generic Function Invocation
 
-[ *fixme* Description required here. ]
+There is a detailed and customizable protocol involved in the process of
+invoking a generic function --- i.e., in the process of deciding which
+of the generic function's methods are applicable to the current
+arguments, and which one of those to apply.  Here is a summary diagram
+of the generic functions involved.
 
address@hidden
address@hidden
address@hidden (generic)
 
 @itemize @bullet
 @item
address@hidden
-
address@hidden
address@hidden
address@hidden (generic)
 
 @item
address@hidden
address@hidden (generic)
 
 @item
address@hidden
address@hidden (generic)
 
address@hidden @bullet
 @item
address@hidden
address@hidden (generic)
 @end itemize
 
address@hidden
address@hidden
address@hidden (generic)
 
 @itemize @bullet
 @item
address@hidden
address@hidden itemize
-
address@hidden
address@hidden (generic)
 
address@hidden @bullet
 @item
address@hidden
address@hidden (generic)
 @end itemize
 
address@hidden
-
address@hidden @bullet
 @item
address@hidden
address@hidden
 @end itemize
 
+We do not yet have full documentation for these.  Please refer to the
+code (@file{oop/goops.scm}) for details.
+
 
 @node Redefining a Class
 @section Redefining a Class


hooks/post-receive
-- 
GNU Guile