doc updates.

ChangeLog

+Fri Mar  5 23:52:34 2004  Matthias Clasen  <maclas@gmx.de>
+
+	* gtk/gtktreemodelfilter.c (gtk_tree_model_filter_set_modify_func): 
+	Improve the docs.  (#127727, Murray Cumming)
+
 Fri Mar  5 23:37:16 2004  Matthias Clasen  <maclas@gmx.de>
 
 	* gtk/gtktreeview.c (gtk_tree_view_set_reorderable): Clarify the

ChangeLog.pre-2-10

+Fri Mar  5 23:52:34 2004  Matthias Clasen  <maclas@gmx.de>
+
+	* gtk/gtktreemodelfilter.c (gtk_tree_model_filter_set_modify_func): 
+	Improve the docs.  (#127727, Murray Cumming)
+
 Fri Mar  5 23:37:16 2004  Matthias Clasen  <maclas@gmx.de>
 
 	* gtk/gtktreeview.c (gtk_tree_view_set_reorderable): Clarify the

ChangeLog.pre-2-4

+Fri Mar  5 23:52:34 2004  Matthias Clasen  <maclas@gmx.de>
+
+	* gtk/gtktreemodelfilter.c (gtk_tree_model_filter_set_modify_func): 
+	Improve the docs.  (#127727, Murray Cumming)
+
 Fri Mar  5 23:37:16 2004  Matthias Clasen  <maclas@gmx.de>
 
 	* gtk/gtktreeview.c (gtk_tree_view_set_reorderable): Clarify the

ChangeLog.pre-2-6

+Fri Mar  5 23:52:34 2004  Matthias Clasen  <maclas@gmx.de>
+
+	* gtk/gtktreemodelfilter.c (gtk_tree_model_filter_set_modify_func): 
+	Improve the docs.  (#127727, Murray Cumming)
+
 Fri Mar  5 23:37:16 2004  Matthias Clasen  <maclas@gmx.de>
 
 	* gtk/gtktreeview.c (gtk_tree_view_set_reorderable): Clarify the

ChangeLog.pre-2-8

+Fri Mar  5 23:52:34 2004  Matthias Clasen  <maclas@gmx.de>
+
+	* gtk/gtktreemodelfilter.c (gtk_tree_model_filter_set_modify_func): 
+	Improve the docs.  (#127727, Murray Cumming)
+
 Fri Mar  5 23:37:16 2004  Matthias Clasen  <maclas@gmx.de>
 
 	* gtk/gtktreeview.c (gtk_tree_view_set_reorderable): Clarify the

docs/reference/ChangeLog

+Fri Mar  5 23:58:01 2004  Matthias Clasen  <maclas@gmx.de>
+
+	* gtk/tmpl/gtktreemodelfilter.sgml: A little addition.
+
 Fri Mar  5 23:45:06 2004  Matthias Clasen  <maclas@gmx.de>
 
 	* gtk/tmpl/gtkinvisible.sgml: Remove "internally-used"

docs/reference/gtk/tmpl/gtktreemodelfilter.sgml

@@ -67,6 +67,10 @@ A function which calculates display values from raw values in the model.
 It must fill @value with the display value for the column @column in the 
 row indicated by @iter. 
 </para>
+<para>
+Since this function is called for each data access, it's not a
+particularly efficient operation.
+</para>
 
 @model: the #GtkTreeModelFilter
 @iter: a #GtkTreeIter pointing to the row whose display values are determined

gtk/gtktreemodelfilter.c

@@ -2489,8 +2489,13 @@ gtk_tree_model_filter_set_visible_func (GtkTreeModelFilter            *filter,
  * @data: User data to pass to the modify function, or %NULL.
  * @destroy: Destroy notifier of @data, or %NULL.
  *
- * Sets the @filter to have @n_columns columns with @types and sets 
- * @func to be the modify function of @filter.
+ * With the @n_columns and @types parameters, you give an array of column
+ * types for this model (which will be exposed to the parent model/view).
+ * The @func, @data and @destroy parameters are for specifying the modify
+ * function. The modify function will get called for <emphasis>each</emphasis>
+ * data access, the goal of the modify function is to return the data which 
+ * should be displayed at the location specified using the parameters of the 
+ * modify function.
  *
  * Since: 2.4
  */