Documentation fixes.

Sun Oct 13 18:50:14 2002  Soeren Sandmann  <sandmann@daimi.au.dk>

	* gtkmenu.c, gtkmenu.sgml, gtkitemfactory.c, gdkwindow.c,
	gtkwindow.c, gtkpaned.sgml, gtkdialog.c, gtkbox.h, gtkbutton.sgml,
	gtktreemodel.sgml,gtktable.sgml, gtktable.c:

	Documentation fixes.

	#85719, #90759, #95169, Owen Taylor;
	#89221, Yao Zhang, Matthias Clasen;
	#95592, Joost Faassen;
	#92637, Vitaly Tishkov;
	#94616, Ben Martin;
	#94772, sbaillie@bigpond.net.au;

33 files changed, 754 insertions, 201 deletions

diff --git a/docs/reference/gdk-pixbuf/tmpl/gdk-pixbuf-loader.sgml b/docs/reference/gdk-pixbuf/tmpl/gdk-pixbuf-loader.sgml
index 4058c2f9f1..b9ffc22e61 100644
--- a/docs/reference/gdk-pixbuf/tmpl/gdk-pixbuf-loader.sgml
+++ b/docs/reference/gdk-pixbuf/tmpl/gdk-pixbuf-loader.sgml
@@ -87,6 +87,15 @@ Application-driven progressive image loading.
 @Returns: 
 
 
+<!-- ##### FUNCTION gdk_pixbuf_loader_get_format ##### -->
+<para>
+
+</para>
+
+@loader: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gdk_pixbuf_loader_write ##### -->
 <para>
 
diff --git a/docs/reference/gdk-pixbuf/tmpl/gdk-pixbuf-unused.sgml b/docs/reference/gdk-pixbuf/tmpl/gdk-pixbuf-unused.sgml
index 857e0664f2..3c67abbc71 100644
--- a/docs/reference/gdk-pixbuf/tmpl/gdk-pixbuf-unused.sgml
+++ b/docs/reference/gdk-pixbuf/tmpl/gdk-pixbuf-unused.sgml
@@ -365,21 +365,6 @@ XlibRGB
 
 @obj: A GTK+ object.
 
-<!-- ##### STRUCT GdkPixbufFormat ##### -->
-<para>
-A #GdkPixbufFormat contains information about the image format accepted by a
-module. Only modules should access the fields directly.
-</para>
-
-@name: the name of the image format
-@signature: the signature of the module
-@domain: the message domain for the @description
-@description: a description of the image format
-@mime_types: a %NULL-terminated array of MIME types for the image format.
-@extensions: a %NULL-terminated array of typical filename extensions for the
-image format.
-@flags: 
-
 <!-- ##### STRUCT GdkPixbufFrame ##### -->
 <para>
  This object describes an individual frame of an animation.
@@ -412,92 +397,6 @@ image format.
 @pixbuf: The pixbuf that is losing its last reference.
 @data: User closure data.
 
-<!-- ##### USER_FUNCTION GdkPixbufModuleFillInfoFunc ##### -->
-<para>
-Defines the type of the function used to fill a 
-#GdkPixbufFormat structure with information about a module.
-</para>
-
-@info: a #GdkPixbufFormat.
-
-<!-- ##### USER_FUNCTION GdkPixbufModuleFillVtableFunc ##### -->
-<para>
-Defines the type of the function used to set the vtable of a 
-#GdkPixbufModule when it is loaded. 
-</para>
-
-@module: a #GdkPixbufModule.
-
-<!-- ##### STRUCT GdkPixbufModulePattern ##### -->
-<para>
-The signature of a module is a set of prefixes. Prefixes are encoded as
-pairs of ordinary strings, where the second string, if not %NULL,
-may contain ' ', '!', 'x', 'z', and 'n' to indicate bytes that must be 
-matched, not matched, "don't-care"-bytes, zeros and non-zeros.
-Each prefix has an associated integer that describes the relevance of 
-the prefix, with 0 meaning a mismatch and 100 a "perfect match".
-</para>
-
-<para>
-The signature of a module is stored as an array of 
-#GdkPixbufModulePattern<!-- -->s. 
-</para>
-
-@prefix: the prefix for this pattern
-@mask: mask containing bytes which modify how the prefix is matched against
-  test data
-@relevance: relevance of this pattern
-
-<!-- ##### USER_FUNCTION GdkPixbufModulePreparedFunc ##### -->
-<para>
-Defines the type of the function that gets called once the initial 
-setup of @pixbuf is done.
-</para>
-<para>
-#GdkPixbufLoader uses a function of this type to emit the 
-"<link linkend="GdkPixbufLoader-area-prepared">area_prepared</link>"
-signal.
-</para>
-
-@pixbuf: the #GdkPixbuf that is currently being loaded.
-@anim: if an animation is being loaded, the #GdkPixbufAnimation, else %NULL.
-@user_data: the loader.
-
-<!-- ##### USER_FUNCTION GdkPixbufModuleSizeFunc ##### -->
-<para>
-Defines the type of the function that gets called once the size 
-of the loaded image is known.
-</para>
-<para>
-The function is expected to set @width and @height to the desired
-size to which the image should be scaled. If a module has no efficient 
-way to achieve the desired scaling during the loading of the image, it may
-either ignore the size request, or only approximate it -- &gdk-pixbuf; will
-then perform the required scaling on the completely loaded image. 
-</para>
-
-@width: pointer to a location containing the current image width
-@height: pointer to a location containing the current image height
-@user_data: the loader.
-
-<!-- ##### USER_FUNCTION GdkPixbufModuleUpdatedFunc ##### -->
-<para>
-Defines the type of the function that gets called every time a region
-of @pixbuf is updated.
-</para>
-<para>
-#GdkPixbufLoader uses a function of this type to emit the 
-"<link linkend="GdkPixbufLoader-area-updated">area_updated</link>"
-signal.
-</para>
-
-@pixbuf: the #GdkPixbuf that is currently being loaded.
-@x: the X origin of the updated area.
-@y: the Y origin of the updated area.
-@width: the width of the updated area.
-@height: the height of the updated area.
-@user_data: the loader.
-
 <!-- ##### ARG GnomeCanvasPixbuf:height ##### -->
   <para>
     Indicates the height the pixbuf will be scaled to.  This argument
@@ -668,53 +567,6 @@ End:
   </para>
 
 
-<!-- ##### FUNCTION gdk_pixbuf_format_get_description ##### -->
-<para>
-
-</para>
-
-@format: 
-@Returns: 
-
-<!-- ##### FUNCTION gdk_pixbuf_format_get_extensions ##### -->
-<para>
-
-</para>
-
-@format: 
-@Returns: 
-
-<!-- ##### FUNCTION gdk_pixbuf_format_get_mime_types ##### -->
-<para>
-
-</para>
-
-@format: 
-@Returns: 
-
-<!-- ##### FUNCTION gdk_pixbuf_format_get_name ##### -->
-<para>
-
-</para>
-
-@format: 
-@Returns: 
-
-<!-- ##### FUNCTION gdk_pixbuf_format_is_writable ##### -->
-<para>
-
-</para>
-
-@format: 
-@Returns: 
-
-<!-- ##### FUNCTION gdk_pixbuf_get_formats ##### -->
-<para>
-
-</para>
-
-@Returns: 
-
 <!-- ##### FUNCTION gdk_pixbuf_new_from_stream ##### -->
 <para>
 
diff --git a/docs/reference/gdk-pixbuf/tmpl/module_interface.sgml b/docs/reference/gdk-pixbuf/tmpl/module_interface.sgml
index 412fec6981..26f0c72ea2 100644
--- a/docs/reference/gdk-pixbuf/tmpl/module_interface.sgml
+++ b/docs/reference/gdk-pixbuf/tmpl/module_interface.sgml
@@ -65,6 +65,183 @@ They are not covered by the same stability guarantees as the regular
 
 </para>
 
+<!-- ##### FUNCTION gdk_pixbuf_set_option ##### -->
+<para>
+
+</para>
+
+@pixbuf: 
+@key: 
+@value: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gdk_pixbuf_get_formats ##### -->
+<para>
+
+</para>
+
+@Returns: 
+
+
+<!-- ##### FUNCTION gdk_pixbuf_format_get_name ##### -->
+<para>
+
+</para>
+
+@format: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gdk_pixbuf_format_get_description ##### -->
+<para>
+
+</para>
+
+@format: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gdk_pixbuf_format_get_mime_types ##### -->
+<para>
+
+</para>
+
+@format: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gdk_pixbuf_format_get_extensions ##### -->
+<para>
+
+</para>
+
+@format: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gdk_pixbuf_format_is_writable ##### -->
+<para>
+
+</para>
+
+@format: 
+@Returns: 
+
+
+<!-- ##### STRUCT GdkPixbufFormat ##### -->
+<para>
+A #GdkPixbufFormat contains information about the image format accepted by a
+module. Only modules should access the fields directly.
+</para>
+
+@name: the name of the image format
+@signature: the signature of the module
+@domain: the message domain for the @description
+@description: a description of the image format
+@mime_types: a %NULL-terminated array of MIME types for the image format.
+@extensions: a %NULL-terminated array of typical filename extensions for the
+image format.
+@flags: 
+
+<!-- ##### ENUM GdkPixbufFormatFlags ##### -->
+<para>
+
+</para>
+
+@GDK_PIXBUF_FORMAT_WRITABLE: 
+
+<!-- ##### STRUCT GdkPixbufModulePattern ##### -->
+<para>
+The signature of a module is a set of prefixes. Prefixes are encoded as
+pairs of ordinary strings, where the second string, if not %NULL,
+may contain ' ', '!', 'x', 'z', and 'n' to indicate bytes that must be 
+matched, not matched, "don't-care"-bytes, zeros and non-zeros.
+Each prefix has an associated integer that describes the relevance of 
+the prefix, with 0 meaning a mismatch and 100 a "perfect match".
+</para>
+
+<para>
+The signature of a module is stored as an array of 
+#GdkPixbufModulePattern<!-- -->s. 
+</para>
+
+@prefix: the prefix for this pattern
+@mask: mask containing bytes which modify how the prefix is matched against
+  test data
+@relevance: relevance of this pattern
+
+<!-- ##### USER_FUNCTION GdkPixbufModuleFillVtableFunc ##### -->
+<para>
+Defines the type of the function used to set the vtable of a 
+#GdkPixbufModule when it is loaded. 
+</para>
+
+@module: a #GdkPixbufModule.
+
+
+<!-- ##### USER_FUNCTION GdkPixbufModuleFillInfoFunc ##### -->
+<para>
+Defines the type of the function used to fill a 
+#GdkPixbufFormat structure with information about a module.
+</para>
+
+@info: a #GdkPixbufFormat.
+
+
+<!-- ##### USER_FUNCTION GdkPixbufModuleSizeFunc ##### -->
+<para>
+Defines the type of the function that gets called once the size 
+of the loaded image is known.
+</para>
+<para>
+The function is expected to set @width and @height to the desired
+size to which the image should be scaled. If a module has no efficient 
+way to achieve the desired scaling during the loading of the image, it may
+either ignore the size request, or only approximate it -- &gdk-pixbuf; will
+then perform the required scaling on the completely loaded image. 
+</para>
+
+@width: pointer to a location containing the current image width
+@height: pointer to a location containing the current image height
+@user_data: the loader.
+
+
+<!-- ##### USER_FUNCTION GdkPixbufModulePreparedFunc ##### -->
+<para>
+Defines the type of the function that gets called once the initial 
+setup of @pixbuf is done.
+</para>
+<para>
+#GdkPixbufLoader uses a function of this type to emit the 
+"<link linkend="GdkPixbufLoader-area-prepared">area_prepared</link>"
+signal.
+</para>
+
+@pixbuf: the #GdkPixbuf that is currently being loaded.
+@anim: if an animation is being loaded, the #GdkPixbufAnimation, else %NULL.
+@user_data: the loader.
+
+
+<!-- ##### USER_FUNCTION GdkPixbufModuleUpdatedFunc ##### -->
+<para>
+Defines the type of the function that gets called every time a region
+of @pixbuf is updated.
+</para>
+<para>
+#GdkPixbufLoader uses a function of this type to emit the 
+"<link linkend="GdkPixbufLoader-area-updated">area_updated</link>"
+signal.
+</para>
+
+@pixbuf: the #GdkPixbuf that is currently being loaded.
+@x: the X origin of the updated area.
+@y: the Y origin of the updated area.
+@width: the width of the updated area.
+@height: the height of the updated area.
+@user_data: the loader.
+
+
 <!-- ##### STRUCT GdkPixbufModule ##### -->
 <para>
 A #GdkPixbufModule contains the necessary functions to load and save 
@@ -96,3 +273,15 @@ is loaded and must set the function pointers of the #GdkPixbufModule.
 @_reserved5: 
 @_reserved6: 
 
+<!-- ##### STRUCT GdkPixbufAnimationClass ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### STRUCT GdkPixbufAnimationIterClass ##### -->
+<para>
+
+</para>
+
+
diff --git a/docs/reference/gdk/tmpl/dnd.sgml b/docs/reference/gdk/tmpl/dnd.sgml
index 3d372c68b0..07005b1169 100644
--- a/docs/reference/gdk/tmpl/dnd.sgml
+++ b/docs/reference/gdk/tmpl/dnd.sgml
@@ -96,6 +96,20 @@ This function is called by the drag source to obtain the
 @protocol: location to store the DND protocol in.
 
 
+<!-- ##### FUNCTION gdk_drag_find_window_for_screen ##### -->
+<para>
+
+</para>
+
+@context: 
+@drag_window: 
+@screen: 
+@x_root: 
+@y_root: 
+@dest_window: 
+@protocol: 
+
+
 <!-- ##### FUNCTION gdk_drag_context_ref ##### -->
 <para>
 Deprecated function; use g_object_ref() instead.
diff --git a/docs/reference/gdk/tmpl/drawing.sgml b/docs/reference/gdk/tmpl/drawing.sgml
index 91ff9ac378..0238676f7e 100644
--- a/docs/reference/gdk/tmpl/drawing.sgml
+++ b/docs/reference/gdk/tmpl/drawing.sgml
@@ -204,6 +204,25 @@ lines.
 @npoints: the size of the @points array.
 
 
+<!-- ##### FUNCTION gdk_draw_pixbuf ##### -->
+<para>
+
+</para>
+
+@drawable: 
+@gc: 
+@pixbuf: 
+@src_x: 
+@src_y: 
+@dest_x: 
+@dest_y: 
+@width: 
+@height: 
+@dither: 
+@x_dither: 
+@y_dither: 
+
+
 <!-- ##### FUNCTION gdk_draw_segments ##### -->
 <para>
 Draws a number of unconnected lines.
diff --git a/docs/reference/gdk/tmpl/events.sgml b/docs/reference/gdk/tmpl/events.sgml
index 131fed144a..a6a7c0924c 100644
--- a/docs/reference/gdk/tmpl/events.sgml
+++ b/docs/reference/gdk/tmpl/events.sgml
@@ -183,6 +183,15 @@ is given in the <link linkend="glib-The-Main-Event-Loop">GLib Main Loop</link>.
 @event: 
 
 
+<!-- ##### FUNCTION gdk_event_new ##### -->
+<para>
+
+</para>
+
+@type: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gdk_event_copy ##### -->
 <para>
 </para>
@@ -323,6 +332,24 @@ gdk_event_handler_set().
 @show_events: 
 
 
+<!-- ##### FUNCTION gdk_event_set_screen ##### -->
+<para>
+
+</para>
+
+@event: 
+@screen: 
+
+
+<!-- ##### FUNCTION gdk_event_get_screen ##### -->
+<para>
+
+</para>
+
+@event: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gdk_setting_get ##### -->
 <para>
 </para>
diff --git a/docs/reference/gdk/tmpl/gdk-unused.sgml b/docs/reference/gdk/tmpl/gdk-unused.sgml
index d13f51750e..681fd6672e 100644
--- a/docs/reference/gdk/tmpl/gdk-unused.sgml
+++ b/docs/reference/gdk/tmpl/gdk-unused.sgml
@@ -914,6 +914,16 @@ they will be ignored.
 
 @screen: 
 
+<!-- ##### FUNCTION gdk_screen_get_window_at_pointer ##### -->
+<para>
+
+</para>
+
+@screen: 
+@win_x: 
+@win_y: 
+@Returns: 
+
 <!-- ##### FUNCTION gdk_screen_use_virtual_screen ##### -->
 <para>
 
diff --git a/docs/reference/gdk/tmpl/gdkdisplay.sgml b/docs/reference/gdk/tmpl/gdkdisplay.sgml
index acf62b5da8..7dd4820ea2 100644
--- a/docs/reference/gdk/tmpl/gdkdisplay.sgml
+++ b/docs/reference/gdk/tmpl/gdkdisplay.sgml
@@ -196,6 +196,48 @@ of an X display. All its fields are private and should not be accessed directly.
 @msec: 
 
 
+<!-- ##### FUNCTION gdk_display_get_pointer ##### -->
+<para>
+
+</para>
+
+@display: 
+@screen: 
+@x: 
+@y: 
+@mask: 
+
+
+<!-- ##### FUNCTION gdk_display_get_window_at_pointer ##### -->
+<para>
+
+</para>
+
+@display: 
+@win_x: 
+@win_y: 
+@Returns: 
+
+
+<!-- ##### STRUCT GdkDisplayPointerHooks ##### -->
+<para>
+
+</para>
+
+@get_pointer: 
+@window_get_pointer: 
+@window_at_pointer: 
+
+<!-- ##### FUNCTION gdk_display_set_pointer_hooks ##### -->
+<para>
+
+</para>
+
+@display: 
+@new_hooks: 
+@Returns: 
+
+
 <!-- ##### SIGNAL GdkDisplay::closed ##### -->
 <para>
 
diff --git a/docs/reference/gdk/tmpl/gdkscreen.sgml b/docs/reference/gdk/tmpl/gdkscreen.sgml
index 689681138f..7585f5114a 100644
--- a/docs/reference/gdk/tmpl/gdkscreen.sgml
+++ b/docs/reference/gdk/tmpl/gdkscreen.sgml
@@ -119,18 +119,16 @@ when GDK gets multihead support.
 @Returns: 
 
 
-<!-- ##### FUNCTION gdk_screen_get_window_at_pointer ##### -->
+<!-- ##### FUNCTION gdk_screen_get_width ##### -->
 <para>
 
 </para>
 
 @screen: 
-@win_x: 
-@win_y: 
 @Returns: 
 
 
-<!-- ##### FUNCTION gdk_screen_get_width ##### -->
+<!-- ##### FUNCTION gdk_screen_get_height ##### -->
 <para>
 
 </para>
@@ -139,7 +137,7 @@ when GDK gets multihead support.
 @Returns: 
 
 
-<!-- ##### FUNCTION gdk_screen_get_height ##### -->
+<!-- ##### FUNCTION gdk_screen_get_width_mm ##### -->
 <para>
 
 </para>
@@ -148,7 +146,7 @@ when GDK gets multihead support.
 @Returns: 
 
 
-<!-- ##### FUNCTION gdk_screen_get_width_mm ##### -->
+<!-- ##### FUNCTION gdk_screen_get_height_mm ##### -->
 <para>
 
 </para>
@@ -157,7 +155,7 @@ when GDK gets multihead support.
 @Returns: 
 
 
-<!-- ##### FUNCTION gdk_screen_get_height_mm ##### -->
+<!-- ##### FUNCTION gdk_screen_list_visuals ##### -->
 <para>
 
 </para>
@@ -166,7 +164,7 @@ when GDK gets multihead support.
 @Returns: 
 
 
-<!-- ##### FUNCTION gdk_screen_list_visuals ##### -->
+<!-- ##### FUNCTION gdk_screen_get_toplevel_windows ##### -->
 <para>
 
 </para>
@@ -175,7 +173,7 @@ when GDK gets multihead support.
 @Returns: 
 
 
-<!-- ##### FUNCTION gdk_screen_get_toplevel_windows ##### -->
+<!-- ##### FUNCTION gdk_screen_make_display_name ##### -->
 <para>
 
 </para>
diff --git a/docs/reference/gdk/tmpl/windows.sgml b/docs/reference/gdk/tmpl/windows.sgml
index 53fcc69bfb..7e3101a355 100644
--- a/docs/reference/gdk/tmpl/windows.sgml
+++ b/docs/reference/gdk/tmpl/windows.sgml
@@ -401,6 +401,22 @@ Deprecated equivalent of g_object_unref()
 @window: 
 
 
+<!-- ##### FUNCTION gdk_window_fullscreen ##### -->
+<para>
+
+</para>
+
+@window: 
+
+
+<!-- ##### FUNCTION gdk_window_unfullscreen ##### -->
+<para>
+
+</para>
+
+@window: 
+
+
 <!-- ##### FUNCTION gdk_window_move ##### -->
 <para>
 
@@ -932,6 +948,24 @@ Deprecated equivalent to gdk_drawable_set_colormap()
 @hint: 
 
 
+<!-- ##### FUNCTION gdk_window_set_skip_taskbar_hint ##### -->
+<para>
+
+</para>
+
+@window: 
+@skips_taskbar: 
+
+
+<!-- ##### FUNCTION gdk_window_set_skip_pager_hint ##### -->
+<para>
+
+</para>
+
+@window: 
+@skips_pager: 
+
+
 <!-- ##### FUNCTION gdk_window_get_position ##### -->
 <para>
 
diff --git a/docs/reference/gdk/tmpl/x_interaction.sgml b/docs/reference/gdk/tmpl/x_interaction.sgml
index fec8a43d95..2c01db3001 100644
--- a/docs/reference/gdk/tmpl/x_interaction.sgml
+++ b/docs/reference/gdk/tmpl/x_interaction.sgml
@@ -417,6 +417,35 @@ Obtains the #GdkFont for the given Xlib font ID on @display, or %NULL if no
 @Returns: 
 
 
+<!-- ##### FUNCTION gdk_x11_screen_get_window_manager_name ##### -->
+<para>
+
+</para>
+
+@screen: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gdk_x11_screen_lookup_visual ##### -->
+<para>
+
+</para>
+
+@screen: 
+@xvisualid: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gdk_x11_colormap_foreign_new ##### -->
+<para>
+
+</para>
+
+@visual: 
+@xcolormap: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gdk_x11_colormap_get_xcolormap ##### -->
 <para>
 Returns the X colormap belonging to a #GdkColormap.
@@ -464,6 +493,22 @@ Returns the display of a #GdkCursor.
 @Returns: 
 
 
+<!-- ##### FUNCTION gdk_x11_display_grab ##### -->
+<para>
+
+</para>
+
+@display: 
+
+
+<!-- ##### FUNCTION gdk_x11_display_ungrab ##### -->
+<para>
+
+</para>
+
+@display: 
+
+
 <!-- ##### FUNCTION gdk_x11_drawable_get_xdisplay ##### -->
 <para>
 Returns the display of a #GdkDrawable.
diff --git a/docs/reference/gtk/tmpl/gtk-unused.sgml b/docs/reference/gtk/tmpl/gtk-unused.sgml
index bd4999a4a3..35265757e2 100644
--- a/docs/reference/gtk/tmpl/gtk-unused.sgml
+++ b/docs/reference/gtk/tmpl/gtk-unused.sgml
@@ -1122,6 +1122,30 @@ and its unique identifying integer.
 @nparams: 
 @params: 
 
+<!-- ##### SIGNAL GtkStatusbar::text-popped ##### -->
+<para>
+Is emitted whenever a new message is popped off a statusbar's stack.
+</para>
+
+@statusbar: the object which received the signal.
+@context_id: the context id of the relevant message/statusbar.
+@text: the message that was just popped.
+
+<!-- ##### SIGNAL GtkStatusbar::text-pushed ##### -->
+<para>
+Is emitted whenever a new message gets pushed onto a statusbar's stack.
+</para>
+
+@statusbar: the object which received the signal.
+@context_id: the context id of the relevant message/statusbar.
+@text: the message that was pushed.
+
+<!-- ##### ARG GtkStatusbar:shadow-type ##### -->
+<para>
+
+</para>
+
+
 <!-- ##### STRUCT GtkStatusbarMsg ##### -->
 <para>
 Holds the data for a statusbar message. <structfield>text</structfield> holds the actual text string. <structfield>context_id</structfield> is the context that this message is associated with, and <structfield>message_id</structfield> is this particular message's identifier. However, these fields should not be modified directly.
diff --git a/docs/reference/gtk/tmpl/gtkaccelgroup.sgml b/docs/reference/gtk/tmpl/gtkaccelgroup.sgml
index d9d3fa10e5..49e042ce16 100644
--- a/docs/reference/gtk/tmpl/gtkaccelgroup.sgml
+++ b/docs/reference/gtk/tmpl/gtkaccelgroup.sgml
@@ -98,6 +98,17 @@ Deprecated equivalent of g_object_unref().
 @Returns: 
 
 
+<!-- ##### USER_FUNCTION GtkAccelGroupFindFunc ##### -->
+<para>
+
+</para>
+
+@key: 
+@closure: 
+@data: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gtk_accel_group_disconnect ##### -->
 <para>
 
diff --git a/docs/reference/gtk/tmpl/gtkbox.sgml b/docs/reference/gtk/tmpl/gtkbox.sgml
index bfdad588d9..3ad6e766b1 100644
--- a/docs/reference/gtk/tmpl/gtkbox.sgml
+++ b/docs/reference/gtk/tmpl/gtkbox.sgml
@@ -131,6 +131,9 @@ field.</entry>
 </tbody></tgroup></informaltable>
 </para>
 
+@children: 
+@spacing: 
+@homogeneous: 
 
 <!-- ##### STRUCT GtkBoxChild ##### -->
 <para>

diff --git a/docs/reference/gtk/tmpl/gtkbutton.sgml b/docs/reference/gtk/tmpl/gtkbutton.sgml
index 1b60ff31a0..a78809fd4b 100644
--- a/docs/reference/gtk/tmpl/gtkbutton.sgml
+++ b/docs/reference/gtk/tmpl/gtkbutton.sgml
@@ -29,7 +29,8 @@ This should not be accessed directly.  Use the accessor functions below.
 
 <!-- ##### FUNCTION gtk_button_new ##### -->
 <para>
-Creates a new #GtkButton widget.
+Creates a new #GtkButton widget. To add a child widget to the button,
+use gtk_container_add().
 </para>
 
 @Returns: The newly created #GtkButton widget.
diff --git a/docs/reference/gtk/tmpl/gtkdialog.sgml b/docs/reference/gtk/tmpl/gtkdialog.sgml
index 24dc48ecd3..9fafa89c2b 100644
--- a/docs/reference/gtk/tmpl/gtkdialog.sgml
+++ b/docs/reference/gtk/tmpl/gtkdialog.sgml
@@ -130,8 +130,8 @@ response from the user.</para></listitem>
 <structfield>vbox</structfield> is a #GtkVBox - the main part of the
 dialog box.
 </para>
-<para>
 
+<para>
 <structfield>action_area</structfield> is a #GtkHButtonBox packed below the
 dividing #GtkHSeparator in the dialog. It is treated exactly the same
 as any other #GtkHButtonBox.
diff --git a/docs/reference/gtk/tmpl/gtkiconfactory.sgml b/docs/reference/gtk/tmpl/gtkiconfactory.sgml
index 653d7268da..f36190f014 100644
--- a/docs/reference/gtk/tmpl/gtkiconfactory.sgml
+++ b/docs/reference/gtk/tmpl/gtkiconfactory.sgml
@@ -221,6 +221,18 @@ looking up the icon to use for a given stock ID.
 @alias: 
 
 
+<!-- ##### FUNCTION gtk_icon_size_lookup_for_settings ##### -->
+<para>
+
+</para>
+
+@settings: 
+@size: 
+@width: 
+@height: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gtk_icon_size_register ##### -->
 <para>
 
diff --git a/docs/reference/gtk/tmpl/gtkliststore.sgml b/docs/reference/gtk/tmpl/gtkliststore.sgml
index fc8d5d30f0..149c389149 100644
--- a/docs/reference/gtk/tmpl/gtkliststore.sgml
+++ b/docs/reference/gtk/tmpl/gtkliststore.sgml
@@ -167,3 +167,42 @@ drop</link> interfaces.
 @list_store: 
 
 
+<!-- ##### FUNCTION gtk_list_store_iter_is_valid ##### -->
+<para>
+
+</para>
+
+@list_store: 
+@iter: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_list_store_reorder ##### -->
+<para>
+
+</para>
+
+@store: 
+@new_order: 
+
+
+<!-- ##### FUNCTION gtk_list_store_swap ##### -->
+<para>
+
+</para>
+
+@store: 
+@a: 
+@b: 
+
+
+<!-- ##### FUNCTION gtk_list_store_move ##### -->
+<para>
+
+</para>
+
+@store: 
+@iter: 
+@position: 
+
+
diff --git a/docs/reference/gtk/tmpl/gtkmain.sgml b/docs/reference/gtk/tmpl/gtkmain.sgml
index 885a793d99..0dd8d6509d 100644
--- a/docs/reference/gtk/tmpl/gtkmain.sgml
+++ b/docs/reference/gtk/tmpl/gtkmain.sgml
@@ -289,6 +289,14 @@ cleaned from any arguments that GTK+ handles itself.
 @argv: Points to the argument vector.
 
 
+<!-- ##### USER_FUNCTION GtkModuleDisplayInitFunc ##### -->
+<para>
+
+</para>
+
+@display: 
+
+
 <!-- ##### FUNCTION gtk_true ##### -->
 <para>
 All this function does it to return %TRUE. This can be useful for example
diff --git a/docs/reference/gtk/tmpl/gtkmenu.sgml b/docs/reference/gtk/tmpl/gtkmenu.sgml
index d5aa97fd46..10d49af0c7 100644
--- a/docs/reference/gtk/tmpl/gtkmenu.sgml
+++ b/docs/reference/gtk/tmpl/gtkmenu.sgml
@@ -151,21 +151,15 @@ Moves a #GtkMenuItem to a new position within the #GtkMenu.
 
 
 <!-- ##### FUNCTION gtk_menu_popup ##### -->
-<para>
-Displays a menu and makes it available for selection.  Applications can use
-this function to display context-sensitive menus, and will typically supply
-%NULL for the @parent_menu_shell, @parent_menu_item, @func and @data 
-parameters.  The default menu positioning function will position the menu
-at the current pointer position.
-</para>
 
-@menu: a #GtkMenu.
-@parent_menu_shell: the menu shell containing the triggering menu item.
-@parent_menu_item: the menu item whose activation triggered the popup.
-@func: a user supplied function used to position the menu.
-@data: user supplied data to be passed to @func.
-@button: the button which was pressed to initiate the event.
-@activate_time: the time at which the activation event occurred.
+
+@menu: 
+@parent_menu_shell: 
+@parent_menu_item: 
+@func: 
+@data: 
+@button: 
+@activate_time: 
 
 
 <!-- ##### FUNCTION gtk_menu_set_accel_group ##### -->
diff --git a/docs/reference/gtk/tmpl/gtkmenushell.sgml b/docs/reference/gtk/tmpl/gtkmenushell.sgml
index 08e9490a48..e5009d44be 100644
--- a/docs/reference/gtk/tmpl/gtkmenushell.sgml
+++ b/docs/reference/gtk/tmpl/gtkmenushell.sgml
@@ -89,6 +89,15 @@ Selects the menu item from the menu shell.
 @menu_item: The #GtkMenuItem to select.
 
 
+<!-- ##### FUNCTION gtk_menu_shell_select_first ##### -->
+<para>
+
+</para>
+
+@menu_shell: 
+@search_sensitive: 
+
+
 <!-- ##### FUNCTION gtk_menu_shell_deselect ##### -->
 <para>
 Deselects the currently selected item from the menu shell, if any.
diff --git a/docs/reference/gtk/tmpl/gtknotebook.sgml b/docs/reference/gtk/tmpl/gtknotebook.sgml
index 963da3141a..6694ba7be5 100644
--- a/docs/reference/gtk/tmpl/gtknotebook.sgml
+++ b/docs/reference/gtk/tmpl/gtknotebook.sgml
@@ -244,6 +244,15 @@ gtk_notebook_set_current_page() instead.
 @Returns: 
 
 
+<!-- ##### FUNCTION gtk_notebook_get_n_pages ##### -->
+<para>
+
+</para>
+
+@notebook: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gtk_notebook_get_tab_label ##### -->
 <para>
 </para>
diff --git a/docs/reference/gtk/tmpl/gtkpaned.sgml b/docs/reference/gtk/tmpl/gtkpaned.sgml
index aa1d425e8b..3fe425c216 100644
--- a/docs/reference/gtk/tmpl/gtkpaned.sgml
+++ b/docs/reference/gtk/tmpl/gtkpaned.sgml
@@ -58,8 +58,8 @@ gtk_widget_set_size_request (hpaned, 200 + GTK_PANED (hpaned)->gutter_size, -1);
 gtk_paned_pack1 (GTK_PANED (hpaned), frame1, TRUE, FALSE);
 gtk_widget_set_size_request (frame1, 50, -1);
 
-gtk_paned_pack2 (GTK_PANED (hpaned), frame1, FALSE, FALSE);
-gtk_widget_set_size_request (frame1, 50, -1);
+gtk_paned_pack2 (GTK_PANED (hpaned), frame2, FALSE, FALSE);
+gtk_widget_set_size_request (frame2, 50, -1);
 </programlisting>
 </example>
 
diff --git a/docs/reference/gtk/tmpl/gtkstatusbar.sgml b/docs/reference/gtk/tmpl/gtkstatusbar.sgml
index 4d7ea2688b..0d575b6cc3 100644
--- a/docs/reference/gtk/tmpl/gtkstatusbar.sgml
+++ b/docs/reference/gtk/tmpl/gtkstatusbar.sgml
@@ -51,6 +51,15 @@ The message at the top of the stack can be removed using gtk_statusbar_pop(). A
 Contains private data that should be modified with the functions described below.
 </para>
 
+@parent_widget: 
+@frame: 
+@label: 
+@messages: 
+@keys: 
+@seq_context_id: 
+@seq_message_id: 
+@grip_window: 
+@has_resize_grip: 
 
 <!-- ##### FUNCTION gtk_statusbar_new ##### -->
 <para>
@@ -120,26 +129,3 @@ Returns whether the statusbar has a resize grip.
 @Returns: %TRUE if the statusbar has a resize grip.
 
 
-<!-- ##### SIGNAL GtkStatusbar::text-popped ##### -->
-<para>
-Is emitted whenever a new message is popped off a statusbar's stack.
-</para>
-
-@statusbar: the object which received the signal.
-@context_id: the context id of the relevant message/statusbar.
-@text: the message that was just popped.
-
-<!-- ##### SIGNAL GtkStatusbar::text-pushed ##### -->
-<para>
-Is emitted whenever a new message gets pushed onto a statusbar's stack.
-</para>
-
-@statusbar: the object which received the signal.
-@context_id: the context id of the relevant message/statusbar.
-@text: the message that was pushed.
-
-<!-- ##### ARG GtkStatusbar:shadow-type ##### -->
-<para>
-
-</para>
-
diff --git a/docs/reference/gtk/tmpl/gtkstock.sgml b/docs/reference/gtk/tmpl/gtkstock.sgml
index afb8578a62..64a1108bd3 100644
--- a/docs/reference/gtk/tmpl/gtkstock.sgml
+++ b/docs/reference/gtk/tmpl/gtkstock.sgml
@@ -151,6 +151,13 @@ The "Close" item.
 
 
 
+<!-- ##### MACRO GTK_STOCK_COLOR_PICKER ##### -->
+<para>
+
+</para>
+
+
+
 <!-- ##### MACRO GTK_STOCK_CONVERT ##### -->
 <para>
 The "Convert" item.
diff --git a/docs/reference/gtk/tmpl/gtktable.sgml b/docs/reference/gtk/tmpl/gtktable.sgml
index 57ef0d0b43..7fda888960 100644
--- a/docs/reference/gtk/tmpl/gtktable.sgml
+++ b/docs/reference/gtk/tmpl/gtktable.sgml
@@ -135,8 +135,8 @@ and row numbers of the table. (Columns and rows are indexed from zero).
 @child: The widget to add.
 @left_attach: the column number to attach the left side of a child widget to.
 @right_attach: the column number to attach the right side of a child widget to.
-@top_attach: the row number to attach the left side of a child widget to.
-@bottom_attach: the column number to attach the right side of a child widget to.
+@top_attach: the row number to attach the top of a child widget to.
+@bottom_attach: the column number to attach the bottom of a child widget to.
 @xoptions: Used to specify the properties of the child widget when the table is resized.
 @yoptions: The same as xoptions, except this field determines behaviour of vertical resizing.
 @xpadding: An integer value specifying the padding on the left and right of the widget being added to the table.
diff --git a/docs/reference/gtk/tmpl/gtktreemodel.sgml b/docs/reference/gtk/tmpl/gtktreemodel.sgml
index 902ea0911f..4ebe443567 100644
--- a/docs/reference/gtk/tmpl/gtktreemodel.sgml
+++ b/docs/reference/gtk/tmpl/gtktreemodel.sgml
@@ -125,7 +125,7 @@ the second is much more common, as you often get paths from callbacks.
   parent_iter = iter;
   gtk_tree_model_get_nth_child (model, &amp;iter, &amp;parent_iter, 2);
   parent_iter = iter;
-  gtk_tree_model_get_nth_child (model, &amp;iter, NULL, 5);
+  gtk_tree_model_get_nth_child (model, &amp;iter, &amp;parent_iter, 5);
 }
 </programlisting>
 </example>
@@ -291,6 +291,16 @@ section.
 @Returns: 
 
 
+<!-- ##### FUNCTION gtk_tree_path_new_from_indices ##### -->
+<para>
+
+</para>
+
+@first_index: 
+@Varargs: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gtk_tree_path_to_string ##### -->
 <para>
 
@@ -482,6 +492,15 @@ versions of GTK+.
 @reference: 
 
 
+<!-- ##### FUNCTION gtk_tree_row_reference_copy ##### -->
+<para>
+
+</para>
+
+@reference: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gtk_tree_row_reference_inserted ##### -->
 <para>
 
@@ -685,6 +704,16 @@ versions of GTK+.
 @Returns: 
 
 
+<!-- ##### FUNCTION gtk_tree_model_get_string_from_iter ##### -->
+<para>
+
+</para>
+
+@tree_model: 
+@iter: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gtk_tree_model_ref_node ##### -->
 <para>
 
diff --git a/docs/reference/gtk/tmpl/gtktreemodelsort.sgml b/docs/reference/gtk/tmpl/gtktreemodelsort.sgml
index fc2d4cce79..1bea6a9297 100644
--- a/docs/reference/gtk/tmpl/gtktreemodelsort.sgml
+++ b/docs/reference/gtk/tmpl/gtktreemodelsort.sgml
@@ -98,6 +98,16 @@ GtkTreeModelSort
 @tree_model_sort: 
 
 
+<!-- ##### FUNCTION gtk_tree_model_sort_iter_is_valid ##### -->
+<para>
+
+</para>
+
+@tree_model_sort: 
+@iter: 
+@Returns: 
+
+
 <!-- ##### ARG GtkTreeModelSort:model ##### -->
 <para>
 
diff --git a/docs/reference/gtk/tmpl/gtktreeselection.sgml b/docs/reference/gtk/tmpl/gtktreeselection.sgml
index efb2dd085d..b88d04c3aa 100644
--- a/docs/reference/gtk/tmpl/gtktreeselection.sgml
+++ b/docs/reference/gtk/tmpl/gtktreeselection.sgml
@@ -142,6 +142,25 @@ selected rows.  It will be called on every selected row in the view.
 @data: 
 
 
+<!-- ##### FUNCTION gtk_tree_selection_get_selected_rows ##### -->
+<para>
+
+</para>
+
+@selection: 
+@model: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_tree_selection_count_selected_rows ##### -->
+<para>
+
+</para>
+
+@selection: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gtk_tree_selection_select_path ##### -->
 <para>
 
@@ -224,6 +243,16 @@ selected rows.  It will be called on every selected row in the view.
 @end_path: 
 
 
+<!-- ##### FUNCTION gtk_tree_selection_unselect_range ##### -->
+<para>
+
+</para>
+
+@selection: 
+@start_path: 
+@end_path: 
+
+
 <!-- ##### SIGNAL GtkTreeSelection::changed ##### -->
 <para>
 Emitted whenever the selection has (possibly) changed.  Please note that
diff --git a/docs/reference/gtk/tmpl/gtktreestore.sgml b/docs/reference/gtk/tmpl/gtktreestore.sgml
index d1fdc867de..8ce862f456 100644
--- a/docs/reference/gtk/tmpl/gtktreestore.sgml
+++ b/docs/reference/gtk/tmpl/gtktreestore.sgml
@@ -173,3 +173,43 @@ GtkTreeStore
 @tree_store: 
 
 
+<!-- ##### FUNCTION gtk_tree_store_iter_is_valid ##### -->
+<para>
+
+</para>
+
+@tree_store: 
+@iter: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_tree_store_reorder ##### -->
+<para>
+
+</para>
+
+@tree_store: 
+@parent: 
+@new_order: 
+
+
+<!-- ##### FUNCTION gtk_tree_store_swap ##### -->
+<para>
+
+</para>
+
+@tree_store: 
+@a: 
+@b: 
+
+
+<!-- ##### FUNCTION gtk_tree_store_move ##### -->
+<para>
+
+</para>
+
+@tree_store: 
+@iter: 
+@position: 
+
+
diff --git a/docs/reference/gtk/tmpl/gtktreeview.sgml b/docs/reference/gtk/tmpl/gtktreeview.sgml
index 62f5fc3ac3..4d4de6b298 100644
--- a/docs/reference/gtk/tmpl/gtktreeview.sgml
+++ b/docs/reference/gtk/tmpl/gtktreeview.sgml
@@ -377,6 +377,18 @@ Function used for #gtk_tree_view_map_expanded_rows.
 @start_editing: 
 
 
+<!-- ##### FUNCTION gtk_tree_view_set_cursor_on_cell ##### -->
+<para>
+
+</para>
+
+@tree_view: 
+@path: 
+@focus_column: 
+@focus_cell: 
+@start_editing: 
+
+
 <!-- ##### FUNCTION gtk_tree_view_get_cursor ##### -->
 <para>
 
@@ -413,6 +425,15 @@ Function used for #gtk_tree_view_map_expanded_rows.
 @tree_view: 
 
 
+<!-- ##### FUNCTION gtk_tree_view_expand_to_path ##### -->
+<para>
+
+</para>
+
+@tree_view: 
+@path: 
+
+
 <!-- ##### FUNCTION gtk_tree_view_expand_row ##### -->
 <para>
 
diff --git a/docs/reference/gtk/tmpl/gtktreeviewcolumn.sgml b/docs/reference/gtk/tmpl/gtktreeviewcolumn.sgml
index 800698d907..6710dcfd36 100644
--- a/docs/reference/gtk/tmpl/gtktreeviewcolumn.sgml
+++ b/docs/reference/gtk/tmpl/gtktreeviewcolumn.sgml
@@ -471,6 +471,15 @@ calling gtk_tree_view_column_set_cell_data_func()
 @Returns: 
 
 
+<!-- ##### FUNCTION gtk_tree_view_column_focus_cell ##### -->
+<para>
+
+</para>
+
+@tree_column: 
+@cell: 
+
+
 <!-- ##### SIGNAL GtkTreeViewColumn::clicked ##### -->
 <para>
 
diff --git a/docs/reference/gtk/tmpl/gtkwindow.sgml b/docs/reference/gtk/tmpl/gtkwindow.sgml
index d973842873..5376d69fed 100644
--- a/docs/reference/gtk/tmpl/gtkwindow.sgml
+++ b/docs/reference/gtk/tmpl/gtkwindow.sgml
@@ -403,6 +403,22 @@ Deprecated alias for gtk_window_set_position().
 @window: 
 
 
+<!-- ##### FUNCTION gtk_window_fullscreen ##### -->
+<para>
+
+</para>
+
+@window: 
+
+
+<!-- ##### FUNCTION gtk_window_unfullscreen ##### -->
+<para>
+
+</para>
+
+@window: 
+
+
 <!-- ##### FUNCTION gtk_window_begin_resize_drag ##### -->
 <para>
 
@@ -485,6 +501,24 @@ Deprecated alias for gtk_window_set_position().
 @hint: 
 
 
+<!-- ##### FUNCTION gtk_window_set_skip_taskbar_hint ##### -->
+<para>
+
+</para>
+
+@window: 
+@setting: 
+
+
+<!-- ##### FUNCTION gtk_window_set_skip_pager_hint ##### -->
+<para>
+
+</para>
+
+@window: 
+@setting: 
+
+
 <!-- ##### FUNCTION gtk_window_get_decorated ##### -->
 <para>
 
@@ -637,6 +671,24 @@ Deprecated alias for gtk_window_set_position().
 @Returns: 
 
 
+<!-- ##### FUNCTION gtk_window_get_skip_taskbar_hint ##### -->
+<para>
+
+</para>
+
+@window: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_window_get_skip_pager_hint ##### -->
+<para>
+
+</para>
+
+@window: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gtk_window_move ##### -->
 <para>
 
@@ -683,6 +735,16 @@ Deprecated alias for gtk_window_set_position().
 @list: 
 
 
+<!-- ##### FUNCTION gtk_window_set_default_icon_from_file ##### -->
+<para>
+
+</para>
+
+@filename: 
+@err: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gtk_window_set_icon ##### -->
 <para>
 
@@ -701,6 +763,17 @@ Deprecated alias for gtk_window_set_position().
 @list: 
 
 
+<!-- ##### FUNCTION gtk_window_set_icon_from_file ##### -->
+<para>
+
+</para>
+
+@window: 
+@filename: 
+@err: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gtk_decorated_window_init ##### -->
 <para>