Name: rmT116609 Date: 01/15/2003
A DESCRIPTION OF THE PROBLEM :
Sun recommends that users extend the standard doclet to customize it to their needs.
However, this is impossible to do for the new -use option, as the key class: ClassUseMapper, has a private constructor. Worse, the actual generation of html is done in a static method which calls the private constructor.
This means the only way to extend the ClassUseMapper is to copy and paste both it and several other classes, which is not a satisfactory solution.
Please make the constructor of com.sun.tools.doclet.standard.ClassUseMapper either protected or public.
STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
1. Try to extend ClassUseMapper, i.e. to exclude hidden API.
EXPECTED VERSUS ACTUAL BEHAVIOR :
I expected to be able to extend ClassUseMapper but was unable to.
CUSTOMER WORKAROUND :
Simply don't use ClassUseMapper, or cut and paste several classes.
(Review ID: 179204)
======================================================================
A DESCRIPTION OF THE PROBLEM :
Sun recommends that users extend the standard doclet to customize it to their needs.
However, this is impossible to do for the new -use option, as the key class: ClassUseMapper, has a private constructor. Worse, the actual generation of html is done in a static method which calls the private constructor.
This means the only way to extend the ClassUseMapper is to copy and paste both it and several other classes, which is not a satisfactory solution.
Please make the constructor of com.sun.tools.doclet.standard.ClassUseMapper either protected or public.
STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
1. Try to extend ClassUseMapper, i.e. to exclude hidden API.
EXPECTED VERSUS ACTUAL BEHAVIOR :
I expected to be able to extend ClassUseMapper but was unable to.
CUSTOMER WORKAROUND :
Simply don't use ClassUseMapper, or cut and paste several classes.
(Review ID: 179204)
======================================================================