gtk-doc's autogenerated FOO-sections.txt and include files

[Sven Herzberg <herzi gnome-de org>]

Hi,

I'd like to auto-generate the sections.txt file for a project of mine;
however, I'd also like to set the proper "<INCLUDE>include.h</INCLUDE>"
part of that project and would like to propose this:

The tool that generates the sections.txt file could get two command line
arguments:

--auto-include (default)

Include the header file containing a function as the <INCLUDE> part
within a file's <SECTION>.

--single-include=[include.h]

Put the <INCLUDE> on top of the sections file. Maybe even add a multiply
specifyable --explicit-include=other.h (so that stuff like gdk/gdkx.h
can be specified as well…).

What do you think? (Also in regards to the current single include
discussions on gtk-devel-list.)

Regards,
  Sven