United StatesChange Country, Oracle Worldwide Web Sites Communities I am a... I want to...
JDK-4760191 : stddoclet: A first sentence {@docRoot} link is broken in single-page index

Details
Type:
Bug
Submit Date:
2002-10-09
Status:
Resolved
Updated Date:
2014-05-05
Project Name:
JDK
Resolved Date:
2003-11-23
Component:
tools
OS:
other
Sub-Component:
javadoc(tool)
CPU:
generic
Priority:
P4
Resolution:
Fixed
Affected Versions:
1.4.2
Fixed Versions:
5.0 (b30)

Related Reports

Sub Tasks

Description
The first sentence of a package, class or member contains {@docRoot} 
appears in the alphabetic index as a kind of a summary.  If that index
is generated *without* -splitindex, that {@docRoot} link is broken.

For example, for a first sentence in a class comment that links
to the package summary page, if the original first sentence is:

<A HREF="{@docRoot}/p1/package-summary.html#tests">To package tests</A>

I expect to get this in the index-all.html file:

<A HREF="./p1/package-summary.html#tests">To package tests</A>

but instead get this:

<A HREF="/p1/package-summary.html#tests">To package tests</A>

                                    

Comments
CONVERTED DATA

BugTraq+ Release Management Values

COMMIT TO FIX:
tiger
tiger-beta

FIXED IN:
tiger-beta

INTEGRATED IN:
tiger-b30
tiger-beta


                                     
2004-06-14
PUBLIC COMMENTS

Fixed.
###@###.### 2003-11-15
                                     
2003-11-15
EVALUATION

Fix for Tiger.  I've already written the test for index-all.html in
the DocRootSlash.java test file, but have yet to write the fix.
###@###.### 2002-10-08

The SingleIndexWriter.java source file uses a constructor that does
not set the relativepath field, while SplitIndexWriter.java does.
###@###.### 2002-10-09

Fixed by initializing the relativepath field.
###@###.### 2003-11-15
                                     
2002-10-09



Hardware and Software, Engineered to Work Together