docs: add Gtk*Class docs

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

65 files changed, 657 insertions, 40 deletions

diff --git a/docs/reference/gtk/gtk3-sections.txt b/docs/reference/gtk/gtk3-sections.txt
index 70f0e0a0b7..5e1903f5f3 100644
--- a/docs/reference/gtk/gtk3-sections.txt
+++ b/docs/reference/gtk/gtk3-sections.txt
@@ -55,6 +55,7 @@ gtk_about_dialog_get_type
 <FILE>gtkaccelgroup</FILE>
 <TITLE>Keyboard Accelerators</TITLE>
 GtkAccelGroup
+GtkAccelGroupClass
 gtk_accel_group_new
 gtk_accel_group_connect
 gtk_accel_group_connect_by_path
@@ -83,7 +84,6 @@ gtk_accelerator_set_default_mod_mask
 gtk_accelerator_get_default_mod_mask
 
 <SUBSECTION Standard>
-GtkAccelGroupClass
 GTK_TYPE_ACCEL_GROUP
 GTK_ACCEL_GROUP
 GTK_IS_ACCEL_GROUP
@@ -178,6 +178,7 @@ gtk_accessible_get_type
 <FILE>gtkaction</FILE>
 <TITLE>GtkAction</TITLE>
 GtkAction
+GtkActionClass
 gtk_action_new
 gtk_action_get_name
 gtk_action_is_sensitive
@@ -228,7 +229,6 @@ GTK_ACTION_CLASS
 GTK_IS_ACTION
 GTK_IS_ACTION_CLASS
 GTK_ACTION_GET_CLASS
-GtkActionClass
 <SUBSECTION Private>
 gtk_action_get_type
 GtkActionPrivate
@@ -259,6 +259,7 @@ gtk_activatable_get_type
 <FILE>gtkactiongroup</FILE>
 <TITLE>GtkActionGroup</TITLE>
 GtkActionGroup
+GtkActionGroupClass
 gtk_action_group_new
 gtk_action_group_get_name
 gtk_action_group_get_sensitive
@@ -292,7 +293,6 @@ GTK_ACTION_GROUP_CLASS
 GTK_IS_ACTION_GROUP
 GTK_IS_ACTION_GROUP_CLASS
 GTK_ACTION_GROUP_GET_CLASS
-GtkActionGroupClass
 <SUBSECTION Private>
 gtk_action_group_get_type
 GtkActionGroupPrivate
@@ -335,6 +335,7 @@ gtk_adjustment_get_type
 <FILE>gtkalignment</FILE>
 <TITLE>GtkAlignment</TITLE>
 GtkAlignment
+GtkAlignmentClass
 gtk_alignment_new
 gtk_alignment_set
 gtk_alignment_get_padding
@@ -355,6 +356,7 @@ GtkAlignmentPrivate
 <FILE>gtkassistant</FILE>
 <TITLE>GtkAssistant</TITLE>
 GtkAssistant
+GtkAssistantClass
 gtk_assistant_new
 gtk_assistant_get_current_page
 gtk_assistant_set_current_page
@@ -385,7 +387,6 @@ gtk_assistant_next_page
 gtk_assistant_previous_page
 
 <SUBSECTION Standard>
-GtkAssistantClass
 GTK_TYPE_ASSISTANT
 GTK_ASSISTANT
 GTK_ASSISTANT_CLASS
@@ -419,6 +420,7 @@ gtk_arrow_get_type
 <FILE>gtkaspectframe</FILE>
 <TITLE>GtkAspectFrame</TITLE>
 GtkAspectFrame
+GtkAspectFrameClass
 gtk_aspect_frame_new
 gtk_aspect_frame_set
 <SUBSECTION Standard>
@@ -437,6 +439,7 @@ gtk_aspect_frame_get_type
 <FILE>gtkbbox</FILE>
 <TITLE>GtkButtonBox</TITLE>
 GtkButtonBox
+GtkButtonBoxClass
 gtk_button_box_new
 gtk_button_box_get_layout
 gtk_button_box_get_child_secondary
@@ -460,6 +463,7 @@ gtk_button_box_get_type
 <FILE>gtkbin</FILE>
 <TITLE>GtkBin</TITLE>
 GtkBin
+GtkBinClass
 gtk_bin_get_child
 <SUBSECTION Standard>
 GTK_BIN
@@ -477,6 +481,7 @@ gtk_bin_get_type
 <FILE>gtkbox</FILE>
 <TITLE>GtkBox</TITLE>
 GtkBox
+GtkBoxClass
 gtk_box_new
 gtk_box_pack_start
 gtk_box_pack_end
@@ -505,7 +510,9 @@ gtk_box_get_type
 <FILE>gtklistbox</FILE>
 <TITLE>GtkListBox</TITLE>
 GtkListBox
+GtkListBoxClass
 GtkListBoxRow
+GtkListBoxRowClass
 GtkListBoxFilterFunc
 GtkListBoxSortFunc
 GtkListBoxUpdateHeaderFunc
@@ -636,6 +643,7 @@ GtkBuilderPrivate
 <FILE>gtkbutton</FILE>
 <TITLE>GtkButton</TITLE>
 GtkButton
+GtkButtonClass
 gtk_button_new
 gtk_button_new_with_label
 gtk_button_new_with_mnemonic
@@ -739,6 +747,7 @@ gtk_check_button_get_type
 <SECTION>
 <FILE>gtkcheckmenuitem</FILE>
 GtkCheckMenuItem
+GtkCheckMenuItemClass
 <TITLE>GtkCheckMenuItem</TITLE>
 gtk_check_menu_item_new
 gtk_check_menu_item_new_with_label
@@ -820,6 +829,7 @@ gtk_hsv_get_type
 <FILE>gtkcolorsel</FILE>
 <TITLE>GtkColorSelection</TITLE>
 GtkColorSelection
+GtkColorSelectionClass
 gtk_color_selection_new
 gtk_color_selection_set_has_opacity_control
 gtk_color_selection_get_has_opacity_control
@@ -877,6 +887,7 @@ gtk_color_selection_dialog_get_type
 <FILE>gtkcombobox</FILE>
 <TITLE>GtkComboBox</TITLE>
 GtkComboBox
+GtkComboBoxClass
 gtk_combo_box_new
 gtk_combo_box_new_with_entry
 gtk_combo_box_new_with_model
@@ -963,6 +974,7 @@ gtk_combo_box_text_get_type
 <FILE>gtkcontainer</FILE>
 <TITLE>GtkContainer</TITLE>
 GtkContainer
+GtkContainerClass
 GTK_IS_RESIZE_CONTAINER
 GTK_CONTAINER_WARN_INVALID_CHILD_PROPERTY_ID
 gtk_container_add
@@ -1018,6 +1030,7 @@ gtk_container_get_type
 <FILE>gtkdialog</FILE>
 <TITLE>GtkDialog</TITLE>
 GtkDialog
+GtkDialogClass
 GtkDialogFlags
 GtkResponseType
 gtk_dialog_new
@@ -1264,6 +1277,7 @@ gtk_entry_completion_get_type
 <FILE>gtkeventbox</FILE>
 <TITLE>GtkEventBox</TITLE>
 GtkEventBox
+GtkEventBoxClass
 gtk_event_box_new
 gtk_event_box_set_above_child
 gtk_event_box_get_above_child
@@ -1284,6 +1298,7 @@ gtk_event_box_get_type
 <FILE>gtkexpander</FILE>
 <TITLE>GtkExpander</TITLE>
 GtkExpander
+GtkExpanderClass
 gtk_expander_new
 gtk_expander_new_with_mnemonic
 gtk_expander_set_expanded
@@ -1411,6 +1426,7 @@ GtkFileChooserDialogPrivate
 <FILE>gtkfilechooserwidget</FILE>
 <TITLE>GtkFileChooserWidget</TITLE>
 GtkFileChooserWidget
+GtkFileChooserWidgetClass
 gtk_file_chooser_widget_new
 <SUBSECTION Standard>
 GTK_FILE_CHOOSER_WIDGET
@@ -1428,6 +1444,7 @@ GtkFileChooserWidgetPrivate
 <FILE>gtkfilechooserbutton</FILE>
 <TITLE>GtkFileChooserButton</TITLE>
 GtkFileChooserButton
+GtkFileChooserButtonClass
 gtk_file_chooser_button_new
 gtk_file_chooser_button_new_with_dialog
 gtk_file_chooser_button_get_title
@@ -1612,10 +1629,10 @@ gtk_font_chooser_get_type
 <FILE>gtkfontchooserwidget</FILE>
 <TITLE>GtkFontChooserWidget</TITLE>
 GtkFontChooserWidget
+GtkFontChooserWidgetClass
 gtk_font_chooser_widget_new
 
 <SUBSECTION Standard>
-GtkFontChooserWidgetClass
 GTK_TYPE_FONT_CHOOSER_WIDGET
 GTK_FONT_CHOOSER_WIDGET
 GTK_FONT_CHOOSER_WIDGET_CLASS
@@ -1632,10 +1649,10 @@ gtk_font_chooser_widget_get_type
 <FILE>gtkfontchooserdialog</FILE>
 <TITLE>GtkFontChooserDialog</TITLE>
 GtkFontChooserDialog
+GtkFontChooserDialogClass
 gtk_font_chooser_dialog_new
 
 <SUBSECTION Standard>
-GtkFontChooserDialogClass
 GTK_TYPE_FONT_CHOOSER_DIALOG
 GTK_FONT_CHOOSER_DIALOG
 GTK_FONT_CHOOSER_DIALOG_CLASS
@@ -1652,6 +1669,7 @@ gtk_font_chooser_dialog_get_type
 <FILE>gtkframe</FILE>
 <TITLE>GtkFrame</TITLE>
 GtkFrame
+GtkFrameClass
 gtk_frame_new
 gtk_frame_set_label
 gtk_frame_set_label_widget
@@ -1677,6 +1695,7 @@ gtk_frame_get_type
 <FILE>gtkhandlebox</FILE>
 <TITLE>GtkHandleBox</TITLE>
 GtkHandleBox
+GtkHandleBoxClass
 gtk_handle_box_new
 gtk_handle_box_set_shadow_type
 gtk_handle_box_set_handle_position
@@ -1932,6 +1951,7 @@ GtkImageGIconData
 <FILE>gtkimagemenuitem</FILE>
 <TITLE>GtkImageMenuItem</TITLE>
 GtkImageMenuItem
+GtkImageMenuItemClass
 gtk_image_menu_item_set_image
 gtk_image_menu_item_get_image
 gtk_image_menu_item_new
@@ -1944,7 +1964,6 @@ gtk_image_menu_item_get_always_show_image
 gtk_image_menu_item_set_always_show_image
 gtk_image_menu_item_set_accel_group
 <SUBSECTION Standard>
-GtkImageMenuItemClass
 GTK_IMAGE_MENU_ITEM
 GTK_IMAGE_MENU_ITEM_CLASS
 GTK_IMAGE_MENU_ITEM_GET_CLASS
@@ -2136,6 +2155,7 @@ gtk_layout_get_type
 <FILE>gtklinkbutton</FILE>
 <TITLE>GtkLinkButton</TITLE>
 GtkLinkButton
+GtkLinkButtonClass
 gtk_link_button_new
 gtk_link_button_new_with_label
 gtk_link_button_get_uri
@@ -2150,7 +2170,6 @@ GTK_IS_LINK_BUTTON
 GTK_LINK_BUTTON_CLASS
 GTK_IS_LINK_BUTTON_CLASS
 GTK_LINK_BUTTON_GET_CLASS
-GtkLinkButtonClass
 <SUBSECTION Private>
 GtkLinkButtonPrivate
 gtk_link_button_get_type
@@ -2253,6 +2272,7 @@ gtk_menu_button_get_type
 <FILE>gtkmenuitem</FILE>
 <TITLE>GtkMenuItem</TITLE>
 GtkMenuItem
+GtkMenuItemClass
 gtk_menu_item_new
 gtk_menu_item_new_with_label
 gtk_menu_item_new_with_mnemonic
@@ -2521,6 +2541,7 @@ gtk_numerable_icon_get_type
 <FILE>gtkoffscreenwindow</FILE>
 <TITLE>GtkOffscreenWindow</TITLE>
 GtkOffscreenWindow
+GtkOffscreenWindowClass
 gtk_offscreen_window_new
 gtk_offscreen_window_get_surface
 gtk_offscreen_window_get_pixbuf
@@ -3079,6 +3100,7 @@ gtk_scrollbar_get_type
 <FILE>gtkscrolledwindow</FILE>
 <TITLE>GtkScrolledWindow</TITLE>
 GtkScrolledWindow
+GtkScrolledWindowClass
 gtk_scrolled_window_new
 gtk_scrolled_window_get_hadjustment
 gtk_scrolled_window_get_vadjustment
@@ -3119,6 +3141,7 @@ GtkScrolledWindowPrivate
 <FILE>gtksearchbar</FILE>
 <TITLE>GtkSearchBar</TITLE>
 GtkSearchBar
+GtkSearchBarClass
 gtk_search_bar_new
 gtk_search_bar_connect_entry
 gtk_search_bar_get_search_mode
@@ -3174,9 +3197,9 @@ GtkSeparatorPrivate
 <FILE>gtkseparatormenuitem</FILE>
 <TITLE>GtkSeparatorMenuItem</TITLE>
 GtkSeparatorMenuItem
+GtkSeparatorMenuItemClass
 gtk_separator_menu_item_new
 <SUBSECTION Standard>
-GtkSeparatorMenuItemClass
 GTK_SEPARATOR_MENU_ITEM
 GTK_SEPARATOR_MENU_ITEM_CLASS
 GTK_SEPARATOR_MENU_ITEM_GET_CLASS
@@ -3471,6 +3494,7 @@ gtk_table_get_type
 <FILE>gtktearoffmenuitem</FILE>
 <TITLE>GtkTearoffMenuItem</TITLE>
 GtkTearoffMenuItem
+GtkTearoffMenuItemClass
 gtk_tearoff_menu_item_new
 <SUBSECTION Standard>
 GTK_TEAROFF_MENU_ITEM
@@ -3968,6 +3992,7 @@ GtkToolbarPrivate
 <FILE>gtktoolitem</FILE>
 <TITLE>GtkToolItem</TITLE>
 GtkToolItem
+GtkToolItemClass
 gtk_tool_item_new
 gtk_tool_item_set_homogeneous
 gtk_tool_item_get_homogeneous
@@ -4014,6 +4039,7 @@ GtkToolItemPrivate
 <FILE>gtkseparatortoolitem</FILE>
 <TITLE>GtkSeparatorToolItem</TITLE>
 GtkSeparatorToolItem
+GtkSeparatorToolItemClass
 gtk_separator_tool_item_new
 gtk_separator_tool_item_set_draw
 gtk_separator_tool_item_get_draw
@@ -4035,6 +4061,7 @@ GtkSeparatorToolItemPrivate
 <FILE>gtktoolbutton</FILE>
 <TITLE>GtkToolButton</TITLE>
 GtkToolButton
+GtkToolButtonClass
 gtk_tool_button_new
 gtk_tool_button_new_from_stock
 gtk_tool_button_set_label
@@ -4067,6 +4094,7 @@ GtkToolButtonPrivate
 <FILE>gtkmenutoolbutton</FILE>
 <TITLE>GtkMenuToolButton</TITLE>
 GtkMenuToolButton
+GtkMenuToolButtonClass
 gtk_menu_tool_button_new
 gtk_menu_tool_button_new_from_stock
 gtk_menu_tool_button_set_menu
@@ -4075,7 +4103,6 @@ gtk_menu_tool_button_set_arrow_tooltip_text
 gtk_menu_tool_button_set_arrow_tooltip_markup
 
 <SUBSECTION Standard>
-GtkMenuToolButtonClass
 GTK_TYPE_MENU_TOOL_BUTTON
 GTK_MENU_TOOL_BUTTON
 GTK_MENU_TOOL_BUTTON_CLASS
@@ -4115,13 +4142,13 @@ gtk_radio_tool_button_get_type
 <FILE>gtktoggletoolbutton</FILE>
 <TITLE>GtkToggleToolButton</TITLE>
 GtkToggleToolButton
+GtkToggleToolButtonClass
 gtk_toggle_tool_button_new
 gtk_toggle_tool_button_new_from_stock
 gtk_toggle_tool_button_set_active
 gtk_toggle_tool_button_get_active
 
 <SUBSECTION Standard>
-GtkToggleToolButtonClass
 GTK_TYPE_TOGGLE_TOOL_BUTTON
 GTK_TOGGLE_TOOL_BUTTON
 GTK_TOGGLE_TOOL_BUTTON_CLASS
@@ -4138,6 +4165,7 @@ GtkToggleToolButtonPrivate
 <FILE>gtktoolitemgroup</FILE>
 <TITLE>GtkToolItemGroup</TITLE>
 GtkToolItemGroup
+GtkToolItemGroupClass
 gtk_tool_item_group_get_collapsed
 gtk_tool_item_group_get_drop_item
 gtk_tool_item_group_get_ellipsize
@@ -4157,7 +4185,6 @@ gtk_tool_item_group_set_label_widget
 gtk_tool_item_group_set_header_relief
 
 <SUBSECTION Standard>
-GtkToolItemGroupClass
 GTK_TOOL_ITEM_GROUP
 GTK_IS_TOOL_ITEM_GROUP
 GTK_TYPE_TOOL_ITEM_GROUP
@@ -4174,6 +4201,7 @@ gtk_tool_item_group_get_type
 <FILE>gtktoolpalette</FILE>
 <TITLE>GtkToolPalette</TITLE>
 GtkToolPalette
+GtkToolPaletteClass
 gtk_tool_palette_new
 gtk_tool_palette_get_exclusive
 gtk_tool_palette_set_exclusive
@@ -4199,7 +4227,6 @@ gtk_tool_palette_get_hadjustment
 gtk_tool_palette_get_vadjustment
 
 <SUBSECTION Standard>
-GtkToolPaletteClass
 GTK_TOOL_PALETTE
 GTK_IS_TOOL_PALETTE
 GTK_TYPE_TOOL_PALETTE
@@ -4372,6 +4399,7 @@ gtk_tree_model_filter_get_type
 <FILE>gtktreeselection</FILE>
 <TITLE>GtkTreeSelection</TITLE>
 GtkTreeSelection
+GtkTreeSelectionClass
 GtkTreeSelectionFunc
 GtkTreeSelectionForeachFunc
 gtk_tree_selection_set_mode
@@ -4679,7 +4707,6 @@ gtk_tree_view_get_tooltip_column
 gtk_tree_view_set_tooltip_column
 
 <SUBSECTION Standard>
-GtkTreeSelectionClass
 GTK_TREE_VIEW
 GTK_IS_TREE_VIEW
 GTK_TYPE_TREE_VIEW
@@ -4694,6 +4721,7 @@ gtk_tree_view_get_type
 <FILE>gtkcellview</FILE>
 <TITLE>GtkCellView</TITLE>
 GtkCellView
+GtkCellViewClass
 gtk_cell_view_new
 gtk_cell_view_new_with_context
 gtk_cell_view_new_with_text
@@ -4711,7 +4739,6 @@ gtk_cell_view_get_draw_sensitive
 gtk_cell_view_set_fit_model
 gtk_cell_view_get_fit_model
 <SUBSECTION Standard>
-GtkCellViewClass
 GTK_TYPE_CELL_VIEW
 GTK_CELL_VIEW
 GTK_CELL_VIEW_CLASS
@@ -5156,6 +5183,7 @@ gtk_vbox_get_type
 <FILE>gtkviewport</FILE>
 <TITLE>GtkViewport</TITLE>
 GtkViewport
+GtkViewportClass
 gtk_viewport_new
 gtk_viewport_get_hadjustment
 gtk_viewport_get_vadjustment
@@ -5558,6 +5586,7 @@ gtk_requisition_get_type
 <FILE>gtkwindow</FILE>
 <TITLE>GtkWindow</TITLE>
 GtkWindow
+GtkWindowClass
 gtk_window_new
 gtk_window_set_title
 gtk_window_set_wmclass
@@ -6189,6 +6218,7 @@ gtk_gradient_get_type
 <TITLE>GtkStyle</TITLE>
 GTK_STYLE_ATTACHED
 GtkStyle
+GtkStyleClass
 gtk_style_new
 gtk_style_copy
 gtk_style_attach
@@ -6229,7 +6259,6 @@ GtkRcProperty
 GtkRcPropertyParser
 
 <SUBSECTION Standard>
-GtkStyleClass
 GTK_STYLE
 GTK_IS_STYLE
 GTK_TYPE_STYLE
@@ -6245,6 +6274,7 @@ GtkThemeEngine
 <FILE>gtkrc</FILE>
 <TITLE>Resource Files</TITLE>
 GtkRcStyle
+GtkRcStyleClass
 GtkRcFlags
 GtkRcTokenType
 gtk_rc_scanner_new
@@ -6272,7 +6302,6 @@ gtk_rc_style_new
 gtk_rc_style_copy
 
 <SUBSECTION Standard>
-GtkRcStyleClass
 GTK_RC_STYLE
 GTK_IS_RC_STYLE
 GTK_TYPE_RC_STYLE
@@ -6631,6 +6660,7 @@ GTK_STOCK_ZOOM_OUT
 <TITLE>GtkIconTheme</TITLE>
 GtkIconInfo
 GtkIconTheme
+GtkIconThemeClass
 GtkIconLookupFlags
 GTK_ICON_THEME_ERROR
 GtkIconThemeError
@@ -6683,7 +6713,6 @@ gtk_icon_info_get_attach_points
 gtk_icon_info_get_display_name
 gtk_icon_info_is_symbolic
 <SUBSECTION Standard>
-GtkIconThemeClass
 GTK_ICON_THEME
 GTK_IS_ICON_THEME
 GTK_TYPE_ICON_THEME
@@ -6703,6 +6732,7 @@ gtk_icon_theme_error_quark
 <TITLE>Themeable Stock Images</TITLE>
 GtkIconSource
 GtkIconFactory
+GtkIconFactoryClass
 GtkIconSet
 GtkIconSize
 gtk_icon_source_copy
@@ -6749,7 +6779,6 @@ gtk_icon_source_set_size_wildcarded
 gtk_icon_source_set_state
 gtk_icon_source_set_state_wildcarded
 <SUBSECTION Standard>
-GtkIconFactoryClass
 GTK_TYPE_ICON_FACTORY
 GTK_ICON_FACTORY
 GTK_IS_ICON_FACTORY
@@ -6770,6 +6799,7 @@ gtk_icon_source_get_type
 <FILE>gtkprintoperation</FILE>
 <TITLE>High-level Printing API</TITLE>
 GtkPrintOperation
+GtkPrintOperationClass
 GtkPrintStatus
 GtkPrintOperationAction
 GtkPrintOperationResult
@@ -6826,7 +6856,6 @@ GTK_IS_PRINT_OPERATION_PREVIEW
 GTK_PRINT_OPERATION_PREVIEW
 GTK_PRINT_OPERATION_PREVIEW_GET_IFACE
 GTK_TYPE_PRINT_OPERATION_PREVIEW
-GtkPrintOperationClass
 GtkPrintOperationPreviewIface
 
 <SUBSECTION Private>
@@ -7230,6 +7259,7 @@ gtk_print_job_get_type
 <FILE>gtkpagesetupunixdialog</FILE>
 <TITLE>GtkPageSetupUnixDialog</TITLE>
 GtkPageSetupUnixDialog
+GtkPageSetupUnixDialogClass
 gtk_page_setup_unix_dialog_new
 gtk_page_setup_unix_dialog_set_page_setup
 gtk_page_setup_unix_dialog_get_page_setup
@@ -7237,7 +7267,6 @@ gtk_page_setup_unix_dialog_set_print_settings
 gtk_page_setup_unix_dialog_get_print_settings
 
 <SUBSECTION Standard>
-GtkPageSetupUnixDialogClass
 GTK_TYPE_PAGE_SETUP_UNIX_DIALOG
 GTK_PAGE_SETUP_UNIX_DIALOG
 GTK_PAGE_SETUP_UNIX_DIALOG_CLASS
@@ -7276,6 +7305,7 @@ gtk_test_widget_wait_for_draw
 <FILE>filesystem</FILE>
 <TITLE>Filesystem utilities</TITLE>
 GtkMountOperation
+GtkMountOperationClass
 gtk_mount_operation_new
 gtk_mount_operation_is_showing
 gtk_mount_operation_set_parent
@@ -7284,7 +7314,6 @@ gtk_mount_operation_set_screen
 gtk_mount_operation_get_screen
 gtk_show_uri
 <SUBSECTION Standard>
-GtkMountOperationClass
 GTK_IS_MOUNT_OPERATION
 GTK_IS_MOUNT_OPERATION_CLASS
 GTK_MOUNT_OPERATION
@@ -7321,6 +7350,7 @@ gtk_orientable_get_type
 <FILE>gtkapplication</FILE>
 <TITLE>GtkApplication</TITLE>
 GtkApplication
+GtkApplicationClass
 
 gtk_application_new
 gtk_application_add_window
@@ -7349,7 +7379,6 @@ gtk_application_get_accels_for_action
 gtk_application_set_accels_for_action
 
 <SUBSECTION Standard>
-GtkApplicationClass
 GTK_TYPE_APPLICATION
 GTK_APPLICATION
 GTK_APPLICATION_CLASS
@@ -7365,13 +7394,13 @@ GtkApplicationPrivate
 <FILE>gtkapplicationwindow</FILE>
 <TITLE>GtkApplicationWindow</TITLE>
 GtkApplicationWindow
+GtkApplicationWindowClass
 gtk_application_window_new
 gtk_application_window_set_show_menubar
 gtk_application_window_get_show_menubar
 gtk_application_window_get_id
 
 <SUBSECTION Standard>
-GtkApplicationWindowClass
 GTK_TYPE_APPLICATION_WINDOW
 GTK_APPLICATION_WINDOW
 GTK_APPLICATION_WINDOW_CLASS
@@ -7414,6 +7443,7 @@ GTK_TYPE_ACTIONABLE
 <FILE>gtkgrid</FILE>
 <TITLE>GtkGrid</TITLE>
 GtkGrid
+GtkGridClass
 gtk_grid_new
 gtk_grid_attach
 gtk_grid_attach_next_to
@@ -7437,7 +7467,6 @@ gtk_grid_get_row_baseline_position
 gtk_grid_set_row_baseline_position
 
 <SUBSECTION Standard>
-GtkGridClass
 GTK_TYPE_GRID
 GTK_GRID
 GTK_GRID_CLASS
@@ -7453,12 +7482,12 @@ gtk_grid_get_type
 <SECTION>
 <FILE>gtkswitch</FILE>
 GtkSwitch
+GtkSwitchClass
 gtk_switch_new
 gtk_switch_set_active
 gtk_switch_get_active
 
 <SUBSECTION Standard>
-GtkSwitchClass
 GTK_TYPE_SWITCH
 GTK_SWITCH
 GTK_SWITCH_CLASS
@@ -7501,6 +7530,7 @@ GTK_IS_APP_CHOOSER_ONLINE_PK_CLASS
 <FILE>gtkappchooserbutton</FILE>
 <TITLE>GtkAppChooserButton</TITLE>
 GtkAppChooserButton
+GtkAppChooserButtonClass
 gtk_app_chooser_button_new
 gtk_app_chooser_button_append_custom_item
 gtk_app_chooser_button_append_separator
@@ -7513,7 +7543,6 @@ gtk_app_chooser_button_get_heading
 gtk_app_chooser_button_set_heading
 
 <SUBSECTION Standard>
-GtkAppChooserButtonClass
 GTK_TYPE_APP_CHOOSER_BUTTON
 GTK_APP_CHOOSER_BUTTON
 GTK_APP_CHOOSER_BUTTON_CLASS
@@ -7530,6 +7559,7 @@ gtk_app_chooser_button_get_type
 <FILE>gtkappchooserdialog</FILE>
 <TITLE>GtkAppChooserDialog</TITLE>
 GtkAppChooserDialog
+GtkAppChooserDialogClass
 gtk_app_chooser_dialog_new
 gtk_app_chooser_dialog_new_for_content_type
 gtk_app_chooser_dialog_get_widget
@@ -7537,7 +7567,6 @@ gtk_app_chooser_dialog_set_heading
 gtk_app_chooser_dialog_get_heading
 
 <SUBSECTION Standard>
-GtkAppChooserDialogClass
 GTK_TYPE_APP_CHOOSER_DIALOG
 GTK_APP_CHOOSER_DIALOG
 GTK_APP_CHOOSER_DIALOG_CLASS
@@ -7554,6 +7583,7 @@ gtk_app_chooser_dialog_get_type
 <FILE>gtkappchooserwidget</FILE>
 <TITLE>GtkAppChooserWidget</TITLE>
 GtkAppChooserWidget
+GtkAppChooserWidgetClass
 gtk_app_chooser_widget_new
 gtk_app_chooser_widget_set_show_default
 gtk_app_chooser_widget_get_show_default
@@ -7569,7 +7599,6 @@ gtk_app_chooser_widget_set_default_text
 gtk_app_chooser_widget_get_default_text
 
 <SUBSECTION Standard>
-GtkAppChooserWidgetClass
 GTK_TYPE_APP_CHOOSER_WIDGET
 GTK_APP_CHOOSER_WIDGET
 GTK_APP_CHOOSER_WIDGET_CLASS
@@ -7586,13 +7615,13 @@ gtk_app_chooser_widget_get_type
 <FILE>gtklockbutton</FILE>
 <TITLE>GtkLockButton</TITLE>
 GtkLockButton
+GtkLockButtonClass
 
 gtk_lock_button_new
 gtk_lock_button_get_permission
 gtk_lock_button_set_permission
 
 <SUBSECTION Standard>
-GtkLockButtonClass
 GTK_TYPE_LOCK_BUTTON
 GTK_LOCK_BUTTON
 GTK_IS_LOCK_BUTTON
@@ -7608,6 +7637,7 @@ GtkLockButtonPrivate
 <FILE>gtkoverlay</FILE>
 <TITLE>GtkOverlay</TITLE>
 GtkOverlay
+GtkOverlayClass
 
 gtk_overlay_new
 gtk_overlay_add_overlay
@@ -7619,7 +7649,6 @@ GTK_OVERLAY_CLASS
 GTK_IS_OVERLAY
 GTK_IS_OVERLAY_CLASS
 GTK_OVERLAY_GET_CLASS
-GtkOverlayClass
 
 <SUBSECTION Private>
 gtk_overlay_get_type
@@ -7650,6 +7679,7 @@ gtk_color_chooser_get_type
 <FILE>gtkcolorchooserwidget</FILE>
 <TITLE>GtkColorChooserWidget</TITLE>
 GtkColorChooserWidget
+GtkColorChooserWidgetClass
 gtk_color_chooser_widget_new
 
 <SUBSECTION Standard>
@@ -7773,6 +7803,7 @@ gtk_stack_switcher_get_stack
 <FILE>gtkrevealer</FILE>
 <TITLE>GtkRevealer</TITLE>
 GtkRevealer
+GtkRevealerClass
 gtk_revealer_new
 gtk_revealer_get_reveal_child
 gtk_revealer_set_reveal_child
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);
diff --git a/gtk/gtkaccelgroup.h b/gtk/gtkaccelgroup.h
index e31de4f4c0..40d3cec112 100644
--- a/gtk/gtkaccelgroup.h
+++ b/gtk/gtkaccelgroup.h
@@ -88,15 +88,25 @@ struct _GtkAccelGroup
   GtkAccelGroupPrivate *priv;
 };
 
+/**
+ * GtkAccelGroupClass:
+ * @parent_class: The parent class.
+ * @accel_changed: Signal emitted when an entry is added to or removed
+ *    from the accel group.
+ */
 struct _GtkAccelGroupClass
 {
   GObjectClass parent_class;
 
+  /*< public >*/
+
   void	(*accel_changed)	(GtkAccelGroup	*accel_group,
 				 guint           keyval,
 				 GdkModifierType modifier,
 				 GClosure       *accel_closure);
-  
+
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/gtkalignment.h b/gtk/gtkalignment.h
index e4cf345b5d..0f962c97fb 100644
--- a/gtk/gtkalignment.h
+++ b/gtk/gtkalignment.h
@@ -55,10 +55,16 @@ struct _GtkAlignment
   GtkAlignmentPrivate *priv;
 };
 
+/**
+ * GtkAlignmentClass:
+ * @parent_class: The parent class.
+ */
 struct _GtkAlignmentClass
 {
   GtkBinClass parent_class;
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/gtkappchooserbutton.h b/gtk/gtkappchooserbutton.h
index 1e9f7755c2..e737e04bb5 100644
--- a/gtk/gtkappchooserbutton.h
+++ b/gtk/gtkappchooserbutton.h
@@ -49,12 +49,23 @@ struct _GtkAppChooserButton {
   GtkAppChooserButtonPrivate *priv;
 };
 
+/**
+ * GtkAppChooserButtonClass:
+ * @parent_class: The parent class.
+ * @custom_item_activated: Signal emitted when a custom item,
+ *    previously added with gtk_app_chooser_button_append_custom_item(),
+ *    is activated from the dropdown menu.
+ */
 struct _GtkAppChooserButtonClass {
   GtkComboBoxClass parent_class;
 
+  /*< public >*/
+
   void (* custom_item_activated) (GtkAppChooserButton *self,
                                   const gchar *item_name);
 
+  /*< private >*/
+
   /* padding for future class expansion */
   gpointer padding[16];
 };
diff --git a/gtk/gtkappchooserdialog.h b/gtk/gtkappchooserdialog.h
index d222298bb6..f2af4954fc 100644
--- a/gtk/gtkappchooserdialog.h
+++ b/gtk/gtkappchooserdialog.h
@@ -52,9 +52,15 @@ struct _GtkAppChooserDialog {
   GtkAppChooserDialogPrivate *priv;
 };
 
+/**
+ * GtkAppChooserDialogClass:
+ * @parent_class: The parent class.
+ */
 struct _GtkAppChooserDialogClass {
   GtkDialogClass parent_class;
 
+  /*< private >*/
+
   /* padding for future class expansion */
   gpointer padding[16];
 };
diff --git a/gtk/gtkappchooserwidget.h b/gtk/gtkappchooserwidget.h
index 27067128e4..19aba13701 100644
--- a/gtk/gtkappchooserwidget.h
+++ b/gtk/gtkappchooserwidget.h
@@ -53,9 +53,21 @@ struct _GtkAppChooserWidget {
   GtkAppChooserWidgetPrivate *priv;
 };
 
+/**
+ * GtkAppChooserWidgetClass:
+ * @parent_class: The parent class.
+ * @application_selected: Signal emitted when an application item is
+ *    selected from the widget's list.
+ * @application_activated: Signal emitted when an application item is
+ *    activated from the widget's list.
+ * @populate_popup: Signal emitted when a context menu is about to
+ *    popup over an application item.
+ */
 struct _GtkAppChooserWidgetClass {
   GtkBoxClass parent_class;
 
+  /*< public >*/
+
   void (* application_selected)  (GtkAppChooserWidget *self,
                                   GAppInfo            *app_info);
 
@@ -66,6 +78,8 @@ struct _GtkAppChooserWidgetClass {
                                   GtkMenu             *menu,
                                   GAppInfo            *app_info);
 
+  /*< private >*/
+
   /* padding for future class expansion */
   gpointer padding[16];
 };
diff --git a/gtk/gtkapplication.h b/gtk/gtkapplication.h
index 2d12039e09..c08f2dc373 100644
--- a/gtk/gtkapplication.h
+++ b/gtk/gtkapplication.h
@@ -48,10 +48,21 @@ struct _GtkApplication
   GtkApplicationPrivate *priv;
 };
 
+/**
+ * GtkApplicationClass:
+ * @parent_class: The parent class.
+ * @window_added: Signal emitted when a #GtkWindow is added to
+ *    application through gtk_application_add_window().
+ * @window_removed: Signal emitted when a #GtkWindow is removed from
+ *    application, either as a side-effect of being destroyed or
+ *    explicitly through gtk_application_remove_window().
+ */
 struct _GtkApplicationClass
 {
   GApplicationClass parent_class;
 
+  /*< public >*/
+
   void (*window_added)   (GtkApplication *application,
                           GtkWindow      *window);
   void (*window_removed) (GtkApplication *application,
diff --git a/gtk/gtkapplicationwindow.h b/gtk/gtkapplicationwindow.h
index 32fd068f98..f0654b3bdc 100644
--- a/gtk/gtkapplicationwindow.h
+++ b/gtk/gtkapplicationwindow.h
@@ -48,6 +48,10 @@ struct _GtkApplicationWindow
   GtkApplicationWindowPrivate *priv;
 };
 
+/**
+ * GtkApplicationWindowClass:
+ * @parent_class: The parent class.
+ */
 struct _GtkApplicationWindowClass
 {
   GtkWindowClass parent_class;
diff --git a/gtk/gtkaspectframe.h b/gtk/gtkaspectframe.h
index 3a54623105..be06f1fb18 100644
--- a/gtk/gtkaspectframe.h
+++ b/gtk/gtkaspectframe.h
@@ -54,10 +54,16 @@ struct _GtkAspectFrame
   GtkAspectFramePrivate *priv;
 };
 
+/**
+ * GtkAspectFrameClass:
+ * @parent_class: The parent class.
+ */
 struct _GtkAspectFrameClass
 {
   GtkFrameClass parent_class;
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/gtkassistant.h b/gtk/gtkassistant.h
index ef94067263..c41b02a350 100644
--- a/gtk/gtkassistant.h
+++ b/gtk/gtkassistant.h
@@ -89,15 +89,27 @@ struct _GtkAssistant
   GtkAssistantPrivate *priv;
 };
 
+/**
+ * GtkAssistantClass:
+ * @parent_class: The parent class.
+ * @prepare: Signal emitted when a new page is set as the assistant's current page, before making the new page visible.
+ * @apply: Signal emitted when the apply button is clicked.
+ * @close: Signal emitted either when the close button or last page apply button is clicked.
+ * @cancel: Signal emitted when the cancel button is clicked.
+ */
 struct _GtkAssistantClass
 {
   GtkWindowClass parent_class;
 
+  /*< public >*/
+
   void (* prepare) (GtkAssistant *assistant, GtkWidget *page);
   void (* apply)   (GtkAssistant *assistant);
   void (* close)   (GtkAssistant *assistant);
   void (* cancel)  (GtkAssistant *assistant);
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/gtkbbox.h b/gtk/gtkbbox.h
index 36cc39422e..98d55c36bb 100644
--- a/gtk/gtkbbox.h
+++ b/gtk/gtkbbox.h
@@ -54,10 +54,16 @@ struct _GtkButtonBox
   GtkButtonBoxPrivate *priv;
 };
 
+/**
+ * GtkButtonBoxClass:
+ * @parent_class: The parent class.
+ */
 struct _GtkButtonBoxClass
 {
   GtkBoxClass parent_class;
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/gtkbin.h b/gtk/gtkbin.h
index 6f8949ae57..bca7885c5b 100644
--- a/gtk/gtkbin.h
+++ b/gtk/gtkbin.h
@@ -55,10 +55,16 @@ struct _GtkBin
   GtkBinPrivate *priv;
 };
 
+/**
+ * GtkBinClass:
+ * @parent_class: The parent class.
+ */
 struct _GtkBinClass
 {
   GtkContainerClass parent_class;
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/gtkbox.h b/gtk/gtkbox.h
index 9a79fbcd47..bed154794b 100644
--- a/gtk/gtkbox.h
+++ b/gtk/gtkbox.h
@@ -56,10 +56,16 @@ struct _GtkBox
   GtkBoxPrivate *priv;
 };
 
+/**
+ * GtkBoxClass:
+ * @parent_class: The parent class.
+ */
 struct _GtkBoxClass
 {
   GtkContainerClass parent_class;
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/gtkbutton.h b/gtk/gtkbutton.h
index 18379889fa..70ce41e0be 100644
--- a/gtk/gtkbutton.h
+++ b/gtk/gtkbutton.h
@@ -55,17 +55,33 @@ struct _GtkButton
   GtkButtonPrivate *priv;
 };
 
+/**
+ * GtkButtonClass:
+ * @parent_class: The parent class.
+ * @pressed: Signal emitted when the button is pressed. Deprecated: 2.8.
+ * @released: Signal emitted when the button is released. Deprecated: 2.8.
+ * @clicked: Signal emitted when the button has been activated (pressed and released).
+ * @enter: Signal emitted when the pointer enters the button. Deprecated: 2.8.
+ * @leave: Signal emitted when the pointer leaves the button. Deprecated: 2.8.
+ * @activate: Signal that causes the button to animate press then
+ *    release. Applications should never connect to this signal, but use
+ *    the @clicked signal.
+ */
 struct _GtkButtonClass
 {
   GtkBinClass        parent_class;
-  
+
+  /*< public >*/
+
   void (* pressed)  (GtkButton *button);
   void (* released) (GtkButton *button);
   void (* clicked)  (GtkButton *button);
   void (* enter)    (GtkButton *button);
   void (* leave)    (GtkButton *button);
   void (* activate) (GtkButton *button);
-  
+
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/gtkcellareabox.h b/gtk/gtkcellareabox.h
index 7339b9fb1a..2784a02ad7 100644
--- a/gtk/gtkcellareabox.h
+++ b/gtk/gtkcellareabox.h
@@ -49,6 +49,9 @@ struct _GtkCellAreaBox
   GtkCellAreaBoxPrivate *priv;
 };
 
+/**
+ * GtkCellAreaBoxClass:
+ */
 struct _GtkCellAreaBoxClass
 {
   /*< private >*/
diff --git a/gtk/gtkcellrenderer.h b/gtk/gtkcellrenderer.h
index 59d85251a6..afa45ecf51 100644
--- a/gtk/gtkcellrenderer.h
+++ b/gtk/gtkcellrenderer.h
@@ -90,10 +90,29 @@ struct _GtkCellRenderer
   GtkCellRendererPrivate *priv;
 };
 
+/**
+ * GtkCellRendererClass:
+ * @get_request_mode: Called to gets whether the cell renderer prefers
+ *    a height-for-width layout or a width-for-height layout.
+ * @get_preferred_width: Called to get a renderer's natural width.
+ * @get_preferred_height_for_width: Called to get a renderer's natural height for width.
+ * @get_preferred_height: Called to get a renderer's natural height.
+ * @get_preferred_width_for_height: Called to get a renderer's natural width for height.
+ * @get_aligned_area: Called to get the aligned area used by @cell inside @cell_area.
+ * @get_size: Called to get the width and height needed to render the cell. Deprecated: 3.0.
+ * @render: Called to render the content of the #GtkCellRenderer.
+ * @activate: Called to activate the content of the #GtkCellRenderer.
+ * @start_editing: Called to initiate editing the content of the #GtkCellRenderer.
+ * @editing_canceled: Signal gets emitted when the user cancels the process of editing a cell.
+ * @editing_started: Signal gets emitted when a cell starts to be edited.
+ */
 struct _GtkCellRendererClass
 {
+  /*< private >*/
   GInitiallyUnownedClass parent_class;
 
+  /*< public >*/
+
   /* vtable - not signals */
   GtkSizeRequestMode (* get_request_mode)                (GtkCellRenderer      *cell);
   void               (* get_preferred_width)             (GtkCellRenderer      *cell,
@@ -153,6 +172,8 @@ struct _GtkCellRendererClass
 			     GtkCellEditable *editable,
 			     const gchar     *path);
 
+  /*< private >*/
+
   GtkCellRendererClassPrivate *priv;
 
   /* Padding for future expansion */
diff --git a/gtk/gtkcellview.h b/gtk/gtkcellview.h
index 071ca73a1b..af82655545 100644
--- a/gtk/gtkcellview.h
+++ b/gtk/gtkcellview.h
@@ -49,10 +49,16 @@ struct _GtkCellView
   GtkCellViewPrivate *priv;
 };
 
+/**
+ * GtkCellViewClass:
+ * @parent_class: The parent class.
+ */
 struct _GtkCellViewClass
 {
   GtkWidgetClass parent_class;
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/gtkcheckmenuitem.h b/gtk/gtkcheckmenuitem.h
index 2e67f7d8e3..f791038055 100644
--- a/gtk/gtkcheckmenuitem.h
+++ b/gtk/gtkcheckmenuitem.h
@@ -55,14 +55,24 @@ struct _GtkCheckMenuItem
   GtkCheckMenuItemPrivate *priv;
 };
 
+/**
+ * GtkCheckMenuItemClass:
+ * @parent_class: The parent class.
+ * @toggled: Signal emitted when the state of the check box is changed.
+ * @draw_indicator: Called to draw the check indicator.
+ */
 struct _GtkCheckMenuItemClass
 {
   GtkMenuItemClass parent_class;
 
+  /*< public >*/
+
   void (* toggled)	  (GtkCheckMenuItem *check_menu_item);
   void (* draw_indicator) (GtkCheckMenuItem *check_menu_item,
 			   cairo_t          *cr);
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/gtkcolorchooserwidget.h b/gtk/gtkcolorchooserwidget.h
index f47bc3084b..b47cdd0ad3 100644
--- a/gtk/gtkcolorchooserwidget.h
+++ b/gtk/gtkcolorchooserwidget.h
@@ -45,10 +45,16 @@ struct _GtkColorChooserWidget
   GtkColorChooserWidgetPrivate *priv;
 };
 
+/**
+ * GtkColorChooserWidgetClass:
+ * @parent_class: The parent class.
+ */
 struct _GtkColorChooserWidgetClass
 {
   GtkBoxClass parent_class;
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/gtkcombobox.h b/gtk/gtkcombobox.h
index c3c89196a6..a4277121a2 100644
--- a/gtk/gtkcombobox.h
+++ b/gtk/gtkcombobox.h
@@ -47,15 +47,26 @@ struct _GtkComboBox
   GtkComboBoxPrivate *priv;
 };
 
+/**
+ * GtkComboBoxClass:
+ * @parent_class: The parent class.
+ * @changed: Signal is emitted when the active item is changed.
+ * @format_entry_text: Signal which allows you to change how the text
+ *    displayed in a combo box's entry is displayed.
+ */
 struct _GtkComboBoxClass
 {
   GtkBinClass parent_class;
 
+  /*< public >*/
+
   /* signals */
   void     (* changed)           (GtkComboBox *combo_box);
   gchar   *(* format_entry_text) (GtkComboBox *combo_box,
 				  const gchar *path);
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/gtkcontainer.h b/gtk/gtkcontainer.h
index 0a1f7b68dc..56db9f7687 100644
--- a/gtk/gtkcontainer.h
+++ b/gtk/gtkcontainer.h
@@ -55,10 +55,28 @@ struct _GtkContainer
   GtkContainerPrivate *priv;
 };
 
+/**
+ * GtkContainerClass:
+ * @parent_class: The parent class.
+ * @add: Signal emitted when a widget is added to container.
+ * @remove: Signal emitted when a widget is removed from container.
+ * @check_resize: Signal emitted when a size recalculation is needed.
+ * @forall: Invokes callback on each child of container.
+ * @set_focus_child: Sets the focused child of container.
+ * @child_type: Returns the type of the children supported by the container.
+ * @composite_name: Gets a widget's composite name. Deprecated: 3.10.
+ * @set_child_property: Set a property on a child of container.
+ * @get_path_for_child: Get path representing entire widget hierarchy
+ *    from the toplevel down to and including @child.
+ *
+ * Base class for containers.
+ */
 struct _GtkContainerClass
 {
   GtkWidgetClass parent_class;
 
+  /*< public >*/
+
   void    (*add)       		(GtkContainer	 *container,
 				 GtkWidget	 *widget);
   void    (*remove)    		(GtkContainer	 *container,
diff --git a/gtk/gtkcustompaperunixdialog.h b/gtk/gtkcustompaperunixdialog.h
index 063df8e760..60566b15e8 100644
--- a/gtk/gtkcustompaperunixdialog.h
+++ b/gtk/gtkcustompaperunixdialog.h
@@ -41,10 +41,16 @@ struct _GtkCustomPaperUnixDialog
   GtkCustomPaperUnixDialogPrivate *priv;
 };
 
+/**
+ * GtkCustomPaperUnixDialogClass:
+ * @parent_class: The parent class.
+ */
 struct _GtkCustomPaperUnixDialogClass
 {
   GtkDialogClass parent_class;
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/gtkdialog.h b/gtk/gtkdialog.h
index 3761f7dc6c..3e6945bfa9 100644
--- a/gtk/gtkdialog.h
+++ b/gtk/gtkdialog.h
@@ -114,16 +114,26 @@ struct _GtkDialog
   GtkDialogPrivate *priv;
 };
 
+/**
+ * GtkDialogClass:
+ * @parent_class: The parent class.
+ * @response: Signal emitted when an action widget is activated.
+ * @close: Signal emitted when the user uses a keybinding to close the dialog.
+ */
 struct _GtkDialogClass
 {
   GtkWindowClass parent_class;
 
+  /*< public >*/
+
   void (* response) (GtkDialog *dialog, gint response_id);
 
   /* Keybinding signals */
 
   void (* close)    (GtkDialog *dialog);
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/gtkeventbox.h b/gtk/gtkeventbox.h
index 3548da09ad..3129ae16cc 100644
--- a/gtk/gtkeventbox.h
+++ b/gtk/gtkeventbox.h
@@ -54,10 +54,16 @@ struct _GtkEventBox
   GtkEventBoxPrivate *priv;
 };
 
+/**
+ * GtkEventBoxClass:
+ * @parent_class: The parent class.
+ */
 struct _GtkEventBoxClass
 {
   GtkBinClass parent_class;
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/gtkexpander.h b/gtk/gtkexpander.h
index a70f844e4c..085c4480e3 100644
--- a/gtk/gtkexpander.h
+++ b/gtk/gtkexpander.h
@@ -48,15 +48,24 @@ struct _GtkExpander
   GtkExpanderPrivate *priv;
 };
 
+/**
+ * GtkExpanderClass:
+ * @parent_class: The parent class.
+ * @activate: Keybinding signal is emitted when the user hits the Enter key.
+ */
 struct _GtkExpanderClass
 {
   GtkBinClass    parent_class;
 
+  /*< public >*/
+
   /* Key binding signal; to get notification on the expansion
    * state connect to notify:expanded.
    */
   void        (* activate) (GtkExpander *expander);
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/gtkfilechooserbutton.h b/gtk/gtkfilechooserbutton.h
index f8e1606968..9d6ffa6e8c 100644
--- a/gtk/gtkfilechooserbutton.h
+++ b/gtk/gtkfilechooserbutton.h
@@ -47,13 +47,21 @@ struct _GtkFileChooserButton
   GtkFileChooserButtonPrivate *priv;
 };
 
+/**
+ * GtkFileChooserButtonClass:
+ * @parent_class: The parent class.
+ * @file_set: Signal emitted when the user selects a file.
+ */
 struct _GtkFileChooserButtonClass
 {
-  /*< private >*/
   GtkBoxClass parent_class;
 
+  /*< public >*/
+
   void (* file_set) (GtkFileChooserButton *fc);
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*__gtk_reserved1);
   void (*__gtk_reserved2);
diff --git a/gtk/gtkfilechooserwidget.h b/gtk/gtkfilechooserwidget.h
index 5d9d89892f..617cfd3e93 100644
--- a/gtk/gtkfilechooserwidget.h
+++ b/gtk/gtkfilechooserwidget.h
@@ -46,10 +46,16 @@ struct _GtkFileChooserWidget
   GtkFileChooserWidgetPrivate *priv;
 };
 
+/**
+ * GtkFileChooserWidgetClass:
+ * @parent_class: The parent class.
+ */
 struct _GtkFileChooserWidgetClass
 {
   GtkBoxClass parent_class;
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/gtkfontchooserdialog.h b/gtk/gtkfontchooserdialog.h
index d4a18e5826..c830d36b38 100644
--- a/gtk/gtkfontchooserdialog.h
+++ b/gtk/gtkfontchooserdialog.h
@@ -45,10 +45,16 @@ struct _GtkFontChooserDialog
   GtkFontChooserDialogPrivate *priv;
 };
 
+/**
+ * GtkFontChooserDialogClass:
+ * @parent_class: The parent class.
+ */
 struct _GtkFontChooserDialogClass
 {
   GtkDialogClass parent_class;
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/gtkfontchooserwidget.h b/gtk/gtkfontchooserwidget.h
index 662f9326e8..ae4a764adf 100644
--- a/gtk/gtkfontchooserwidget.h
+++ b/gtk/gtkfontchooserwidget.h
@@ -45,10 +45,16 @@ struct _GtkFontChooserWidget
   GtkFontChooserWidgetPrivate *priv;
 };
 
+/**
+ * GtkFontChooserWidgetClass:
+ * @parent_class: The parent class.
+ */
 struct _GtkFontChooserWidgetClass
 {
   GtkBoxClass parent_class;
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/gtkframe.h b/gtk/gtkframe.h
index e8ac219f3f..0237da9709 100644
--- a/gtk/gtkframe.h
+++ b/gtk/gtkframe.h
@@ -55,12 +55,21 @@ struct _GtkFrame
   GtkFramePrivate *priv;
 };
 
+/**
+ * GtkFrameClass:
+ * @parent_class: The parent class.
+ * @compute_child_allocation:
+ */
 struct _GtkFrameClass
 {
   GtkBinClass parent_class;
 
+  /*< public >*/
+
   void (*compute_child_allocation) (GtkFrame *frame, GtkAllocation *allocation);
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/gtkgrid.h b/gtk/gtkgrid.h
index 4266eda5a9..168face068 100644
--- a/gtk/gtkgrid.h
+++ b/gtk/gtkgrid.h
@@ -49,10 +49,16 @@ struct _GtkGrid
   GtkGridPrivate *priv;
 };
 
+/**
+ * GtkGridClass:
+ * @parent_class: The parent class.
+ */
 struct _GtkGridClass
 {
   GtkContainerClass parent_class;
 
+  /*< private >*/
+
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
   void (*_gtk_reserved3) (void);
diff --git a/gtk/gtkicontheme.h b/gtk/gtkicontheme.h
index b95b03bb07..cb1368af44 100644
--- a/gtk/gtkicontheme.h
+++ b/gtk/gtkicontheme.h
@@ -73,12 +73,23 @@ struct _GtkIconTheme
   GtkIconThemePrivate *priv;
 };
 
+/**
+ * GtkIconThemeClass:
+ * @parent_class: The parent class.
+ * @changed: Signal emitted when the current icon theme is switched or
+ *    GTK+ detects that a change has occurred in the contents of the
+ *    current icon theme.
+ */
 struct _GtkIconThemeClass
 {
   GObjectClass parent_class;
 
+  /*< public >*/
+
   void (* changed)  (GtkIconTheme *icon_theme);
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/gtklistbox.h b/gtk/gtklistbox.h
index 35cdc09a1a..7b2a832032 100644
--- a/gtk/gtklistbox.h
+++ b/gtk/gtklistbox.h
@@ -49,10 +49,21 @@ struct _GtkListBox
   GtkContainer parent_instance;
 };
 
+/**
+ * GtkListBoxClass:
+ * @parent_class: The parent class.
+ * @row_selected: Signal emitted when a new row is selected.
+ * @row_activated: Signal emitted when a row has been activated by the user.
+ * @activate_cursor_row: 
+ * @toggle_cursor_row: 
+ * @move_cursor: 
+ */
 struct _GtkListBoxClass
 {
   GtkContainerClass parent_class;
 
+  /*< public >*/
+
   void (*row_selected)        (GtkListBox      *list_box,
                                GtkListBoxRow   *row);
   void (*row_activated)       (GtkListBox      *list_box,
@@ -63,6 +74,8 @@ struct _GtkListBoxClass
                                GtkMovementStep  step,
                                gint             count);
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
@@ -84,12 +97,21 @@ struct _GtkListBoxRow
   GtkBin parent_instance;
 };
 
+/**
+ * GtkListBoxRowClass:
+ * @parent_class: The parent class.
+ * @activate: 
+ */
 struct _GtkListBoxRowClass
 {
   GtkBinClass parent_class;
 
+  /*< public >*/
+
   void (* activate) (GtkListBoxRow *row);
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/gtklockbutton.h b/gtk/gtklockbutton.h
index 1d089733b1..cc7e23013f 100644
--- a/gtk/gtklockbutton.h
+++ b/gtk/gtklockbutton.h
@@ -42,10 +42,16 @@ struct _GtkLockButton
   GtkLockButtonPrivate *priv;
 };
 
+/**
+ * GtkLockButtonClass:
+ * @parent_class: The parent class.
+ */
 struct _GtkLockButtonClass
 {
   GtkButtonClass parent_class;
 
+  /*< private >*/
+
   void (*reserved0) (void);
   void (*reserved1) (void);
   void (*reserved2) (void);
diff --git a/gtk/gtkmenuitem.h b/gtk/gtkmenuitem.h
index 24c87838b0..70dbfd1bc9 100644
--- a/gtk/gtkmenuitem.h
+++ b/gtk/gtkmenuitem.h
@@ -54,10 +54,25 @@ struct _GtkMenuItem
   GtkMenuItemPrivate *priv;
 };
 
+/**
+ * GtkMenuItemClass:
+ * @parent_class: The parent class.
+ * @activate: Signal emitted when the item is activated.
+ * @activate_item: Signal emitted when the item is activated, but also
+ *    if the menu item has a submenu.
+ * @toggle_size_request: 
+ * @toggle_size_allocate: 
+ * @set_label: Sets @text on the #GtkMenuItem label
+ * @get_label: Gets @text from the #GtkMenuItem label
+ * @select: Signal emitted when the item is selected.
+ * @deselect: Signal emitted when the item is deselected.
+ */
 struct _GtkMenuItemClass
 {
   GtkBinClass parent_class;
 
+  /*< public >*/
+
   /* If the following flag is true, then we should always
    * hide the menu when the MenuItem is activated. Otherwise,
    * it is up to the caller. For instance, when navigating
@@ -79,6 +94,8 @@ struct _GtkMenuItemClass
   void (* select)               (GtkMenuItem *menu_item);
   void (* deselect)             (GtkMenuItem *menu_item);
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/gtkmenutoolbutton.h b/gtk/gtkmenutoolbutton.h
index 110febcbdd..71a5d64a4c 100644
--- a/gtk/gtkmenutoolbutton.h
+++ b/gtk/gtkmenutoolbutton.h
@@ -48,12 +48,21 @@ struct _GtkMenuToolButton
   GtkMenuToolButtonPrivate *priv;
 };
 
+/**
+ * GtkMenuToolButtonClass:
+ * @parent_class: The parent class.
+ * @show_menu: Signal emitted before the menu is shown.
+ */
 struct _GtkMenuToolButtonClass
 {
   GtkToolButtonClass parent_class;
 
+  /*< public >*/
+
   void (*show_menu) (GtkMenuToolButton *button);
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/gtkmountoperation.h b/gtk/gtkmountoperation.h
index 7648300fe5..976cb44bff 100644
--- a/gtk/gtkmountoperation.h
+++ b/gtk/gtkmountoperation.h
@@ -54,10 +54,16 @@ struct _GtkMountOperation
   GtkMountOperationPrivate *priv;
 };
 
+/**
+ * GtkMountOperationClass:
+ * @parent_class: The parent class.
+ */
 struct _GtkMountOperationClass
 {
   GMountOperationClass parent_class;
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/gtkoffscreenwindow.h b/gtk/gtkoffscreenwindow.h
index 1fc4782c21..2434558986 100644
--- a/gtk/gtkoffscreenwindow.h
+++ b/gtk/gtkoffscreenwindow.h
@@ -42,10 +42,16 @@ struct _GtkOffscreenWindow
   GtkWindow parent_object;
 };
 
+/**
+ * GtkOffscreenWindowClass:
+ * @parent_class: The parent class.
+ */
 struct _GtkOffscreenWindowClass
 {
   GtkWindowClass parent_class;
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/gtkoverlay.h b/gtk/gtkoverlay.h
index 1f8883bc6b..32e3f391d3 100644
--- a/gtk/gtkoverlay.h
+++ b/gtk/gtkoverlay.h
@@ -47,14 +47,24 @@ struct _GtkOverlay
   GtkOverlayPrivate *priv;
 };
 
+/**
+ * GtkOverlayClass:
+ * @parent_class: The parent class.
+ * @get_child_position: Signal emitted to determine the position and
+ *    size of any overlay child widgets.
+ */
 struct _GtkOverlayClass
 {
   GtkBinClass parent_class;
 
+  /*< public >*/
+
   gboolean (*get_child_position) (GtkOverlay    *overlay,
                                   GtkWidget     *widget,
                                   GtkAllocation *allocation);
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/gtkpagesetupunixdialog.h b/gtk/gtkpagesetupunixdialog.h
index 8b0748e36d..1bf4c7c41a 100644
--- a/gtk/gtkpagesetupunixdialog.h
+++ b/gtk/gtkpagesetupunixdialog.h
@@ -45,10 +45,16 @@ struct _GtkPageSetupUnixDialog
   GtkPageSetupUnixDialogPrivate *priv;
 };
 
+/**
+ * GtkPageSetupUnixDialogClass:
+ * @parent_class: The parent class.
+ */
 struct _GtkPageSetupUnixDialogClass
 {
   GtkDialogClass parent_class;
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/gtkprintoperation.h b/gtk/gtkprintoperation.h
index 5269f89438..fdafdac886 100644
--- a/gtk/gtkprintoperation.h
+++ b/gtk/gtkprintoperation.h
@@ -125,10 +125,34 @@ struct _GtkPrintOperation
   GtkPrintOperationPrivate *priv;
 };
 
+/**
+ * GtkPrintOperationClass:
+ * @parent_class: The parent class.
+ * @done: Signal emitted when the print operation run has finished
+ *    doing everything required for printing.
+ * @begin_print: Signal emitted after the user has finished changing
+ *    print settings in the dialog, before the actual rendering starts.
+ * @paginate: Signal emitted after the "begin-print" signal, but
+ *    before the actual rendering starts.
+ * @request_page_setup: Emitted once for every page that is printed,
+ *    to give the application a chance to modify the page setup.
+ * @draw_page: Signal emitted for every page that is printed.
+ * @end_print: Signal emitted after all pages have been rendered.
+ * @status_changed: Emitted at between the various phases of the print
+ *    operation.
+ * @create_custom_widget: Signal emitted when displaying the print dialog.
+ * @custom_widget_apply: Signal emitted right before "begin-print" if
+ *    you added a custom widget in the "create-custom-widget" handler.
+ * @preview: Signal emitted when a preview is requested from the
+ *    native dialog.
+ * @update_custom_widget: Emitted after change of selected printer.
+ */
 struct _GtkPrintOperationClass
 {
   GObjectClass parent_class;
 
+  /*< public >*/
+
   void     (*done)               (GtkPrintOperation *operation,
                                   GtkPrintOperationResult result);
   void     (*begin_print)        (GtkPrintOperation *operation,
@@ -160,6 +184,8 @@ struct _GtkPrintOperationClass
                                     GtkPageSetup      *setup,
                                     GtkPrintSettings  *settings);
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/gtkrevealer.h b/gtk/gtkrevealer.h
index 684e7c59c4..f37a282447 100644
--- a/gtk/gtkrevealer.h
+++ b/gtk/gtkrevealer.h
@@ -50,6 +50,10 @@ struct _GtkRevealer {
   GtkBin parent_instance;
 };
 
+/**
+ * GtkRevealerClass:
+ * @parent_class: The parent class.
+ */
 struct _GtkRevealerClass {
   GtkBinClass parent_class;
 };
diff --git a/gtk/gtkscrolledwindow.h b/gtk/gtkscrolledwindow.h
index be62c8d801..503b3d707e 100644
--- a/gtk/gtkscrolledwindow.h
+++ b/gtk/gtkscrolledwindow.h
@@ -53,12 +53,23 @@ struct _GtkScrolledWindow
   GtkScrolledWindowPrivate *priv;
 };
 
+/**
+ * GtkScrolledWindowClass:
+ * @parent_class: The parent class.
+ * @scrollbar_spacing: 
+ * @scroll_child: Keybinding signal which gets emitted when a
+ *    keybinding that scrolls is pressed.
+ * @move_focus_out: Keybinding signal which gets emitted when focus is
+ *    moved away from the scrolled window by a keybinding.
+ */
 struct _GtkScrolledWindowClass
 {
   GtkBinClass parent_class;
 
   gint scrollbar_spacing;
 
+  /*< public >*/
+
   /* Action signals for keybindings. Do not connect to these signals
    */
 
@@ -73,6 +84,8 @@ struct _GtkScrolledWindowClass
   void (* move_focus_out) (GtkScrolledWindow *scrolled_window,
 			   GtkDirectionType   direction);
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/gtksearchbar.h b/gtk/gtksearchbar.h
index ea3ae851bc..0d8b075b1f 100644
--- a/gtk/gtksearchbar.h
+++ b/gtk/gtksearchbar.h
@@ -52,11 +52,16 @@ struct _GtkSearchBar
   GtkBin parent;
 };
 
+/**
+ * GtkSearchBarClass:
+ * @parent_class: The parent class.
+ */
 struct _GtkSearchBarClass
 {
-  /*< private >*/
   GtkBinClass parent_class;
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/gtkseparatormenuitem.h b/gtk/gtkseparatormenuitem.h
index 98e4c562e0..321c5b4727 100644
--- a/gtk/gtkseparatormenuitem.h
+++ b/gtk/gtkseparatormenuitem.h
@@ -51,10 +51,16 @@ struct _GtkSeparatorMenuItem
   GtkMenuItem menu_item;
 };
 
+/**
+ * GtkSeparatorMenuItemClass:
+ * @parent_class: The parent class.
+ */
 struct _GtkSeparatorMenuItemClass
 {
   GtkMenuItemClass parent_class;
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/gtkseparatortoolitem.h b/gtk/gtkseparatortoolitem.h
index 5513f835bd..2fff9e4fcd 100644
--- a/gtk/gtkseparatortoolitem.h
+++ b/gtk/gtkseparatortoolitem.h
@@ -47,10 +47,16 @@ struct _GtkSeparatorToolItem
   GtkSeparatorToolItemPrivate *priv;
 };
 
+/**
+ * GtkSeparatorToolItemClass:
+ * @parent_class: The parent class.
+ */
 struct _GtkSeparatorToolItemClass
 {
   GtkToolItemClass parent_class;
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (* _gtk_reserved1) (void);
   void (* _gtk_reserved2) (void);
diff --git a/gtk/gtkswitch.h b/gtk/gtkswitch.h
index 539d9e82da..9804f4f474 100644
--- a/gtk/gtkswitch.h
+++ b/gtk/gtkswitch.h
@@ -61,17 +61,19 @@ struct _GtkSwitch
 
 /**
  * GtkSwitchClass:
- *
- * The <structname>GtkSwitchClass</structname> structure contains only
- * private data.
+ * @parent_class: The parent class.
+ * @activate: An action signal and emitting it causes the switch to animate.
  */
 struct _GtkSwitchClass
 {
-  /*< private >*/
   GtkWidgetClass parent_class;
 
+  /*< public >*/
+
   void (* activate) (GtkSwitch *sw);
 
+  /*< private >*/
+
   void (* _switch_padding_1) (void);
   void (* _switch_padding_2) (void);
   void (* _switch_padding_3) (void);
diff --git a/gtk/gtkthemingengine.h b/gtk/gtkthemingengine.h
index f75464a932..a60677497d 100644
--- a/gtk/gtkthemingengine.h
+++ b/gtk/gtkthemingengine.h
@@ -78,6 +78,8 @@ struct _GtkThemingEngineClass
 {
   GObjectClass parent_class;
 
+  /*< public >*/
+
   void (* render_line) (GtkThemingEngine *engine,
                         cairo_t          *cr,
                         gdouble           x0,
diff --git a/gtk/gtktoggletoolbutton.h b/gtk/gtktoggletoolbutton.h
index 975a4c19c3..8fb263ffb3 100644
--- a/gtk/gtktoggletoolbutton.h
+++ b/gtk/gtktoggletoolbutton.h
@@ -48,13 +48,22 @@ struct _GtkToggleToolButton
   GtkToggleToolButtonPrivate *priv;
 };
 
+/**
+ * GtkToggleToolButtonClass:
+ * @parent_class: The parent class.
+ * @toggled: Signal emitted whenever the toggle tool button changes state.
+ */
 struct _GtkToggleToolButtonClass
 {
   GtkToolButtonClass parent_class;
 
+  /*< public >*/
+
   /* signal */
   void (* toggled) (GtkToggleToolButton *button);
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (* _gtk_reserved1) (void);
   void (* _gtk_reserved2) (void);
diff --git a/gtk/gtktoolbutton.h b/gtk/gtktoolbutton.h
index 47b4b0a1a0..574c2eb636 100644
--- a/gtk/gtktoolbutton.h
+++ b/gtk/gtktoolbutton.h
@@ -48,15 +48,26 @@ struct _GtkToolButton
   GtkToolButtonPrivate *priv;
 };
 
+/**
+ * GtkToolButtonClass:
+ * @parent_class: The parent class.
+ * @button_type: 
+ * @clicked: Signal emitted when the tool button is clicked with the
+ *    mouse or activated with the keyboard.
+ */
 struct _GtkToolButtonClass
 {
   GtkToolItemClass parent_class;
 
   GType button_type;
 
+  /*< public >*/
+
   /* signal */
   void       (* clicked)             (GtkToolButton    *tool_item);
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (* _gtk_reserved1) (void);
   void (* _gtk_reserved2) (void);
diff --git a/gtk/gtktoolitem.h b/gtk/gtktoolitem.h
index 376239f169..4f2436472e 100644
--- a/gtk/gtktoolitem.h
+++ b/gtk/gtktoolitem.h
@@ -50,6 +50,15 @@ struct _GtkToolItem
   GtkToolItemPrivate *priv;
 };
 
+/**
+ * GtkToolItemClass:
+ * @parent_class: The parent class.
+ * @create_menu_proxy: Signal emitted when the toolbar needs
+ *    information from tool_item about whether the item should appear in
+ *    the toolbar overflow menu.
+ * @toolbar_reconfigured: Signal emitted when some property of the
+ *    toolbar that the item is a child of changes.
+ */
 struct _GtkToolItemClass
 {
   GtkBinClass parent_class;
@@ -58,6 +67,8 @@ struct _GtkToolItemClass
   gboolean   (* create_menu_proxy)    (GtkToolItem *tool_item);
   void       (* toolbar_reconfigured) (GtkToolItem *tool_item);
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (* _gtk_reserved1) (void);
   void (* _gtk_reserved2) (void);
diff --git a/gtk/gtktoolitemgroup.h b/gtk/gtktoolitemgroup.h
index dbe5cf57d1..34bef6503a 100644
--- a/gtk/gtktoolitemgroup.h
+++ b/gtk/gtktoolitemgroup.h
@@ -52,10 +52,16 @@ struct _GtkToolItemGroup
   GtkToolItemGroupPrivate *priv;
 };
 
+/**
+ * GtkToolItemGroupClass:
+ * @parent_class: The parent class.
+ */
 struct _GtkToolItemGroupClass
 {
   GtkContainerClass parent_class;
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/gtktoolpalette.h b/gtk/gtktoolpalette.h
index 721db21f92..8595dba3c0 100644
--- a/gtk/gtktoolpalette.h
+++ b/gtk/gtktoolpalette.h
@@ -67,10 +67,16 @@ struct _GtkToolPalette
   GtkToolPalettePrivate *priv;
 };
 
+/**
+ * GtkToolPaletteClass:
+ * @parent_class: The parent class.
+ */
 struct _GtkToolPaletteClass
 {
   GtkContainerClass parent_class;
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/gtktreeselection.h b/gtk/gtktreeselection.h
index 379961e2c2..be1567f0df 100644
--- a/gtk/gtktreeselection.h
+++ b/gtk/gtktreeselection.h
@@ -80,12 +80,21 @@ struct _GtkTreeSelection
   GtkTreeSelectionPrivate *priv;
 };
 
+/**
+ * GtkTreeSelectionClass:
+ * @parent_class: The parent class.
+ * @changed: Signal emitted whenever the selection has (possibly) changed.
+ */
 struct _GtkTreeSelectionClass
 {
   GObjectClass parent_class;
 
+  /*< public >*/
+
   void (* changed) (GtkTreeSelection *selection);
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/gtkviewport.h b/gtk/gtkviewport.h
index af1397f1ff..8b0bef0e18 100644
--- a/gtk/gtkviewport.h
+++ b/gtk/gtkviewport.h
@@ -56,10 +56,16 @@ struct _GtkViewport
   GtkViewportPrivate *priv;
 };
 
+/**
+ * GtkViewportClass:
+ * @parent_class: The parent class.
+ */
 struct _GtkViewportClass
 {
   GtkBinClass parent_class;
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);
diff --git a/gtk/gtkwindow.h b/gtk/gtkwindow.h
index 0be0c9fbc3..426970e597 100644
--- a/gtk/gtkwindow.h
+++ b/gtk/gtkwindow.h
@@ -57,10 +57,19 @@ struct _GtkWindow
   GtkWindowPrivate *priv;
 };
 
+/**
+ * GtkWindowClass:
+ * @parent_class: The parent class.
+ * @set_focus: Sets child as the focus widget for the window.
+ * @activate_focus: Activates the current focused widget within the window.
+ * @activate_default: Activates the default widget for the window.
+ */
 struct _GtkWindowClass
 {
   GtkBinClass parent_class;
 
+  /*< public >*/
+
   void     (* set_focus)   (GtkWindow *window,
                             GtkWidget *focus);
 
@@ -70,6 +79,8 @@ struct _GtkWindowClass
   void     (* activate_default) (GtkWindow *window);
   void	   (* keys_changed)     (GtkWindow *window);
 
+  /*< private >*/
+
   /* Padding for future expansion */
   void (*_gtk_reserved1) (void);
   void (*_gtk_reserved2) (void);