[gtk+] docs: documentation for GtkTextBufferClass

[Sébastien Wilmet <swilmet src gnome org>]

commit 2e68e4fc09213801d1d43ecfadbe9475816b3889
Author: Sébastien Wilmet <swilmet gnome org>
Date:   Sat Oct 18 14:47:10 2014 +0200

    docs: documentation for GtkTextBufferClass
    
    It'll most probably be more useful in the near future.

 docs/reference/gtk/gtk3-sections.txt |    3 +-
 gtk/gtktextbuffer.h                  |   94 ++++++++++++++++++++--------------
 2 files changed, 58 insertions(+), 39 deletions(-)
---
diff --git a/docs/reference/gtk/gtk3-sections.txt b/docs/reference/gtk/gtk3-sections.txt
index 570832e..723ba22 100644
--- a/docs/reference/gtk/gtk3-sections.txt
+++ b/docs/reference/gtk/gtk3-sections.txt
@@ -3543,6 +3543,7 @@ gtk_tearoff_menu_item_get_type
 <FILE>gtktextbuffer</FILE>
 <TITLE>GtkTextBuffer</TITLE>
 GtkTextBuffer
+GtkTextBufferClass
 gtk_text_buffer_new
 gtk_text_buffer_get_line_count
 gtk_text_buffer_get_char_count
@@ -3629,9 +3630,9 @@ GTK_TYPE_TEXT_BUFFER
 GTK_TEXT_BUFFER_CLASS
 GTK_IS_TEXT_BUFFER_CLASS
 GTK_TEXT_BUFFER_GET_CLASS
+gtk_text_buffer_get_type
 <SUBSECTION Private>
 GtkTextBufferPrivate
-gtk_text_buffer_get_type
 </SECTION>
 
 <SECTION>
diff --git a/gtk/gtktextbuffer.h b/gtk/gtktextbuffer.h
index 5b56f8d..f1f13f3 100644
--- a/gtk/gtktextbuffer.h
+++ b/gtk/gtktextbuffer.h
@@ -82,60 +82,78 @@ struct _GtkTextBuffer
   GtkTextBufferPrivate *priv;
 };
 
+/**
+ * GtkTextBufferClass:
+ * @parent_class: The object class structure needs to be the first.
+ * @insert_text: The class handler for the #GtkTextBuffer::insert-text signal.
+ * @insert_pixbuf: The class handler for the #GtkTextBuffer::insert-pixbuf
+ *   signal.
+ * @insert_child_anchor: The class handler for the
+ *   #GtkTextBuffer::insert-child-anchor signal.
+ * @delete_range: The class handler for the #GtkTextBuffer::delete-range signal.
+ * @changed: The class handler for the #GtkTextBuffer::changed signal.
+ * @modified_changed: The class handler for the #GtkTextBuffer::modified-changed
+ *   signal.
+ * @mark_set: The class handler for the #GtkTextBuffer::mark-set signal.
+ * @mark_deleted: The class handler for the #GtkTextBuffer::mark-deleted signal.
+ * @apply_tag: The class handler for the #GtkTextBuffer::apply-tag signal.
+ * @remove_tag: The class handler for the #GtkTextBuffer::remove-tag signal.
+ * @begin_user_action: The class handler for the
+ *   #GtkTextBuffer::begin-user-action signal.
+ * @end_user_action: The class handler for the #GtkTextBuffer::end-user-action
+ *   signal.
+ * @paste_done: The class handler for the #GtkTextBuffer::paste-done signal.
+ */
 struct _GtkTextBufferClass
 {
   GObjectClass parent_class;
 
-  void (* insert_text)     (GtkTextBuffer *buffer,
-                            GtkTextIter *pos,
-                            const gchar *new_text,
-                            gint new_text_length);
+  void (* insert_text)            (GtkTextBuffer      *buffer,
+                                   GtkTextIter        *pos,
+                                   const gchar        *new_text,
+                                   gint                new_text_length);
+
+  void (* insert_pixbuf)          (GtkTextBuffer      *buffer,
+                                   GtkTextIter        *iter,
+                                   GdkPixbuf          *pixbuf);
 
-  void (* insert_pixbuf)   (GtkTextBuffer *buffer,
-                            GtkTextIter   *iter,
-                            GdkPixbuf     *pixbuf);
+  void (* insert_child_anchor)    (GtkTextBuffer      *buffer,
+                                   GtkTextIter        *iter,
+                                   GtkTextChildAnchor *anchor);
 
-  void (* insert_child_anchor)   (GtkTextBuffer      *buffer,
-                                  GtkTextIter        *iter,
-                                  GtkTextChildAnchor *anchor);
+  void (* delete_range)           (GtkTextBuffer      *buffer,
+                                   GtkTextIter        *start,
+                                   GtkTextIter        *end);
 
-  void (* delete_range)     (GtkTextBuffer *buffer,
-                             GtkTextIter   *start,
-                             GtkTextIter   *end);
+  void (* changed)                (GtkTextBuffer      *buffer);
 
-  /* Only for text/widgets/pixbuf changed, marks/tags don't cause this
-   * to be emitted
-   */
-  void (* changed)         (GtkTextBuffer *buffer);
+  void (* modified_changed)       (GtkTextBuffer      *buffer);
 
+  void (* mark_set)               (GtkTextBuffer      *buffer,
+                                   const GtkTextIter  *location,
+                                   GtkTextMark        *mark);
 
-  /* New value for the modified flag */
-  void (* modified_changed)   (GtkTextBuffer *buffer);
+  void (* mark_deleted)           (GtkTextBuffer      *buffer,
+                                   GtkTextMark        *mark);
 
-  /* Mark moved or created */
-  void (* mark_set)           (GtkTextBuffer *buffer,
-                               const GtkTextIter *location,
-                               GtkTextMark *mark);
+  void (* apply_tag)              (GtkTextBuffer      *buffer,
+                                   GtkTextTag         *tag,
+                                   const GtkTextIter  *start,
+                                   const GtkTextIter  *end);
 
-  void (* mark_deleted)       (GtkTextBuffer *buffer,
-                               GtkTextMark *mark);
+  void (* remove_tag)             (GtkTextBuffer      *buffer,
+                                   GtkTextTag         *tag,
+                                   const GtkTextIter  *start,
+                                   const GtkTextIter  *end);
 
-  void (* apply_tag)          (GtkTextBuffer *buffer,
-                               GtkTextTag *tag,
-                               const GtkTextIter *start,
-                               const GtkTextIter *end);
+  void (* begin_user_action)      (GtkTextBuffer      *buffer);
 
-  void (* remove_tag)         (GtkTextBuffer *buffer,
-                               GtkTextTag *tag,
-                               const GtkTextIter *start,
-                               const GtkTextIter *end);
+  void (* end_user_action)        (GtkTextBuffer      *buffer);
 
-  /* Called at the start and end of an atomic user action */
-  void (* begin_user_action)  (GtkTextBuffer *buffer);
-  void (* end_user_action)    (GtkTextBuffer *buffer);
+  void (* paste_done)             (GtkTextBuffer      *buffer,
+                                   GtkClipboard       *clipboard);
 
-  void (* paste_done)         (GtkTextBuffer *buffer,
-                               GtkClipboard  *clipboard);
+  /*< private >*/
 
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);