From: Matthias Clasen Date: Mon, 26 Nov 2001 19:01:08 +0000 (+0000) Subject: Mark g_tree_traverse() as deprecated. (#65343) X-Git-Url: http://git.openbox.org/?a=commitdiff_plain;h=e44629811335fe969a4d5bb10e8f4ae5a5f74a0f;p=dana%2Fcg-glib.git Mark g_tree_traverse() as deprecated. (#65343) * glib/gtree.h: Mark g_tree_traverse() as deprecated. (#65343) * glib/gtree.c (g_tree_traverse): Explain the deprecation in some detail. --- diff --git a/ChangeLog b/ChangeLog index 4b177143..1a3557f3 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,10 @@ +2001-11-26 Matthias Clasen + + * glib/gtree.h: Mark g_tree_traverse() as deprecated. (#65343) + + * glib/gtree.c (g_tree_traverse): Explain the deprecation in + some detail. + Mon Nov 26 09:42:24 2001 Tim Janik * configure.in: provide GLIB_SIZEOF_SIZE_T. diff --git a/ChangeLog.pre-2-0 b/ChangeLog.pre-2-0 index 4b177143..1a3557f3 100644 --- a/ChangeLog.pre-2-0 +++ b/ChangeLog.pre-2-0 @@ -1,3 +1,10 @@ +2001-11-26 Matthias Clasen + + * glib/gtree.h: Mark g_tree_traverse() as deprecated. (#65343) + + * glib/gtree.c (g_tree_traverse): Explain the deprecation in + some detail. + Mon Nov 26 09:42:24 2001 Tim Janik * configure.in: provide GLIB_SIZEOF_SIZE_T. diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10 index 4b177143..1a3557f3 100644 --- a/ChangeLog.pre-2-10 +++ b/ChangeLog.pre-2-10 @@ -1,3 +1,10 @@ +2001-11-26 Matthias Clasen + + * glib/gtree.h: Mark g_tree_traverse() as deprecated. (#65343) + + * glib/gtree.c (g_tree_traverse): Explain the deprecation in + some detail. + Mon Nov 26 09:42:24 2001 Tim Janik * configure.in: provide GLIB_SIZEOF_SIZE_T. diff --git a/ChangeLog.pre-2-12 b/ChangeLog.pre-2-12 index 4b177143..1a3557f3 100644 --- a/ChangeLog.pre-2-12 +++ b/ChangeLog.pre-2-12 @@ -1,3 +1,10 @@ +2001-11-26 Matthias Clasen + + * glib/gtree.h: Mark g_tree_traverse() as deprecated. (#65343) + + * glib/gtree.c (g_tree_traverse): Explain the deprecation in + some detail. + Mon Nov 26 09:42:24 2001 Tim Janik * configure.in: provide GLIB_SIZEOF_SIZE_T. diff --git a/ChangeLog.pre-2-2 b/ChangeLog.pre-2-2 index 4b177143..1a3557f3 100644 --- a/ChangeLog.pre-2-2 +++ b/ChangeLog.pre-2-2 @@ -1,3 +1,10 @@ +2001-11-26 Matthias Clasen + + * glib/gtree.h: Mark g_tree_traverse() as deprecated. (#65343) + + * glib/gtree.c (g_tree_traverse): Explain the deprecation in + some detail. + Mon Nov 26 09:42:24 2001 Tim Janik * configure.in: provide GLIB_SIZEOF_SIZE_T. diff --git a/ChangeLog.pre-2-4 b/ChangeLog.pre-2-4 index 4b177143..1a3557f3 100644 --- a/ChangeLog.pre-2-4 +++ b/ChangeLog.pre-2-4 @@ -1,3 +1,10 @@ +2001-11-26 Matthias Clasen + + * glib/gtree.h: Mark g_tree_traverse() as deprecated. (#65343) + + * glib/gtree.c (g_tree_traverse): Explain the deprecation in + some detail. + Mon Nov 26 09:42:24 2001 Tim Janik * configure.in: provide GLIB_SIZEOF_SIZE_T. diff --git a/ChangeLog.pre-2-6 b/ChangeLog.pre-2-6 index 4b177143..1a3557f3 100644 --- a/ChangeLog.pre-2-6 +++ b/ChangeLog.pre-2-6 @@ -1,3 +1,10 @@ +2001-11-26 Matthias Clasen + + * glib/gtree.h: Mark g_tree_traverse() as deprecated. (#65343) + + * glib/gtree.c (g_tree_traverse): Explain the deprecation in + some detail. + Mon Nov 26 09:42:24 2001 Tim Janik * configure.in: provide GLIB_SIZEOF_SIZE_T. diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8 index 4b177143..1a3557f3 100644 --- a/ChangeLog.pre-2-8 +++ b/ChangeLog.pre-2-8 @@ -1,3 +1,10 @@ +2001-11-26 Matthias Clasen + + * glib/gtree.h: Mark g_tree_traverse() as deprecated. (#65343) + + * glib/gtree.c (g_tree_traverse): Explain the deprecation in + some detail. + Mon Nov 26 09:42:24 2001 Tim Janik * configure.in: provide GLIB_SIZEOF_SIZE_T. diff --git a/glib/gtree.c b/glib/gtree.c index a5737f83..96a1b342 100644 --- a/glib/gtree.c +++ b/glib/gtree.c @@ -467,7 +467,10 @@ g_tree_foreach (GTree *tree, * @user_data: user data to pass to the function. * * Calls the given function for each node in the GTree. This function is - * deprecated, use g_tree_foreach() instead. + * deprecated, since the order of a balanced tree is somewhat arbitrary. + * If you just want to visit all nodes in some order, use g_tree_foreach() + * instead. If you really need to visit nodes in a specific order, consider + * using an N-ary Tree. **/ void g_tree_traverse (GTree *tree, diff --git a/glib/gtree.h b/glib/gtree.h index ba5102c6..b6894d5b 100644 --- a/glib/gtree.h +++ b/glib/gtree.h @@ -66,10 +66,14 @@ gboolean g_tree_lookup_extended (GTree *tree, void g_tree_foreach (GTree *tree, GTraverseFunc func, gpointer user_data); + +#ifndef G_DISABLE_DEPRECATED void g_tree_traverse (GTree *tree, GTraverseFunc traverse_func, GTraverseType traverse_type, gpointer user_data); +#endif /* G_DISABLE_DEPRECATED */ + gpointer g_tree_search (GTree *tree, GCompareFunc search_func, gconstpointer user_data);