[gtk+] Doc: small fixes in GtkTextView



commit a78fc4a9c5319c49e3d7668b42fe83d31bc3bbc9
Author: Sébastien Wilmet <swilmet gnome org>
Date:   Tue Sep 10 14:23:28 2013 +0200

    Doc: small fixes in GtkTextView
    
    Move GtkWrapMode from GtkTextTag to the GtkTextView section. The wrap
    mode property is in the text view.
    
    Links to the "mark-set" and "mark-deleted" signals.
    
    Add a precision about gtk_text_buffer_get_iter_at_line().
    
    Fix typo in gtk_text_tag_set_priority().
    
    https://bugzilla.gnome.org/show_bug.cgi?id=708076

 docs/reference/gtk/gtk3-sections.txt |    2 +-
 gtk/gtktextbuffer.c                  |   19 ++++++++++---------
 gtk/gtktexttag.c                     |    4 ++--
 3 files changed, 13 insertions(+), 12 deletions(-)
---
diff --git a/docs/reference/gtk/gtk3-sections.txt b/docs/reference/gtk/gtk3-sections.txt
index 12e0825..531f05e 100644
--- a/docs/reference/gtk/gtk3-sections.txt
+++ b/docs/reference/gtk/gtk3-sections.txt
@@ -3704,7 +3704,6 @@ gtk_text_mark_get_type
 <FILE>gtktexttag</FILE>
 <TITLE>GtkTextTag</TITLE>
 GtkTextTag
-GtkWrapMode
 gtk_text_tag_new
 gtk_text_tag_get_priority
 gtk_text_tag_set_priority
@@ -3757,6 +3756,7 @@ gtk_text_tag_table_get_type
 <TITLE>GtkTextView</TITLE>
 GtkTextView
 GtkTextWindowType
+GtkWrapMode
 gtk_text_view_new
 gtk_text_view_new_with_buffer
 gtk_text_view_set_buffer
diff --git a/gtk/gtktextbuffer.c b/gtk/gtktextbuffer.c
index c126672..c113080 100644
--- a/gtk/gtktextbuffer.c
+++ b/gtk/gtktextbuffer.c
@@ -2111,8 +2111,8 @@ gtk_text_buffer_set_mark (GtkTextBuffer     *buffer,
  * return value if you like. Marks are owned by the buffer and go 
  * away when the buffer does.
  *
- * Emits the "mark-set" signal as notification of the mark's initial
- * placement.
+ * Emits the #GtkTextBuffer::mark-set signal as notification of the mark's
+ * initial placement.
  *
  * Return value: (transfer none): the new #GtkTextMark object
  **/
@@ -2138,8 +2138,8 @@ gtk_text_buffer_create_mark (GtkTextBuffer     *buffer,
  * another buffer, and if its name is not %NULL then there must not
  * be another mark in the buffer with the same name.
  *
- * Emits the "mark-set" signal as notification of the mark's initial
- * placement.
+ * Emits the #GtkTextBuffer::mark-set signal as notification of the mark's
+ * initial placement.
  *
  * Since: 2.12
  **/
@@ -2172,8 +2172,8 @@ gtk_text_buffer_add_mark (GtkTextBuffer     *buffer,
  * @mark: a #GtkTextMark
  * @where: new location for @mark in @buffer
  *
- * Moves @mark to the new location @where. Emits the "mark-set" signal
- * as notification of the move.
+ * Moves @mark to the new location @where. Emits the #GtkTextBuffer::mark-set
+ * signal as notification of the move.
  **/
 void
 gtk_text_buffer_move_mark (GtkTextBuffer     *buffer,
@@ -2221,7 +2221,7 @@ gtk_text_buffer_get_iter_at_mark (GtkTextBuffer *buffer,
  * invalid, until it gets added to a buffer again with 
  * gtk_text_buffer_add_mark(). Use gtk_text_mark_get_deleted() to  
  * find out if a mark has been removed from its buffer.
- * The "mark-deleted" signal will be emitted as notification after 
+ * The #GtkTextBuffer::mark-deleted signal will be emitted as notification after
  * the mark is deleted.
  **/
 void
@@ -2911,8 +2911,9 @@ gtk_text_buffer_get_iter_at_line_index  (GtkTextBuffer *buffer,
  * @buffer: a #GtkTextBuffer 
  * @iter: (out): iterator to initialize
  * @line_number: line number counting from 0
- * 
- * Initializes @iter to the start of the given line.
+ *
+ * Initializes @iter to the start of the given line. If @line_number is greater
+ * than the number of lines in the @buffer, the end iterator is returned.
  **/
 void
 gtk_text_buffer_get_iter_at_line (GtkTextBuffer *buffer,
diff --git a/gtk/gtktexttag.c b/gtk/gtktexttag.c
index 2cdd88f..2462f73 100644
--- a/gtk/gtktexttag.c
+++ b/gtk/gtktexttag.c
@@ -1907,8 +1907,8 @@ gtk_text_tag_get_priority (GtkTextTag *tag)
  * gtk_text_tag_set_priority:
  * @tag: a #GtkTextTag
  * @priority: the new priority
- * 
- * Sets the priority of a #GtkTextTag. Valid priorities are
+ *
+ * Sets the priority of a #GtkTextTag. Valid priorities
  * start at 0 and go to one less than gtk_text_tag_table_get_size().
  * Each tag in a table has a unique priority; setting the priority
  * of one tag shifts the priorities of all the other tags in the


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]