docs: add Gtk*Class docs

https://bugzilla.gnome.org/show_bug.cgi?id=81006

9 files changed, 99 insertions, 0 deletions

diff --git a/gtk/deprecated/gtkaction.h b/gtk/deprecated/gtkaction.h
index b78da92a32..a105708d86 100644
--- a/gtk/deprecated/gtkaction.h
+++ b/gtk/deprecated/gtkaction.h
@@ -56,13 +56,22 @@ struct _GtkAction
   GtkActionPrivate *private_data;
 };
 
+/**
+ * GtkActionClass:
+ * @parent_class: The parent class.
+ * @activate: Signal emitted when the action is activated.
+ */
 struct _GtkActionClass
 {
   GObjectClass parent_class;
 
+  /*< public >*/
+
   /* activation signal */
   void       (* activate)           (GtkAction    *action);
 
+  /*< private >*/
+
   GType      menu_item_type;
   GType      toolbar_item_type;
 
diff --git a/gtk/deprecated/gtkactiongroup.h b/gtk/deprecated/gtkactiongroup.h
index e2e54edc51..3ce8f270d3 100644
--- a/gtk/deprecated/gtkactiongroup.h
+++ b/gtk/deprecated/gtkactiongroup.h
@@ -60,6 +60,11 @@ struct _GtkActionGroup
   GtkActionGroupPrivate *priv;
 };
 
+/**
+ * GtkActionGroupClass:
+ * @parent_class: The parent class.
+ * @get_action: Looks up an action in the action group by name.
+ */
 struct _GtkActionGroupClass
 {
   GObjectClass parent_class;
@@ -67,6 +72,8 @@ struct _GtkActionGroupClass
   GtkAction *(* get_action) (GtkActionGroup *action_group,
                              const gchar    *action_name);
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/deprecated/gtkcolorsel.h b/gtk/deprecated/gtkcolorsel.h
index f7715d2379..681fe06ad0 100644
--- a/gtk/deprecated/gtkcolorsel.h
+++ b/gtk/deprecated/gtkcolorsel.h
@@ -70,12 +70,19 @@ struct _GtkColorSelection
   GtkColorSelectionPrivate *private_data;
 };
 
+/**
+ * GtkColorSelectionClass:
+ * @parent_class: The parent class.
+ * @color_changed:
+ */
 struct _GtkColorSelectionClass
 {
   GtkBoxClass parent_class;
 
   void (*color_changed)	(GtkColorSelection *color_selection);
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/deprecated/gtkhandlebox.h b/gtk/deprecated/gtkhandlebox.h
index 3a635941da..b63476ef9d 100644
--- a/gtk/deprecated/gtkhandlebox.h
+++ b/gtk/deprecated/gtkhandlebox.h
@@ -57,6 +57,14 @@ struct _GtkHandleBox
   GtkHandleBoxPrivate *priv;
 };
 
+/**
+ * GtkHandleBoxClass:
+ * @parent_class: The parent class.
+ * @child_attached: Signal emitted when the contents of the handlebox
+ *    are reattached to the main window. Deprecated: 3.4.
+ * @child_detached: Signal emitted when the contents of the handlebox
+ *    are detached from the main window. Deprecated: 3.4.
+ */
 struct _GtkHandleBoxClass
 {
   GtkBinClass parent_class;
@@ -66,6 +74,8 @@ struct _GtkHandleBoxClass
   void	(*child_detached)	(GtkHandleBox	*handle_box,
 				 GtkWidget	*child);
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/deprecated/gtkiconfactory.h b/gtk/deprecated/gtkiconfactory.h
index 779a331f7f..4e47c777a2 100644
--- a/gtk/deprecated/gtkiconfactory.h
+++ b/gtk/deprecated/gtkiconfactory.h
@@ -57,10 +57,16 @@ struct _GtkIconFactory
   GtkIconFactoryPrivate *priv;
 };
 
+/**
+ * GtkIconFactoryClass:
+ * @parent_class: The parent class.
+ */
 struct _GtkIconFactoryClass
 {
   GObjectClass parent_class;
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/deprecated/gtkimagemenuitem.h b/gtk/deprecated/gtkimagemenuitem.h
index ec07132ec8..77972c8a67 100644
--- a/gtk/deprecated/gtkimagemenuitem.h
+++ b/gtk/deprecated/gtkimagemenuitem.h
@@ -55,10 +55,16 @@ struct _GtkImageMenuItem
   GtkImageMenuItemPrivate *priv;
 };
 
+/**
+ * GtkImageMenuItemClass:
+ * @parent_class: The parent class.
+ */
 struct _GtkImageMenuItemClass
 {
   GtkMenuItemClass parent_class;
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/deprecated/gtkrc.h b/gtk/deprecated/gtkrc.h
index 4fc1505337..c3676973db 100644
--- a/gtk/deprecated/gtkrc.h
+++ b/gtk/deprecated/gtkrc.h
@@ -100,10 +100,21 @@ struct _GtkRcStyle
   guint engine_specified : 1;   /* The RC file specified the engine */
 };
 
+/**
+ * GtkRcStyleClass:
+ * @parent_class: The parent class.
+ * @create_rc_style: 
+ * @parse: 
+ * @merge: 
+ * @create_style: 
+ * @create_style: 
+ */
 struct _GtkRcStyleClass
 {
   GObjectClass parent_class;
 
+  /*< public >*/
+
   /* Create an empty RC style of the same type as this RC style.
    * The default implementation, which does
    * g_object_new (G_OBJECT_TYPE (style), NULL);
@@ -129,6 +140,8 @@ struct _GtkRcStyleClass
    */
   GtkStyle * (*create_style) (GtkRcStyle *rc_style);
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/deprecated/gtkstyle.h b/gtk/deprecated/gtkstyle.h
index 755fac0eb5..d5bf9d7b34 100644
--- a/gtk/deprecated/gtkstyle.h
+++ b/gtk/deprecated/gtkstyle.h
@@ -98,10 +98,43 @@ struct _GtkStyle
   GSList         *icon_factories; /* of type GtkIconFactory* */
 };
 
+/**
+ * GtkStyleClass:
+ * @parent_class: The parent class.
+ * @realize: 
+ * @unrealize: 
+ * @copy: 
+ * @clone: 
+ * @init_from_rc: 
+ * @set_background: 
+ * @render_icon: 
+ * @draw_hline: 
+ * @draw_vline: 
+ * @draw_shadow: 
+ * @draw_arrow: 
+ * @draw_diamond: 
+ * @draw_box: 
+ * @draw_flat_box: 
+ * @draw_check: 
+ * @draw_option: 
+ * @draw_tab: 
+ * @draw_shadow_gap: 
+ * @draw_box_gap: 
+ * @draw_extension: 
+ * @draw_focus: 
+ * @draw_slider: 
+ * @draw_handle: 
+ * @draw_expander: 
+ * @draw_layout: 
+ * @draw_resize_grip: 
+ * @draw_spinner: 
+ */
 struct _GtkStyleClass
 {
   GObjectClass parent_class;
 
+  /*< public >*/
+
   /* Initialize for a particular visual. style->visual
    * will have been set at this point. Will typically chain
    * to parent.
@@ -352,6 +385,8 @@ struct _GtkStyleClass
                                  gint                    width,
                                  gint                    height);
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1)  (void);
   void (*_gtk_reserved2)  (void);
diff --git a/gtk/deprecated/gtktearoffmenuitem.h b/gtk/deprecated/gtktearoffmenuitem.h
index fafa473e0f..ab8fcf22ad 100644
--- a/gtk/deprecated/gtktearoffmenuitem.h
+++ b/gtk/deprecated/gtktearoffmenuitem.h
@@ -53,10 +53,16 @@ struct _GtkTearoffMenuItem
   GtkTearoffMenuItemPrivate *priv;
 };
 
+/**
+ * GtkTearoffMenuItemClass:
+ * @parent_class: The parent class.
+ */
 struct _GtkTearoffMenuItemClass
 {
   GtkMenuItemClass parent_class;
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);