On Fri, 21 Jun 2024 15:13:27 GMT, Iris Clark <[email protected]> wrote:
>> src/java.desktop/share/classes/javax/swing/plaf/basic/BasicSliderUI.java
>> line 153:
>>
>>> 151: /**
>>> 152: * Constructs a {@code BasicSliderUI}.
>>> 153: * @deprecated This constructor will be removed in future release
>>
>> This needs a full stop at the end. It's usually added in `@deprecated` tags.
>> Suggestion:
>>
>> * @deprecated This constructor will be removed in future release.
>>
>>
>> Should we explain *why* it's deprecated?
>
> Second the recommendation for "why". As a "forRemoval=true" deprecation, it
> will appear in the "Terminally Deprecated Elements" table on this page:
> https://download.java.net/java/early_access/jdk24/docs/api/deprecated-list.html.
What text would you add ?
"This constructor was added by accident in JDK 16." ?
-------------
PR Review Comment: https://git.openjdk.org/jdk/pull/19819#discussion_r1649289562