[gtk+] Add a couple of missing annotations



commit 19cab17c229f86d7318a73619ef0bf90d5eb4531
Author: Johan Dahlin <johan gnome org>
Date:   Sat Sep 18 13:42:15 2010 -0300

    Add a couple of missing annotations

 gtk/gtktoolpalette.c   |   14 +++++++-------
 gtk/gtktoolshell.c     |    2 +-
 gtk/gtktreeselection.c |    8 ++++----
 gtk/gtktreestore.c     |    2 +-
 gtk/gtkuimanager.c     |    2 +-
 5 files changed, 14 insertions(+), 14 deletions(-)
---
diff --git a/gtk/gtktoolpalette.c b/gtk/gtktoolpalette.c
index 169936e..04f4c28 100644
--- a/gtk/gtktoolpalette.c
+++ b/gtk/gtktoolpalette.c
@@ -1560,7 +1560,7 @@ gtk_tool_palette_get_expand (GtkToolPalette   *palette,
  * Gets the item at position (x, y).
  * See gtk_tool_palette_get_drop_group().
  *
- * Returns: the #GtkToolItem at position or %NULL if there is no such item
+ * Returns: (transfer none): the #GtkToolItem at position or %NULL if there is no such item
  *
  * Since: 2.20
  */
@@ -1592,7 +1592,7 @@ gtk_tool_palette_get_drop_item (GtkToolPalette *palette,
  *
  * Gets the group at position (x, y).
  *
- * Returns: the #GtkToolItemGroup at position or %NULL
+ * Returns: (transfer none): the #GtkToolItemGroup at position or %NULL
  *     if there is no such group
  *
  * Since: 2.20
@@ -1643,7 +1643,7 @@ gtk_tool_palette_get_drop_group (GtkToolPalette *palette,
  * Get the dragged item from the selection.
  * This could be a #GtkToolItem or a #GtkToolItemGroup.
  *
- * Returns: the dragged item in selection
+ * Returns: (transfer none): the dragged item in selection
  *
  * Since: 2.20
  */
@@ -1873,7 +1873,7 @@ _gtk_tool_palette_child_set_drag_source (GtkWidget *child,
  *
  * Gets the target entry for a dragged #GtkToolItem.
  *
- * Returns: the #GtkTargetEntry for a dragged item.
+ * Returns: (transfer none): the #GtkTargetEntry for a dragged item.
  *
  * Since: 2.20
  */
@@ -1888,7 +1888,7 @@ gtk_tool_palette_get_drag_target_item (void)
  *
  * Get the target entry for a dragged #GtkToolItemGroup.
  *
- * Returns: the #GtkTargetEntry for a dragged group
+ * Returns: (transfer none): the #GtkTargetEntry for a dragged group
  *
  * Since: 2.20
  */
@@ -1912,7 +1912,7 @@ _gtk_tool_palette_set_expanding_child (GtkToolPalette *palette,
  *
  * Gets the horizontal adjustment of the tool palette.
  *
- * Returns: the horizontal adjustment of @palette
+ * Returns: (transfer none): the horizontal adjustment of @palette
  *
  * Since: 2.20
  */
@@ -1930,7 +1930,7 @@ gtk_tool_palette_get_hadjustment (GtkToolPalette *palette)
  *
  * Gets the vertical adjustment of the tool palette.
  *
- * Returns: the vertical adjustment of @palette
+ * Returns: (transfer none): the vertical adjustment of @palette
  *
  * Since: 2.20
  */
diff --git a/gtk/gtktoolshell.c b/gtk/gtktoolshell.c
index ead74d4..12d019f 100644
--- a/gtk/gtktoolshell.c
+++ b/gtk/gtktoolshell.c
@@ -228,7 +228,7 @@ gtk_tool_shell_get_ellipsize_mode (GtkToolShell *shell)
  * call this function directly, but rely on gtk_tool_item_get_text_size_group()
  * instead.
  *
- * Return value: the current text size group of @shell
+ * Return value: (transfer none): the current text size group of @shell
  *
  * Since: 2.20
  **/
diff --git a/gtk/gtktreeselection.c b/gtk/gtktreeselection.c
index 2df14d0..000f71e 100644
--- a/gtk/gtktreeselection.c
+++ b/gtk/gtktreeselection.c
@@ -266,7 +266,7 @@ gtk_tree_selection_set_select_function (GtkTreeSelection     *selection,
 }
 
 /**
- * gtk_tree_selection_get_select_function:
+ * gtk_tree_selection_get_select_function: (skip)
  * @selection: A #GtkTreeSelection.
  *
  * Returns the current selection function.
@@ -284,7 +284,7 @@ gtk_tree_selection_get_select_function (GtkTreeSelection *selection)
 }
 
 /**
- * gtk_tree_selection_get_user_data:
+ * gtk_tree_selection_get_user_data: (skip)
  * @selection: A #GtkTreeSelection.
  *
  * Returns the user data for the selection function.
@@ -305,7 +305,7 @@ gtk_tree_selection_get_user_data (GtkTreeSelection *selection)
  * 
  * Returns the tree view associated with @selection.
  * 
- * Return value: A #GtkTreeView
+ * Return value: (transfer none): A #GtkTreeView
  **/
 GtkTreeView *
 gtk_tree_selection_get_tree_view (GtkTreeSelection *selection)
@@ -576,7 +576,7 @@ model_changed (gpointer data)
 /**
  * gtk_tree_selection_selected_foreach:
  * @selection: A #GtkTreeSelection.
- * @func: The function to call for each selected node.
+ * @func: (scope call): The function to call for each selected node.
  * @data: user data to pass to the function.
  *
  * Calls a function for each selected node. Note that you cannot modify
diff --git a/gtk/gtktreestore.c b/gtk/gtktreestore.c
index eb5a0cc..c7f0087 100644
--- a/gtk/gtktreestore.c
+++ b/gtk/gtktreestore.c
@@ -292,7 +292,7 @@ gtk_tree_store_new (gint n_columns,
  *
  * Non vararg creation function.  Used primarily by language bindings.
  *
- * Return value: a new #GtkTreeStore
+ * Return value: (transfer full): a new #GtkTreeStore
  **/
 GtkTreeStore *
 gtk_tree_store_newv (gint   n_columns,
diff --git a/gtk/gtkuimanager.c b/gtk/gtkuimanager.c
index aa84968..d1f1f42 100644
--- a/gtk/gtkuimanager.c
+++ b/gtk/gtkuimanager.c
@@ -929,7 +929,7 @@ gtk_ui_manager_get_toplevels (GtkUIManager         *self,
  * Looks up an action by following a path. See gtk_ui_manager_get_widget()
  * for more information about paths.
  * 
- * Return value: the action whose proxy widget is found by following the path, 
+ * Return value: (transfer none): the action whose proxy widget is found by following the path, 
  *     or %NULL if no widget was found.
  *
  * Since: 2.4



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