[gtk] ListBox: Avoid ::row-activated/Row::activate ambig

[Daniel Boles <dboles src gnome org>]

commit 20729533756db6038542d95e0d76e07b9b096864
Author: Daniel Boles <dboles src gnome org>
Date:   Mon Mar 12 16:08:29 2018 +0000

    ListBox: Avoid ::row-activated/Row::activate ambig
    
    …uity, by adding a doc comment to Row::activate explaining what it does
    and why it is probably not what the user reading that is looking for.
    
    https://bugzilla.gnome.org/show_bug.cgi?id=794008

 gtk/gtklistbox.c | 8 ++++++++
 1 file changed, 8 insertions(+)
---
diff --git a/gtk/gtklistbox.c b/gtk/gtklistbox.c
index 50e050a6c6..77dcaf9a56 100644
--- a/gtk/gtklistbox.c
+++ b/gtk/gtklistbox.c
@@ -3409,6 +3409,14 @@ gtk_list_box_row_class_init (GtkListBoxRowClass *klass)
 
   klass->activate = gtk_list_box_row_activate;
 
+  /**
+   * GtkListBoxRow::activate:
+   *
+   * This is a keybinding signal, which will cause this row to be activated.
+   *
+   * If you want to be notified when the user activates a row (by key or not),
+   * use the #GtkListBox::row-activated signal on the row’s parent #GtkListBox.
+   */
   row_signals[ROW__ACTIVATE] =
     g_signal_new (I_("activate"),
                   G_OBJECT_CLASS_TYPE (object_class),