The ant manual toc at /usr/share/doc/ant-core-1.7.0/html/manual/toc.html contains a relative link to api/index.html but the ebuild installs the javadoc files one level higher at /usr/share/doc/ant-core-1.7.0/html/api/index.html causing an unnecessary broken link. There is another link like this in the manual page of the script optional target. Unfortunately it seems rather difficult to make dohtml and thus java-pkg_dojavadoc install into a subdir, and other things might break in the process. So maybe one of these ad-hoc solutions is better suited: 1. ln -s ../api ${D}usr/share/doc/${PF}/html/manual/api 2. sed -i s:api/:../api/: docs/manual/toc.html \ docs/manual/OptionalTasks/script.html
Yeah I have been thinking about integrating a feature like this to our eclasses at some point. So far I have just been symlinking them into place.
came onto the same problem symlinking is possible but during uninstall it will be left over in the file system it would be good whether to change the links, change the position of the ant api doc or add a small redirector file at the place so the links follow up at last. (this preferrably be done in the ebuild so on uninstall/upgrade everything will be removed)
Finally got around to writing the eclass patch for this. It's now fixed in 1.7.0-r1