6 files changed, 35 insertions, 8 deletions
diff --git a/docs/reference/gtk/tmpl/gtkaccelgroup.sgml b/docs/reference/gtk/tmpl/gtkaccelgroup.sgml
index 4c928e05a..ecefb40f9 100644
--- a/docs/reference/gtk/tmpl/gtkaccelgroup.sgml
+++ b/docs/reference/gtk/tmpl/gtkaccelgroup.sgml
@@ -5,7 +5,7 @@ Accelerator Groups
 Groups of global keyboard accelerators for an entire GtkWindow
 
 <!-- ##### SECTION Long_Description ##### -->
-<para id="GtkAccelGroup">
+<para>
 A #GtkAccelGroup represents a group of keyboard accelerators,
 typically attached to a toplevel #GtkWindow (with
 gtk_window_add_accel_group()). Usually you won't need to create a
diff --git a/docs/reference/gtk/tmpl/gtkcontainer.sgml b/docs/reference/gtk/tmpl/gtkcontainer.sgml
index 2f078572a..ccf1d0a70 100644
--- a/docs/reference/gtk/tmpl/gtkcontainer.sgml
+++ b/docs/reference/gtk/tmpl/gtkcontainer.sgml
@@ -5,8 +5,21 @@ GtkContainer
 Base class for widgets which contain other widgets
 
 <!-- ##### SECTION Long_Description ##### -->
-<para>
-
+<para id="child-properties">
+<structname>GtkContainer</structname> introduces <firstterm>child 
+properties</firstterm> - these are object properties that are not specific
+to either the container or the contained widget, but rather to their relation.
+Typical examples of child properties are the position or pack-type of a widget
+which is contained in a #GtkBox.</para>
+<para>
+Use gtk_container_class_install_child_property() to install child properties 
+for a container class and gtk_container_class_find_child_property() or
+gtk_container_class_list_child_properties() to get information about existing
+child properties. To set the value of a child property, use
+gtk_container_child_set_property(), gtk_container_child_set() or
+gtk_container_child_set_valist(). To obtain the value of a child property,
+use gtk_container_child_get_property(), gtk_container_child_get() or
+gtk_container_child_get_valist(). 
 </para>
 
 <!-- ##### SECTION See_Also ##### -->
diff --git a/docs/reference/gtk/tmpl/gtkiconfactory.sgml b/docs/reference/gtk/tmpl/gtkiconfactory.sgml
index f36190f01..97557d8d2 100644
--- a/docs/reference/gtk/tmpl/gtkiconfactory.sgml
+++ b/docs/reference/gtk/tmpl/gtkiconfactory.sgml
@@ -8,7 +8,7 @@ Manipulating stock icons
 <!-- ##### SECTION Long_Description ##### -->
 
 
-<para id="GtkIconFactory">
+<para>
 Browse the available stock icons in the list of stock IDs found <link
 linkend="gtk-Stock-Items">here</link>. You can also use 
 the <application>gtk-demo</application> application for this purpose.
diff --git a/docs/reference/gtk/tmpl/gtkrc.sgml b/docs/reference/gtk/tmpl/gtkrc.sgml
index 2f237804f..3d2cb453c 100644
--- a/docs/reference/gtk/tmpl/gtkrc.sgml
+++ b/docs/reference/gtk/tmpl/gtkrc.sgml
@@ -5,7 +5,7 @@ Resource Files
 Routines for handling resource files
 
 <!-- ##### SECTION Long_Description ##### -->
-<para id="GtkRcStyle">
+<para>
 GTK+ provides resource file mechanism for configuring
 various aspects of the operation of a GTK+ program
 at runtime.
@@ -310,7 +310,7 @@ settings</replaceable> }</literal></term>
     <term><literal><replaceable>class</replaceable>::<replaceable>property</replaceable> = <replaceable>value</replaceable></literal></term>
      <listitem>
        <para>
-        Sets a style property for a widget class.
+        Sets a <link linkend="style-property">style property</link> for a widget class.
        </para>
      </listitem>
   </varlistentry>
diff --git a/docs/reference/gtk/tmpl/gtktextview.sgml b/docs/reference/gtk/tmpl/gtktextview.sgml
index 8875feae5..267e7192d 100644
--- a/docs/reference/gtk/tmpl/gtktextview.sgml
+++ b/docs/reference/gtk/tmpl/gtktextview.sgml
@@ -324,7 +324,7 @@ types related to the text widget and how they work together.
 
 
 <!-- ##### STRUCT GtkTextChildAnchor ##### -->
-<para id="GtkTextChildAnchor">
+<para>
 A <structname>GtkTextChildAnchor</structname> is a spot in the buffer 
 where child widgets can be "anchored" (inserted inline, as if they were 
 characters). The anchor can have multiple widgets anchored, to allow for 
diff --git a/docs/reference/gtk/tmpl/gtkwidget.sgml b/docs/reference/gtk/tmpl/gtkwidget.sgml
index f681f8c07..2ffc19a17 100644
--- a/docs/reference/gtk/tmpl/gtkwidget.sgml
+++ b/docs/reference/gtk/tmpl/gtkwidget.sgml
@@ -5,8 +5,21 @@ GtkWidget
 Base class for all widgets
 
 <!-- ##### SECTION Long_Description ##### -->
+<para id="style-properties">
+<structname>GtkWidget</structname> introduces <firstterm>style 
+properties</firstterm> - these are basically object properties that are stored
+not on the object, but in the style object associated to the widget. Style
+properties are set in <link linkend="gtk-Resource-Files">resource files</link>.
+This mechanism is used for configuring such things as the location of the
+scrollbar arrows through the theme, giving theme authors more control over the
+look of applications without the need to write a theme engine in C.
+</para>
 <para>
-
+Use gtk_widget_class_install_style_property() to install style properties for 
+a widget class, gtk_widget_class_find_style_property() or
+gtk_widget_class_list_style_properties() to get information about existing
+style properties and gtk_widget_style_get_property(), gtk_widget_style_get() or
+gtk_widget_style_get_valist() to obtain the value of a style property.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->
@@ -36,6 +49,7 @@ handles the emission.
 Implementation of this signal is optional.
 </para>
 
+@parent_class: 
 @activate_signal: 
 @set_scroll_adjustments_signal: