Add docs.

9 files changed, 60 insertions, 7 deletions

diff --git a/ChangeLog b/ChangeLog
index 990ac62130..5591918525 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+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.
diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10
index 990ac62130..5591918525 100644
--- a/ChangeLog.pre-2-10
+++ b/ChangeLog.pre-2-10
@@ -1,3 +1,7 @@
+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.
diff --git a/ChangeLog.pre-2-2 b/ChangeLog.pre-2-2
index 990ac62130..5591918525 100644
--- a/ChangeLog.pre-2-2
+++ b/ChangeLog.pre-2-2
@@ -1,3 +1,7 @@
+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.
diff --git a/ChangeLog.pre-2-4 b/ChangeLog.pre-2-4
index 990ac62130..5591918525 100644
--- a/ChangeLog.pre-2-4
+++ b/ChangeLog.pre-2-4
@@ -1,3 +1,7 @@
+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.
diff --git a/ChangeLog.pre-2-6 b/ChangeLog.pre-2-6
index 990ac62130..5591918525 100644
--- a/ChangeLog.pre-2-6
+++ b/ChangeLog.pre-2-6
@@ -1,3 +1,7 @@
+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.
diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8
index 990ac62130..5591918525 100644
--- a/ChangeLog.pre-2-8
+++ b/ChangeLog.pre-2-8
@@ -1,3 +1,7 @@
+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.
diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 598864fe03..531ab5badf 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,6 +1,10 @@
+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.
 
diff --git a/docs/reference/gtk/tmpl/gtkcontainer.sgml b/docs/reference/gtk/tmpl/gtkcontainer.sgml
index ccf1d0a705..c0ac78af81 100644
--- a/docs/reference/gtk/tmpl/gtkcontainer.sgml
+++ b/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>
 
diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index 87940e2c7c..71bf80ef78 100644
--- a/gtk/gtkwidget.c
+++ b/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)