From 3264d8d1598916a59775ed07969ff0d20b8790e0 Mon Sep 17 00:00:00 2001
From: Pavel Holejsovsky <pholejs@src.gnome.org>
Date: Sun, 19 Dec 2010 22:15:42 +0100
Subject: [PATCH 1/1] Add GI annotations to GClosure and friends.

---
 gobject/gclosure.c | 29 +++++++++++++++--------------
 gobject/gobject.c  |  2 +-
 2 files changed, 16 insertions(+), 15 deletions(-)

diff --git a/gobject/gclosure.c b/gobject/gclosure.c
index 8a6b0f7..a415182 100644
--- a/gobject/gclosure.c
+++ b/gobject/gclosure.c
@@ -186,7 +186,7 @@ enum {
  * }
  * ]|
  *
- * Returns: a newly allocated #GClosure
+ * Returns: (transfer full): a newly allocated #GClosure
  */
 GClosure*
 g_closure_new_simple (guint           sizeof_closure,
@@ -293,7 +293,7 @@ closure_invoke_notifiers (GClosure *closure,
 }
 
 /**
- * g_closure_set_meta_marshal:
+ * g_closure_set_meta_marshal: (skip)
  * @closure: a #GClosure
  * @marshal_data: context-dependent data to pass to @meta_marshal
  * @meta_marshal: a #GClosureMarshal function
@@ -343,7 +343,7 @@ g_closure_set_meta_marshal (GClosure       *closure,
 }
 
 /**
- * g_closure_add_marshal_guards:
+ * g_closure_add_marshal_guards: (skip)
  * @closure: a #GClosure
  * @pre_marshal_data: data to pass to @pre_marshal_notify
  * @pre_marshal_notify: a function to call before the closure callback
@@ -401,7 +401,7 @@ g_closure_add_marshal_guards (GClosure      *closure,
 }
 
 /**
- * g_closure_add_finalize_notifier:
+ * g_closure_add_finalize_notifier: (skip)
  * @closure: a #GClosure
  * @notify_data: data to pass to @notify_func
  * @notify_func: the callback function to register
@@ -437,7 +437,7 @@ g_closure_add_finalize_notifier (GClosure      *closure,
 }
 
 /**
- * g_closure_add_invalidate_notifier:
+ * g_closure_add_invalidate_notifier: (skip)
  * @closure: a #GClosure
  * @notify_data: data to pass to @notify_func
  * @notify_func: the callback function to register
@@ -517,7 +517,7 @@ closure_try_remove_fnotify (GClosure       *closure,
  * Increments the reference count on a closure to force it staying
  * alive while the caller holds a pointer to it.
  *
- * Returns: The @closure passed in, for convenience
+ * Returns: (transfer none): The @closure passed in, for convenience
  */
 GClosure*
 g_closure_ref (GClosure *closure)
@@ -665,7 +665,7 @@ g_closure_sink (GClosure *closure)
 }
 
 /**
- * g_closure_remove_invalidate_notifier:
+ * g_closure_remove_invalidate_notifier: (skip)
  * @closure: a #GClosure
  * @notify_data: data which was passed to g_closure_add_invalidate_notifier()
  *               when registering @notify_func
@@ -693,7 +693,7 @@ g_closure_remove_invalidate_notifier (GClosure      *closure,
 }
 
 /**
- * g_closure_remove_finalize_notifier:
+ * g_closure_remove_finalize_notifier: (skip)
  * @closure: a #GClosure
  * @notify_data: data which was passed to g_closure_add_finalize_notifier()
  *  when registering @notify_func
@@ -726,8 +726,9 @@ g_closure_remove_finalize_notifier (GClosure      *closure,
  * @return_value: 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
+ * @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
  *
  * Invokes the closure, i.e. executes the callback represented by the @closure.
@@ -776,7 +777,7 @@ g_closure_invoke (GClosure       *closure,
 }
 
 /**
- * g_closure_set_marshal:
+ * g_closure_set_marshal: (skip)
  * @closure: a #GClosure
  * @marshal: a #GClosureMarshal function
  *
@@ -802,7 +803,7 @@ g_closure_set_marshal (GClosure       *closure,
 }
 
 /**
- * g_cclosure_new:
+ * g_cclosure_new: (skip)
  * @callback_func: the function to invoke
  * @user_data: user data to pass to @callback_func
  * @destroy_data: destroy notify to be called when @user_data is no longer used
@@ -830,7 +831,7 @@ g_cclosure_new (GCallback      callback_func,
 }
 
 /**
- * g_cclosure_new_swap:
+ * g_cclosure_new_swap: (skip)
  * @callback_func: the function to invoke
  * @user_data: user data to pass to @callback_func
  * @destroy_data: destroy notify to be called when @user_data is no longer used
@@ -838,7 +839,7 @@ g_cclosure_new (GCallback      callback_func,
  * Creates a new closure which invokes @callback_func with @user_data as
  * the first parameter.
  *
- * Returns: a new #GCClosure
+ * Returns: (transfer full): a new #GCClosure
  */
 GClosure*
 g_cclosure_new_swap (GCallback      callback_func,
diff --git a/gobject/gobject.c b/gobject/gobject.c
index 1bf32b4..5587df9 100644
--- a/gobject/gobject.c
+++ b/gobject/gobject.c
@@ -3444,7 +3444,7 @@ g_cclosure_new_object (GCallback callback_func,
 }
 
 /**
- * g_cclosure_new_object_swap:
+ * g_cclosure_new_object_swap: (skip)
  * @callback_func: the function to invoke
  * @object: a #GObject pointer to pass to @callback_func
  *
-- 
2.7.4