diff --git a/ChangeLog b/ChangeLog
index c3a619d99f..8f93318ec2 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,10 +1,15 @@
+2005-12-14  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/gtktreeview.c (gtk_tree_view_class_init): Add docs 
+	for the row-activated signal.  (#324044, Davyd Madeley)
+
 2005-12-14  Michael Natterer  <mitch@imendio.com>
 
 	* tests/test-images/valid_jpeg_progressive_test: new test image.
 
 Tue Dec 13 09:47:20 2005  Tim Janik  <timj@gtk.org>
 
-	* README.in: added a link to the fgloating reference docs in the
+	* README.in: added a link to the floating reference docs in the
 	2.10 release NEWS section.
 
 2005-12-12  Matthias Clasen  <mclasen@redhat.com>
diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10
index c3a619d99f..8f93318ec2 100644
--- a/ChangeLog.pre-2-10
+++ b/ChangeLog.pre-2-10
@@ -1,10 +1,15 @@
+2005-12-14  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/gtktreeview.c (gtk_tree_view_class_init): Add docs 
+	for the row-activated signal.  (#324044, Davyd Madeley)
+
 2005-12-14  Michael Natterer  <mitch@imendio.com>
 
 	* tests/test-images/valid_jpeg_progressive_test: new test image.
 
 Tue Dec 13 09:47:20 2005  Tim Janik  <timj@gtk.org>
 
-	* README.in: added a link to the fgloating reference docs in the
+	* README.in: added a link to the floating reference docs in the
 	2.10 release NEWS section.
 
 2005-12-12  Matthias Clasen  <mclasen@redhat.com>
diff --git a/gtk/gtktreeview.c b/gtk/gtktreeview.c
index c9abeabbfd..48b0637537 100644
--- a/gtk/gtktreeview.c
+++ b/gtk/gtktreeview.c
@@ -778,6 +778,21 @@ gtk_tree_view_class_init (GtkTreeViewClass *class)
 		  GTK_TYPE_ADJUSTMENT,
 		  GTK_TYPE_ADJUSTMENT);
 
+  /**
+   * GtkTreeView::row-activated:
+   * @tree_view: the object on which the signal is emitted
+   * @path: the #GtkTreePath for the activated row
+   * @column: the #GtkTreeViewColumn in which the activation occurred
+   *
+   * The "row-activated" signal is emitted when the method
+   * gtk_tree_view_row_activated() is called or the user double clicks 
+   * a treeview row. It is also emitted when a non-editable row is 
+   * selected and one of the keys: Space, Shift+Space, Return or 
+   * Enter is pressed.
+   * 
+   * For selection handling refer to the <link linkend="TreeWidget">tree 
+   * widget conceptual overview</link> as well as #GtkTreeSelection.
+   */
   tree_view_signals[ROW_ACTIVATED] =
     g_signal_new (I_("row_activated"),
 		  G_TYPE_FROM_CLASS (o_class),