diff --git a/ChangeLog b/ChangeLog
index 03319d07df..1a2378142d 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2007-01-23  Murray Cumming  <murrayc@murrayc.com>
+
+	* gtk/gtktreemodel.c: gtk_tree_path_next(): 
+	Add a note to the documentation about the changed path being only a 
+	path to a potential node, so you must check that it really exists.
+
 2007-01-22  Matthias Clasen  <mclasen@redhat.com>
 
 	* configure.in: Bump version
diff --git a/gtk/gtktreemodel.c b/gtk/gtktreemodel.c
index 88022b805b..2213e95c77 100644
--- a/gtk/gtktreemodel.c
+++ b/gtk/gtktreemodel.c
@@ -775,7 +775,8 @@ gtk_tree_path_is_descendant (GtkTreePath *path,
  * gtk_tree_path_next:
  * @path: A #GtkTreePath.
  *
- * Moves the @path to point to the next node at the current depth.
+ * Moves the @path to point to the next potential node at the current depth.
+ * You must use gtk_tree_model_get_iter() to discover whether a corresponding row actually exists.
  **/
 void
 gtk_tree_path_next (GtkTreePath *path)