[Rpm-maint] [rpm-software-management/rpm] API documentation generation broken with doxygen > 1.8.7 (#131)

[pavlinamv]

The problem is because:

> In version 1.8.8 a change has taken place about handling files
> with unknown / unsupported extension. Till that version they were seen as
> C-like files. In version 1.8.8 and up they are skipped, but it is possible
> to use your own extension and map it to a supported version. 

Thus files
doc/librpm/Doxyheader 
doc/hacking/Doxyheader
are skipped and that is why "Modules" are missing.

To solve the problem: 
Add to both files "Doxyheader" an extension. According to the extension, change files "hacking.doxy.in" and "librpm.doxy.in" as it is in change.diff (for extension "xxx").

Another option is to configure "hacking.doxy.in" and "librpm.doxy.in" to process files without extension (no_extension). Doxygen would start to go through all files without extension - README,  INSTALL, ...   as C files, which could lead to undesired results. Therefore I prefer the first option.

[change.txt](https://github.com/rpm-software-management/rpm/files/753006/change.txt)


-- 
You are receiving this because you commented.
Reply to this email directly or view it on GitHub:
https://github.com/rpm-software-management/rpm/issues/131#issuecomment-277520879
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.rpm.org/pipermail/rpm-maint/attachments/20170205/a088ec44/attachment.html>