Bug ID: JDK-4789256 Enable javadoc to process source files in .zip or .jar file

Type: Enhancement
Component: tools
Sub-Component: javadoc(tool)
Affected Version: 6

Priority: P4
Status: Closed
Resolution: Won't Fix
OS: generic,other
CPU: generic

Submitted: 2002-12-05
Updated: 2024-10-08
Resolved: 2024-10-08

We currently ship src.zip file in the J2SE release.  If a developer wants to
inherit documentation from it, they must first unzip it, which enlarges
it from 9.1MB to 37.5MB and takes several minutes to unzip.  This is necessary
because javadoc can only handle .java files, not .zip files.

It would be preferable to allow the source file to remain zipped and
simply allow javadoc to process the source files in the zip file.

Might consider other formats as well, such as .jar, .tar, .gzip, .z, etc.

[~jjg] was this issue fixed by JDK-6794582? Should this issue stay open?
12-07-2022
EVALUATION May be fixed by 6794582, but see caveat in Evaluation for that bug. This CR left open so that a test can be written to verify the behavior requested here.
08-12-2010
EVALUATION Jon writes: javac (actually, DefaultFileManager) can _read_ source from zip files, but currently the only way to activate that behavior is via a zip file on the sourcepath. The underlying issue here is that javadoc performs its own "discovery" of source files by driving the java.io.File API directly. It is that code that needs to be upgraded, ideally by converting javadoc to JSR199. Javadoc will have JSR 199 support added for Dolphin (if not sooner). We'll make sure that this RFE is indeed addressed at that time.
03-03-2006
CONVERTED DATA BugTraq+ Release Management Values COMMIT TO FIX: mustang
14-06-2004
EVALUATION Do as low priority. ###@###.### 2002-12-05 Re-assigning to javadoctool subcategory ###@###.### 2005-1-11 03:50:02 GMT
05-12-2002

Duplicate :	JDK-6443703 - Need ability to access java sources in ZIP archives
Relates :	JDK-6794582 - javadoc should read files using a FileManager
Relates :	JDK-6306394 - jtreg test com/sun/javadoc/testBadPackageFileInJar/TestBadPackageFileInJar.java failing