<i18n dev> RFR: 8278254: Cleanup doclint warnings in java.desktop module [v2]

[Alexey Ivanov]

On Tue, 18 Jan 2022 16:30:07 GMT, Alexey Ivanov <aivanov at openjdk.org> wrote:

>> Prasanta Sadhukhan has updated the pull request incrementally with one additional commit since the last revision:
>> 
>>   review fix
>
> src/java.desktop/share/classes/javax/swing/JScrollBar.java line 120:
> 
>> 118:     /**
>> 119:      * Amount to change the scrollbar's value by,
>> 120:      * given a unit up/down request.
> 
> Suggestion:
> 
>      * The amount to change the value of the scrollbar by,
>      * given a unit up/down request.
> 
> However, this still looks cumbersome and is not as clear.

What about _Stores the amount by which the value of the scrollbar is changed upon a unit up/down request_?

> src/java.desktop/share/classes/javax/swing/JScrollBar.java line 129:
> 
>> 127:     /**
>> 128:      * Amount to change the scrollbar's value by,
>> 129:      * given a block (usually "page") up/down request.
> 
> Suggestion:
> 
>      * The amount to change the value of the scrollbar by,
>      * given a block (usually "page") up/down request.

Similarly, _Stores the amount by which the value of the scrollbar is changed upon a block (usually "page") up/down request_.

-------------

PR: https://git.openjdk.java.net/jdk/pull/7004