[gtk+] GTK docs: various fixups

[Matthias Clasen <matthiasc src gnome org>]

commit 0bca60fdd3af35df917e0103b4744ef12cd9f805
Author: Matthias Clasen <mclasen redhat com>
Date:   Fri Oct 1 13:05:12 2010 -0400

    GTK docs: various fixups

 docs/reference/gtk/gtk3-sections.txt |   49 +++++++++++++++++----------------
 gtk/gtkenums.h                       |    9 +++---
 gtk/gtknotebook.c                    |    3 +-
 gtk/gtkprintbackend.c                |    4 +++
 4 files changed, 35 insertions(+), 30 deletions(-)
---
diff --git a/docs/reference/gtk/gtk3-sections.txt b/docs/reference/gtk/gtk3-sections.txt
index 236c28c..fe0d966 100644
--- a/docs/reference/gtk/gtk3-sections.txt
+++ b/docs/reference/gtk/gtk3-sections.txt
@@ -37,9 +37,6 @@ gtk_about_dialog_get_logo
 gtk_about_dialog_set_logo
 gtk_about_dialog_get_logo_icon_name
 gtk_about_dialog_set_logo_icon_name
-GtkAboutDialogActivateLinkFunc
-gtk_about_dialog_set_email_hook
-gtk_about_dialog_set_url_hook
 gtk_show_about_dialog
 <SUBSECTION Standard>
 GTK_ABOUT_DIALOG
@@ -875,6 +872,8 @@ gtk_container_unset_focus_chain
 gtk_container_class_find_child_property
 gtk_container_class_install_child_property
 gtk_container_class_list_child_properties
+gtk_container_class_handle_border_width
+
 <SUBSECTION Standard>
 GTK_CONTAINER
 GTK_IS_CONTAINER
@@ -1675,7 +1674,6 @@ GtkImage
 GtkImageType
 gtk_image_get_icon_set
 gtk_image_get_pixbuf
-gtk_image_get_pixmap
 gtk_image_get_stock
 gtk_image_get_animation
 gtk_image_get_icon_name
@@ -1684,7 +1682,6 @@ gtk_image_get_storage_type
 gtk_image_new_from_file
 gtk_image_new_from_icon_set
 gtk_image_new_from_pixbuf
-gtk_image_new_from_pixmap
 gtk_image_new_from_stock
 gtk_image_new_from_animation
 gtk_image_new_from_icon_name
@@ -1692,7 +1689,6 @@ gtk_image_new_from_gicon
 gtk_image_set_from_file
 gtk_image_set_from_icon_set
 gtk_image_set_from_pixbuf
-gtk_image_set_from_pixmap
 gtk_image_set_from_stock
 gtk_image_set_from_animation
 gtk_image_set_from_icon_name
@@ -2371,6 +2367,7 @@ gtk_radio_button_new_with_mnemonic
 gtk_radio_button_new_with_mnemonic_from_widget
 gtk_radio_button_set_group
 gtk_radio_button_get_group
+gtk_radio_button_join_group
 <SUBSECTION Standard>
 GTK_RADIO_BUTTON
 GTK_IS_RADIO_BUTTON
@@ -4355,6 +4352,16 @@ gtk_cell_renderer_set_alignment
 gtk_cell_renderer_get_padding
 gtk_cell_renderer_set_padding
 
+<SUBSECTION Width-for-height>
+gtk_cell_renderer_get_preferred_height
+gtk_cell_renderer_get_preferred_height_for_width
+gtk_cell_renderer_get_preferred_size
+gtk_cell_renderer_get_preferred_width
+gtk_cell_renderer_get_preferred_width_for_height
+gtk_cell_renderer_get_request_mode
+gtk_cell_view_get_desired_height_for_width_of_row
+gtk_cell_view_get_desired_width_of_row
+
 <SUBSECTION Standard>
 GTK_CELL_RENDERER
 GTK_IS_CELL_RENDERER
@@ -4722,19 +4729,15 @@ gtk_vseparator_get_type
 <TITLE>GtkWidget</TITLE>
 GtkWidget
 GtkWidgetClass
-GtkWidgetFlags
-GTK_WIDGET_FLAGS
-GTK_WIDGET_SET_FLAGS
-GTK_WIDGET_UNSET_FLAGS
 GtkCallback
 GtkRequisition
 GtkAllocation
 GtkSelectionData
 GtkWidgetAuxInfo
-GtkWidgetShapeInfo
 GtkWidgetHelpType
 gtk_widget_new
 gtk_widget_destroy
+gtk_widget_in_destruction
 gtk_widget_destroyed
 gtk_widget_unparent
 gtk_widget_show
@@ -5157,12 +5160,12 @@ GTKMAIN_C_VAR
 <SECTION>
 <FILE>gtkfeatures</FILE>
 <TITLE>Feature Test Macros</TITLE>
-gtk_major_version
-gtk_minor_version
-gtk_micro_version
-gtk_binary_age
-gtk_interface_age
-gtk_check_version
+gtk_get_major_version
+gtk_get_minor_version
+gtk_get_micro_version
+gtk_get_binary_age
+gtk_get_interface_age
+gtk_get_check_version
 
 <SUBSECTION>
 GTK_MAJOR_VERSION
@@ -5412,7 +5415,6 @@ gtk_drag_unhighlight
 <SUBSECTION Source Side>
 gtk_drag_begin
 gtk_drag_set_icon_widget
-gtk_drag_set_icon_pixmap
 gtk_drag_set_icon_pixbuf
 gtk_drag_set_icon_stock
 gtk_drag_set_icon_surface
@@ -5420,7 +5422,6 @@ gtk_drag_set_icon_name
 gtk_drag_set_icon_default
 gtk_drag_check_threshold
 gtk_drag_source_set
-gtk_drag_source_set_icon
 gtk_drag_source_set_icon_pixbuf
 gtk_drag_source_set_icon_stock
 gtk_drag_source_set_icon_name
@@ -5456,7 +5457,6 @@ gtk_binding_set_add_path
 <FILE>gtkenums</FILE>
 <TITLE>Standard Enumerations</TITLE>
 GtkAccelFlags
-GtkAnchorType
 GtkArrowPlacement
 GtkArrowType
 GtkAttachOptions
@@ -5487,7 +5487,6 @@ GtkSubmenuDirection
 GtkSubmenuPlacement
 GtkToolbarStyle
 GtkUpdateType
-GtkVisibility
 GtkWindowPosition
 GtkWindowType
 GtkSortType
@@ -6321,16 +6320,18 @@ GtkApplicationPrivate
 <FILE>gtkwrapbox</FILE>
 <TITLE>GtkWrapBox</TITLE>
 GtkWrapBox
-
 gtk_wrap_box_new
+GtkWrapBoxPacking
 gtk_wrap_box_insert_child
 gtk_wrap_box_reorder_child
 GtkWrapAllocationMode
 gtk_wrap_box_set_allocation_mode
 gtk_wrap_box_get_allocation_mode
 GtkWrapBoxSpreading
-gtk_wrap_box_set_spreading
-gtk_Wrap_box_get_spreading
+gtk_wrap_box_set_vertical_spreading
+gtk_wrap_box_get_vertical_spreading
+gtk_wrap_box_set_horizontal_spreading
+gtk_wrap_box_get_horizontal_spreading
 gtk_wrap_box_set_vertical_spacing
 gtk_wrap_box_get_vertical_spacing
 gtk_wrap_box_set_horizontal_spacing
diff --git a/gtk/gtkenums.h b/gtk/gtkenums.h
index 5305791..98cd0a5 100644
--- a/gtk/gtkenums.h
+++ b/gtk/gtkenums.h
@@ -37,15 +37,14 @@ G_BEGIN_DECLS
 
 /**
  * GtkAlign:
- *
  * @GTK_ALIGN_FILL: stretch to fill all space if possible, center if
- * no meaningful way to stretch
+ *     no meaningful way to stretch
  * @GTK_ALIGN_START: snap to left or top side, leaving space on right
- * or bottom
+ *     or bottom
  * @GTK_ALIGN_END: snap to right or bottom side, leaving space on left
- * or top
+ *     or top
  * @GTK_ALIGN_CENTER: center natural width of widget inside the
- * allocation
+ *     allocation
  *
  * Controls how a widget deals with extra space in a single (x or y)
  * dimension.
diff --git a/gtk/gtknotebook.c b/gtk/gtknotebook.c
index e510b4e..6bc6b1f 100644
--- a/gtk/gtknotebook.c
+++ b/gtk/gtknotebook.c
@@ -7546,7 +7546,8 @@ gtk_notebook_reorder_child (GtkNotebook *notebook,
 /**
  * gtk_notebook_set_group_name:
  * @notebook: a #GtkNotebook
- * @name: (allow-none): the name of the notebook group, or %NULL to unset it
+ * @group_name: (allow-none): the name of the notebook group,
+ *     or %NULL to unset it
  *
  * Sets a group name for @notebook.
  *
diff --git a/gtk/gtkprintbackend.c b/gtk/gtkprintbackend.c
index c212bec..60c12b7 100644
--- a/gtk/gtkprintbackend.c
+++ b/gtk/gtkprintbackend.c
@@ -589,7 +589,11 @@ gtk_print_backend_set_list_done (GtkPrintBackend *backend)
 /**
  * gtk_print_backend_get_printer_list:
  *
+ * Returns the current list of printers.
+ *
  * Return value: (element-type GtkPrinter) (transfer container):
+ *   A list of #GtkPrinter objects. The list should be freed
+ *   with g_list_free().
  */
 GList *
 gtk_print_backend_get_printer_list (GtkPrintBackend *backend)