JDK-4507380 : Merlin javadoc cannot handle packages named *.java (regression)
  • Type: Bug
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 1.4.0,1.4.1
  • Priority: P4
  • Status: Closed
  • Resolution: Fixed
  • OS:
    linux,solaris_7,solaris_8,windows_nt,windows_2000 linux,solaris_7,solaris_8,windows_nt,windows_2000
  • CPU: generic,x86,sparc
  • Submitted: 2001-09-26
  • Updated: 2002-06-27
  • Resolved: 2002-03-08
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
Other
1.4.1 hopperFixed
Related Reports
Duplicate :  
Duplicate :  
Duplicate :  
Duplicate :  
Description

Name: bsT130419			Date: 09/26/2001


java version "1.4.0-beta2"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.0-beta2-b77)
Java HotSpot(TM) Client VM (build 1.4.0-beta2-b77, mixed mode)


If you have a package named "java" (obviously not a top-level package), then
javadoc reports an error when constructing the javadocs.

e.g:

package a.java;
public class A {
}


Using the 1.4 javadoc command gives:

[len@nepenthes java_test]$ javadoc -d doc a.java
Loading source file a.java...
error: cannot read: a.java
1 error

Using the 1.3 javadoc command gives:
[len@nepenthes java_test]$ javadoc -d doc a.java
Loading source files for package a.java...
Constructing Javadoc information...
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/index.html...
Generating doc/packages.html...
Generating doc/a/java/package-summary.html...
Generating doc/a/java/package-tree.html...
Generating doc/a/java/package-frame.html...
Generating doc/a/java/A.html...
Generating doc/serialized-form.html...
Generating doc/package-list...
Generating doc/help-doc.html...
Generating doc/stylesheet.css...
and generates the expected documentation.
(We have a package named java to implement a custom url protocol named java:,
and having a package named after the protocol is one method for registering such
protocols)
(Review ID: 132606) 
======================================================================

Comments
CONVERTED DATA BugTraq+ Release Management Values COMMIT TO FIX: hopper FIXED IN: hopper INTEGRATED IN: hopper VERIFIED IN: hopper-beta
14-06-2004

PUBLIC COMMENTS ..
10-06-2004

WORK AROUND Name: bsT130419 Date: 09/26/2001 Omit that package from javadoc generation. -or- List the source files individually on the command line. ###@###.### 2001-09-26
26-09-2001

EVALUATION This is a dup of 4482379, which was closed as will not fix. However, as this bug reports the problem as a regression, I am keeping it open. ###@###.### 2001-09-26
26-09-2001