[glib/listmodel-docs] list model: Expand items-changed docs

[Matthias Clasen <matthiasc src gnome org>]

commit 99764fd8fab82ba4df8b139f5e3c9662e4702e49
Author: Matthias Clasen <mclasen redhat com>
Date:   Fri Jun 21 15:53:51 2019 +0000

    list model: Expand items-changed docs
    
    Point out explicitly that positions change
    when ::items-changed is emitted.

 gio/glistmodel.c | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)
---
diff --git a/gio/glistmodel.c b/gio/glistmodel.c
index 17b1d64d5..0dde9ad1f 100644
--- a/gio/glistmodel.c
+++ b/gio/glistmodel.c
@@ -131,9 +131,12 @@ g_list_model_default_init (GListModelInterface *iface)
    * @removed: the number of items removed
    * @added: the number of items added
    *
-   * This signal is emitted whenever items were added or removed to
-   * @list. At @position, @removed items were removed and @added items
-   * were added in their place.
+   * This signal is emitted whenever items were added to or removed
+   * from @list. At @position, @removed items were removed and @added
+   * items were added in their place.
+   *
+   * Note: If @removed != @added, the positions of all later items
+   * in the model change.
    *
    * Since: 2.44
    */