[gtk+] Fixed GtkTreeModel::row-deleted documentation



commit f632956166251b50ef31c25110df07565359c182
Author: Tristan Van Berkom <tristan van berkom gmail com>
Date:   Wed Mar 9 15:06:45 2011 +0900

    Fixed GtkTreeModel::row-deleted documentation
    
    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 |    9 +++------
 1 files changed, 3 insertions(+), 6 deletions(-)
---
diff --git a/gtk/gtktreemodel.c b/gtk/gtktreemodel.c
index a6c075a..b4c3424 100644
--- a/gtk/gtktreemodel.c
+++ b/gtk/gtktreemodel.c
@@ -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);



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]