Name: nt126004 Date: 04/04/2002


FULL PRODUCT VERSION :
java version "1.4.0"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.0-b92)
Java HotSpot(TM) Client VM (build 1.4.0-b92, mixed mode)

FULL OPERATING SYSTEM VERSION :
Microsoft Windows 2000 [Version 5.00.2195]

A DESCRIPTION OF THE PROBLEM :
This is not fixed by Bug Id 4460354.

Cannot use standard approaches to create a link to the
#package_description bookmark in the first sentence of a
package-summary.html ("package") page, such that the link
works both from the package page and the overview-
summary.html ("overview") page.

STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
1. In the first sentence of a package.html page, try the
syntax described in the Source Code section below.
2.
3.

EXPECTED VERSUS ACTUAL BEHAVIOR :
Expected: Relative link to bookmark on package page should
work both from that package page and from the overview page.

Actual: Depending on which syntax you use, one or the other
ends up broken.

This bug can be reproduced always.

---------- BEGIN SOURCE ----------
I have tried a few approaches:
-----------
(1) Works on package-summary.html page, but tries to point to a local bookmark
when it appears on the overview-summary.html page:

<a href="#package_description">complete description</a>
This is not fixed by Bug Id 4460354.

-----------
(2) Works on package-summary.html page, but not when link appears on overview-
summary.html page:

<a href="package-summary.html#package_description">complete description</a>
This is not fixed by Bug Id 4460354.

-----------
(3) Works on package-summary.html page, but not when link appears on overview-
summary.html page:

<a href="{@docroot}package-summary.html#package_description">complete
description</a> of this package.

-----------
(4) OPPOSITE: Works when link appears on overview-summary.html page, but not on
package-summary.html page:

Click the <a href="{@docroot}com/mydomain/mypackage/package-
summary.html#package_description">complete description</a> of this package.

-----------
(5) This syntax does not work at all:
{@link com.mydomain.mypackage#package_description}
---------- END SOURCE ----------

CUSTOMER WORKAROUND :
Write the URL so it will be relative when it appears on the
overview page, and then use JavaScript to rewrite it on the
package page:
<a href="{@docroot}com/mydomain/mypackage/package-
summary.html#package_description"
onclick="this.href=adjustPath()">complete description</a>

<script language="JavaScript"><!--
/* Rewrites bookmark to be relative to this package page.
   Do not put this script into the HEAD element,
   as anything we put in there seems to be ignored by
   javadoc.
*/
   function adjustPath() {
      return "#package_description";
   }
// --></script>
(Review ID: 144814)
======================================================================