The overview page feature of javadoc in Doclava has an issue where the working
directory changes for the resulting overview HTML page but @docRoot is not
appropriately updated to reflect this, causing links to external files (like
images) to be broken.
Under javadoc normally, the output path of the overview page is in the
destination directory. With Doclava, the file is added to
reference/packages.html such that now all references need to use "../" to
access files. Normally, using @docRoot would solve this problem but with
Doclava @docRoot on the overview.html page is still set to ".".
It's unclear how to work around this issue other than to simply hardcode the
path as "../" in order to put image files in overview.html.
Original issue reported on code.google.com by jasta00@gmail.com on 15 Jul 2012 at 7:51
Original issue reported on code.google.com by
jasta00@gmail.com
on 15 Jul 2012 at 7:51