Minor documentation fixes

2002-08-10  Soren Sandmann  <sandmann@daimi.au.dk>

	* docs/reference/gtk/tree_widget.sgml,
	docs/reference/gtk/tmpl/gtkdialog.sgml,
	docs/reference/gtk/tmpl/gtkentry.sgml,
	docs/reference/gtk/tmpl/gtkfilesel.sgml,
	docs/reference/gtk/tmpl/gtkfontsel.sgml,
	docs/reference/gtk/tmpl/gtkfontseldlg.sgml,
	docs/reference/gtk/tmpl/gtktreemodel.sgml,
	docs/reference/gtk/tmpl/gtkwidget.sgml, gdk/x11/gdkdisplay-x11.c,
	gtk/gtkbbox.c, gtk/gtkbox.c, gtk/gtkbutton.c, gtk/gtkcellrenderer.c,
	gtk/gtkcellrendererpixbuf.c, gtk/gtkcellrenderertext.c,
	gtk/gtkcheckmenuitem.c, gtk/gtkcontainer.c, gtk/gtkcurve.c,
	gtk/gtkdialog.h, gtk/gtkentry.c, gtk/gtkfilesel.c, gtk/gtkfontsel.c,
	gtk/gtkframe.c, gtk/gtkhandlebox.c, gtk/gtkiconfactory.c,
	gtk/gtkimage.c, gtk/gtkinvisible.c, gtk/gtkitemfactory.c,
	gtk/gtklabel.c, gtk/gtklayout.c, gtk/gtkmenu.c, gtk/gtkprogress.c,
	gtk/gtkprogressbar.c, gtk/gtkscrolledwindow.c, gtk/gtksizegroup.c,
	gtk/gtktable.c, gtk/gtktextiter.c, gtk/gtktexttag.c,
	gtk/gtktexttag.h, gtk/gtktextview.c, gtk/gtktogglebutton.c,
	gtk/gtktoolbar.c, gtk/gtktreemodel.c, gtk/gtktreeselection.c,
	gtk/gtktreestore.c, gtk/gtktreeview.c, gtk/gtktreeviewcolumn.c,
	gtk/gtkviewport.c, gtk/gtkwidget.c, gtk/gtkwidget.h,
	gtk/gtkwindow.c:

	Minor documentation fixes

	(#89254, patch from Brett Nash;
	 #85809, patch from daten@dnetc.org;
	 #76391, patch from Ross Burton;
	 #74559, Manuel Clos;
	 #73569, #72005, Alexey A. Malyshev;
	 #70061, patch from Dennis Bj"orklund;
	 #64566, #63388, #58328, #57499, #81007, #77349, Vitaly Tishkov;
	 #78932, Vitaly Tishkov, patch from Ross Burton;
	 #73306)

22 files changed, 144 insertions, 121 deletions

diff --git a/docs/reference/gdk-pixbuf/tmpl/gdk-pixbuf-loader.sgml b/docs/reference/gdk-pixbuf/tmpl/gdk-pixbuf-loader.sgml
index fb6275b5ed..4058c2f9f1 100644
--- a/docs/reference/gdk-pixbuf/tmpl/gdk-pixbuf-loader.sgml
+++ b/docs/reference/gdk-pixbuf/tmpl/gdk-pixbuf-loader.sgml
@@ -99,6 +99,16 @@ Application-driven progressive image loading.
 @Returns: 
 
 
+<!-- ##### FUNCTION gdk_pixbuf_loader_set_size ##### -->
+<para>
+
+</para>
+
+@loader: 
+@width: 
+@height: 
+
+
 <!-- ##### FUNCTION gdk_pixbuf_loader_get_pixbuf ##### -->
 <para>
 
@@ -126,16 +136,6 @@ Application-driven progressive image loading.
 @error: 
 @Returns: 
 
-<!-- ##### SIGNAL GdkPixbufLoader::size-prepared ##### -->
-  <para>
-    This signal is emitted when the pixbuf loader has been fed the
-    initial amount of data that is required to figure out the size
-    of the image that it will create.  Applications can call  
-    gdk_pixbuf_loader_set_size() in response to this signal to set
-    the desired size to which the image should be scaled.
-  </para>
-@width: the original width of the image
-@height: the original height of the image
 
 <!-- ##### SIGNAL GdkPixbufLoader::area-prepared ##### -->
   <para>
@@ -144,6 +144,8 @@ Application-driven progressive image loading.
     call gdk_pixbuf_loader_get_pixbuf() to fetch the partially-loaded pixbuf.
   </para>
 
+@gdkpixbufloader: the object which received the signal.
+
 <!-- ##### SIGNAL GdkPixbufLoader::area-updated ##### -->
   <para>
     This signal is emitted when a significant area of the image being
@@ -154,6 +156,11 @@ Application-driven progressive image loading.
   </para>
 
 @gdkpixbufloader: Loader which emitted the signal.
+@arg1: 
+@arg2: 
+@arg3: 
+@arg4: 
+<!-- # Unused Parameters # -->
 @x: X offset of upper-left corner of the updated area.
 @y: Y offset of upper-left corner of the updated area.
 @width: Width of updated area.
@@ -176,4 +183,19 @@ sgml-parent-document: ("../gdk-pixbuf.sgml" "book" "refsect2" "")
 End:
 -->
 
+<!-- ##### SIGNAL GdkPixbufLoader::size-prepared ##### -->
+  <para>
+    This signal is emitted when the pixbuf loader has been fed the
+    initial amount of data that is required to figure out the size
+    of the image that it will create.  Applications can call  
+    gdk_pixbuf_loader_set_size() in response to this signal to set
+    the desired size to which the image should be scaled.
+  </para>
+
+@gdkpixbufloader: the object which received the signal.
+@arg1: 
+@arg2: 
+<!-- # Unused Parameters # -->
+@width: the original width of the image
+@height: the original height of the image
 
diff --git a/docs/reference/gdk/tmpl/gdk-unused.sgml b/docs/reference/gdk/tmpl/gdk-unused.sgml
index cf6dbb8ba9..68015589b6 100644
--- a/docs/reference/gdk/tmpl/gdk-unused.sgml
+++ b/docs/reference/gdk/tmpl/gdk-unused.sgml
@@ -882,6 +882,13 @@ they will be ignored.
 </para>
 
 
+<!-- ##### FUNCTION gdk_screen_close ##### -->
+<para>
+
+</para>
+
+@screen: 
+
 <!-- ##### FUNCTION gdk_screen_use_virtual_screen ##### -->
 <para>
 
diff --git a/docs/reference/gdk/tmpl/gdkdisplay.sgml b/docs/reference/gdk/tmpl/gdkdisplay.sgml
index 17b08f9342..b7a50b47f1 100644
--- a/docs/reference/gdk/tmpl/gdkdisplay.sgml
+++ b/docs/reference/gdk/tmpl/gdkdisplay.sgml
@@ -205,3 +205,11 @@ of an X display. All its fields are private and should not be accessed directly.
 @sm_client_id: 
 
 
+<!-- ##### SIGNAL GdkDisplay::closed ##### -->
+<para>
+
+</para>
+
+@gdkdisplay: the object which received the signal.
+@arg1: 
+
diff --git a/docs/reference/gdk/tmpl/gdkscreen.sgml b/docs/reference/gdk/tmpl/gdkscreen.sgml
index 40797a255b..8b2ac7b45b 100644
--- a/docs/reference/gdk/tmpl/gdkscreen.sgml
+++ b/docs/reference/gdk/tmpl/gdkscreen.sgml
@@ -166,14 +166,6 @@ when GDK gets multihead support.
 @Returns: 
 
 
-<!-- ##### FUNCTION gdk_screen_close ##### -->
-<para>
-
-</para>
-
-@screen: 
-
-
 <!-- ##### FUNCTION gdk_screen_list_visuals ##### -->
 <para>
 
diff --git a/docs/reference/gtk/tmpl/gtkbbox.sgml b/docs/reference/gtk/tmpl/gtkbbox.sgml
index ecc2bfdd82..ceec7a0916 100644
--- a/docs/reference/gtk/tmpl/gtkbbox.sgml
+++ b/docs/reference/gtk/tmpl/gtkbbox.sgml
@@ -162,22 +162,22 @@ box.
 
 </para>
 
-<!-- ##### ARG GtkButtonBox:child-min-height ##### -->
+<!-- ##### ARG GtkButtonBox:child-internal-pad-y ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkButtonBox:child-min-width ##### -->
+<!-- ##### ARG GtkButtonBox:child-internal-pad-x ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkButtonBox:child-internal-pad-y ##### -->
+<!-- ##### ARG GtkButtonBox:child-min-width ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkButtonBox:child-internal-pad-x ##### -->
+<!-- ##### ARG GtkButtonBox:child-min-height ##### -->
 <para>
 
 </para>
diff --git a/docs/reference/gtk/tmpl/gtkbutton.sgml b/docs/reference/gtk/tmpl/gtkbutton.sgml
index 606ca5da9e..ecc477c1de 100644
--- a/docs/reference/gtk/tmpl/gtkbutton.sgml
+++ b/docs/reference/gtk/tmpl/gtkbutton.sgml
@@ -248,22 +248,22 @@ mouse cursor is.
 
 </para>
 
-<!-- ##### ARG GtkButton:default-border ##### -->
+<!-- ##### ARG GtkButton:child-displacement-y ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkButton:default-outside-border ##### -->
+<!-- ##### ARG GtkButton:child-displacement-x ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkButton:child-displacement-y ##### -->
+<!-- ##### ARG GtkButton:default-border ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkButton:child-displacement-x ##### -->
+<!-- ##### ARG GtkButton:default-outside-border ##### -->
 <para>
 
 </para>
diff --git a/docs/reference/gtk/tmpl/gtkcheckbutton.sgml b/docs/reference/gtk/tmpl/gtkcheckbutton.sgml
index 7b5e72c6ad..9f985152d9 100644
--- a/docs/reference/gtk/tmpl/gtkcheckbutton.sgml
+++ b/docs/reference/gtk/tmpl/gtkcheckbutton.sgml
@@ -66,12 +66,12 @@ Creates a new #GtkCheckButton with a #GtkLabel to the right of it.
 @Returns: 
 
 
-<!-- ##### ARG GtkCheckButton:indicator-size ##### -->
+<!-- ##### ARG GtkCheckButton:indicator-spacing ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkCheckButton:indicator-spacing ##### -->
+<!-- ##### ARG GtkCheckButton:indicator-size ##### -->
 <para>
 
 </para>
diff --git a/docs/reference/gtk/tmpl/gtkdialog.sgml b/docs/reference/gtk/tmpl/gtkdialog.sgml
index 6a113643a3..3a5480f415 100644
--- a/docs/reference/gtk/tmpl/gtkdialog.sgml
+++ b/docs/reference/gtk/tmpl/gtkdialog.sgml
@@ -127,17 +127,18 @@ response from the user.</para></listitem>
 
 <!-- ##### STRUCT GtkDialog ##### -->
 <para>
-<structfield>window</structfield> is a #GtkWindow, but should not be
-modified directly, (use the functions provided, such as
-gtk_window_set_title(). See the #GtkWindow section for more).
+<structfield>vbox</structfield> is a #GtkVBox - the main part of the
+dialog box.
 </para>
 <para>
-<structfield>vbox</structfield> is a #GtkVBox - the main part of the dialog box.
-</para>
-<para>
-<structfield>action_area</structfield> is a #GtkHBox packed below the dividing #GtkHSeparator in the dialog. It is treated exactly the same as any other #GtkHBox.
+
+<structfield>action_area</structfield> is a #GtkHBox packed below the
+dividing #GtkHSeparator in the dialog. It is treated exactly the same
+as any other #GtkHBox.
 </para>
 
+@action_area: 
+@vbox: 
 
 <!-- ##### ENUM GtkDialogFlags ##### -->
 <para>
@@ -303,12 +304,12 @@ was clicked.
 
 </para>
 
-<!-- ##### ARG GtkDialog:button-spacing ##### -->
+<!-- ##### ARG GtkDialog:action-area-border ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkDialog:action-area-border ##### -->
+<!-- ##### ARG GtkDialog:button-spacing ##### -->
 <para>
 
 </para>
diff --git a/docs/reference/gtk/tmpl/gtkentry.sgml b/docs/reference/gtk/tmpl/gtkentry.sgml
index f00dbb5685..5b04ab5b3f 100644
--- a/docs/reference/gtk/tmpl/gtkentry.sgml
+++ b/docs/reference/gtk/tmpl/gtkentry.sgml
@@ -95,15 +95,11 @@ gtk_editable_set_position() instead.
 
 <!-- ##### FUNCTION gtk_entry_get_text ##### -->
 <para>
-Retrieve the contents of the entry widget. The returned
-pointer points to internally allocated storage in the
-widget and must not be freed, modified or stored.
-See also gtk_editable_get_chars().
+
 </para>
 
-@entry: a #GtkEntry.
-@Returns: the pointer the the contents of the text widget as a
-          string.
+@entry: 
+@Returns: 
 
 
 <!-- ##### FUNCTION gtk_entry_select_region ##### -->
diff --git a/docs/reference/gtk/tmpl/gtkfilesel.sgml b/docs/reference/gtk/tmpl/gtkfilesel.sgml
index afc8d6d1df..f64024db1c 100644
--- a/docs/reference/gtk/tmpl/gtkfilesel.sgml
+++ b/docs/reference/gtk/tmpl/gtkfilesel.sgml
@@ -100,11 +100,6 @@ The #GtkFileSelection struct contains the following #GtkWidget fields:
 </row>
 
 <row>
-<entry>*dir_list, *file_list;</entry>
-<entry>the two #GtkCList widgets corresponding to directories and files.</entry>
-</row>
-
-<row>
 <entry>*ok_button, *cancel_button;</entry>
 <entry>the two main buttons that signals should be connected to in order to perform an action when the user hits either OK or Cancel.</entry>
 </row>
diff --git a/docs/reference/gtk/tmpl/gtkfontsel.sgml b/docs/reference/gtk/tmpl/gtkfontsel.sgml
index 986ada711d..d3c030f016 100644
--- a/docs/reference/gtk/tmpl/gtkfontsel.sgml
+++ b/docs/reference/gtk/tmpl/gtkfontsel.sgml
@@ -94,7 +94,8 @@ Gets the text displayed in the preview area.
 </para>
 
 @fontsel: a #GtkFontSelection.
-@Returns: the text displayed in the preview area.
+@Returns: the text displayed in the preview area. This string is
+ owned by the widget and should not be modified or freed.
 
 
 <!-- ##### FUNCTION gtk_font_selection_set_preview_text ##### -->
diff --git a/docs/reference/gtk/tmpl/gtkfontseldlg.sgml b/docs/reference/gtk/tmpl/gtkfontseldlg.sgml
index e781c7e27f..d6e07d28f7 100644
--- a/docs/reference/gtk/tmpl/gtkfontseldlg.sgml
+++ b/docs/reference/gtk/tmpl/gtkfontseldlg.sgml
@@ -115,7 +115,8 @@ Gets the text displayed in the preview area.
 </para>
 
 @fsd: a #GtkFontSelectionDialog.
-@Returns: the text displayed in the preview area.
+@Returns: the text displayed in the preview area. This string is owned
+   by the widget and should not be modified or freed.
 
 
 <!-- ##### FUNCTION gtk_font_selection_dialog_set_preview_text ##### -->
diff --git a/docs/reference/gtk/tmpl/gtkoptionmenu.sgml b/docs/reference/gtk/tmpl/gtkoptionmenu.sgml
index 876a046a5d..31debc57f8 100644
--- a/docs/reference/gtk/tmpl/gtkoptionmenu.sgml
+++ b/docs/reference/gtk/tmpl/gtkoptionmenu.sgml
@@ -100,12 +100,12 @@ selected value for the option menu.
 
 </para>
 
-<!-- ##### ARG GtkOptionMenu:indicator-spacing ##### -->
+<!-- ##### ARG GtkOptionMenu:indicator-size ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkOptionMenu:indicator-size ##### -->
+<!-- ##### ARG GtkOptionMenu:indicator-spacing ##### -->
 <para>
 
 </para>
diff --git a/docs/reference/gtk/tmpl/gtkrange.sgml b/docs/reference/gtk/tmpl/gtkrange.sgml
index 3ad1851a33..153dbaaa36 100644
--- a/docs/reference/gtk/tmpl/gtkrange.sgml
+++ b/docs/reference/gtk/tmpl/gtkrange.sgml
@@ -153,32 +153,32 @@ Emitted when the range value changes.
 
 </para>
 
-<!-- ##### ARG GtkRange:stepper-spacing ##### -->
+<!-- ##### ARG GtkRange:slider-width ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkRange:stepper-size ##### -->
+<!-- ##### ARG GtkRange:arrow-displacement-y ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkRange:trough-border ##### -->
+<!-- ##### ARG GtkRange:arrow-displacement-x ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkRange:slider-width ##### -->
+<!-- ##### ARG GtkRange:stepper-spacing ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkRange:arrow-displacement-y ##### -->
+<!-- ##### ARG GtkRange:trough-border ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkRange:arrow-displacement-x ##### -->
+<!-- ##### ARG GtkRange:stepper-size ##### -->
 <para>
 
 </para>
diff --git a/docs/reference/gtk/tmpl/gtkscale.sgml b/docs/reference/gtk/tmpl/gtkscale.sgml
index 8935f1164b..d2861f1900 100644
--- a/docs/reference/gtk/tmpl/gtkscale.sgml
+++ b/docs/reference/gtk/tmpl/gtkscale.sgml
@@ -148,12 +148,12 @@ format_value_callback (GtkScale *scale,
 
 </para>
 
-<!-- ##### ARG GtkScale:slider-length ##### -->
+<!-- ##### ARG GtkScale:value-spacing ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkScale:value-spacing ##### -->
+<!-- ##### ARG GtkScale:slider-length ##### -->
 <para>
 
 </para>
diff --git a/docs/reference/gtk/tmpl/gtkscrollbar.sgml b/docs/reference/gtk/tmpl/gtkscrollbar.sgml
index 65792a700f..e5cbe8e039 100644
--- a/docs/reference/gtk/tmpl/gtkscrollbar.sgml
+++ b/docs/reference/gtk/tmpl/gtkscrollbar.sgml
@@ -54,12 +54,12 @@ The #GtkScrollbar struct does not contain any public data.
 </para>
 
 
-<!-- ##### ARG GtkScrollbar:has-forward-stepper ##### -->
+<!-- ##### ARG GtkScrollbar:has-secondary-backward-stepper ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkScrollbar:has-backward-stepper ##### -->
+<!-- ##### ARG GtkScrollbar:has-secondary-forward-stepper ##### -->
 <para>
 
 </para>
@@ -69,17 +69,17 @@ The #GtkScrollbar struct does not contain any public data.
 
 </para>
 
-<!-- ##### ARG GtkScrollbar:has-secondary-backward-stepper ##### -->
+<!-- ##### ARG GtkScrollbar:min-slider-length ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkScrollbar:min-slider-length ##### -->
+<!-- ##### ARG GtkScrollbar:has-forward-stepper ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkScrollbar:has-secondary-forward-stepper ##### -->
+<!-- ##### ARG GtkScrollbar:has-backward-stepper ##### -->
 <para>
 
 </para>
diff --git a/docs/reference/gtk/tmpl/gtktexttag.sgml b/docs/reference/gtk/tmpl/gtktexttag.sgml
index c3aebfa08b..31a39e94ac 100644
--- a/docs/reference/gtk/tmpl/gtktexttag.sgml
+++ b/docs/reference/gtk/tmpl/gtktexttag.sgml
@@ -58,7 +58,6 @@ GTK+ structs, the fields in this struct should only be read, never
 modified directly.
 </para>
 
-@refcount: private field, ignore
 @appearance: pointer to sub-struct containing certain attributes
 @justification: 
 @direction: 
@@ -73,15 +72,10 @@ modified directly.
 @tabs: 
 @wrap_mode: 
 @language: 
-@padding1: 
 @invisible: 
 @bg_full_height: 
 @editable: 
 @realized: 
-@pad1: 
-@pad2: 
-@pad3: 
-@pad4: 
 
 <!-- ##### FUNCTION gtk_text_tag_new ##### -->
 <para>
@@ -132,16 +126,11 @@ modified directly.
 @bg_stipple: 
 @fg_stipple: 
 @rise: 
-@padding1: 
 @underline: 
 @strikethrough: 
 @draw_bg: 
 @inside_selection: 
 @is_text: 
-@pad1: 
-@pad2: 
-@pad3: 
-@pad4: 
 
 <!-- ##### FUNCTION gtk_text_attributes_new ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtktoolbar.sgml b/docs/reference/gtk/tmpl/gtktoolbar.sgml
index 71686ff362..0e12b5d3c0 100644
--- a/docs/reference/gtk/tmpl/gtktoolbar.sgml
+++ b/docs/reference/gtk/tmpl/gtktoolbar.sgml
@@ -386,27 +386,27 @@ Should be used if you wish to perform an action when ever the style of a toolbar
 
 </para>
 
-<!-- ##### ARG GtkToolbar:button-relief ##### -->
+<!-- ##### ARG GtkToolbar:space-size ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkToolbar:internal-padding ##### -->
+<!-- ##### ARG GtkToolbar:shadow-type ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkToolbar:shadow-type ##### -->
+<!-- ##### ARG GtkToolbar:space-style ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkToolbar:space-size ##### -->
+<!-- ##### ARG GtkToolbar:button-relief ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkToolbar:space-style ##### -->
+<!-- ##### ARG GtkToolbar:internal-padding ##### -->
 <para>
 
 </para>
diff --git a/docs/reference/gtk/tmpl/gtktreemodel.sgml b/docs/reference/gtk/tmpl/gtktreemodel.sgml
index 6fc6e39c1d..902ea0911f 100644
--- a/docs/reference/gtk/tmpl/gtktreemodel.sgml
+++ b/docs/reference/gtk/tmpl/gtktreemodel.sgml
@@ -310,7 +310,7 @@ section.
 
 <!-- ##### MACRO gtk_tree_path_new_root ##### -->
 <para>
-A alternate name for gtk_tree_path_new_root() provided for
+An alternate name for gtk_tree_path_new_iter() provided for
 compatibility reasons; this macro will be deprecated in future
 versions of GTK+.
 </para>
diff --git a/docs/reference/gtk/tmpl/gtktreeview.sgml b/docs/reference/gtk/tmpl/gtktreeview.sgml
index e96163a6b4..cf97b8fb25 100644
--- a/docs/reference/gtk/tmpl/gtktreeview.sgml
+++ b/docs/reference/gtk/tmpl/gtktreeview.sgml
@@ -906,7 +906,7 @@ Function used for #gtk_tree_view_map_expanded_rows.
 
 </para>
 
-<!-- ##### ARG GtkTreeView:indent-expanders ##### -->
+<!-- ##### ARG GtkTreeView:expander-size ##### -->
 <para>
 
 </para>
@@ -916,12 +916,12 @@ Function used for #gtk_tree_view_map_expanded_rows.
 
 </para>
 
-<!-- ##### ARG GtkTreeView:expander-size ##### -->
+<!-- ##### ARG GtkTreeView:allow-rules ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkTreeView:allow-rules ##### -->
+<!-- ##### ARG GtkTreeView:indent-expanders ##### -->
 <para>
 
 </para>
diff --git a/docs/reference/gtk/tmpl/gtkwidget.sgml b/docs/reference/gtk/tmpl/gtkwidget.sgml
index 7fde53364c..750e4493be 100644
--- a/docs/reference/gtk/tmpl/gtkwidget.sgml
+++ b/docs/reference/gtk/tmpl/gtkwidget.sgml
@@ -22,7 +22,18 @@ GtkWidget
 
 <!-- ##### STRUCT GtkWidgetClass ##### -->
 <para>
+<structfield>activate_signal</structfield>
+The signal to emit when a widget of this class is activated,
+gtk_widget_activate() handles the emission. Implementation of this
+signal is optional. 
+</para>
 
+<para>
+<structfield>set_scroll_adjustment_signal</structfield>
+This signal is emitted  when a widget of this class is added
+to a scrolling aware parent, gtk_widget_set_scroll_adjustments()
+handles the emission.
+Implementation of this signal is optional.
 </para>
 
 
@@ -1603,7 +1614,7 @@ This function is deprecated; it does nothing.
 
 @widget: the object which received the signal.
 @event: 
-@Returns: 
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 
 <!-- ##### SIGNAL GtkWidget::button-release-event ##### -->
 <para>
@@ -1612,7 +1623,7 @@ This function is deprecated; it does nothing.
 
 @widget: the object which received the signal.
 @event: 
-@Returns: 
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 
 <!-- ##### SIGNAL GtkWidget::child-notify ##### -->
 <para>
@@ -1629,7 +1640,7 @@ This function is deprecated; it does nothing.
 
 @widget: the object which received the signal.
 @event: 
-@Returns: 
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 
 <!-- ##### SIGNAL GtkWidget::configure-event ##### -->
 <para>
@@ -1638,7 +1649,7 @@ This function is deprecated; it does nothing.
 
 @widget: the object which received the signal.
 @event: 
-@Returns: 
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 
 <!-- ##### SIGNAL GtkWidget::delete-event ##### -->
 <para>
@@ -1647,7 +1658,7 @@ This function is deprecated; it does nothing.
 
 @widget: the object which received the signal.
 @event: 
-@Returns: 
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 
 <!-- ##### SIGNAL GtkWidget::destroy-event ##### -->
 <para>
@@ -1656,7 +1667,7 @@ This function is deprecated; it does nothing.
 
 @widget: the object which received the signal.
 @event: 
-@Returns: 
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 
 <!-- ##### SIGNAL GtkWidget::direction-changed ##### -->
 <para>
@@ -1754,7 +1765,7 @@ This function is deprecated; it does nothing.
 
 @widget: the object which received the signal.
 @event: 
-@Returns: 
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 
 <!-- ##### SIGNAL GtkWidget::event ##### -->
 <para>
@@ -1763,7 +1774,7 @@ This function is deprecated; it does nothing.
 
 @widget: the object which received the signal.
 @event: 
-@Returns: 
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 
 <!-- ##### SIGNAL GtkWidget::event-after ##### -->
 <para>
@@ -1780,7 +1791,7 @@ This function is deprecated; it does nothing.
 
 @widget: the object which received the signal.
 @event: 
-@Returns: 
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 
 <!-- ##### SIGNAL GtkWidget::focus ##### -->
 <para>
@@ -1789,7 +1800,7 @@ This function is deprecated; it does nothing.
 
 @widget: the object which received the signal.
 @arg1: 
-@Returns: 
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 
 <!-- ##### SIGNAL GtkWidget::focus-in-event ##### -->
 <para>
@@ -1798,7 +1809,7 @@ This function is deprecated; it does nothing.
 
 @widget: the object which received the signal.
 @event: 
-@Returns: 
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 
 <!-- ##### SIGNAL GtkWidget::focus-out-event ##### -->
 <para>
@@ -1807,7 +1818,7 @@ This function is deprecated; it does nothing.
 
 @widget: the object which received the signal.
 @event: 
-@Returns: 
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 
 <!-- ##### SIGNAL GtkWidget::grab-focus ##### -->
 <para>
@@ -1850,7 +1861,7 @@ a widget changes from un-anchored to anchored or vice-versa.
 
 @widget: the object which received the signal.
 @event: 
-@Returns: 
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 
 <!-- ##### SIGNAL GtkWidget::key-release-event ##### -->
 <para>
@@ -1859,7 +1870,7 @@ a widget changes from un-anchored to anchored or vice-versa.
 
 @widget: the object which received the signal.
 @event: 
-@Returns: 
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 
 <!-- ##### SIGNAL GtkWidget::leave-notify-event ##### -->
 <para>
@@ -1868,7 +1879,7 @@ a widget changes from un-anchored to anchored or vice-versa.
 
 @widget: the object which received the signal.
 @event: 
-@Returns: 
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 
 <!-- ##### SIGNAL GtkWidget::map ##### -->
 <para>
@@ -1884,7 +1895,7 @@ a widget changes from un-anchored to anchored or vice-versa.
 
 @widget: the object which received the signal.
 @event: 
-@Returns: 
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 
 <!-- ##### SIGNAL GtkWidget::mnemonic-activate ##### -->
 <para>
@@ -1902,7 +1913,7 @@ a widget changes from un-anchored to anchored or vice-versa.
 
 @widget: the object which received the signal.
 @event: 
-@Returns: 
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 
 <!-- ##### SIGNAL GtkWidget::no-expose-event ##### -->
 <para>
@@ -1911,7 +1922,7 @@ a widget changes from un-anchored to anchored or vice-versa.
 
 @widget: the object which received the signal.
 @event: 
-@Returns: 
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 
 <!-- ##### SIGNAL GtkWidget::parent-set ##### -->
 <para>
@@ -1936,7 +1947,7 @@ a widget changes from un-anchored to anchored or vice-versa.
 
 @widget: the object which received the signal.
 @event: 
-@Returns: 
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 
 <!-- ##### SIGNAL GtkWidget::proximity-in-event ##### -->
 <para>
@@ -1945,7 +1956,7 @@ a widget changes from un-anchored to anchored or vice-versa.
 
 @widget: the object which received the signal.
 @event: 
-@Returns: 
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 
 <!-- ##### SIGNAL GtkWidget::proximity-out-event ##### -->
 <para>
@@ -1954,7 +1965,7 @@ a widget changes from un-anchored to anchored or vice-versa.
 
 @widget: the object which received the signal.
 @event: 
-@Returns: 
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 
 <!-- ##### SIGNAL GtkWidget::realize ##### -->
 <para>
@@ -1970,7 +1981,7 @@ a widget changes from un-anchored to anchored or vice-versa.
 
 @widget: the object which received the signal.
 @event: 
-@Returns: 
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 
 <!-- ##### SIGNAL GtkWidget::selection-clear-event ##### -->
 <para>
@@ -1979,7 +1990,7 @@ a widget changes from un-anchored to anchored or vice-versa.
 
 @widget: the object which received the signal.
 @event: 
-@Returns: 
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 
 <!-- ##### SIGNAL GtkWidget::selection-get ##### -->
 <para>
@@ -1998,7 +2009,7 @@ a widget changes from un-anchored to anchored or vice-versa.
 
 @widget: the object which received the signal.
 @event: 
-@Returns: 
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 
 <!-- ##### SIGNAL GtkWidget::selection-received ##### -->
 <para>
@@ -2016,7 +2027,7 @@ a widget changes from un-anchored to anchored or vice-versa.
 
 @widget: the object which received the signal.
 @event: 
-@Returns: 
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 
 <!-- ##### SIGNAL GtkWidget::show ##### -->
 <para>
@@ -2080,7 +2091,7 @@ a widget changes from un-anchored to anchored or vice-versa.
 
 @widget: the object which received the signal.
 @event: 
-@Returns: 
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 
 <!-- ##### SIGNAL GtkWidget::unrealize ##### -->
 <para>
@@ -2096,7 +2107,7 @@ a widget changes from un-anchored to anchored or vice-versa.
 
 @widget: the object which received the signal.
 @event: 
-@Returns: 
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 
 <!-- ##### SIGNAL GtkWidget::window-state-event ##### -->
 <para>
@@ -2105,7 +2116,7 @@ a widget changes from un-anchored to anchored or vice-versa.
 
 @widget: the object which received the signal.
 @event: 
-@Returns: 
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
 
 <!-- ##### ARG GtkWidget:name ##### -->
 <para>
@@ -2192,27 +2203,27 @@ a widget changes from un-anchored to anchored or vice-versa.
 
 </para>
 
-<!-- ##### ARG GtkWidget:cursor-color ##### -->
+<!-- ##### ARG GtkWidget:interior-focus ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkWidget:secondary-cursor-color ##### -->
+<!-- ##### ARG GtkWidget:cursor-aspect-ratio ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkWidget:focus-line-width ##### -->
+<!-- ##### ARG GtkWidget:secondary-cursor-color ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkWidget:interior-focus ##### -->
+<!-- ##### ARG GtkWidget:focus-line-pattern ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG GtkWidget:cursor-aspect-ratio ##### -->
+<!-- ##### ARG GtkWidget:cursor-color ##### -->
 <para>
 
 </para>
@@ -2222,7 +2233,7 @@ a widget changes from un-anchored to anchored or vice-versa.
 
 </para>
 
-<!-- ##### ARG GtkWidget:focus-line-pattern ##### -->
+<!-- ##### ARG GtkWidget:focus-line-width ##### -->
 <para>
 
 </para>
diff --git a/docs/reference/gtk/tree_widget.sgml b/docs/reference/gtk/tree_widget.sgml
index 0f1f947581..352bdb0786 100644
--- a/docs/reference/gtk/tree_widget.sgml
+++ b/docs/reference/gtk/tree_widget.sgml
@@ -220,7 +220,7 @@ static void tree_selection_changed_cb (GtkTreeSelection *selection, gpointer dat
 GtkTreeSelection *select;
 
 select = gtk_tree_view_get_selection (GTK_TREE_VIEW (tree));
-gtk_tree_selection_set_mode (select, GTK_SELECT_SINGLE);
+gtk_tree_selection_set_mode (select, GTK_SELECTION_SINGLE);
 g_signal_connect (G_OBJECT (select), "changed",
                   G_CALLBACK (tree_selection_changed_cb),
                   NULL);