-
Bug
-
Resolution: Won't Fix
-
P4
-
19
Multiple @throws tags can be used in a documentation comment for the same or different exceptions.
Consider merging entries that describe the same exception in resulting documentation. Not only could it improve readability, but also provide clearer model for writing around the inherited documentation when the overridden method provides multiple entries:
Overrider:
@throws exception-class "before" {@inheritDoc} "after"
Overridden:
@throws exception-class "first-entry"
@throws exception-class "second-entry"
...
Consider merging entries that describe the same exception in resulting documentation. Not only could it improve readability, but also provide clearer model for writing around the inherited documentation when the overridden method provides multiple entries:
Overrider:
@throws exception-class "before" {@inheritDoc} "after"
Overridden:
@throws exception-class "first-entry"
@throws exception-class "second-entry"
...