Merge branch 'otte/for-master2' into 'master'

docs: Add note about stable sorting to SortListModel

See merge request GNOME/gtk!4017
This commit is contained in:
Benjamin Otte 2021-10-01 02:49:11 +00:00
commit 72bbc51ba9

View File

@ -58,6 +58,13 @@
* A `GListModel` that sorts the elements of an underlying model
* according to a `GtkSorter`.
*
* The model is a stable sort. If two items compare equal according
* to the sorter, the one that appears first in the original model will
* also appear first after sorting.
* Note that if you change the sorter, the previous order will have no
* influence on the new order. If you want that, consider using a
* `GtkMultiSorter` and appending the previous sorter to it.
*
* The model can be set up to do incremental sorting, so that
* sorting long lists doesn't block the UI. See
* [method@Gtk.SortListModel.set_incremental] for details.