RFR: 8270996: javadoc: missing comments in serialized classes [v3]

[Kevin Rushforth]

On Tue, 5 Mar 2024 02:41:54 GMT, Prasanta Sadhukhan <psadhukhan at openjdk.org> wrote:

> So, that @SuppressWarnings("serial") // Same-version serialization only would be addressed as javac lint warning JBS?

Yes. I filed [JDK-8327170](https://bugs.openjdk.org/browse/JDK-8327170) as an umbrella task to address javac lint warnings, and will file new linked blocking bugs to address individual warnings.

> Just thinking out aloud, I dont see this @SuppressWarnings("doclint:missing") in our java.desktop classes? what's the difference there?

We wanted to silence the warnings (so we can turn on `-Werror` once the last warning is gone), and didn't see any real benefit in actually documenting the private fields. We could revisit that later if there was a reason, but I suspect there isn't.

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

PR Review Comment: https://git.openjdk.org/jfx/pull/1386#discussion_r1512867661