[gtk+] Add some element-type annotations to gtk apis



commit 54077d61e2e6b93714410f154b5b3f1c1247b06a
Author: Matthias Clasen <mclasen redhat com>
Date:   Fri Sep 17 09:26:39 2010 -0400

    Add some element-type annotations to gtk apis

 gtk/gtkbindings.c    |    3 ++-
 gtk/gtkcontainer.c   |    5 +++--
 gtk/gtkradiobutton.c |    4 ++--
 gtk/gtkwidget.c      |   10 ++++++----
 4 files changed, 13 insertions(+), 9 deletions(-)
---
diff --git a/gtk/gtkbindings.c b/gtk/gtkbindings.c
index 313b53e..ff9a49f 100644
--- a/gtk/gtkbindings.c
+++ b/gtk/gtkbindings.c
@@ -769,7 +769,8 @@ gtk_binding_entry_remove (GtkBindingSet	 *binding_set,
  * @keyval:       key value
  * @modifiers:    key modifier
  * @signal_name:  signal name to be bound
- * @binding_args: list of #GtkBindingArg signal arguments
+ * @binding_args: (transfer none) (element-type GtkBindingArg):
+ *     list of #GtkBindingArg signal arguments
  *
  * Override or install a new key binding for @keyval with @modifiers on
  * @binding_set.
diff --git a/gtk/gtkcontainer.c b/gtk/gtkcontainer.c
index c5f8bd8..38a5f9a 100644
--- a/gtk/gtkcontainer.c
+++ b/gtk/gtkcontainer.c
@@ -2480,9 +2480,10 @@ chain_widget_destroyed (GtkWidget *widget,
 }
 
 /**
- * gtk_container_set_focus_chain: 
+ * gtk_container_set_focus_chain:
  * @container: a #GtkContainer
- * @focusable_widgets: the new focus chain
+ * @focusable_widgets: (transfer none) (element-type GtkWidget):
+ *     the new focus chain
  *
  * Sets a focus chain, overriding the one computed automatically by GTK+.
  * 
diff --git a/gtk/gtkradiobutton.c b/gtk/gtkradiobutton.c
index 6881e10..bd11ef7 100644
--- a/gtk/gtkradiobutton.c
+++ b/gtk/gtkradiobutton.c
@@ -267,8 +267,8 @@ gtk_radio_button_get_property (GObject    *object,
 /**
  * gtk_radio_button_set_group:
  * @radio_button: a #GtkRadioButton.
- * @group: an existing radio button group, such as one returned from
- *  gtk_radio_button_get_group().
+ * @group: (transfer none) (element-type GtkRadioButton): an existing radio
+ *     button group, such as one returned from gtk_radio_button_get_group().
  *
  * Sets a #GtkRadioButton's group. It should be noted that this does not change
  * the layout of your interface in any way, so if you are changing the group,
diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index ddc9237..b29e2f5 100644
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -4850,16 +4850,18 @@ gtk_widget_remove_accelerator (GtkWidget      *widget,
 }
 
 /**
- * gtk_widget_list_accel_closures
+ * gtk_widget_list_accel_closures:
  * @widget:  widget to list accelerator closures for
- * @returns: a newly allocated #GList of closures
  *
  * Lists the closures used by @widget for accelerator group connections
  * with gtk_accel_group_connect_by_path() or gtk_accel_group_connect().
  * The closures can be used to monitor accelerator changes on @widget,
- * by connecting to the @GtkAccelGroup::accel-changed signal of the 
- * #GtkAccelGroup of a closure which can be found out with 
+ * by connecting to the @GtkAccelGroup::accel-changed signal of the
+ * #GtkAccelGroup of a closure which can be found out with
  * gtk_accel_group_from_accel_closure().
+ *
+ * Return value: (transfer container) (element-type GClosure):
+ *     a newly allocated #GList of closures
  */
 GList*
 gtk_widget_list_accel_closures (GtkWidget *widget)



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