Properly document gtk_container_set_focus_child(). (#521739, Andrew Cowie)

2008-03-17  Emmanuele Bassi  <ebassi@gnome.org>

	* gtk/gtkcontainer.c: Properly document
	gtk_container_set_focus_child(). (#521739, Andrew Cowie)

svn path=/trunk/; revision=19893

diff --git a/ChangeLog b/ChangeLog
index c6b016eb1224c549db6ff9fdbe8241ecd5791355..4727430b1e5b871aae543256fd1b3c5596e9429f 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2008-03-17  Emmanuele Bassi  <ebassi@gnome.org>
+
+       * gtk/gtkcontainer.c: Properly document
+       gtk_container_set_focus_child(). (#521739, Andrew Cowie)
+
 2008-03-16  Alberto Ruiz <aruiz@gnome.org>
 
        * modules/engines/ms-windows/Theme/gtk-2.0/gtkrc: more descriptive

diff --git a/gtk/gtkcontainer.c b/gtk/gtkcontainer.c
index b4889ddf38eeaf572b5b4447200b6c7c44afc268..c81a37211982d56b4fd95de23f0eb0583322d337 100644 (file)
--- a/gtk/gtkcontainer.c
+++ b/gtk/gtkcontainer.c
@@ -1537,6 +1537,17 @@ gtk_container_foreach_full (GtkContainer       *container,
     notify (callback_data);
 }
 
+/**
+ * gtk_container_set_focus_child:
+ * @container: a #GtkContainer
+ * @widget: a #GtkWidget, or %NULL
+ *
+ * Sets, or unsets if @widget is %NULL, the focused child of @container.
+ *
+ * This function emits the GtkContainer::set_focus_child signal of
+ * @container. Implementations of #GtkContainer can override the
+ * default behaviour by overriding the class closure of this signal.
+ */
 void
 gtk_container_set_focus_child (GtkContainer *container,
                               GtkWidget    *widget)