Please review a trivial fix and simple test for DocLint and serializable records.
Although the original JBS issue was somewhat confused, the underlying cause of the test case is that `javadoc`/`DocLint` was checking the comments on the private internal fields, prior to writing the fields in the "Serialized Form" page. Since the serialized form is defined to be exactly the record components, there is no need to document the fields, as explained in section 1.13, Serialization of Records. https://docs.oracle.com/en/java/javase/17/docs/specs/serialization/serial-arch.html#serialization-of-records > Documenting serializable fields and data for record classes is unnecessary, > since there is no variation in the serial form, other than whether a > substitute or replacement object is used. ------------- Commit messages: - JDK-8275199: Bogus warning generated for serializable records Changes: https://git.openjdk.java.net/jdk/pull/6071/files Webrev: https://webrevs.openjdk.java.net/?repo=jdk&pr=6071&range=00 Issue: https://bugs.openjdk.java.net/browse/JDK-8275199 Stats: 63 lines in 3 files changed: 42 ins; 9 del; 12 mod Patch: https://git.openjdk.java.net/jdk/pull/6071.diff Fetch: git fetch https://git.openjdk.java.net/jdk pull/6071/head:pull/6071 PR: https://git.openjdk.java.net/jdk/pull/6071
