[gtk+/gtk-2-24] Add a couple of missing annotations

[Martin Pitt <martinpitt src gnome org>]

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

    Add a couple of missing annotations
    
    Backported from master commit 19cab17c.

 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 507af9d..63d2a92 100644
--- a/gtk/gtktoolpalette.c
+++ b/gtk/gtktoolpalette.c
@@ -1541,7 +1541,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
  */
@@ -1569,7 +1569,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
@@ -1619,7 +1619,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
  */
@@ -1849,7 +1849,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
  */
@@ -1864,7 +1864,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
  */
@@ -1888,7 +1888,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
  */
@@ -1906,7 +1906,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 11f886e..337a6f9 100644
--- a/gtk/gtktoolshell.c
+++ b/gtk/gtktoolshell.c
@@ -233,7 +233,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 714b6ea..8587f45 100644
--- a/gtk/gtktreeselection.c
+++ b/gtk/gtktreeselection.c
@@ -275,7 +275,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.
@@ -293,7 +293,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.
@@ -314,7 +314,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)
@@ -585,7 +585,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 c8b4d00..4e5c4e4 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 084f1bf..d004cf1 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