From c44a49fa0c5ff502d57d5cf43f78d0dafbc1aa7b Mon Sep 17 00:00:00 2001
From: Owen Taylor <otaylor@redhat.com>
Date: Sun, 24 Feb 2002 04:45:31 +0000
Subject: [PATCH] Document gtk_tree_path_new_root(),
 gtk_tree_model_get_iter_root() as

Sat Feb 23 23:39:14 2002  Owen Taylor  <otaylor@redhat.com>

        * gtk/tmpl/gtktreemodel.sgml: Document gtk_tree_path_new_root(),
        gtk_tree_model_get_iter_root() as compatibility macros.

        * gtk/gtk-sections.txt: Updates.
---
 docs/reference/ChangeLog                  |  7 ++++++
 docs/reference/gtk/gtk-sections.txt       |  3 +++
 docs/reference/gtk/tmpl/gtktreemodel.sgml | 26 +++++++++++++++++++++--
 3 files changed, 34 insertions(+), 2 deletions(-)

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index b0cfc1cadb..b7e4adcd95 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,10 @@
+Sat Feb 23 23:39:14 2002  Owen Taylor  <otaylor@redhat.com>
+
+	* gtk/tmpl/gtktreemodel.sgml: Document gtk_tree_path_new_root(),
+	gtk_tree_model_get_iter_root() as compatibility macros.
+
+	* gtk/gtk-sections.txt: Updates.
+
 2002-02-23  Anders Carlsson  <andersca@gnu.org>
 
 	* gtk/Makefile.am (HTML_IMAGES): Rename strikeout to 
diff --git a/docs/reference/gtk/gtk-sections.txt b/docs/reference/gtk/gtk-sections.txt
index 59e5e6cba6..113572c7c4 100644
--- a/docs/reference/gtk/gtk-sections.txt
+++ b/docs/reference/gtk/gtk-sections.txt
@@ -2813,6 +2813,7 @@ GtkTreeModelFlags
 gtk_tree_path_new
 gtk_tree_path_new_from_string
 gtk_tree_path_to_string
+gtk_tree_path_new_first
 gtk_tree_path_new_root
 gtk_tree_path_append_index
 gtk_tree_path_prepend_index
@@ -2842,6 +2843,7 @@ gtk_tree_model_get_n_columns
 gtk_tree_model_get_column_type
 gtk_tree_model_get_iter
 gtk_tree_model_get_iter_from_string
+gtk_tree_model_get_iter_first
 gtk_tree_model_get_iter_root
 gtk_tree_model_get_path
 gtk_tree_model_get_value
@@ -3692,6 +3694,7 @@ gtk_window_get_type
 GtkWindowGeometryInfo
 gtk_window_remove_embedded_xid
 gtk_window_add_embedded_xid
+GtkWindowKeysForeachFunc
 </SECTION>
 
 
diff --git a/docs/reference/gtk/tmpl/gtktreemodel.sgml b/docs/reference/gtk/tmpl/gtktreemodel.sgml
index 7436f32764..422a6faa97 100644
--- a/docs/reference/gtk/tmpl/gtktreemodel.sgml
+++ b/docs/reference/gtk/tmpl/gtktreemodel.sgml
@@ -114,7 +114,7 @@ The tree interface used by #GtkTreeView
 @Returns: 
 
 
-<!-- ##### FUNCTION gtk_tree_path_new_root ##### -->
+<!-- ##### FUNCTION gtk_tree_path_new_first ##### -->
 <para>
 
 </para>
@@ -122,6 +122,16 @@ The tree interface used by #GtkTreeView
 @Returns: 
 
 
+<!-- ##### MACRO gtk_tree_path_new_root ##### -->
+<para>
+A alternate name for gtk_tree_path_new_root() provided for
+compatibility reasons; this macro will be deprecated in future
+versions of GTK+.
+</para>
+
+@Returns: A new #GtkTreePath.
+
+
 <!-- ##### FUNCTION gtk_tree_path_append_index ##### -->
 <para>
 
@@ -382,7 +392,7 @@ The tree interface used by #GtkTreeView
 @Returns: 
 
 
-<!-- ##### FUNCTION gtk_tree_model_get_iter_root ##### -->
+<!-- ##### FUNCTION gtk_tree_model_get_iter_first ##### -->
 <para>
 
 </para>
@@ -392,6 +402,18 @@ The tree interface used by #GtkTreeView
 @Returns: 
 
 
+<!-- ##### MACRO gtk_tree_model_get_iter_root ##### -->
+<para>
+A alternate name for gtk_tree_model_get_iter_root() provided for
+compatibility reasons; this macro will be deprecated in future
+versions of GTK+.
+</para>
+
+@tree_model:  A #GtkTreeModel.
+@iter: uninitialized #GtkTreeIter.
+@Returns:  %TRUE, if @iter was set.
+
+
 <!-- ##### FUNCTION gtk_tree_model_get_path ##### -->
 <para>