[gtk+/gi-annotations: 15/31] Update GI annotations in 'Multiline Text Editor'
- From: Pavel Holejsovsky <pholejs src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gtk+/gi-annotations: 15/31] Update GI annotations in 'Multiline Text Editor'
- Date: Mon, 17 Jan 2011 05:52:06 +0000 (UTC)
commit 7decb3d1b07c76eaf1851043bc678ca10d14b089
Author: Pavel Holejsovsky <pholejs src gnome org>
Date: Sun Jan 16 08:36:19 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 | 29 +++++++++++++++--------------
gtk/gtktextiter.c | 2 +-
gtk/gtktextview.c | 2 +-
4 files changed, 19 insertions(+), 18 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..e4e6836 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 container): 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 container): an array of
+ * #GdkAtom<!-- -->s representing the registered formats.
*
* Since: 2.10
**/
@@ -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 f06250c..319da16 100644
--- a/gtk/gtktextview.c
+++ b/gtk/gtktextview.c
@@ -2293,7 +2293,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
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]