Name: nt126004 Date: 06/12/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 :
Mandrake Linux 8.1 2.96-0.62mdk
A DESCRIPTION OF THE PROBLEM :
When using a package name like "org.java", javadoc treats
the directory name (org/java) as a java source file (and, of
course, fails to load the file).
STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
1. Create this directory tree:
./org/java
./org/javo
2. Put this source file in org/java (Test.java):
package org.java;
public interface Test {}
3. Put this source file in org/javo (Test.java):
package org.javo;
public interface Test {}
4. Run: $ javac -d . org/java/*.java org/javo/*.java
5. Run: $ javadoc -d doc org.javo
6. Run: $ javadoc -d doc org.java
EXPECTED VERSUS ACTUAL BEHAVIOR :
Actual:
---------------------------------------------------------
$ javadoc -d doc org.javo
Loading source files for package org.javo...
Constructing Javadoc information...
Standard Doclet version 1.4.0
Generating doc/constant-values.html...
Building tree for all the packages and classes...
Building index for all the packages and classes...
Generating doc/overview-tree.html...
Generating doc/index-all.html...
Generating doc/deprecated-list.html...
Building index for all classes...
Generating doc/allclasses-frame.html...
Generating doc/allclasses-noframe.html...
Generating doc/index.html...
Generating doc/packages.html...
Generating doc/org/javo/package-frame.html...
Generating doc/org/javo/package-summary.html...
Generating doc/org/javo/package-tree.html...
Generating doc/org/javo/Test.html...
Generating doc/serialized-form.html...
Generating doc/package-list...
Generating doc/help-doc.html...
Generating doc/stylesheet.css...
---------------------------------------------------------
$ javadoc -d doc org.java
Loading source file org.java...
error: cannot read: org.java
1 error
---------------------------------------------------------
ERROR MESSAGES/STACK TRACES THAT OCCUR :
See "Expected and Actual Results".
This bug can be reproduced always.
---------- BEGIN SOURCE ----------
See "Steps to Reproduce".
---------- END SOURCE ----------
CUSTOMER WORKAROUND :
$ javadoc -d doc -subpackages org.java
(Review ID: 153384)
======================================================================