-
Enhancement
-
Resolution: Fixed
-
P4
-
5.0
-
None
-
tiger
-
generic, sparc
-
generic, solaris_9
The javadoc output produced by the standard doclet includes a
chart showing (the transitive closures of) the superclasses and
superinterfaces. For example, the doc for java.util.HashSet shows:
java.lang.Object
|_ java.util.AbstractCollection
|_ java.util.AbstractSet
|_ java.util.HashSet
All Implemented Interfaces:
Cloneable, Collection, Iterable, Serializable, Set
The new generics-aware standard doclet adds type parameter information
where it shows a class or interface's directly-extended classes and
interfaces, but it does not have available to it all information
that would be needed to add type parameter info to the above chart.
A review of the docs generated by the generics-aware standard doclet
concluded that it would be highly desirable to add type parameters to
this chart. Although this is not 100% essential (the info can
be deduced from the "direct" info that's already available), it can
involve mental gymnastics to keep track of all the recursive type
argument substitutions in complex cases.
Proposal:
Add new methods to the doclet API, giving doclets the information
needed to add type parameter info where desired:
Add to com.sun.javadoc.ParameterizedType:
Type superclassType();
Type[] interfaceTypes();
- duplicates
-
JDK-5029944 Need Doclet API support for substituted type parameters
-
- Closed
-
- relates to
-
JDK-5029946 Doclet needs to support substituted type parameters
-
- Resolved
-
-
JDK-5009540 doclet does not show type arguments on indirectly extended generic classes/interface
-
- Resolved
-