Is @deprecated javadoc comment still useful?

Weijun Wang at
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 mailing list