listmodel: add documentation about unique instances

This has subtly been required and the original intention, so make it more
discoverable by adding to the documentation.

Fixes #3030
This commit is contained in:
Christian Hergert 2023-06-21 11:01:52 -07:00
parent 43e133723c
commit d972ba03b4

View File

@ -124,6 +124,8 @@ G_DEFINE_INTERFACE (GListModel, g_list_model, G_TYPE_OBJECT)
* %NULL is never returned for an index that is smaller than the length
* of the list. See g_list_model_get_n_items().
*
* The same #GObject instance may not appear more than once in a #GListModel.
*
* Returns: (type GObject) (transfer full) (nullable): the object at @position.
*
* Since: 2.44