Top-level include files

["Morten Welinder" <mortenw gnome org>]

Someone is pushing changes to the way Gnome modules include header files,
see http://live.gnome.org/GnomeGoals/CleanupGTKIncludes

> GTK+ is moving toward a model where it is only allowed to include the 'toplevel'
> headers. Only <glib.h>, <gdk/gdk.h>, <gdk-pixbuf/gdk-pixbuf.h> and <gtk/gtk.h>
> can be directly included.

This would be nice advice were it not for the fact that it is wrong
and it is being
spread far and wide.  One exception is <gdk/gdkkeysyms.h> and it is not alone.

So: what header files are meant to be included by applications?  Where is this
information documented?

I have been trying to get this information via bugzilla, wiki, irc and
not the mailing
list.  The best answer, so far, is "see if it compiles" which is a
sad, sad statement
about the API.

Morten