stddoclet: Should know where home is -- docs should link to java.sun.com

Name: nt126004 Date: 04/19/2002


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

FULL OPERATING SYSTEM VERSION : All

A DESCRIPTION OF THE PROBLEM :
javadoc should know where "home" is. It should be
implicitly aware of where the javadoc and package-list
for standard packages provided with the JSDK distribution
come from and have a "-link" directive pointing there. For
example, the javadoc that comes with the JDK 1.3.1_02
should implicitly do this:

-link http://java.sun.com/j2se/1.3/docs/api

Of course, this link should come last in the list. javadoc
should first check user supplied -link and -linkoffline
directives, and then lastly look at its own internal link.

And finally, this feature should be on by default, and a
flag to disable it should be able to be specified on the
command-line (like -nohome).


STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
Run javadoc without -link
http://java.sun.com/j2se/1.3/docs/api

This bug can be reproduced always.

CUSTOMER WORKAROUND :
Add "-link http://java.sun.com/j2se/1.3/docs/api" to your
javadoc line. Also, whenever you upgrade JDK versions,
remember to update this as well.
(Review ID: 145076)
======================================================================