[gtk+] GtkListBox: improve the docs

[Matthias Clasen <matthiasc src gnome org>]

commit c813765430c7fa69d9fe44ecb414532e44e723b0
Author: Matthias Clasen <mclasen redhat com>
Date:   Thu May 8 07:33:01 2014 -0400

    GtkListBox: improve the docs
    
    The documentation was not really clear about ::row-selected
    not working for multi-selection.

 gtk/gtklistbox.c |    4 +++-
 1 files changed, 3 insertions(+), 1 deletions(-)
---
diff --git a/gtk/gtklistbox.c b/gtk/gtklistbox.c
index 62aefe5..1b0fd12 100644
--- a/gtk/gtklistbox.c
+++ b/gtk/gtklistbox.c
@@ -395,7 +395,9 @@ gtk_list_box_class_init (GtkListBoxClass *klass)
    * The ::row-selected signal is emitted when a new row is selected, or
    * (with a %NULL @row) when the selection is cleared.
    *
-   * Also see #GtkListBox::selected-rows-changed.
+   * When the @box is using #GTK_SELECTION_MULTIPLE, this signal will not
+   * give you the full picture of selection changes, and you should use
+   * the #GtkListBox::selected-rows-changed signal instead.
    *
    * Since: 3.10
    */