Bug 409511 - Broken links in root Javadoc files
Summary: Broken links in root Javadoc files
Status: VERIFIED FIXED
Alias: None
Product: Platform
Classification: Eclipse Project
Component: Doc (show other bugs)
Version: 4.3   Edit
Hardware: All All
: P3 normal (vote)
Target Milestone: 4.3 RC3   Edit
Assignee: Markus Keller CLA
QA Contact:
URL:
Whiteboard:
Keywords: Documentation
Depends on: 101048
Blocks:
  Show dependency tree
 
Reported: 2013-05-30 11:34 EDT by Markus Keller CLA
Modified: 2013-05-31 02:41 EDT (History)
2 users (show)

See Also:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Markus Keller CLA 2013-05-30 11:34:18 EDT 
Bug in Javadoc tool:

When the -bottom argument contains {@docRoot}, then the tag is usually correctly replaced by the correct repetition of "../". However, for files at the root (deprecated-list.html, constant-values.html, etc.), the "{@docRoot}" is wrongly replaced by "" (the empty string). The correct replacement would be ".".

Bug 101048 worked around this, but that hack doesn't work any more, since the formatting of the -bottom argument has changed slightly (now uses ', not "):

<a href='{@docRoot}/../misc/api-usage-rules.html'>Guidelines for using Eclipse APIs.</a>
Comment 2 Markus Keller CLA 2013-05-30 11:55:47 EDT 
.
Comment 3 Markus Keller CLA 2013-05-30 12:15:12 EDT 
Oracle bugs:
http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6215454
http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=7089999

I would have marked the bugs as duplicates and told them what's wrong, but Oracle's Java bug database is still screwed...
Comment 4 Dani Megert CLA 2013-05-31 02:41:28 EDT 
Verified in I20130530-1430.