-
Bug
-
Resolution: Fixed
-
P4
-
20
-
None
-
b24
The solution provided for JDK-6509045 and JDK-8067757 becomes inadequate if documentation inheritance depth > 1 and {@inheritDoc} expands to multiple @throws tags on the higher levels of the inheritance hierarchy.
The solution fails because the code that processes {@inheritDoc} in that case does not have necessary context to complete its job. While every @throws tag that a particular {@inheritDoc} expands to, translates to a separate entry in the "Throws:" section, by the time such an {@inheritDoc} is processed, the "Throws:" section is unavailable.
One solution is to process {@inheritDoc} deeply and collectively in ThrowsTaglet#getAllBlockTagOutput. This hijacks the model of context-free processing, however, it does so just for one specific tag: @throws.
The solution fails because the code that processes {@inheritDoc} in that case does not have necessary context to complete its job. While every @throws tag that a particular {@inheritDoc} expands to, translates to a separate entry in the "Throws:" section, by the time such an {@inheritDoc} is processed, the "Throws:" section is unavailable.
One solution is to process {@inheritDoc} deeply and collectively in ThrowsTaglet#getAllBlockTagOutput. This hijacks the model of context-free processing, however, it does so just for one specific tag: @throws.
- relates to
-
JDK-8285488 Improve DocFinder
- Resolved
-
JDK-6509045 {@inheritDoc} only copies one instance of the specified exception
- Resolved
-
JDK-8067757 Incorrect HTML generation for copied javadoc with multiple @throws tags
- Resolved