-
Bug
-
Resolution: Unresolved
-
P3
-
6
-
generic
-
generic
The {@inheritDoc} tag can be used to inherit the documention of corresponding elements in the super class or interface, reducing the amount of copying and pasting needed to document a hierarchy of classes. Unfortunately, {@inheritDoc} does not seem to work for type parameters, e.g.
/**
* @param <S> some type
*/
class Parent<S> {...}
/**
* @param <S> {@inheritDoc}
*/
class Child<S> extends Parent<S> {}
doesn't produce any documentation for S in Child.
This behavior would help encourage documenting the role of type parameters.
/**
* @param <S> some type
*/
class Parent<S> {...}
/**
* @param <S> {@inheritDoc}
*/
class Child<S> extends Parent<S> {}
doesn't produce any documentation for S in Child.
This behavior would help encourage documenting the role of type parameters.
- csr for
-
JDK-8257771 JavaDoc should support {@inheritDoc} for type parameters
- Closed