[glib] Add missing GClosure annotations



commit af210cd0eed755eb461da0ccce38fe99545ffd08
Author: Pavel Holejsovsky <pholejs src gnome org>
Date:   Fri Aug 19 10:34:02 2011 +0200

    Add missing GClosure annotations

 gobject/gclosure.c |    7 ++++---
 gobject/gclosure.h |   19 +++++++++++--------
 2 files changed, 15 insertions(+), 11 deletions(-)
---
diff --git a/gobject/gclosure.c b/gobject/gclosure.c
index 9cce0b8..134d8b0 100644
--- a/gobject/gclosure.c
+++ b/gobject/gclosure.c
@@ -729,13 +729,14 @@ g_closure_remove_finalize_notifier (GClosure      *closure,
 /**
  * g_closure_invoke:
  * @closure: a #GClosure
- * @return_value: a #GValue to store the return value. May be %NULL if the
- *                callback of @closure doesn't return a value.
+ * @return_value: (allow-none): a #GValue to store the return
+ *                value. May be %NULL if the callback of @closure
+ *                doesn't return a value.
  * @n_param_values: the length of the @param_values array
  * @param_values: (array length=n_param_values): an array of
  *                #GValue<!-- -->s holding the arguments on which to
  *                invoke the callback of @closure
- * @invocation_hint: a context-dependent invocation hint
+ * @invocation_hint: (allow-none): a context-dependent invocation hint
  *
  * Invokes the closure, i.e. executes the callback represented by the @closure.
  */
diff --git a/gobject/gclosure.h b/gobject/gclosure.h
index 1b47c65..bb024a4 100644
--- a/gobject/gclosure.h
+++ b/gobject/gclosure.h
@@ -99,15 +99,18 @@ typedef void  (*GClosureNotify)		(gpointer	 data,
 /**
  * GClosureMarshal:
  * @closure: the #GClosure to which the marshaller belongs
- * @return_value: a #GValue to store the return value. May be %NULL if the
- *  callback of @closure doesn't return a value.
+ * @return_value: (allow-none): a #GValue to store the return
+ *  value. May be %NULL if the callback of @closure doesn't return a
+ *  value.
  * @n_param_values: the length of the @param_values array
- * @param_values: an array of #GValue<!-- -->s holding the arguments on
- *  which to invoke the callback of @closure
- * @invocation_hint: the invocation hint given as the last argument
- *  to g_closure_invoke()
- * @marshal_data: additional data specified when registering the marshaller,
- *  see g_closure_set_marshal() and g_closure_set_meta_marshal()
+ * @param_values: (array length=n_param_values): an array of
+ *  #GValue<!-- -->s holding the arguments on which to invoke the
+ *  callback of @closure
+ * @invocation_hint: (allow-none): the invocation hint given as the
+ *  last argument to g_closure_invoke()
+ * @marshal_data: (allow-none): additional data specified when
+ *  registering the marshaller, see g_closure_set_marshal() and
+ *  g_closure_set_meta_marshal()
  * 
  * The type used for marshaller functions.
  */



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]