Re: Top-level include files

["Matthias Clasen" <matthias clasen gmail com>]

On Wed, Dec 17, 2008 at 9:17 AM, Morten Welinder <mortenw gnome org> wrote:
> 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?
>

Its supposed to be documented in the api docs, at the top of the
synopsis for each section. Of course, the documentation may be
outdated.