Clarifications and cleanups for the java.io API spec related to serialization.
See also [JDK-8372300](https://bugs.openjdk.org/browse/JDK-8372300), which updates the serialization specification. (The serialization specification should be regarded as the source of truth, with the API specs providing sometimes-imperfect descriptions of what it says.) --------- - [x] I confirm that I make this contribution in accordance with the [OpenJDK Interim AI Policy](https://openjdk.org/legal/ai). ------------- Commit messages: - 8383164: [lworld] javadoc updates for value class serialization Changes: https://git.openjdk.org/valhalla/pull/2429/files Webrev: https://webrevs.openjdk.org/?repo=valhalla&pr=2429&range=00 Issue: https://bugs.openjdk.org/browse/JDK-8383164 Stats: 106 lines in 5 files changed: 30 ins; 44 del; 32 mod Patch: https://git.openjdk.org/valhalla/pull/2429.diff Fetch: git fetch https://git.openjdk.org/valhalla.git pull/2429/head:pull/2429 PR: https://git.openjdk.org/valhalla/pull/2429
