JDK-4701470 : Javadoc tries to load org.java directory as a file.
  • Type: Bug
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 1.4.0
  • Priority: P4
  • Status: Closed
  • Resolution: Duplicate
  • OS: linux
  • CPU: x86
  • Submitted: 2002-06-13
  • Updated: 2002-06-27
  • Resolved: 2002-06-13
Related Reports
Duplicate :  
Description

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) 
======================================================================

Comments
PUBLIC COMMENTS ...
10-06-2004