Bug 282598 – dev-cpp/eigen-2.0.5[doc] won't compile with app-doc/doxygen-1.6.0

• Status: RESOLVED FIXED
• Product: Gentoo Linux

[Description Martin von Gagern 2009-08-24 18:04:42 UTC]

This is an early warning, as app-doc/doxygen-1.6.0 isn't in the tree yet. It has been requested by bug #269961, and I'd expect it to arrive soon.

With doxygen 1.6.0 and USE=doc, building eigen will fail. The cause of this is that, for reasons yet unknown (probably a different handling of INCLUDE_PATH and the search for header files), many of the classes won't get documented by doxygen. As a consequence, the generated hierarchy would be empty. eigen2/doc/CMakeLists.txt contains commands to post-process this hierarchy.html using some sed commands, which will fail, causing make to abort.

sed: can't read /var/tmp/portage/dev-cpp/eigen-2.0.5/work/eigen2_build/doc/html/hierarchy.html: No such file or directory
sed: can't read /var/tmp/portage/dev-cpp/eigen-2.0.5/work/eigen2_build/doc/html/hierarchy.html: No such file or directory
sed: can't read /var/tmp/portage/dev-cpp/eigen-2.0.5/work/eigen2_build/doc/html/hierarchy.html: No such file or directory
make[3]: *** [doc/CMakeFiles/doc] Error 2
make[2]: *** [doc/CMakeFiles/doc.dir/all] Error 2
make[1]: *** [doc/CMakeFiles/doc.dir/rule] Error 2
make: *** [doc] Error 2
 * 
 * ERROR: dev-cpp/eigen-2.0.5 failed.
 * Call stack:
 *               ebuild.sh, line   49:  Called src_compile
 *             environment, line 2913:  Called die
 * The specific snippet of code:
 *           emake doc || die "building documentation failed";
 *  The die message:
 *   building documentation failed

I don't know if it would be good policy to already add a blocker on =app-doc/doxygen-1.6.0 to eigen, or if you expect doxygen to fix this issue before it hits the tree, or if you simply want to patch something (e.g. the cleanhierarchy.sh script) to ignore the sed errors, or whatever. I just thought you'd like to know there's trouble ahead.

For those who want to work around this, USE=-doc is the obvious solution. The documentation is available at http://eigen.tuxfamily.org/dox-devel/ .

[Comment 1 Steve Arnold 2009-08-25 06:13:29 UTC]

Reported upstream:

http://bugzilla.gnome.org/show_bug.cgi?id=592975

[Comment 2 Martin von Gagern 2009-08-25 13:54:17 UTC]

Fixed by doxygen 1.6.1, so you can add that to the tree, and either restrict the mask to 1.6.0 only, or remove both the mask and the 1.6.0 ebuild completely.

[Comment 3 Tomáš Chvátal (RETIRED) 2009-09-07 12:08:51 UTC]

@nerdboy:
could you please bump the doxygen and close this bug?
Thanks

[Comment 4 Maciej Mrozowski 2009-09-24 19:20:54 UTC]

Btw, eigen-2.0.5 is missing doxygen dependency (when doc use flag enabled)...

[Comment 5 Steve Arnold 2009-09-25 23:27:15 UTC]

Done and tested; seems to fix the eigen build issue.