[gtk+] gtk: add missing ownership annotations ported from Vala

[Evan Nemerson <evann src gnome org>]

commit a77765f17229ee1d0ab93134b426bb2838179bac
Author: Evan Nemerson <evan nemerson com>
Date:   Mon May 26 09:42:23 2014 -0700

    gtk: add missing ownership annotations ported from Vala
    
    https://bugzilla.gnome.org/show_bug.cgi?id=730745

 gtk/gtkfilechooser.c |    2 +-
 gtk/gtkicontheme.c   |    9 +++++----
 gtk/gtkmain.c        |    4 ++--
 gtk/gtkpagesetup.c   |    2 +-
 gtk/gtktextiter.c    |   11 ++++++-----
 5 files changed, 15 insertions(+), 13 deletions(-)
---
diff --git a/gtk/gtkfilechooser.c b/gtk/gtkfilechooser.c
index ddfd5c9..049712c 100644
--- a/gtk/gtkfilechooser.c
+++ b/gtk/gtkfilechooser.c
@@ -1860,7 +1860,7 @@ gtk_file_chooser_get_extra_widget (GtkFileChooser *chooser)
 /**
  * gtk_file_chooser_add_filter:
  * @chooser: a #GtkFileChooser
- * @filter: a #GtkFileFilter
+ * @filter: (transfer full): a #GtkFileFilter
  * 
  * Adds @filter to the list of filters that the user can select between.
  * When a filter is selected, only files that are passed by that
diff --git a/gtk/gtkicontheme.c b/gtk/gtkicontheme.c
index 91143fd..9965dc0 100644
--- a/gtk/gtkicontheme.c
+++ b/gtk/gtkicontheme.c
@@ -2414,9 +2414,10 @@ add_size (gpointer  key,
  * that the icon is available in a scalable format. The array 
  * is zero-terminated.
  * 
- * Returns: (array zero-terminated=1): An newly allocated array
- * describing the sizes at which the icon is available. The array
- * should be freed with g_free() when it is no longer needed.
+ * Returns: (array zero-terminated=1) (transfer full): An newly
+ * allocated array describing the sizes at which the icon is
+ * available. The array should be freed with g_free() when it is no
+ * longer needed.
  *
  * Since: 2.6
  **/
@@ -3521,7 +3522,7 @@ icon_info_new_builtin (BuiltinIcon *icon)
  * 
  * Make a copy of a #GtkIconInfo.
  * 
- * Returns: the new GtkIconInfo
+ * Returns: (transfer full): the new GtkIconInfo
  *
  * Since: 2.4
  *
diff --git a/gtk/gtkmain.c b/gtk/gtkmain.c
index c1a6076..7869235 100644
--- a/gtk/gtkmain.c
+++ b/gtk/gtkmain.c
@@ -808,8 +808,8 @@ gtk_set_debug_flags (guint flags)
  * with g_option_context_add_group(), if you are using
  * g_option_context_parse() to parse your commandline arguments.
  *
- * Returns: a #GOptionGroup for the commandline arguments recognized
- *     by GTK+
+ * Returns: (transfer full): a #GOptionGroup for the commandline
+ *     arguments recognized by GTK+
  *
  * Since: 2.6
  */
diff --git a/gtk/gtkpagesetup.c b/gtk/gtkpagesetup.c
index 53d0f7b..b0c9ef4 100644
--- a/gtk/gtkpagesetup.c
+++ b/gtk/gtkpagesetup.c
@@ -208,7 +208,7 @@ gtk_page_setup_set_orientation (GtkPageSetup       *setup,
  * 
  * Gets the paper size of the #GtkPageSetup.
  * 
- * Returns: the paper size
+ * Returns: (transfer none): the paper size
  *
  * Since: 2.10
  */
diff --git a/gtk/gtktextiter.c b/gtk/gtktextiter.c
index bb7fdb0..55e33c0 100644
--- a/gtk/gtktextiter.c
+++ b/gtk/gtktextiter.c
@@ -899,7 +899,7 @@ gtk_text_iter_get_char (const GtkTextIter *iter)
  * text as well, so it is not a reliable indicator that a pixbuf or
  * widget is in the buffer.
  *
- * Returns: slice of text from the buffer
+ * Returns: (transfer full): slice of text from the buffer
  **/
 gchar*
 gtk_text_iter_get_slice       (const GtkTextIter *start,
@@ -925,7 +925,7 @@ gtk_text_iter_get_slice       (const GtkTextIter *start,
  * byte offsets in the buffer. If you want offsets to correspond, see
  * gtk_text_iter_get_slice ().
  *
- * Returns: array of characters from the buffer
+ * Returns: (transfer full): array of characters from the buffer
  **/
 gchar*
 gtk_text_iter_get_text       (const GtkTextIter *start,
@@ -949,7 +949,7 @@ gtk_text_iter_get_text       (const GtkTextIter *start,
  * Invisible text is usually invisible because a #GtkTextTag with the
  * “invisible” attribute turned on has been applied to it.
  *
- * Returns: slice of text from the buffer
+ * Returns: (transfer full): slice of text from the buffer
  **/
 gchar*
 gtk_text_iter_get_visible_slice (const GtkTextIter  *start,
@@ -973,7 +973,8 @@ gtk_text_iter_get_visible_slice (const GtkTextIter  *start,
  * Invisible text is usually invisible because a #GtkTextTag with the
  * “invisible” attribute turned on has been applied to it.
  *
- * Returns: string containing visible text in the range
+ * Returns: (transfer full): string containing visible text in the
+ * range
  **/
 gchar*
 gtk_text_iter_get_visible_text (const GtkTextIter  *start,
@@ -1465,7 +1466,7 @@ gtk_text_iter_can_insert (const GtkTextIter *iter,
  * language apply to @iter, the return value is identical to that of
  * gtk_get_default_language ().
  *
- * Returns: language in effect at @iter
+ * Returns: (transfer full): language in effect at @iter
  **/
 PangoLanguage *
 gtk_text_iter_get_language (const GtkTextIter *iter)