Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 185694 - dev-java/ant-core-1.7.0: broken link in doc from manual to javadoc api
Summary: dev-java/ant-core-1.7.0: broken link in doc from manual to javadoc api
Status: RESOLVED FIXED
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: [OLD] Java (show other bugs)
Hardware: All Linux
: High trivial (vote)
Assignee: Java team
URL: file:///usr/share/doc/ant-core-1.7.0/...
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2007-07-17 19:52 UTC by Martin von Gagern
Modified: 2007-11-28 02:06 UTC (History)
1 user (show)

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Martin von Gagern 2007-07-17 19:52:52 UTC
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
Comment 1 Petteri Räty (RETIRED) gentoo-dev 2007-07-17 20:40:05 UTC
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.
Comment 2 emerald 2007-07-28 20:52:16 UTC
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)
Comment 3 Petteri Räty (RETIRED) gentoo-dev 2007-11-28 02:06:56 UTC
Finally got around to writing the eclass patch for this. It's now fixed in 1.7.0-r1