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

2017-02-06 Thread Panu Matilainen
Closed #131.

-- 
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#event-950123502___
Rpm-maint mailing list
Rpm-maint@lists.rpm.org
http://lists.rpm.org/mailman/listinfo/rpm-maint


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

2017-02-06 Thread Panu Matilainen
Oh. I suppose it even makes sense. Fixed now, by simply giving the Doxyheader 
files a .h extension (commit e8438555279b9a4e406ffd0edfc224de1c2862a6).

Thank you for figuring this out!

-- 
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-277652879___
Rpm-maint mailing list
Rpm-maint@lists.rpm.org
http://lists.rpm.org/mailman/listinfo/rpm-maint


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

2017-02-05 Thread 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___
Rpm-maint mailing list
Rpm-maint@lists.rpm.org
http://lists.rpm.org/mailman/listinfo/rpm-maint


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

2017-01-20 Thread Panu Matilainen
For whatever reason, the modules page is not generated anymore with newer 
doxygen versions, see http://ftp.rpm.org/api/4.13.0/ vs 
http://ftp.rpm.org/api/4.12.0.1/. In git master the main page is supposed to 
have content as well but that's also missing when the modules breakage happens.

I chased the breakage starting with doxygen 1.8.8 but didn't spot anything 
obvious,  it's not warning or whining about anything that I can see. Help 
figuring that out would be most welcome.

-- 
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
https://github.com/rpm-software-management/rpm/issues/131___
Rpm-maint mailing list
Rpm-maint@lists.rpm.org
http://lists.rpm.org/mailman/listinfo/rpm-maint