Re: Usage of GTK+ headers

[Owen Taylor <otaylor redhat com>]

On Wed, 2005-10-12 at 10:47 -0400, Tristan Van Berkom wrote:
> Banginwar, Rajesh wrote:
> > Hello,
> > 
> >             Many of the GTK+ libraries have one or more top level header
> > files. E.g. Glib has glib.h, gdk-pixbuf has two gdk-data.h and
> > gdk-pixbuf.h and so on... My question is about what applications
> > typically use? Do they use just the top level header only? Or is it ok
> > to use the specific header file as needed e.g. gtk/gtkstyle.h?
> 
> Oh yeah,
>      and I forgot to mention... gtk-devel-list is a list about
> development on GTK+ itself, gtk-list was fine for this type of
> question; no need to cross-post to this list.

I think the question was valid here - it wasn't a question about 

 "What should I do in my app"

But rather:

 "What guarantees does GTK+ make that should be documented in 
  a specification of the GTK+ interface"

Practically speaking, we try to maintain compatibility for GTK+
and GLib (but not libgobject) for including subheaders -- a lot
of apps include them explicitly so we have little freedom to
rearrange them. 

But we'd prefer that people included the main headers 
gtk/gtk.h gdk/gdk.h gdk-pixbuf/gdk-pixbuf.h, etc.

Regards,
					Owen