United StatesChange Country, Oracle Worldwide Web Sites Communities I am a... I want to...
JDK-6748546 : javadoc API should be classloader-friendly

Details
Type:
Enhancement
Submit Date:
2008-09-15
Status:
Closed
Updated Date:
2011-07-15
Project Name:
JDK
Resolved Date:
2011-07-15
Component:
tools
OS:
generic
Sub-Component:
javadoc(tool)
CPU:
generic
Priority:
P3
Resolution:
Fixed
Affected Versions:
7
Fixed Versions:

Related Reports
Backport:
Relates:

Sub Tasks

Description
Internally, javadoc creates a URLClassLoader in which to instantiate doclets. This classloader is not given a parent class loader, and so does not honor the standard parent delegation scheme.

This means that if javadoc is invoked from a class that was itself loaded from a classloader (such as in the regression test harness, jtreg) the doclets loaded by javadoc will not interact correctly with the classes that invoked javadoc.

The fix is to allow javadoc to be invoked with a parent class loader, to be used when creating the javadoc class loader.

                                    

Comments
EVALUATION

Yes, adding methods with classloader args allows javadoc to use jtreg samevm mode.
                                     
2008-09-16



Hardware and Software, Engineered to Work Together