[gtk/row-activated-annotation] treeview: Documentation tweaks

[Matthias Clasen <matthiasc src gnome org>]

commit c2f2a4522780632d8debc9691cb902873e7fd4b7
Author: Matthias Clasen <mclasen redhat com>
Date:   Tue Jun 8 07:57:55 2021 -0400

    treeview: Documentation tweaks

 gtk/gtktreeview.c | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)
---
diff --git a/gtk/gtktreeview.c b/gtk/gtktreeview.c
index 17fe30305e..7d58986458 100644
--- a/gtk/gtktreeview.c
+++ b/gtk/gtktreeview.c
@@ -1170,12 +1170,14 @@ gtk_tree_view_class_init (GtkTreeViewClass *class)
    * @column: (nullable): the `GtkTreeViewColumn` in which the activation occurred
    *
    * The "row-activated" signal is emitted when the method
-   * gtk_tree_view_row_activated() is called, when the user double
-   * clicks a treeview row with the "activate-on-single-click"
-   * property set to %FALSE, or when the user single clicks a row when
-   * the "activate-on-single-click" property set to %TRUE. It is also
-   * emitted when a non-editable row is selected and one of the keys:
-   * Space, Shift+Space, Return or Enter is pressed.
+   * gtk_tree_view_row_activated() is called.
+   *
+   * It is called when the user double-clicks a treeview row with the
+   * [property@Gtk.TreeView:activate-on-single-click] property set to %FALSE,
+   * or when the user single-clicks a row when that property set to %TRUE.
+   *
+   * This signal 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
    * [tree widget conceptual overview][TreeWidget]