[gtk/docs-fixes: 5/5] Add missing ownership transfer annotations

[Emmanuele Bassi <ebassi src gnome org>]

commit 303e20226c6a82b3ed8097de42d87e61b529e2ba
Author: Emmanuele Bassi <ebassi gnome org>
Date:   Wed Feb 26 10:29:59 2020 +0000

    Add missing ownership transfer annotations

 gtk/gtkdropcontrollermotion.c |  3 ++-
 gtk/gtkicontheme.c            | 11 ++++++-----
 gtk/gtktreednd.c              |  4 ++--
 3 files changed, 10 insertions(+), 8 deletions(-)
---
diff --git a/gtk/gtkdropcontrollermotion.c b/gtk/gtkdropcontrollermotion.c
index 51199b729a..155675f5a2 100644
--- a/gtk/gtkdropcontrollermotion.c
+++ b/gtk/gtkdropcontrollermotion.c
@@ -367,7 +367,8 @@ gtk_drop_controller_motion_contains_pointer (GtkDropControllerMotion *self)
  *
  * Returns the value of the GtkDropControllerMotion:drop property.
  *
- * Returns: The #GdkDrop currently happening within @self or %NULL if none
+ * Returns: (transfer none) (nullable): The #GdkDrop currently happening
+ *   within @self or %NULL if none
  */
 GdkDrop *
 gtk_drop_controller_motion_get_drop (GtkDropControllerMotion *self)
diff --git a/gtk/gtkicontheme.c b/gtk/gtkicontheme.c
index 323feb7bb4..5ff96a4070 100644
--- a/gtk/gtkicontheme.c
+++ b/gtk/gtkicontheme.c
@@ -1459,9 +1459,9 @@ gtk_icon_theme_set_search_path (GtkIconTheme       *self,
  *
  * Gets the current search path. See gtk_icon_theme_set_search_path().
  * 
- * Returns: (element-type filename):
- *     a list of icon theme path directories or %NULL.
- *     The returned value should be freed with g_strfreev().
+ * Returns: (transfer full) (array zero-terminated=1) (element-type filename) (nullable):
+ *   a list of icon theme path directories or %NULL.
+ *   The returned value should be freed with g_strfreev().
  */
 char **
 gtk_icon_theme_get_search_path (GtkIconTheme  *self)
@@ -1552,8 +1552,9 @@ gtk_icon_theme_set_resource_path (GtkIconTheme       *self,
  *
  * See gtk_icon_theme_set_resource_path().
  * 
- * Returns: A list of resource paths or %NULL.
- *     The returned value should be freed with g_strfreev().
+ * Returns: (transfer full) (array zero-terminated=1) (element-type utf8) (nullable):
+ *   A list of resource paths or %NULL.
+ *   The returned value should be freed with g_strfreev().
  */
 char **
 gtk_icon_theme_get_resource_path (GtkIconTheme  *self)
diff --git a/gtk/gtktreednd.c b/gtk/gtktreednd.c
index 71909a49c3..7d26c188f0 100644
--- a/gtk/gtktreednd.c
+++ b/gtk/gtktreednd.c
@@ -260,8 +260,8 @@ G_DEFINE_BOXED_TYPE (GtkTreeRowData, gtk_tree_row_data,
  * 
  * Creates a content provider for dragging @path from @tree_model.
  * 
- * Returns: a new #GdkContentProvider
- **/
+ * Returns: (transfer full): a new #GdkContentProvider
+ */
 GdkContentProvider *
 gtk_tree_create_row_drag_content (GtkTreeModel *tree_model,
                                  GtkTreePath  *path)