Name: nt126004 Date: 02/20/2002
FULL PRODUCT VERSION :
java version "1.4.0-rc"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.
Java HotSpot(TM) Client VM (build 1.4.0-rc-b91, mixed mode)
FULL OPERATING SYSTEM VERSION :
Microsoft Windows 2000 [Version 5.00.2195]
No service packs
A DESCRIPTION OF THE PROBLEM :
I am writing some new code, and trying to tie in the new
code's documentation to some other javadoc documents. I
notice that when running Javadoc on my code, the destination
directory for the new documentation is incorrectly
pre-pended to the pre-existing linked documentation. For
instance, if I enter:
javadoc -link D:\Computer\JavaPrograms\docs -d .\docs cse300.a1
I receive an error message:
javadoc: Error reading file:
.\docs\D:\Computer\JavaPrograms\docs/package-list
The intent is that the new documentation will appear in the
subdirectory "docs" off the current directory, linked to the
documentation in "D:\Computer\JavaPrograms\docs", but the
new destination directory is prepended to the old, and the
old documentation is not found.
REGRESSION. Last worked in version 1.3.1
STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
1. Put some javadoc-generated documentation into some
directory DIR1.
2. Create a new documentation directory DIR2 for some new
java class.
3. Run javadoc specifying options: -link DIR1 -d DIR2
EXPECTED VERSUS ACTUAL BEHAVIOR :
Expected resuls: Fully-linked Javadoc-generated
documentation between two local directories.
Actual results: Javadoc errors out, citing an incorrect link
directory as the reason.
ERROR MESSAGES/STACK TRACES THAT OCCUR :
javadoc: Error reading file: .\docs\D:\Computer\JavaPrograms\docs/package-list
This bug can be reproduced always.
---------- BEGIN SOURCE ----------
This is not a source code problem. I will repeat, instead, the command-line I
used to find the error:
javadoc -link D:\Computer\JavaPrograms\docs -d .\docs cse300.a1
cse300.a1 is the package I am trying to document and link to javadoc
documentation inside directory "D:\Computer\JavaPrograms\docs".
---------- END SOURCE ----------
CUSTOMER WORKAROUND :
Option -link is supposed to work with URLs, and by
prepending "file:\\" to the link value, the javadoc command
works (i.e., "javadoc -link
file:\\D:\Computer\JavaPrograms\doc -d .\docs cse300.a1"
works properly).
Release Regression From : 1.3.1
The above release value was the last known release where this
bug was known to work. Since then there has been a regression.
(Review ID: 139561)
======================================================================