GClosure docu fixes from Guillaume Cottenceau, #383155.

Mon Jul  9 10:23:53 2007  Tim Janik  <timj@imendio.com>

        * gobject/tmpl/gclosure.sgml: GClosure docu fixes from Guillaume
        Cottenceau, #383155.

svn path=/trunk/; revision=5610

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 686b11e..8e34605 100644 (file)
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,8 @@
+Mon Jul  9 10:23:53 2007  Tim Janik  <timj@imendio.com>
+
+       * gobject/tmpl/gclosure.sgml: GClosure docu fixes from Guillaume
+       Cottenceau, #383155.
+
 Fri Jun 29 2007  Matthias Clasen  <mclasen@redhat.com>
 
        * === Released 2.13.6 ===

diff --git a/docs/reference/gobject/tmpl/gclosure.sgml b/docs/reference/gobject/tmpl/gclosure.sgml
index 3c9d80a..22b4623 100644 (file)
--- a/docs/reference/gobject/tmpl/gclosure.sgml
+++ b/docs/reference/gobject/tmpl/gclosure.sgml
@@ -242,7 +242,7 @@ alive while the caller holds a pointer to it.
 <!-- ##### FUNCTION g_closure_sink ##### -->
 <para>
 Takes over the initial ownership of a closure.
-Each closure is initially created in a<firstterm>floating</firstterm> state, 
+Each closure is initially created in a <firstterm>floating</firstterm> state, 
 which means that the initial reference count is not owned by any caller. 
 g_closure_sink() checks to see if the object is still floating, and if so, 
 unsets the floating state and decreases the reference count. If the closure 
@@ -360,8 +360,10 @@ invoked before finalization notifiers, in an unspecified order.
 
 <!-- ##### FUNCTION g_closure_remove_finalize_notifier ##### -->
 <para>
-Removes a finalization notifier. Notifiers are automatically removed after
-they are run.
+Removes a finalization notifier.
+</para>
+<para>
+Notice that notifiers are automatically removed after they are run.
 </para>
 
 @closure: a #GClosure
@@ -372,8 +374,11 @@ they are run.
 
 <!-- ##### FUNCTION g_closure_remove_invalidate_notifier ##### -->
 <para>
-Removes a invalidation notifier. Notifiers are automatically removed after
-they are run.
+Removes an invalidation notifier.
+</para>
+
+<para>
+Notice that notifiers are automatically removed after they are run.
 </para>
 
 @closure: a #GClosure
@@ -432,11 +437,12 @@ MyClosure *my_closure_new (gpointer data)
 
 <!-- ##### FUNCTION g_closure_set_marshal ##### -->
 <para>
-Sets the marshaller of @closure. The @marshal_data provides a way for a 
-meta marshaller to provide additional information to the marshaller. 
-(See g_closure_set_meta_marshal().) For GObject's C predefined marshallers
-(the g_cclosure_marshal_*() functions), what it provides is a callback 
-function to use instead of @closure->callback.
+Sets the marshaller of @closure. The <literal>marshal_data</literal>
+of @marshal provides a way for a meta marshaller to provide additional
+information to the marshaller. (See g_closure_set_meta_marshal().) For
+GObject's C predefined marshallers (the g_cclosure_marshal_*()
+functions), what it provides is a callback function to use instead of
+@closure->callback.
 </para>
 
 @closure: a #GClosure
@@ -466,8 +472,8 @@ in some fashion. The most common use of this facility is for C callbacks.
 The same marshallers (generated by 
 <link linkend="glib-genmarshal">glib-genmarshal</link>) are used everywhere,
 but the way that we get the callback function differs. In most cases we want 
-to use @closure->callback, but in other cases we want to use use some 
-different technique to retrieve the callbakc function.
+to use @closure->callback, but in other cases we want to use some 
+different technique to retrieve the callback function.
 </para>
 <para>
 For example, class closures for signals (see g_signal_type_cclosure_new()) 
@@ -487,7 +493,7 @@ Set the callback for a source as a #GClosure.
 </para>
 <para>
 If the source is not one of the standard GLib types, the @closure_callback
-and @closure_marshal fields of the GSourceFuncs structure must have been
+and @closure_marshal fields of the #GSourceFuncs structure must have been
 filled in with pointers to appropriate functions.
 </para>