Is @deprecated javadoc comment still useful?

Stuart Marks stuart.marks at oracle.com
Fri Mar 10 20:46:00 UTC 2017



On 3/8/17 4:12 PM, Weijun Wang wrote:
> It does not show on the current javadoc page, but I am assigned the bug
>
>   8175846: Provide javadoc descriptions for jdk.policytool and jdk.crypto.* modules
>
> So maybe there will be a change?

Hm, it looks like somebody is running javadoc over these packages, otherwise I 
doubt it would have been noticed.

>>  * @deprecated PolicyTool has been deprecated for removal because it
>>  * is rarely used, and it provides little value over editing policy
>>  * files using a text editor.
>>
>> If this were a public API I'd definitely add something like this. It's
>> up to you whether you think it's worth adding this to PolicyTool.
>
> Good suggestion. I'll use it.

Great, glad to help!

s'marks



More information about the core-libs-dev mailing list