Is @deprecated javadoc comment still useful?
weijun.wang at oracle.com
Wed Mar 8 00:15:10 UTC 2017
Hi, Mr Deprecator
I'm adding @Deprecated annotations with arguments to a module and a
class, and at the same time I add @deprecated javadoc comments. The
resulting javadoc pages are attached.
As you can see, the bold sentence (I assume it's generated from the
annotation) and the line below contain the exact same information.
However, they do not use the exact same words: subject vs planned,
version vs release. This makes me uncomfortable.
I've tried to remove the content of the javadoc comment and only keep
the @deprecated tag, the result looks better.
Is that the right way?
More information about the core-libs-dev