GNOME Bugzilla – Bug 698398
Improper description of GtkTreeModel "rows-reordered" iter
Last modified: 2014-01-22 06:23:48 UTC
As of gtk+ 3.6, the documentation for GtkTreeModel "rows-reordered" says: "iter : a valid GtkTreeIter pointing to the node whose" The sentence is incomplete (should be "whose children have been reordered"), and not entirely correct as well: if you reorder the top-level elements, such iter can not be valid, because it will have to point above the top-level. GtkTreeStore has an internal root element, so the actual iter in this case can be used for some operations (for example iter_next and iter_previous will correctly return false, because root->next and root->prev are always NULL), but other operations crash or emit warnings. If there is a chance that the top-level elements are being reordered, one should always check for path depth == 0 first.
Created attachment 266947 [details] [review] docs: fix improper description of GtkTreeModel "rows-reordered" iter
Attachment 266947 [details] pushed as 89a51bd - docs: fix improper description of GtkTreeModel "rows-reordered" iter