]> Pileus Git - ~andy/gtk/commitdiff
Fixed GtkTreeModel::row-deleted documentation
authorTristan Van Berkom <tristan.van.berkom@gmail.com>
Wed, 9 Mar 2011 06:06:45 +0000 (15:06 +0900)
committerTristan Van Berkom <tristan.van.berkom@gmail.com>
Wed, 9 Mar 2011 06:08:32 +0000 (15:08 +0900)
This documentation was in direct conflict with the documentation
of gtk_tree_model_row_deleted() docs, the function docs are TRUE,
the signal docs were FALSE, fixed.

gtk/gtktreemodel.c

index a6c075a097668818a53406c76fca275c3d2e83e7..b4c342461a2ab02a135e8a8e1bb9d02436538539 100644 (file)
@@ -401,12 +401,9 @@ gtk_tree_model_base_init (gpointer g_class)
        * Note that no iterator is passed to the signal handler,
        * since the row is already deleted.
        *
-       * Implementations of GtkTreeModel must emit ::row-deleted
-       * <emphasis>before</emphasis> removing the node from its
-       * internal data structures. This is because models and
-       * views which access and monitor this model might have
-       * references on the node which need to be released in the
-       * row-deleted handler.
+       * This should be called by models after a row has been removed.
+       * The location pointed to by @path should be the location that
+       * the row previously was at. It may not be a valid location anymore.
        */
       closure = g_closure_new_simple (sizeof (GClosure), NULL);
       g_closure_set_marshal (closure, row_deleted_marshal);