<Beans Dev> Integrated: 8251123: doclint warnings about missing javadoc tags and comments

Sergey Bylokhov serb at openjdk.java.net
Tue Oct 6 10:52:46 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:
> https://mail.openjdk.java.net/pipermail/beans-dev/2020-August/000423.html

This pull request has now been integrated.

Changeset: f397b60a
Author:    Sergey Bylokhov <serb at openjdk.org>
URL:       https://git.openjdk.java.net/jdk/commit/f397b60a
Stats:     1256 lines in 69 files changed: 809 ins; 165 del; 282 mod

8251123: doclint warnings about missing javadoc tags and comments

Reviewed-by: jdv, prr

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

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


More information about the beans-dev mailing list