RE: Usage of GTK+ headers

["Banginwar, Rajesh" <rajesh banginwar intel com>]

Hi,
	What I am finding though is some of the libraries have more than
one top level header. E.g. gdk-pixbuf has two: gdk-pixbuf.h and
gdk-pixdata.h. Is this intentional? 

Similarly, pangoft2 has pangofc-fontmap.h and pangofc-decoder.h in
addition to pangoft2. In pangofc-fontmap.h there are 3 interfaces
declared outside of ENABLE macro. Same question, is this intentional?

Sorry, I forgot to give background in earlier email: The question was in
LSB context and I am trying to figure what should become available in
LSB build environments and specifications. 

Thanks,

-Rajesh

> -----Original Message-----
> From: Owen Taylor [mailto:otaylor redhat com]
> Sent: Wednesday, October 12, 2005 10:21 AM
> To: Tristan Van Berkom
> Cc: Banginwar, Rajesh; gtk-devel-list gnome org
> Subject: Re: Usage of GTK+ headers
> 
> 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
>