Update docs from release2.24.8

38 files changed, 770 insertions, 81 deletions

diff --git a/docs/reference/gdk/tmpl/cairo_interaction.sgml b/docs/reference/gdk/tmpl/cairo_interaction.sgml
index fc7fbf56ad..24d4083c31 100644
--- a/docs/reference/gdk/tmpl/cairo_interaction.sgml
+++ b/docs/reference/gdk/tmpl/cairo_interaction.sgml
@@ -30,6 +30,18 @@ Cairo paths and to use pixbufs as sources for drawing operations.
 <!-- ##### SECTION Image ##### -->
 
 
+<!-- ##### FUNCTION gdk_window_create_similar_surface ##### -->
+<para>
+
+</para>
+
+@window: 
+@content: 
+@width: 
+@height: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gdk_cairo_create ##### -->
 <para>
 
@@ -70,6 +82,17 @@ Cairo paths and to use pixbufs as sources for drawing operations.
 @pixmap_y: 
 
 
+<!-- ##### FUNCTION gdk_cairo_set_source_window ##### -->
+<para>
+
+</para>
+
+@cr: 
+@window: 
+@x: 
+@y: 
+
+
 <!-- ##### FUNCTION gdk_cairo_rectangle ##### -->
 <para>
 
diff --git a/docs/reference/gdk/tmpl/cursors.sgml b/docs/reference/gdk/tmpl/cursors.sgml
index 32ad4e8848..2eaf6a3376 100644
--- a/docs/reference/gdk/tmpl/cursors.sgml
+++ b/docs/reference/gdk/tmpl/cursors.sgml
@@ -199,6 +199,15 @@ The standard cursors available.
 @Returns: 
 
 
+<!-- ##### FUNCTION gdk_cursor_get_cursor_type ##### -->
+<para>
+
+</para>
+
+@cursor: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gdk_cursor_ref ##### -->
 <para>
 
diff --git a/docs/reference/gdk/tmpl/gdkdisplay.sgml b/docs/reference/gdk/tmpl/gdkdisplay.sgml
index 19a7798c5f..5dd9862eba 100644
--- a/docs/reference/gdk/tmpl/gdkdisplay.sgml
+++ b/docs/reference/gdk/tmpl/gdkdisplay.sgml
@@ -164,6 +164,15 @@ of an X display. All its fields are private and should not be accessed directly.
 @display: 
 
 
+<!-- ##### FUNCTION gdk_display_is_closed ##### -->
+<para>
+
+</para>
+
+@display: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gdk_display_list_devices ##### -->
 <para>
 
diff --git a/docs/reference/gdk/tmpl/general.sgml b/docs/reference/gdk/tmpl/general.sgml
index 3ef45ac69d..c29995e216 100644
--- a/docs/reference/gdk/tmpl/general.sgml
+++ b/docs/reference/gdk/tmpl/general.sgml
@@ -100,7 +100,7 @@ locale.
 
 @void: 
 @Returns: the resulting locale.
-@Deprecated:2.24: Use setlocale() directly
+@Deprecated: 2.24: Use setlocale() directly
 
 
 <!-- ##### FUNCTION gdk_set_sm_client_id ##### -->
diff --git a/docs/reference/gdk/tmpl/images.sgml b/docs/reference/gdk/tmpl/images.sgml
index 6f04aa9953..769ca13b6d 100644
--- a/docs/reference/gdk/tmpl/images.sgml
+++ b/docs/reference/gdk/tmpl/images.sgml
@@ -164,6 +164,96 @@ Destroys a #GdkImage, freeing any resources allocated for it.
 @colormap: 
 
 
+<!-- ##### FUNCTION gdk_image_get_bits_per_pixel ##### -->
+<para>
+
+</para>
+
+@image: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gdk_image_get_bytes_per_pixel ##### -->
+<para>
+
+</para>
+
+@image: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gdk_image_get_bytes_per_line ##### -->
+<para>
+
+</para>
+
+@image: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gdk_image_get_byte_order ##### -->
+<para>
+
+</para>
+
+@image: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gdk_image_get_depth ##### -->
+<para>
+
+</para>
+
+@image: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gdk_image_get_height ##### -->
+<para>
+
+</para>
+
+@image: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gdk_image_get_image_type ##### -->
+<para>
+
+</para>
+
+@image: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gdk_image_get_visual ##### -->
+<para>
+
+</para>
+
+@image: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gdk_image_get_width ##### -->
+<para>
+
+</para>
+
+@image: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gdk_image_get_pixels ##### -->
+<para>
+
+</para>
+
+@image: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gdk_image_put_pixel ##### -->
 <para>
 Sets a pixel in a #GdkImage to a given pixel value.
diff --git a/docs/reference/gdk/tmpl/input_devices.sgml b/docs/reference/gdk/tmpl/input_devices.sgml
index 5c9bc2c23c..798bb2f817 100644
--- a/docs/reference/gdk/tmpl/input_devices.sgml
+++ b/docs/reference/gdk/tmpl/input_devices.sgml
@@ -172,6 +172,15 @@ types that GTK+ understands.
 @Returns: 
 
 
+<!-- ##### FUNCTION gdk_device_get_name ##### -->
+<para>
+
+</para>
+
+@device: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gdk_device_set_source ##### -->
 <para>
 Sets the source type for an input device.
@@ -181,6 +190,15 @@ Sets the source type for an input device.
 @source: the source type.
 
 
+<!-- ##### FUNCTION gdk_device_get_source ##### -->
+<para>
+
+</para>
+
+@device: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gdk_device_set_mode ##### -->
 <para>
 Sets a the mode of an input device. The mode controls if the 
@@ -193,6 +211,15 @@ entire screen or to a single window.
 @Returns: %TRUE if the mode was successfully changed.
 
 
+<!-- ##### FUNCTION gdk_device_get_mode ##### -->
+<para>
+
+</para>
+
+@device: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gdk_device_set_key ##### -->
 <para>
 Specifies the X key event to generate when a macro button of a device
@@ -205,6 +232,17 @@ is pressed.
 @modifiers: the modifiers to set.
 
 
+<!-- ##### FUNCTION gdk_device_get_key ##### -->
+<para>
+
+</para>
+
+@device: 
+@index: 
+@keyval: 
+@modifiers: 
+
+
 <!-- ##### FUNCTION gdk_device_set_axis_use ##### -->
 <para>
 Specifies how an axis of a device is used.
@@ -215,6 +253,16 @@ Specifies how an axis of a device is used.
 @use: specifies how the axis is used.
 
 
+<!-- ##### FUNCTION gdk_device_get_axis_use ##### -->
+<para>
+
+</para>
+
+@device: 
+@index: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gdk_device_get_core_pointer ##### -->
 <para>
 </para>
@@ -276,6 +324,15 @@ motion history. It contains the following fields:
 @Returns: 
 
 
+<!-- ##### FUNCTION gdk_device_get_n_axes ##### -->
+<para>
+
+</para>
+
+@device: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gdk_input_set_extension_events ##### -->
 <para>
 Turns extension events on or off for a particular window,
diff --git a/docs/reference/gdk/tmpl/pixmaps.sgml b/docs/reference/gdk/tmpl/pixmaps.sgml
index 89bd38d27c..76973b2ffc 100644
--- a/docs/reference/gdk/tmpl/pixmaps.sgml
+++ b/docs/reference/gdk/tmpl/pixmaps.sgml
@@ -71,7 +71,6 @@ window is used.
 @width: the width of the new pixmap in pixels.
 @height: the height of the new pixmap in pixels.
 @Returns: the #GdkBitmap
-
 @Deprecated: 2.22: You can create a Cairo image surface using
 cairo_image_surface_create_for_data() instead. Specify
 %CAIRO_FORMAT_A1 as the format to get a bitmap. Keep in mind that
@@ -81,6 +80,7 @@ gdk_pixmap_new() with a depth of 1 to create a bitmap and then use
 gdk_cairo_create(), cairo_set_source_surface() and cairo_paint()
 to draw the image surface to the bitmap.
 
+
 <!-- ##### FUNCTION gdk_pixmap_create_from_data ##### -->
 <para>
 Create a two-color pixmap from data in XBM data.
@@ -95,13 +95,13 @@ for the new pixmap. Can be %NULL, if the depth is given.
 @fg: the foreground color.
 @bg: the background color.
 @Returns: the #GdkPixmap
-
 @Deprecated: 2.22: If you must replicate the functionality of this
 function, create a pixmap using gdk_pixmap_new(), cairo_paint() it
 with the background color and then create a Cairo image surface as
 pointed out in the docs to gdk_bitmap_create_from_data() and use
 this surface with cairo_mask_surface() to paint the foreground color.
 
+
 <!-- ##### FUNCTION gdk_pixmap_create_from_xpm ##### -->
 
 
@@ -144,6 +144,16 @@ this surface with cairo_mask_surface() to paint the foreground color.
 @Returns: 
 
 
+<!-- ##### FUNCTION gdk_pixmap_get_size ##### -->
+<para>
+
+</para>
+
+@pixmap: 
+@width: 
+@height: 
+
+
 <!-- ##### MACRO gdk_pixmap_ref ##### -->
 <para>
 Deprecated equivalent of g_object_ref().
diff --git a/docs/reference/gdk/tmpl/visuals.sgml b/docs/reference/gdk/tmpl/visuals.sgml
index 7389250245..f77915299d 100644
--- a/docs/reference/gdk/tmpl/visuals.sgml
+++ b/docs/reference/gdk/tmpl/visuals.sgml
@@ -232,3 +232,81 @@ Deprecated equivalent of g_object_unref().
 @Returns: 
 
 
+<!-- ##### FUNCTION gdk_visual_get_bits_per_rgb ##### -->
+<para>
+
+</para>
+
+@visual: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gdk_visual_get_blue_pixel_details ##### -->
+<para>
+
+</para>
+
+@visual: 
+@mask: 
+@shift: 
+@precision: 
+
+
+<!-- ##### FUNCTION gdk_visual_get_byte_order ##### -->
+<para>
+
+</para>
+
+@visual: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gdk_visual_get_colormap_size ##### -->
+<para>
+
+</para>
+
+@visual: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gdk_visual_get_depth ##### -->
+<para>
+
+</para>
+
+@visual: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gdk_visual_get_green_pixel_details ##### -->
+<para>
+
+</para>
+
+@visual: 
+@mask: 
+@shift: 
+@precision: 
+
+
+<!-- ##### FUNCTION gdk_visual_get_red_pixel_details ##### -->
+<para>
+
+</para>
+
+@visual: 
+@mask: 
+@shift: 
+@precision: 
+
+
+<!-- ##### FUNCTION gdk_visual_get_visual_type ##### -->
+<para>
+
+</para>
+
+@visual: 
+@Returns: 
+
+
diff --git a/docs/reference/gdk/tmpl/windows.sgml b/docs/reference/gdk/tmpl/windows.sgml
index 6923717444..ab297dd777 100644
--- a/docs/reference/gdk/tmpl/windows.sgml
+++ b/docs/reference/gdk/tmpl/windows.sgml
@@ -525,6 +525,51 @@ Deprecated equivalent of g_object_unref()
 
 
 
+<!-- ##### FUNCTION gdk_window_get_display ##### -->
+<para>
+
+</para>
+
+@window: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gdk_window_get_screen ##### -->
+<para>
+
+</para>
+
+@window: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gdk_window_get_visual ##### -->
+<para>
+
+</para>
+
+@window: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gdk_window_get_width ##### -->
+<para>
+
+</para>
+
+@window: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gdk_window_get_height ##### -->
+<para>
+
+</para>
+
+@window: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gdk_window_get_window_type ##### -->
 <para>
 
@@ -595,6 +640,24 @@ Deprecated equivalent of g_object_unref()
 @Returns: 
 
 
+<!-- ##### FUNCTION gdk_window_is_shaped ##### -->
+<para>
+
+</para>
+
+@window: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gdk_window_is_input_only ##### -->
+<para>
+
+</para>
+
+@window: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gdk_window_get_state ##### -->
 <para>
 
@@ -712,6 +775,15 @@ Deprecated equivalent of g_object_unref()
 @composited: 
 
 
+<!-- ##### FUNCTION gdk_window_get_composited ##### -->
+<para>
+
+</para>
+
+@window: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gdk_window_move ##### -->
 <para>
 
@@ -773,6 +845,15 @@ Deprecated equivalent of g_object_unref()
 @window: 
 
 
+<!-- ##### FUNCTION gdk_window_has_native ##### -->
+<para>
+
+</para>
+
+@window: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gdk_window_ensure_native ##### -->
 <para>
 
@@ -990,7 +1071,8 @@ Registers a window as a potential drop destination.
 @GdkWindow *, gpointer:
 @GdkWindow *, gpointer:
 @GdkWindow *, gpointer:
-@GdkWindow *, gpointer: 
+@GdkWindow *, gpointer:
+@child_func: 
 @user_data: 
 
 
@@ -1098,6 +1180,15 @@ Registers a window as a potential drop destination.
 @accept_focus: 
 
 
+<!-- ##### FUNCTION gdk_window_get_accept_focus ##### -->
+<para>
+
+</para>
+
+@window: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gdk_window_set_focus_on_map ##### -->
 <para>
 
@@ -1107,6 +1198,15 @@ Registers a window as a potential drop destination.
 @focus_on_map: 
 
 
+<!-- ##### FUNCTION gdk_window_get_focus_on_map ##### -->
+<para>
+
+</para>
+
+@window: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gdk_window_add_filter ##### -->
 <para>
 
@@ -1293,6 +1393,15 @@ backend, <type>MSG</type>s for Win32).
 @parent_relative: 
 
 
+<!-- ##### FUNCTION gdk_window_get_background_pattern ##### -->
+<para>
+
+</para>
+
+@window: 
+@Returns: 
+
+
 <!-- ##### MACRO GDK_PARENT_RELATIVE ##### -->
 <para>
 A special value for <literal>GdkPixmap*</literal> variables, indicating
@@ -1377,6 +1486,15 @@ Deprecated equivalent to gdk_drawable_set_colormap()
 @modal: 
 
 
+<!-- ##### FUNCTION gdk_window_get_modal_hint ##### -->
+<para>
+
+</para>
+
+@window: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gdk_window_set_type_hint ##### -->
 <para>
 
@@ -1458,12 +1576,13 @@ Deprecated equivalent of gdk_drawable_get_size().
 
 
 
-<!-- ##### MACRO gdk_window_get_visual ##### -->
+<!-- ##### FUNCTION gdk_window_get_visual ##### -->
 <para>
-Deprecated equivalent of gdk_drawable_get_visual().
+
 </para>
 
-@Returns: the #GdkVisual of the window
+@window: 
+@Returns: 
 
 
 <!-- ##### MACRO gdk_window_get_colormap ##### -->
@@ -1516,6 +1635,30 @@ Deprecated equivalent of gdk_drawable_get_type().
 @root_y: 
 
 
+<!-- ##### FUNCTION gdk_window_coords_from_parent ##### -->
+<para>
+
+</para>
+
+@window: 
+@parent_x: 
+@parent_y: 
+@x: 
+@y: 
+
+
+<!-- ##### FUNCTION gdk_window_coords_to_parent ##### -->
+<para>
+
+</para>
+
+@window: 
+@x: 
+@y: 
+@parent_x: 
+@parent_y: 
+
+
 <!-- ##### FUNCTION gdk_window_get_pointer ##### -->
 <para>
 
@@ -1579,6 +1722,15 @@ or %GDK_META_MASK in the state field of key events.
 @Returns: 
 
 
+<!-- ##### FUNCTION gdk_window_get_effective_parent ##### -->
+<para>
+
+</para>
+
+@window: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gdk_window_get_toplevel ##### -->
 <para>
 
@@ -1588,6 +1740,15 @@ or %GDK_META_MASK in the state field of key events.
 @Returns: 
 
 
+<!-- ##### FUNCTION gdk_window_get_effective_toplevel ##### -->
+<para>
+
+</para>
+
+@window: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gdk_window_get_children ##### -->
 <para>
 
diff --git a/docs/reference/gdk/tmpl/x_interaction.sgml b/docs/reference/gdk/tmpl/x_interaction.sgml
index 2e332c59b8..52bb3db8b8 100644
--- a/docs/reference/gdk/tmpl/x_interaction.sgml
+++ b/docs/reference/gdk/tmpl/x_interaction.sgml
@@ -40,7 +40,6 @@ The current display.
 </para>
 
 @Returns: an Xlib <type>Display*</type>.
-
 @Deprecated: 2.22: Use gdk_display_get_default() to get the default #GdkDisplay or gdk_x11_get_default_xdisplay() to get the corresponding Xlib <type>Display *</type>.
 
 
@@ -821,3 +820,31 @@ Since: 2.2
 @Returns: 
 
 
+<!-- ##### FUNCTION gdk_x11_set_sm_client_id ##### -->
+<para>
+
+</para>
+
+@sm_client_id: 
+
+
+<!-- ##### FUNCTION gdk_x11_window_foreign_new_for_display ##### -->
+<para>
+
+</para>
+
+@display: 
+@window: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gdk_x11_window_lookup_for_display ##### -->
+<para>
+
+</para>
+
+@display: 
+@window: 
+@Returns: 
+
+
diff --git a/docs/reference/gtk/tmpl/gtkaccelmap.sgml b/docs/reference/gtk/tmpl/gtkaccelmap.sgml
index c7fa69c60a..0a27e0994f 100644
--- a/docs/reference/gtk/tmpl/gtkaccelmap.sgml
+++ b/docs/reference/gtk/tmpl/gtkaccelmap.sgml
@@ -80,20 +80,18 @@ Loadable keyboard accelerator specifications
 @Returns: 
 
 
-<!-- ##### FUNCTION gtk_accel_map_load ##### -->
+<!-- ##### MACRO gtk_accel_map_load ##### -->
 <para>
 
 </para>
 
-@file_name: 
 
 
-<!-- ##### FUNCTION gtk_accel_map_save ##### -->
+<!-- ##### MACRO gtk_accel_map_save ##### -->
 <para>
 
 </para>
 
-@file_name: 
 
 
 <!-- ##### FUNCTION gtk_accel_map_foreach ##### -->
diff --git a/docs/reference/gtk/tmpl/gtkbutton.sgml b/docs/reference/gtk/tmpl/gtkbutton.sgml
index 13ca4a6e77..9cab72a400 100644
--- a/docs/reference/gtk/tmpl/gtkbutton.sgml
+++ b/docs/reference/gtk/tmpl/gtkbutton.sgml
@@ -387,3 +387,12 @@ Returns the current relief style of the given #GtkButton.
 @Returns: 
 
 
+<!-- ##### FUNCTION gtk_button_get_event_window ##### -->
+<para>
+
+</para>
+
+@button: 
+@Returns: 
+
+
diff --git a/docs/reference/gtk/tmpl/gtkcalendar.sgml b/docs/reference/gtk/tmpl/gtkcalendar.sgml
index 234ca1d0de..20281592d5 100644
--- a/docs/reference/gtk/tmpl/gtkcalendar.sgml
+++ b/docs/reference/gtk/tmpl/gtkcalendar.sgml
@@ -166,6 +166,21 @@ calendar.
 
 </para>
 
+<!-- ##### ARG GtkCalendar:horizontal-separation ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkCalendar:inner-border ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkCalendar:vertical-separation ##### -->
+<para>
+
+</para>
+
 <!-- ##### USER_FUNCTION GtkCalendarDetailFunc ##### -->
 <para>
 
diff --git a/docs/reference/gtk/tmpl/gtkcombobox.sgml b/docs/reference/gtk/tmpl/gtkcombobox.sgml
index 7e080eb21c..b5baa6c7c3 100644
--- a/docs/reference/gtk/tmpl/gtkcombobox.sgml
+++ b/docs/reference/gtk/tmpl/gtkcombobox.sgml
@@ -101,11 +101,21 @@ gtk_combo_box_get_active_text().
 
 </para>
 
+<!-- ##### ARG GtkComboBox:entry-text-column ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG GtkComboBox:focus-on-click ##### -->
 <para>
 
 </para>
 
+<!-- ##### ARG GtkComboBox:has-entry ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG GtkComboBox:has-frame ##### -->
 <para>
 
@@ -160,6 +170,15 @@ gtk_combo_box_get_active_text().
 @Returns: 
 
 
+<!-- ##### FUNCTION gtk_combo_box_new_with_entry ##### -->
+<para>
+
+</para>
+
+@void: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gtk_combo_box_new_with_model ##### -->
 <para>
 
@@ -169,6 +188,15 @@ gtk_combo_box_get_active_text().
 @Returns: 
 
 
+<!-- ##### FUNCTION gtk_combo_box_new_with_model_and_entry ##### -->
+<para>
+
+</para>
+
+@model: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gtk_combo_box_get_wrap_width ##### -->
 <para>
 
@@ -450,3 +478,30 @@ gtk_combo_box_get_active_text().
 @Returns: 
 
 
+<!-- ##### FUNCTION gtk_combo_box_get_has_entry ##### -->
+<para>
+
+</para>
+
+@combo_box: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_combo_box_set_entry_text_column ##### -->
+<para>
+
+</para>
+
+@combo_box: 
+@text_column: 
+
+
+<!-- ##### FUNCTION gtk_combo_box_get_entry_text_column ##### -->
+<para>
+
+</para>
+
+@combo_box: 
+@Returns: 
+
+
diff --git a/docs/reference/gtk/tmpl/gtkentry.sgml b/docs/reference/gtk/tmpl/gtkentry.sgml
index ec0e2381fe..4b7ebf1df8 100644
--- a/docs/reference/gtk/tmpl/gtkentry.sgml
+++ b/docs/reference/gtk/tmpl/gtkentry.sgml
@@ -839,7 +839,6 @@ Specifies the side of the entry at which an icon is placed.
 
 @GTK_ENTRY_ICON_PRIMARY: At the beginning of the entry (depending on the text direction).
 @GTK_ENTRY_ICON_SECONDARY: At the end of the entry (depending on the text direction).
-
 @Since: 2.16
 
 <!-- ##### FUNCTION gtk_entry_set_icon_from_pixbuf ##### -->
diff --git a/docs/reference/gtk/tmpl/gtkexpander.sgml b/docs/reference/gtk/tmpl/gtkexpander.sgml
index 402ef58184..77427b4d00 100644
--- a/docs/reference/gtk/tmpl/gtkexpander.sgml
+++ b/docs/reference/gtk/tmpl/gtkexpander.sgml
@@ -115,6 +115,11 @@ a &lt;child&gt; type attribute.
 
 </para>
 
+<!-- ##### ARG GtkExpander:label-fill ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG GtkExpander:label-widget ##### -->
 <para>
 
@@ -271,3 +276,21 @@ a &lt;child&gt; type attribute.
 @Returns: 
 
 
+<!-- ##### FUNCTION gtk_expander_set_label_fill ##### -->
+<para>
+
+</para>
+
+@expander: 
+@label_fill: 
+
+
+<!-- ##### FUNCTION gtk_expander_get_label_fill ##### -->
+<para>
+
+</para>
+
+@expander: 
+@Returns: 
+
+
diff --git a/docs/reference/gtk/tmpl/gtkfilesel.sgml b/docs/reference/gtk/tmpl/gtkfilesel.sgml
index 810ce0acf9..0fa165bb2f 100644
--- a/docs/reference/gtk/tmpl/gtkfilesel.sgml
+++ b/docs/reference/gtk/tmpl/gtkfilesel.sgml
@@ -156,19 +156,16 @@ Creates a new file selection dialog box. By default it will contain a #GtkTreeVi
 @Deprecated: Use gtk_file_chooser_dialog_new() instead
 
 
-<!-- ##### FUNCTION gtk_file_selection_set_filename ##### -->
+<!-- ##### MACRO gtk_file_selection_set_filename ##### -->
 <para>
 </para>
 
-@filesel: 
-@filename: 
 
 
-<!-- ##### FUNCTION gtk_file_selection_get_filename ##### -->
+<!-- ##### MACRO gtk_file_selection_get_filename ##### -->
 <para>
 </para>
 
-@filesel: 
 @Returns: 
 
 
@@ -200,12 +197,11 @@ Hides the file operation buttons that normally appear at the top of the dialog.
 @filesel: a #GtkFileSelection.
 
 
-<!-- ##### FUNCTION gtk_file_selection_get_selections ##### -->
+<!-- ##### MACRO gtk_file_selection_get_selections ##### -->
 <para>
 
 </para>
 
-@filesel: 
 @Returns: 
 
 
diff --git a/docs/reference/gtk/tmpl/gtkfontseldlg.sgml b/docs/reference/gtk/tmpl/gtkfontseldlg.sgml
index 936ebab79a..e08ba4298b 100644
--- a/docs/reference/gtk/tmpl/gtkfontseldlg.sgml
+++ b/docs/reference/gtk/tmpl/gtkfontseldlg.sgml
@@ -136,3 +136,12 @@ fonts.</para></listitem>
 @Returns: 
 
 
+<!-- ##### FUNCTION gtk_font_selection_dialog_get_font_selection ##### -->
+<para>
+
+</para>
+
+@fsd: 
+@Returns: 
+
+
diff --git a/docs/reference/gtk/tmpl/gtkhruler.sgml b/docs/reference/gtk/tmpl/gtkhruler.sgml
index 30c99fa241..45334bf21f 100644
--- a/docs/reference/gtk/tmpl/gtkhruler.sgml
+++ b/docs/reference/gtk/tmpl/gtkhruler.sgml
@@ -48,7 +48,6 @@ Creates a new horizontal ruler.
 
 @void: 
 @Returns: a new #GtkHRuler.
-
 @Deprecated: 2.24: #GtkRuler has been removed from GTK 3 for being
     unmaintained and too specialized. There is no replacement.
 
diff --git a/docs/reference/gtk/tmpl/gtkiconfactory.sgml b/docs/reference/gtk/tmpl/gtkiconfactory.sgml
index 614b50edbd..8a312155ce 100644
--- a/docs/reference/gtk/tmpl/gtkiconfactory.sgml
+++ b/docs/reference/gtk/tmpl/gtkiconfactory.sgml
@@ -376,12 +376,11 @@ This attribute is optional.</para>
 @Returns: 
 
 
-<!-- ##### FUNCTION gtk_icon_source_get_filename ##### -->
+<!-- ##### MACRO gtk_icon_source_get_filename ##### -->
 <para>
 
 </para>
 
-@source: 
 @Returns: 
 
 
@@ -466,13 +465,11 @@ This attribute is optional.</para>
 @setting: 
 
 
-<!-- ##### FUNCTION gtk_icon_source_set_filename ##### -->
+<!-- ##### MACRO gtk_icon_source_set_filename ##### -->
 <para>
 
 </para>
 
-@source: 
-@filename: 
 
 
 <!-- ##### FUNCTION gtk_icon_source_set_pixbuf ##### -->
diff --git a/docs/reference/gtk/tmpl/gtkicontheme.sgml b/docs/reference/gtk/tmpl/gtkicontheme.sgml
index 518c01b5c2..1218271d3a 100644
--- a/docs/reference/gtk/tmpl/gtkicontheme.sgml
+++ b/docs/reference/gtk/tmpl/gtkicontheme.sgml
@@ -194,42 +194,32 @@ The #GQuark used for #GtkIconThemeError errors.
 @screen: 
 
 
-<!-- ##### FUNCTION gtk_icon_theme_set_search_path ##### -->
+<!-- ##### MACRO gtk_icon_theme_set_search_path ##### -->
 <para>
 
 </para>
 
-@icon_theme: 
-@path: 
-@n_elements: 
 
 
-<!-- ##### FUNCTION gtk_icon_theme_get_search_path ##### -->
+<!-- ##### MACRO gtk_icon_theme_get_search_path ##### -->
 <para>
 
 </para>
 
-@icon_theme: 
-@path: 
-@n_elements: 
 
 
-<!-- ##### FUNCTION gtk_icon_theme_append_search_path ##### -->
+<!-- ##### MACRO gtk_icon_theme_append_search_path ##### -->
 <para>
 
 </para>
 
-@icon_theme: 
-@path: 
 
 
-<!-- ##### FUNCTION gtk_icon_theme_prepend_search_path ##### -->
+<!-- ##### MACRO gtk_icon_theme_prepend_search_path ##### -->
 <para>
 
 </para>
 
-@icon_theme: 
-@path: 
 
 
 <!-- ##### FUNCTION gtk_icon_theme_set_custom_theme ##### -->
@@ -393,12 +383,11 @@ The #GQuark used for #GtkIconThemeError errors.
 @Returns: 
 
 
-<!-- ##### FUNCTION gtk_icon_info_get_filename ##### -->
+<!-- ##### MACRO gtk_icon_info_get_filename ##### -->
 <para>
 
 </para>
 
-@icon_info: 
 @Returns: 
 
 
diff --git a/docs/reference/gtk/tmpl/gtkiconview.sgml b/docs/reference/gtk/tmpl/gtkiconview.sgml
index 2602f607c8..3c37bac151 100644
--- a/docs/reference/gtk/tmpl/gtkiconview.sgml
+++ b/docs/reference/gtk/tmpl/gtkiconview.sgml
@@ -112,6 +112,11 @@ private fields and should not be directly accessed.
 
 </para>
 
+<!-- ##### ARG GtkIconView:item-orientation ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG GtkIconView:item-padding ##### -->
 <para>
 
@@ -392,6 +397,24 @@ selected rows.  It will be called on every selected row in the view.
 @Returns: 
 
 
+<!-- ##### FUNCTION gtk_icon_view_set_item_orientation ##### -->
+<para>
+
+</para>
+
+@icon_view: 
+@orientation: 
+
+
+<!-- ##### FUNCTION gtk_icon_view_get_item_orientation ##### -->
+<para>
+
+</para>
+
+@icon_view: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gtk_icon_view_set_columns ##### -->
 <para>
 
diff --git a/docs/reference/gtk/tmpl/gtkitem.sgml b/docs/reference/gtk/tmpl/gtkitem.sgml
index 7049e74847..1999ee4c9e 100644
--- a/docs/reference/gtk/tmpl/gtkitem.sgml
+++ b/docs/reference/gtk/tmpl/gtkitem.sgml
@@ -77,3 +77,5 @@ Emits the "toggle" signal on the given item.
 
 @item: a #GtkItem.
 @Deprecated: 2.22: This function will be removed in GTK+ 3
+
+
diff --git a/docs/reference/gtk/tmpl/gtkmain.sgml b/docs/reference/gtk/tmpl/gtkmain.sgml
index 185a37e05e..3cb773926f 100644
--- a/docs/reference/gtk/tmpl/gtkmain.sgml
+++ b/docs/reference/gtk/tmpl/gtkmain.sgml
@@ -432,6 +432,7 @@ Registers a function to be called when the mainloop is started.
 @data: Data to pass to that function.
 @Deprecated: This function is going to be removed in GTK+ 3.0
 
+
 <!-- ##### FUNCTION gtk_quit_add_destroy ##### -->
 <para>
 Trigger destruction of @object in case the mainloop at level @main_level
diff --git a/docs/reference/gtk/tmpl/gtknotebook.sgml b/docs/reference/gtk/tmpl/gtknotebook.sgml
index 429357db43..36f974bd06 100644
--- a/docs/reference/gtk/tmpl/gtknotebook.sgml
+++ b/docs/reference/gtk/tmpl/gtknotebook.sgml
@@ -182,6 +182,11 @@ Emitted when the user or a function changes the current page.
 
 </para>
 
+<!-- ##### ARG GtkNotebook:group-name ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG GtkNotebook:homogeneous ##### -->
 <para>
 
@@ -714,6 +719,24 @@ Deprecated compatibility macro.
 @Returns: 
 
 
+<!-- ##### FUNCTION gtk_notebook_get_tab_hborder ##### -->
+<para>
+
+</para>
+
+@notebook: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_notebook_get_tab_vborder ##### -->
+<para>
+
+</para>
+
+@notebook: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gtk_notebook_set_current_page ##### -->
 <para>
 
@@ -759,6 +782,24 @@ Deprecated compatibility macro.
 @Returns: 
 
 
+<!-- ##### FUNCTION gtk_notebook_set_group_name ##### -->
+<para>
+
+</para>
+
+@notebook: 
+@group_name: 
+
+
+<!-- ##### FUNCTION gtk_notebook_get_group_name ##### -->
+<para>
+
+</para>
+
+@notebook: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gtk_notebook_set_action_widget ##### -->
 <para>
 
diff --git a/docs/reference/gtk/tmpl/gtkobject.sgml b/docs/reference/gtk/tmpl/gtkobject.sgml
index 38500a573d..f6ccdde1ce 100644
--- a/docs/reference/gtk/tmpl/gtkobject.sgml
+++ b/docs/reference/gtk/tmpl/gtkobject.sgml
@@ -138,7 +138,6 @@ Tells about the state of the object.
 @GTK_FLOATING: 
 @GTK_RESERVED_1: 
 @GTK_RESERVED_2: reserved for future use
-
 @Deprecated: 2.22: Do not re-use #GtkObject flags but use your own variable to
   store flags.
 
@@ -149,7 +148,6 @@ accessing its members.
 </para>
 
 @obj: the object whose flags are returned.
-
 @Deprecated: 2.22: Do not re-use #GtkObject flags but use your own variable to
   store flags.
 
diff --git a/docs/reference/gtk/tmpl/gtkrange.sgml b/docs/reference/gtk/tmpl/gtkrange.sgml
index d64ef0851c..61eb2b29a7 100644
--- a/docs/reference/gtk/tmpl/gtkrange.sgml
+++ b/docs/reference/gtk/tmpl/gtkrange.sgml
@@ -91,6 +91,11 @@ of the "steppers". It also provides properties and methods for setting a
 
 </para>
 
+<!-- ##### ARG GtkRange:round-digits ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG GtkRange:show-fill-level ##### -->
 <para>
 
@@ -131,6 +136,11 @@ of the "steppers". It also provides properties and methods for setting a
 
 </para>
 
+<!-- ##### ARG GtkRange:stepper-position-details ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG GtkRange:stepper-size ##### -->
 <para>
 
@@ -264,33 +274,33 @@ of the "steppers". It also provides properties and methods for setting a
 @Returns: 
 
 
-<!-- ##### FUNCTION gtk_range_get_value ##### -->
+<!-- ##### FUNCTION gtk_range_set_increments ##### -->
 <para>
 
 </para>
 
 @range: 
-@Returns: 
+@step: 
+@page: 
 
 
-<!-- ##### FUNCTION gtk_range_set_increments ##### -->
+<!-- ##### FUNCTION gtk_range_set_range ##### -->
 <para>
 
 </para>
 
 @range: 
-@step: 
-@page: 
+@min: 
+@max: 
 
 
-<!-- ##### FUNCTION gtk_range_set_range ##### -->
+<!-- ##### FUNCTION gtk_range_get_value ##### -->
 <para>
 
 </para>
 
 @range: 
-@min: 
-@max: 
+@Returns: 
 
 
 <!-- ##### FUNCTION gtk_range_set_value ##### -->
@@ -302,6 +312,24 @@ of the "steppers". It also provides properties and methods for setting a
 @value: 
 
 
+<!-- ##### FUNCTION gtk_range_get_round_digits ##### -->
+<para>
+
+</para>
+
+@range: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_range_set_round_digits ##### -->
+<para>
+
+</para>
+
+@range: 
+@round_digits: 
+
+
 <!-- ##### ENUM GtkSensitivityType ##### -->
 <para>
 Determines how GTK+ handles the sensitivity of stepper arrows
diff --git a/docs/reference/gtk/tmpl/gtkrc.sgml b/docs/reference/gtk/tmpl/gtkrc.sgml
index a81ccfa8b5..14556ed52f 100644
--- a/docs/reference/gtk/tmpl/gtkrc.sgml
+++ b/docs/reference/gtk/tmpl/gtkrc.sgml
@@ -888,11 +888,12 @@ statement in a RC file.
 @Deprecated: Use gtk_rc_parse_string() with a suitable string instead.
 
 
-<!-- ##### FUNCTION gtk_rc_parse ##### -->
+<!-- ##### MACRO gtk_rc_parse ##### -->
 <para>
 Parses a given resource file.
 </para>
 
+<!-- # Unused Parameters # -->
 @filename: the filename of a file to parse. If @filename is not absolute, it
   is searched in the current directory.
 
@@ -931,11 +932,10 @@ Parses resource information directly from a string.
 @settings: 
 
 
-<!-- ##### FUNCTION gtk_rc_add_default_file ##### -->
+<!-- ##### MACRO gtk_rc_add_default_file ##### -->
 <para>
 </para>
 
-@filename: 
 
 
 <!-- ##### FUNCTION gtk_rc_get_default_files ##### -->
@@ -946,11 +946,10 @@ Parses resource information directly from a string.
 @Returns: 
 
 
-<!-- ##### FUNCTION gtk_rc_set_default_files ##### -->
+<!-- ##### MACRO gtk_rc_set_default_files ##### -->
 <para>
 </para>
 
-@filenames: 
 
 
 <!-- ##### FUNCTION gtk_rc_parse_color ##### -->
diff --git a/docs/reference/gtk/tmpl/gtkruler.sgml b/docs/reference/gtk/tmpl/gtkruler.sgml
index 363e359dab..eba8b0e12d 100644
--- a/docs/reference/gtk/tmpl/gtkruler.sgml
+++ b/docs/reference/gtk/tmpl/gtkruler.sgml
@@ -76,11 +76,9 @@ This should be points_per_unit. This is the size of the unit in 1/72nd's of an i
 @pixels_per_unit: 
 @ruler_scale: 
 @subdivide: 
-
 @Deprecated: 2.24: #GtkRuler has been removed from GTK 3 for being
     unmaintained and too specialized. There is no replacement.
 
-
 <!-- ##### FUNCTION gtk_ruler_set_metric ##### -->
 <para>
 This calls the #GTKMetricType to set the ruler to units defined. Available units
@@ -90,7 +88,6 @@ is GTK_PIXELS.
 
 @ruler: the gtkruler
 @metric: the unit of measurement
-
 @Deprecated: 2.24: #GtkRuler has been removed from GTK 3 for being
     unmaintained and too specialized. There is no replacement.
 
diff --git a/docs/reference/gtk/tmpl/gtkselection.sgml b/docs/reference/gtk/tmpl/gtkselection.sgml
index 6daf426d0d..c06723b79c 100644
--- a/docs/reference/gtk/tmpl/gtkselection.sgml
+++ b/docs/reference/gtk/tmpl/gtkselection.sgml
@@ -73,8 +73,6 @@ an efficient form. This structure should be treated as
 opaque.
 </para>
 
-@list: 
-@ref_count: 
 
 <!-- ##### STRUCT GtkTargetPair ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkstatusbar.sgml b/docs/reference/gtk/tmpl/gtkstatusbar.sgml
index 2d860995e3..093c656ca0 100644
--- a/docs/reference/gtk/tmpl/gtkstatusbar.sgml
+++ b/docs/reference/gtk/tmpl/gtkstatusbar.sgml
@@ -136,6 +136,15 @@ below.
 @message_id: 
 
 
+<!-- ##### FUNCTION gtk_statusbar_remove_all ##### -->
+<para>
+
+</para>
+
+@statusbar: 
+@context_id: 
+
+
 <!-- ##### FUNCTION gtk_statusbar_set_has_resize_grip ##### -->
 <para>
 
diff --git a/docs/reference/gtk/tmpl/gtkstyle.sgml b/docs/reference/gtk/tmpl/gtkstyle.sgml
index 3df189fc1c..bec1f1b977 100644
--- a/docs/reference/gtk/tmpl/gtkstyle.sgml
+++ b/docs/reference/gtk/tmpl/gtkstyle.sgml
@@ -984,10 +984,6 @@ A struct that specifies a border around a rectangular area that can
 be of different width on each side.
 </para>
 
-@left: The width of the left border.
-@right: The width of the right border.
-@top: The width of the top border.
-@bottom: The width of the bottom border.
 
 <!-- ##### FUNCTION gtk_border_new ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtktable.sgml b/docs/reference/gtk/tmpl/gtktable.sgml
index 4741a1332f..9f8dbcd40d 100644
--- a/docs/reference/gtk/tmpl/gtktable.sgml
+++ b/docs/reference/gtk/tmpl/gtktable.sgml
@@ -281,3 +281,13 @@ to %FALSE if this is not your desired behaviour.
 @Returns: 
 
 
+<!-- ##### FUNCTION gtk_table_get_size ##### -->
+<para>
+
+</para>
+
+@table: 
+@rows: 
+@columns: 
+
+
diff --git a/docs/reference/gtk/tmpl/gtktextview.sgml b/docs/reference/gtk/tmpl/gtktextview.sgml
index 60d34d7b2f..4733694289 100644
--- a/docs/reference/gtk/tmpl/gtktextview.sgml
+++ b/docs/reference/gtk/tmpl/gtktextview.sgml
@@ -864,6 +864,24 @@ multiple views.
 @text_view: 
 
 
+<!-- ##### FUNCTION gtk_text_view_get_hadjustment ##### -->
+<para>
+
+</para>
+
+@text_view: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_text_view_get_vadjustment ##### -->
+<para>
+
+</para>
+
+@text_view: 
+@Returns: 
+
+
 <!-- ##### MACRO GTK_TEXT_VIEW_PRIORITY_VALIDATE ##### -->
 <para>
 The priority at which the text view validates onscreen lines
diff --git a/docs/reference/gtk/tmpl/gtktreemodel.sgml b/docs/reference/gtk/tmpl/gtktreemodel.sgml
index 2bd28999b7..083ce7c514 100644
--- a/docs/reference/gtk/tmpl/gtktreemodel.sgml
+++ b/docs/reference/gtk/tmpl/gtktreemodel.sgml
@@ -258,10 +258,6 @@ the <structfield>stamp</structfield> member, and put model-specific
 data in the three <structfield>user_data</structfield> members.
 </para>
 
-@stamp: A unique stamp to catch invalid iterators
-@user_data: Model specific data
-@user_data2: Model specific data
-@user_data3: Model specific data
 
 <!-- ##### STRUCT GtkTreePath ##### -->
 <para>
@@ -417,6 +413,16 @@ compatibility reasons.
 @Returns: 
 
 
+<!-- ##### FUNCTION gtk_tree_path_get_indices_with_depth ##### -->
+<para>
+
+</para>
+
+@path: 
+@depth: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gtk_tree_path_free ##### -->
 <para>
 
diff --git a/docs/reference/gtk/tmpl/gtkuimanager.sgml b/docs/reference/gtk/tmpl/gtkuimanager.sgml
index 68b8700df5..fbb350df5d 100644
--- a/docs/reference/gtk/tmpl/gtkuimanager.sgml
+++ b/docs/reference/gtk/tmpl/gtkuimanager.sgml
@@ -428,14 +428,11 @@ members and should not be accessed directly.
 @Returns: 
 
 
-<!-- ##### FUNCTION gtk_ui_manager_add_ui_from_file ##### -->
+<!-- ##### MACRO gtk_ui_manager_add_ui_from_file ##### -->
 <para>
 
 </para>
 
-@self: 
-@filename: 
-@error: 
 @Returns: 
 
 
diff --git a/docs/reference/gtk/tmpl/gtkwindow.sgml b/docs/reference/gtk/tmpl/gtkwindow.sgml
index 789999e6bb..0a3632cb40 100644
--- a/docs/reference/gtk/tmpl/gtkwindow.sgml
+++ b/docs/reference/gtk/tmpl/gtkwindow.sgml
@@ -1084,6 +1084,15 @@ Deprecated alias for gtk_window_set_position().
 @Returns: 
 
 
+<!-- ##### FUNCTION gtk_window_has_group ##### -->
+<para>
+
+</para>
+
+@window: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gtk_window_get_window_type ##### -->
 <para>
 
@@ -1147,13 +1156,11 @@ Deprecated alias for gtk_window_set_position().
 @icon: 
 
 
-<!-- ##### FUNCTION gtk_window_set_default_icon_from_file ##### -->
+<!-- ##### MACRO gtk_window_set_default_icon_from_file ##### -->
 <para>
 
 </para>
 
-@filename: 
-@err: 
 @Returns: 
 
 
@@ -1183,14 +1190,11 @@ Deprecated alias for gtk_window_set_position().
 @list: 
 
 
-<!-- ##### FUNCTION gtk_window_set_icon_from_file ##### -->
+<!-- ##### MACRO gtk_window_set_icon_from_file ##### -->
 <para>
 
 </para>
 
-@window: 
-@filename: 
-@err: 
 @Returns: 
 
 
diff --git a/docs/reference/gtk/tmpl/gtkwindowgroup.sgml b/docs/reference/gtk/tmpl/gtkwindowgroup.sgml
index becadf0c5d..300cb08c16 100644
--- a/docs/reference/gtk/tmpl/gtkwindowgroup.sgml
+++ b/docs/reference/gtk/tmpl/gtkwindowgroup.sgml
@@ -62,3 +62,12 @@ Limit the effect of grabs
 @Returns: 
 
 
+<!-- ##### FUNCTION gtk_window_group_get_current_grab ##### -->
+<para>
+
+</para>
+
+@window_group: 
+@Returns: 
+
+