From 312f668efcc8d2370eef632795ddcbacecf03c0a Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Fri, 5 Mar 2004 22:54:14 +0000 Subject: [PATCH] doc updates. --- ChangeLog | 5 +++++ ChangeLog.pre-2-10 | 5 +++++ ChangeLog.pre-2-4 | 5 +++++ ChangeLog.pre-2-6 | 5 +++++ ChangeLog.pre-2-8 | 5 +++++ docs/reference/ChangeLog | 4 ++++ docs/reference/gtk/tmpl/gtktreemodelfilter.sgml | 4 ++++ gtk/gtktreemodelfilter.c | 9 +++++++-- 8 files changed, 40 insertions(+), 2 deletions(-) diff --git a/ChangeLog b/ChangeLog index d97a748890..4ce893501b 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,8 @@ +Fri Mar 5 23:52:34 2004 Matthias Clasen + + * 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 * gtk/gtktreeview.c (gtk_tree_view_set_reorderable): Clarify the diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10 index d97a748890..4ce893501b 100644 --- a/ChangeLog.pre-2-10 +++ b/ChangeLog.pre-2-10 @@ -1,3 +1,8 @@ +Fri Mar 5 23:52:34 2004 Matthias Clasen + + * 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 * gtk/gtktreeview.c (gtk_tree_view_set_reorderable): Clarify the diff --git a/ChangeLog.pre-2-4 b/ChangeLog.pre-2-4 index d97a748890..4ce893501b 100644 --- a/ChangeLog.pre-2-4 +++ b/ChangeLog.pre-2-4 @@ -1,3 +1,8 @@ +Fri Mar 5 23:52:34 2004 Matthias Clasen + + * 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 * gtk/gtktreeview.c (gtk_tree_view_set_reorderable): Clarify the diff --git a/ChangeLog.pre-2-6 b/ChangeLog.pre-2-6 index d97a748890..4ce893501b 100644 --- a/ChangeLog.pre-2-6 +++ b/ChangeLog.pre-2-6 @@ -1,3 +1,8 @@ +Fri Mar 5 23:52:34 2004 Matthias Clasen + + * 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 * gtk/gtktreeview.c (gtk_tree_view_set_reorderable): Clarify the diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8 index d97a748890..4ce893501b 100644 --- a/ChangeLog.pre-2-8 +++ b/ChangeLog.pre-2-8 @@ -1,3 +1,8 @@ +Fri Mar 5 23:52:34 2004 Matthias Clasen + + * 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 * gtk/gtktreeview.c (gtk_tree_view_set_reorderable): Clarify the diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog index 9991658823..67fcdfbe14 100644 --- a/docs/reference/ChangeLog +++ b/docs/reference/ChangeLog @@ -1,3 +1,7 @@ +Fri Mar 5 23:58:01 2004 Matthias Clasen + + * gtk/tmpl/gtktreemodelfilter.sgml: A little addition. + Fri Mar 5 23:45:06 2004 Matthias Clasen * gtk/tmpl/gtkinvisible.sgml: Remove "internally-used" diff --git a/docs/reference/gtk/tmpl/gtktreemodelfilter.sgml b/docs/reference/gtk/tmpl/gtktreemodelfilter.sgml index adceb07950..62ad1b0eba 100644 --- a/docs/reference/gtk/tmpl/gtktreemodelfilter.sgml +++ b/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. + +Since this function is called for each data access, it's not a +particularly efficient operation. + @model: the #GtkTreeModelFilter @iter: a #GtkTreeIter pointing to the row whose display values are determined diff --git a/gtk/gtktreemodelfilter.c b/gtk/gtktreemodelfilter.c index b6934c90b0..fc250c0d27 100644 --- a/gtk/gtktreemodelfilter.c +++ b/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 each + * 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 */