[gtk+/gi-annotations: 10/28] Update GI annotations in 'Multiline Text Editor'

[Pavel Holejsovsky <pholejs src gnome org>]

commit 430369dca801e2f5f17408af239c24bb2f3e04ae
Author: Pavel Holejsovsky <pholejs src gnome org>
Date:   Sat Jan 8 19:39:38 2011 +0100

    Update GI annotations in 'Multiline Text Editor'
    
    'Multiline Text Editor' group from GTK+ manual are: GtkTextIter,
    GtkTextMark, GtkTextBuffer, GtkTextTag, GtkTextTagTable, GtkTextView.

 gtk/gtktextbuffer.c         |    4 ++--
 gtk/gtktextbufferrichtext.c |   31 ++++++++++++++++---------------
 gtk/gtktextiter.c           |    2 +-
 gtk/gtktextview.c           |    2 +-
 4 files changed, 20 insertions(+), 19 deletions(-)
---
diff --git a/gtk/gtktextbuffer.c b/gtk/gtktextbuffer.c
index 050ac9b..3a45357 100644
--- a/gtk/gtktextbuffer.c
+++ b/gtk/gtktextbuffer.c
@@ -4193,7 +4193,7 @@ gtk_text_buffer_get_target_list (GtkTextBuffer   *buffer,
  * using gtk_target_list_add_rich_text_targets() and
  * gtk_target_list_add_text_targets().
  *
- * Return value: the #GtkTargetList
+ * Return value: (transfer none): the #GtkTargetList
  *
  * Since: 2.10
  **/
@@ -4225,7 +4225,7 @@ gtk_text_buffer_get_copy_target_list (GtkTextBuffer *buffer)
  * using gtk_target_list_add_rich_text_targets() and
  * gtk_target_list_add_text_targets().
  *
- * Return value: the #GtkTargetList
+ * Return value: (transfer none): the #GtkTargetList
  *
  * Since: 2.10
  **/
diff --git a/gtk/gtktextbufferrichtext.c b/gtk/gtktextbufferrichtext.c
index 8db902f..0ddc088 100644
--- a/gtk/gtktextbufferrichtext.c
+++ b/gtk/gtktextbufferrichtext.c
@@ -66,8 +66,8 @@ static GQuark    deserialize_quark (void);
  * This function registers a rich text serialization @function along with
  * its @mime_type with the passed @buffer.
  *
- * Return value: the #GdkAtom that corresponds to the newly registered
- *               format's mime-type.
+ * Return value: (transfer none): the #GdkAtom that corresponds to the
+ *               newly registered format's mime-type.
  *
  * Since: 2.10
  **/
@@ -123,8 +123,8 @@ gtk_text_buffer_register_serialize_format (GtkTextBuffer              *buffer,
  * identifier != %NULL here, since the %NULL tagset requires the
  * receiving buffer to deal with with pasting of arbitrary tags.
  *
- * Return value: the #GdkAtom that corresponds to the newly registered
- *               format's mime-type.
+ * Return value: (transfer none): the #GdkAtom that corresponds to the
+ *               newly registered format's mime-type.
  *
  * Since: 2.10
  **/
@@ -164,8 +164,8 @@ gtk_text_buffer_register_serialize_tagset (GtkTextBuffer *buffer,
  * This function registers a rich text deserialization @function along with
  * its @mime_type with the passed @buffer.
  *
- * Return value: the #GdkAtom that corresponds to the newly registered
- *               format's mime-type.
+ * Return value: (transfer none): the #GdkAtom that corresponds to the
+ *               newly registered format's mime-type.
  *
  * Since: 2.10
  **/
@@ -207,8 +207,8 @@ gtk_text_buffer_register_deserialize_format (GtkTextBuffer                *buffe
  * format with the passed @buffer. See
  * gtk_text_buffer_register_serialize_tagset() for details.
  *
- * Return value: the #GdkAtom that corresponds to the newly registered
- *               format's mime-type.
+ * Return value: (transfer none): the #GdkAtom that corresponds to the
+ *               newly registered format's mime-type.
  *
  * Since: 2.10
  **/
@@ -408,8 +408,8 @@ gtk_text_buffer_deserialize_get_can_create_tags (GtkTextBuffer *buffer,
  * with @buffer using gtk_text_buffer_register_serialize_format() or
  * gtk_text_buffer_register_serialize_tagset()
  *
- * Return value: an array of #GdkAtom<!-- -->s representing the registered
- *               formats.
+ * Return value: (array length=n_formats) (transfer full): an array of
+ *               #GdkAtom<!-- -->s representing the registered formats.
  *
  * Since: 2.10
  **/
@@ -436,8 +436,8 @@ gtk_text_buffer_get_serialize_formats (GtkTextBuffer *buffer,
  * with @buffer using gtk_text_buffer_register_deserialize_format() or
  * gtk_text_buffer_register_deserialize_tagset()
  *
- * Return value: an array of #GdkAtom<!-- -->s representing the registered
- *               formats.
+ * Return value: (array length=n_formats) (transfer full): an array of
+ *               #GdkAtom<!-- -->s representing the registered formats.
  *
  * Since: 2.10
  **/
@@ -462,7 +462,7 @@ gtk_text_buffer_get_deserialize_formats (GtkTextBuffer *buffer,
  * @format: the rich text format to use for serializing
  * @start: start of block of text to serialize
  * @end: end of block of test to serialize
- * @length: return location for the length of the serialized data
+ * @length: (out): return location for the length of the serialized data
  *
  * This function serializes the portion of text between @start
  * and @end in the rich text format represented by @format.
@@ -471,7 +471,8 @@ gtk_text_buffer_get_deserialize_formats (GtkTextBuffer *buffer,
  * gtk_text_buffer_register_serialize_format() or
  * gtk_text_buffer_register_serialize_tagset() beforehand.
  *
- * Return value: the serialized data, encoded as @format
+ * Return value: (array length=length) (transfer full): the serialized
+ *               data, encoded as @format
  *
  * Since: 2.10
  **/
@@ -520,7 +521,7 @@ gtk_text_buffer_serialize (GtkTextBuffer     *register_buffer,
  * @content_buffer: the #GtkTextBuffer to deserialize into
  * @format: the rich text format to use for deserializing
  * @iter: insertion point for the deserialized text
- * @data: data to deserialize
+ * @data: (array length=length): data to deserialize
  * @length: length of @data
  * @error: return location for a #GError
  *
diff --git a/gtk/gtktextiter.c b/gtk/gtktextiter.c
index 6ee68bd..51c8f8f 100644
--- a/gtk/gtktextiter.c
+++ b/gtk/gtktextiter.c
@@ -1717,7 +1717,7 @@ gtk_text_iter_get_bytes_in_line (const GtkTextIter   *iter)
 /**
  * gtk_text_iter_get_attributes:
  * @iter: an iterator
- * @values: a #GtkTextAttributes to be filled in
+ * @values: (out): a #GtkTextAttributes to be filled in
  *
  * Computes the effect of any tags applied to this spot in the
  * text. The @values parameter should be initialized to the default
diff --git a/gtk/gtktextview.c b/gtk/gtktextview.c
index 5bbd28c..e500313 100644
--- a/gtk/gtktextview.c
+++ b/gtk/gtktextview.c
@@ -2292,7 +2292,7 @@ gtk_text_view_move_mark_onscreen (GtkTextView *text_view,
 /**
  * gtk_text_view_get_visible_rect:
  * @text_view: a #GtkTextView
- * @visible_rect: rectangle to fill
+ * @visible_rect: (out): rectangle to fill
  *
  * Fills @visible_rect with the currently-visible
  * region of the buffer, in buffer coordinates. Convert to window coordinates