multiselection: Clarify docs

Make it clear that GtkMultiSelection is not persistent
across resorting.

1 files changed, 6 insertions, 0 deletions

diff --git a/gtk/gtkmultiselection.c b/gtk/gtkmultiselection.c
index a97718e704..11caa78fc1 100644
--- a/gtk/gtkmultiselection.c
+++ b/gtk/gtkmultiselection.c
@@ -33,6 +33,12 @@
  *
  * GtkMultiSelection is an implementation of the #GtkSelectionModel interface
  * that allows selecting multiple elements.
+ *
+ * Note that due to the way the selection is stored, newly added items are
+ * always unselected, even if they were just removed from the model, and were
+ * selected before. In particular this means that changing the sort order of
+ * an underlying sort model will clear the selection. In other words, the
+ * selection is *not persistent*.
  */
 
 struct _GtkMultiSelection