Name: boT120536 Date: 01/03/2001


C:\WINDOWS\Desktop>java -version
java version "1.3.0"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.3.0-C)
Java HotSpot(TM) Client VM (build 1.3.0-C, mixed mode)


Problem generating relative URLs to linked javadoc documentation

I generate my javadoc pack
into "APIdocs" folder of current disk and I want to obtain relative links to
three other javadoc documentation packages which are in three subfolders of
"APIdocs". See the fragment of the javadoc options ("@...") file:

-link "APIdocs/JavaAPI"
-link "APIdocs/ServletAPI"
-link "APIdocs/XMLParserAPI"
-sourcepath "../Technology"
-d "APIdocs"

So the situation is that I have three extra subfolders in the target
documentation folder and each one contains their appropriate "package-list"
file. Javadoc itself is called from "d:/Documentation for CD" folder (this
may be any other) and the documentation is generated into this folder's
subfolders. The links which are generated in the resulting javadoc
documentation have duplicated "APIdocs" folder path, for instance (link to
java.awt package summary):

APIdocs/JavaAPI\java/awt/package-summary.html

instead of supposed:

JavaAPI\java/awt/package-summary.html

which is the path from which that extra documentation is linked at
generation. As a result I have to generate my javadoc with one folder
structure

APIdocs
APIdocs/JavaAPI
APIdocs/ServletAPI
APIdocs/XMLParserAPI

and then move three outer documentation packs into an extra "APIdoc"
subfolder, i.e. to

APIdocs
APIdocs/APIdocs
APIdocs/APIdocs/JavaAPI
APIdocs/APIdocs/ServletAPI
APIdocs/APIdocs/XMLParserAPI

in order to make outer links in my documentation work properly.
(Review ID: 114108)
======================================================================