From 1837787ce60e714a5a45ca1053f32c263c803fbe Mon Sep 17 00:00:00 2001 From: David King Date: Thu, 22 Nov 2012 18:38:21 +0000 Subject: docs: Add gtk-doc comment for GtkTreeRowReference https://bugzilla.gnome.org/show_bug.cgi?id=93381 --- gtk/gtktreemodel.h | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/gtk/gtktreemodel.h b/gtk/gtktreemodel.h index ea81a21c47..7d082f1dea 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; -- cgit v1.2.1