[gtk+/gi-annotations: 29/31] Update GI annotations in 'Testing'



commit 154cdacbc5a62cd57a4536022a80a547aae5bae6
Author: Pavel Holejsovsky <pholejs src gnome org>
Date:   Sat Jan 15 15:11:32 2011 +0100

    Update GI annotations in 'Testing'

 gtk/gtktestutils.c |   18 ++++++++++--------
 1 files changed, 10 insertions(+), 8 deletions(-)
---
diff --git a/gtk/gtktestutils.c b/gtk/gtktestutils.c
index 76fcc77..b417695 100644
--- a/gtk/gtktestutils.c
+++ b/gtk/gtktestutils.c
@@ -37,9 +37,10 @@
 
 /**
  * gtk_test_init:
- * @argcp: Address of the <parameter>argc</parameter> parameter of the
+ * @argcp: (inout): Address of the <parameter>argc</parameter> parameter of the
  *        main() function. Changed if any arguments were handled.
- * @argvp: Address of the <parameter>argv</parameter> parameter of main().
+ * @argvp: (inout) (array length=argcp): Address of the 
+ *        <parameter>argv</parameter> parameter of main().
  *        Any parameters understood by g_test_init() or gtk_init() are
  *        stripped before return.
  * @Varargs: currently unused
@@ -230,7 +231,7 @@ gtk_test_spin_button_click (GtkSpinButton  *spinner,
  * so this function is genrally only useful in test programs with
  * predetermined locales, see gtk_test_init() for more details.
  *
- * Returns: a GtkLabel widget if any is found.
+ * Returns: (transfer none): a GtkLabel widget if any is found.
  *
  * Since: 2.14
  **/
@@ -333,7 +334,7 @@ widget_geo_cmp (gconstpointer a,
  * widget, relative to another labeling widget. Such as finding a
  * button or text entry widget, given it's corresponding label widget.
  *
- * Returns: a widget of type @widget_type if any is found.
+ * Returns: (transfer none): a widget of type @widget_type if any is found.
  *
  * Since: 2.14
  **/
@@ -375,7 +376,7 @@ gtk_test_find_sibling (GtkWidget *base_widget,
  * gtk_test_widget_click() for possible caveats involving the search of
  * such widgets and synthesizing widget events.
  *
- * Returns: a valid widget if any is found or %NULL.
+ * Returns: (transfer none): a valid widget if any is found or %NULL.
  *
  * Since: 2.14
  **/
@@ -620,7 +621,7 @@ gtk_test_display_button_window (const gchar *window_title,
  * The window will quit any running gtk_main()-loop when destroyed, and it
  * will automatically be destroyed upon test function teardown.
  *
- * Returns: a widget pointer to the newly created GtkWindow.
+ * Returns: (transfer none): a widget pointer to the newly created GtkWindow.
  *
  * Since: 2.14
  **/
@@ -641,8 +642,9 @@ static guint  n_all_registered_types = 0;
 
 /**
  * gtk_test_list_all_types
- * @n_types: location to store number of types
- * @returns: 0-terminated array of type ids
+ * @n_types: (out): location to store number of types
+ * @returns: (array length=n_types zero-terminated=1) (transfer none):
+ *    0-terminated array of type ids
  *
  * Return the type ids that have been registered after
  * calling gtk_test_register_all_types().



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