Add docs.

ChangeLog

+2002-12-18  Matthias Clasen  <maclas@gmx.de>
+
+	* gtk/gtkwidget.c: Add docs.
+
 Wed Dec 18 12:05:33 2002  Owen Taylor  <otaylor@redhat.com>
 
 	* NEWS: Various name fixes.

ChangeLog.pre-2-10

+2002-12-18  Matthias Clasen  <maclas@gmx.de>
+
+	* gtk/gtkwidget.c: Add docs.
+
 Wed Dec 18 12:05:33 2002  Owen Taylor  <otaylor@redhat.com>
 
 	* NEWS: Various name fixes.

ChangeLog.pre-2-2

+2002-12-18  Matthias Clasen  <maclas@gmx.de>
+
+	* gtk/gtkwidget.c: Add docs.
+
 Wed Dec 18 12:05:33 2002  Owen Taylor  <otaylor@redhat.com>
 
 	* NEWS: Various name fixes.

ChangeLog.pre-2-4

+2002-12-18  Matthias Clasen  <maclas@gmx.de>
+
+	* gtk/gtkwidget.c: Add docs.
+
 Wed Dec 18 12:05:33 2002  Owen Taylor  <otaylor@redhat.com>
 
 	* NEWS: Various name fixes.

ChangeLog.pre-2-6

+2002-12-18  Matthias Clasen  <maclas@gmx.de>
+
+	* gtk/gtkwidget.c: Add docs.
+
 Wed Dec 18 12:05:33 2002  Owen Taylor  <otaylor@redhat.com>
 
 	* NEWS: Various name fixes.

ChangeLog.pre-2-8

+2002-12-18  Matthias Clasen  <maclas@gmx.de>
+
+	* gtk/gtkwidget.c: Add docs.
+
 Wed Dec 18 12:05:33 2002  Owen Taylor  <otaylor@redhat.com>
 
 	* NEWS: Various name fixes.

docs/reference/ChangeLog

+2002-12-18  Matthias Clasen  <maclas@gmx.de>
+
+	* gtk/tmpl/gtkcontainer.sgml: Add docs.
+
 2002-12-17  Matthias Clasen  <maclas@gmx.de>
 
-	* gtk/tmpl/gtkrc.sgml: Link to style properties.
+	* gtk/tmpl/gtkrc.sgml: Link to style properties. 
 
 	* gtk/tmpl/gtkcontainer.sgml: Add bits about child properties.
 

docs/reference/gtk/tmpl/gtkcontainer.sgml

@@ -15,13 +15,16 @@ which is contained in a #GtkBox.</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(). 
+child properties.
+</para>
+<para>
+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(). To emit notification about child property 
+changes, use gtk_widget_child_notify().
 </para>
-
 <!-- ##### SECTION See_Also ##### -->
 <para>
 

gtk/gtkwidget.c

@@ -1361,6 +1361,15 @@ gtk_widget_dispatch_child_properties_changed (GtkWidget   *widget,
     g_signal_emit (widget, widget_signals[CHILD_NOTIFY], g_quark_from_string (pspecs[i]->name), pspecs[i]);
 }
 
+/**
+ * gtk_widget_freeze_child_notify:
+ * @widget: a #GtkWidget
+ * 
+ * Stops emission of "child-notify" signals on @widget. The signals are
+ * queued until gtk_widget_thaw_child_notify() is called on @widget. 
+ *
+ * This is the analogue of g_object_freeze_notify() for child properties.
+ **/
 void
 gtk_widget_freeze_child_notify (GtkWidget *widget)
 {
@@ -1374,6 +1383,18 @@ gtk_widget_freeze_child_notify (GtkWidget *widget)
   g_object_unref (widget);
 }
 
+/**
+ * gtk_widget_child_notify:
+ * @widget: a #GtkWidget
+ * @child_property: the name of a child property installed on the 
+ *                  class of @widget<!-- -->'s parent.
+ * 
+ * Emits a "child-notify" signal for the 
+ * <link linkend="child-properties">child property</link> @child_property 
+ * on @widget.
+ *
+ * This is the analogue of g_object_notify() for child properties.
+ **/
 void
 gtk_widget_child_notify (GtkWidget    *widget,
 			 const gchar  *child_property)
@@ -1410,6 +1431,7 @@ gtk_widget_child_notify (GtkWidget    *widget,
  * @widget: a #GtkWidget
  *
  * Reverts the effect of a previous call to gtk_widget_freeze_child_notify().
+ * This causes all queued "child-notify" signals on @widget to be emitted.
  */ 
 void
 gtk_widget_thaw_child_notify (GtkWidget *widget)