change new_root to new_first to avoid confusion.

Sat Feb 23 22:10:52 2002  Jonathan Blandford  <jrb@redhat.com>

	* gtk/gtktreemodel.c (gtk_tree_path_new_first): change new_root to
	new_first to avoid confusion.
	(gtk_tree_model_get_iter_first): ditto.

2 files changed, 12 insertions, 11 deletions

diff --git a/gtk/gtktreemodel.c b/gtk/gtktreemodel.c
index a17b5aae38..bc941d2608 100644
--- a/gtk/gtktreemodel.c
+++ b/gtk/gtktreemodel.c
@@ -226,15 +226,14 @@ gtk_tree_path_to_string (GtkTreePath *path)
 }
 
 /**
- * gtk_tree_path_new_root:
+ * gtk_tree_path_new_first:
  *
- * Creates a new root #GtkTreePath.  The string representation of this path is
- * "0"
+ * Creates a new #GtkTreePath.  The string representation of this path is "0"
  *
  * Return value: A new #GtkTreePath.
  **/
 GtkTreePath *
-gtk_tree_path_new_root (void)
+gtk_tree_path_new_first (void)
 {
   GtkTreePath *retval;
 
@@ -687,18 +686,18 @@ gtk_tree_model_get_iter_from_string (GtkTreeModel *tree_model,
 
 
 /**
- * gtk_tree_model_get_iter_root:
+ * gtk_tree_model_get_iter_first:
  * @tree_model: A #GtkTreeModel.
  * @iter: The uninitialized #GtkTreeIter.
  * 
- * Initializes @iter with the root iterator in the tree (the one at the root
- * path) and returns %TRUE.   Returns %FALSE if the tree is empty.
+ * Initializes @iter with the first iterator in the tree (the one at the path
+ * "0") and returns %TRUE.  Returns %FALSE if the tree is empty.
  * 
  * Return value: %TRUE, if @iter was set.
  **/
 gboolean
-gtk_tree_model_get_iter_root (GtkTreeModel *tree_model,
-			      GtkTreeIter  *iter)
+gtk_tree_model_get_iter_first (GtkTreeModel *tree_model,
+			       GtkTreeIter  *iter)
 {
   GtkTreePath *path;
   gboolean retval;
diff --git a/gtk/gtktreemodel.h b/gtk/gtktreemodel.h
index 7f59a3e5f1..a94350e77b 100644
--- a/gtk/gtktreemodel.h
+++ b/gtk/gtktreemodel.h
@@ -114,7 +114,8 @@ struct _GtkTreeModelIface
 GtkTreePath *gtk_tree_path_new              (void);
 GtkTreePath *gtk_tree_path_new_from_string  (const gchar       *path);
 gchar       *gtk_tree_path_to_string        (GtkTreePath       *path);
-GtkTreePath *gtk_tree_path_new_root         (void);
+#define gtk_tree_path_new_root gtk_tree_path_new_first
+GtkTreePath *gtk_tree_path_new_first        (void);
 void         gtk_tree_path_append_index     (GtkTreePath       *path,
 					     gint               index);
 void         gtk_tree_path_prepend_index    (GtkTreePath       *path,
@@ -177,7 +178,8 @@ gboolean          gtk_tree_model_get_iter        (GtkTreeModel *tree_model,
 gboolean          gtk_tree_model_get_iter_from_string (GtkTreeModel *tree_model,
 						       GtkTreeIter  *iter,
 						       const gchar  *path_string);
-gboolean          gtk_tree_model_get_iter_root   (GtkTreeModel *tree_model,
+#define gtk_tree_model_get_iter_root(tree_model, iter) gtk_tree_model_get_iter_first(tree_model, iter)
+gboolean          gtk_tree_model_get_iter_first  (GtkTreeModel *tree_model,
 						  GtkTreeIter  *iter);
 GtkTreePath *     gtk_tree_model_get_path        (GtkTreeModel *tree_model,
 						  GtkTreeIter  *iter);