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

Alexey Ivanov aivanov at openjdk.java.net
Thu Jan 20 15:20:53 UTC 2022


On Thu, 20 Jan 2022 06:12:29 GMT, Prasanta Sadhukhan <psadhukhan at openjdk.org> wrote:

>> The changes done under JDK-8278175 suppress on a per-file basis various missing comments that would otherwise trigger doclint warnings. Fixed them so as to remove the doclint:missing warnings.
>
> Prasanta Sadhukhan has updated the pull request incrementally with one additional commit since the last revision:
> 
>   Fix

src/java.desktop/share/classes/java/awt/Component.java line 4137:

> 4135:          * Provides direct access to the back buffer as an image.
> 4136:          *
> 4137:          * @return direct access to the back buffer as an image.

Hm… This doesn't look right.
Suggestion:

         * @return the back buffer as an image.

src/java.desktop/share/classes/java/beans/beancontext/BeanContextSupport.java line 312:

> 310:      */
> 311:     protected class BCSChild implements Serializable {
> 312: 

Shall we indent `serialVersionUID`? It's for `BCSChild` but its indentation suggests it's for the surrounding class.

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

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


More information about the i18n-dev mailing list