GNOME Bugzilla – Bug 592975
doxygen-1.6.0 breaks on eigen-2.0.5 (but doxygen 1.5.8 works fine)
Last modified: 2009-08-25 11:52:53 UTC
With doxygen 1.6.0 building the eigen docs will fail. For some reason, doxygen fails to find most of the classes, which results in an empty hierarchy file. See the Gentoo bug for details: https://bugs.gentoo.org/show_bug.cgi?id=282598
OK, I now understood at least some warning messages. When building the eigen documentation, doxygen 1.6.0 will repeatedly print the following message: Warning: include file ... not found, perhaps you forgot to add its directory to INCLUDE_PATH? The INCLUDE_PATH has nothing to do with it, though. Instead, checkAndOpenFile from pre.l will detect that the file was already included once, as it is listed in g_allIncludes. It will therefore return NULL. readIncludeFile, on the other hand, will hit its "g_curlyCount>0" check, as the main file encloses the included headers in a namespace block, thus resulting in this error message. All this doesn't completely explain why the generated documentation doesn't contain most classes, but I guess that having the namespace blocks in the main files instead of the header files might have something to do with it. I'm not sure if there was a deliberate decision not to support this kind of construct. If so, eigen developers should be made aware of this.
Some regression w.r.t. include file handling has been found, causing the above warning amongst others. I'm currently working on a fix and will release 1.6.1 once I'm done. I'll use the eigen sources to test the results and try to make doxygen behave as before.
This bug was previously marked ASSIGNED, which means it should be fixed in doxygen version 1.6.1. Please verify if this is indeed the case and reopen the bug if you think it is not fixed (include any additional information that you think can be relevant).