GtkTree is not supported

[Owen Taylor <otaylor redhat com>]

Since there have been a lot of questions here about
GtkTree recently, I wanted to give a summary of
the feeling of the GTK+ developers about the
Tree widget.

 - GtkTree has some fundemental limitations - the
   main one being a restriction of the total height
   of the tree to 32,768 pixels.

 - The current GtkTree code violates a few assumptions
   about how GTK+ widgets work, some things (such as
   DND) may not work correctly with GtkTree.

 - The author of GtkTree, Jerome Bolliet, is not 
   (to my knowledge) actively involved with GTK+
   at this point. No other developer has wanted
   to take responsibility 

   If patches are submitted that fix bugs in GtkTree,
   they will be applied, but I don't think any
   of the current GTK+ developers plan to spend 
   time tracking the currently reported bugs.

 - Currently, of the two Tree widgets in GTK+, 
   GtkCTree is more supported. Although the code
   for GtkCTree is complicated, and the API has
   some deficiencies, and it can't contain widgets,
   it is actively maintained, and somewhat less
   limited in other regards.

 - As of GTK+-1.4, GtkTree will almost certainly
   be explicitely marked as deprecated if not
   removed entirely.

 - Either in GTK+-1.4 or in some later version there
   probably will be yet one more tree widget introduced.
 
So, if you are planning to use GtkTree:

 - Consider using GtkTree instead.

 - Expect to run into a few quirks/bugs.

Just a bit of a heads-up.
                                        Owen