<AWT Dev> RFR: 8251123: doclint warnings about missing javadoc tags and comments
Jayathirth D V
jdv at openjdk.java.net
Wed Sep 30 06:14:27 UTC 2020
On Fri, 25 Sep 2020 21:45:39 GMT, Sergey Bylokhov <serb at openjdk.org> wrote:
> We have a number of missing javadoc tags and comments in the desktop module.
> Most of the missing comments are related to the serialized form.
> The fix:
> - Adds missing comments to the non-static/non-transient fields(even private) of the "serializable" classes
> - Adds comments to the "serializable" classes even if those classes are non-public
> - Fixes references/adds missing tags to the special methods(like readObject/writeObject)
> - Delete the java.awt.PeerFixer class.
> I need advice about what exact change should be reviewed in the CSR(except PeerFixer removal)
> Note that in some cases I added the comments to the "implementation details", so I did not specify it fully.
> The old review request:
src/java.desktop/share/classes/java/awt/Window.java line 248:
> 246: * Focus transfers for the lightweight components request should be made
> 247: * synchronously.
> 248: */
More simpler way "Focus transfers should be synchronous for lightweight component requests"
More information about the awt-dev