gtkdoc-scanobj cannot handle files with the same name
If I have a project that provides both API v1 and API v2 in different hierarchies such as:
library/ └── include ├── library-1.0 │ ├── library.h │ └── library-util.h └── library-2.0 ├── library.h └── library-util.h
gtk-scanobj attempts to create
library-util.xml for both library-1.0 and library-2.0 paths. This makes it impossible to differentiate them in the main_xml file.
It would be better if they were disambiguated in some way. Ideally, the XML file would be created named the same as the @section_id tag in the file, but if this is impossible, another option would be for the xml to include path information such as
library-library-1.0-library.xml rather than solely taking the filename as the base.