diff --git a/ChangeLog b/ChangeLog
index c6b016eb12..4727430b1e 100644
--- 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 b4889ddf38..c81a372119 100644
--- 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)