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

[Stefan Kost <ensonic hora-obscura de>]

hi,

Sven Herzberg schrieb:
> 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…).
>   
Sounds like a good idea. Single-include is not so easy, as e.g. in glib,
there are exceptions. I don't like to put "Include: [include.h]" into
doc-comments to markup exceptions. Need to think a bit about it.
> What do you think? (Also in regards to the current single include
> discussions on gtk-devel-list.)
>
> Regards,
>   Sven
>
>