[gtk+] docs: Add gtk-doc comment for GtkTreeRowReference



commit 941851fc865485d5951e1b32773e9bed690b924e
Author: David King <amigadave amigadave com>
Date:   Thu Nov 22 18:38:21 2012 +0000

    docs: Add gtk-doc comment for GtkTreeRowReference
    
    https://bugzilla.gnome.org/show_bug.cgi?id=93381

 gtk/gtktreemodel.h |    9 ++++++---
 1 files changed, 6 insertions(+), 3 deletions(-)
---
diff --git a/gtk/gtktreemodel.h b/gtk/gtktreemodel.h
index ea81a21..7d082f1 100644
--- a/gtk/gtktreemodel.h
+++ b/gtk/gtktreemodel.h
@@ -190,9 +190,12 @@ gboolean     gtk_tree_path_is_ancestor      (GtkTreePath       *path,
 gboolean     gtk_tree_path_is_descendant    (GtkTreePath       *path,
                                              GtkTreePath       *ancestor);
 
-/* Row reference (an object that tracks model changes so it refers to the same
- * row always; a path refers to a position, not a fixed row).  You almost always
- * want to call gtk_tree_row_reference_new.
+/**
+ * GtkTreeRowReference:
+ *
+ * A GtkTreeRowReference tracks model changes so that it always refers to the
+ * same row (a #GtkTreePath refers to a position, not a fixed row). Create a
+ * new GtkTreeRowReference with gtk_tree_row_reference_new().
  */
 
 GType                gtk_tree_row_reference_get_type (void) G_GNUC_CONST;



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