2.9.0

[~andy/gtk] / docs / reference / gtk / tmpl / gtktreemodel.sgml

diff --git a/docs/reference/gtk/tmpl/gtktreemodel.sgml b/docs/reference/gtk/tmpl/gtktreemodel.sgml
index 477703402d4927c61954236c586d25d900cfdf35..1bc63fb9443b20b2542cf74bd72990911fb72a37 100644 (file)
--- a/docs/reference/gtk/tmpl/gtktreemodel.sgml
+++ b/docs/reference/gtk/tmpl/gtktreemodel.sgml
@@ -65,7 +65,7 @@ generic pointers.  These are filled in by the model in a model-specific
 way.  One can convert a path to an iterator by calling
 gtk_tree_model_get_iter().  These iterators are the primary way of
 accessing a model and are similar to the iterators used by
-#GtkTextBuffer.  They are generally statically allocated on the heap and
+#GtkTextBuffer.  They are generally statically allocated on the stack and
 only used for a short time.  The model interface defines a set of
 operations using them for navigating the model.
 </para>
@@ -121,11 +121,11 @@ the second is much more common, as you often get paths from callbacks.
 
 
   /* walk the tree to find the iterator */
-  gtk_tree_model_get_nth_child (model, &amp;iter, NULL, 3);
+  gtk_tree_model_iter_nth_child (model, &amp;iter, NULL, 3);
   parent_iter = iter;
-  gtk_tree_model_get_nth_child (model, &amp;iter, &amp;parent_iter, 2);
+  gtk_tree_model_iter_nth_child (model, &amp;iter, &amp;parent_iter, 2);
   parent_iter = iter;
-  gtk_tree_model_get_nth_child (model, &amp;iter, &amp;parent_iter, 5);
+  gtk_tree_model_iter_nth_child (model, &amp;iter, &amp;parent_iter, 5);
 }
 </programlisting>
 </example>
@@ -193,12 +193,60 @@ enum
 #GtkTreeView, #GtkTreeStore, #GtkListStore, <link linkend="gtk-GtkTreeView-drag-and-drop">GtkTreeDnd</link>, #GtkTreeSortable
 </para>
 
+<!-- ##### SECTION Stability_Level ##### -->
+
+
 <!-- ##### STRUCT GtkTreeModel ##### -->
 <para>
 
 </para>
 
 
+<!-- ##### SIGNAL GtkTreeModel::row-changed ##### -->
+<para>
+
+</para>
+
+@treemodel: the object which received the signal.
+@arg1: 
+@arg2: 
+
+<!-- ##### SIGNAL GtkTreeModel::row-deleted ##### -->
+<para>
+
+</para>
+
+@treemodel: the object which received the signal.
+@arg1: 
+
+<!-- ##### SIGNAL GtkTreeModel::row-has-child-toggled ##### -->
+<para>
+
+</para>
+
+@treemodel: the object which received the signal.
+@arg1: 
+@arg2: 
+
+<!-- ##### SIGNAL GtkTreeModel::row-inserted ##### -->
+<para>
+
+</para>
+
+@treemodel: the object which received the signal.
+@arg1: 
+@arg2: 
+
+<!-- ##### SIGNAL GtkTreeModel::rows-reordered ##### -->
+<para>
+
+</para>
+
+@treemodel: the object which received the signal.
+@arg1: 
+@arg2: 
+@arg3: 
+
 <!-- ##### STRUCT GtkTreeIter ##### -->
 <para>
 The <structname>GtkTreeIter</structname> is the primary structure for
@@ -320,12 +368,12 @@ section.
 
 <!-- ##### MACRO gtk_tree_path_new_root ##### -->
 <para>
-An alternate name for gtk_tree_path_new_iter() provided for
-compatibility reasons; this macro will be deprecated in future
-versions of GTK+.
+An alternate name for gtk_tree_path_new_first() provided for
+compatibility reasons.
 </para>
 
 @Returns: A new #GtkTreePath.
+@Deprecated: Use gtk_tree_path_new_first() instead.
 
 
 <!-- ##### FUNCTION gtk_tree_path_append_index ##### -->
@@ -466,6 +514,15 @@ versions of GTK+.
 @Returns: 
 
 
+<!-- ##### FUNCTION gtk_tree_row_reference_get_model ##### -->
+<para>
+
+</para>
+
+@reference: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gtk_tree_row_reference_get_path ##### -->
 <para>
 
@@ -609,7 +666,7 @@ versions of GTK+.
 
 <!-- ##### MACRO gtk_tree_model_get_iter_root ##### -->
 <para>
-A alternate name for gtk_tree_model_get_iter_root() provided for
+A alternate name for gtk_tree_model_get_iter_first() provided for
 compatibility reasons; this macro will be deprecated in future
 versions of GTK+.
 </para>
@@ -770,9 +827,6 @@ versions of GTK+.
 @tree_model: 
 @path: 
 @iter: 
-<!-- # Unused Parameters # -->
-@start_path: 
-@start_iter: 
 
 
 <!-- ##### FUNCTION gtk_tree_model_row_inserted ##### -->
@@ -815,48 +869,3 @@ versions of GTK+.
 @new_order: 
 
 
-<!-- ##### SIGNAL GtkTreeModel::row-changed ##### -->
-<para>
-
-</para>
-
-@treemodel: the object which received the signal.
-@arg1: 
-@arg2: 
-
-<!-- ##### SIGNAL GtkTreeModel::row-deleted ##### -->
-<para>
-
-</para>
-
-@treemodel: the object which received the signal.
-@arg1: 
-
-<!-- ##### SIGNAL GtkTreeModel::row-has-child-toggled ##### -->
-<para>
-
-</para>
-
-@treemodel: the object which received the signal.
-@arg1: 
-@arg2: 
-
-<!-- ##### SIGNAL GtkTreeModel::row-inserted ##### -->
-<para>
-
-</para>
-
-@treemodel: the object which received the signal.
-@arg1: 
-@arg2: 
-
-<!-- ##### SIGNAL GtkTreeModel::rows-reordered ##### -->
-<para>
-
-</para>
-
-@treemodel: the object which received the signal.
-@arg1: 
-@arg2: 
-@arg3: 
-