RFR [15] 8238467: Clean up annotations on overridden/implemented methods

Pavel Rappo pavel.rappo at oracle.com
Tue Feb 4 13:21:23 UTC 2020


Please review the change for https://bugs.openjdk.java.net/browse/JDK-8238467:


This is a blanket cleanup. The change adds missing @java.lang.Override annotations
and removes some of the {@inheritDoc} tags. The removed {@inheritDoc} tags are
either redundant or misplaced. Redundant {@inheritDoc} tags provide explicit
comment inheritance, otherwise having no value. Misplaced {@inheritDoc} tags 
are used on inapplicable entities, e.g. non-inheriting, non-implementing, static,
private methods, etc.

Added @Override annotations provide compile-time checking and serve as visual
cues to the reader. Removed {@inheritDoc} tags make the source code swell and
sometimes confuse the reader.


More information about the javadoc-dev mailing list