> 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.
Jonathan Gibbons has updated the pull request incrementally with one additional commit since the last revision: update to show fields of serializable records in the serializable form ------------- Changes: - all: https://git.openjdk.java.net/jdk/pull/6071/files - new: https://git.openjdk.java.net/jdk/pull/6071/files/900d1fb7..4e5329be Webrevs: - full: https://webrevs.openjdk.java.net/?repo=jdk&pr=6071&range=01 - incr: https://webrevs.openjdk.java.net/?repo=jdk&pr=6071&range=00-01 Stats: 62 lines in 3 files changed: 22 ins; 22 del; 18 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
