RFR: 8037384: Fix wording in Javadoc of java.io.Serializable

[Chris Hegarty]

On Thu, 19 Nov 2020 03:44:10 GMT, Stuart Marks <smarks at openjdk.org> wrote:

> 8231547: Serializable class doc should link to serialization specification
> 
> Rewrite a couple confusing sentences in the Serializable class doc. This does affect normative text, but the edits are primarily to focus and clarify the text, not to make any semantic changes. Thus, a CSR request shouldn't be required for this change.
> 
> Also add and adjust some links and link markup to the Java Object Serialization Specification.

src/java.base/share/classes/java/io/Serializable.java line 48:

> 46:  * It is possible for subtypes of non-serializable classes to be serialized
> 47:  * and deserialized. During serialization, no data will be written for the
> 48:  * fields of non-serializable classes. During deserialization, the fields of

" fields of non-serializable classes" - this strictly means " fields of non-serializable SUPERclasses", right?

src/java.base/share/classes/java/io/Serializable.java line 49:

> 47:  * and deserialized. During serialization, no data will be written for the
> 48:  * fields of non-serializable classes. During deserialization, the fields of
> 49:  * non-serializable classes will be initialized using the no-arg constructor of

non-serializable SUPERclasses ..

src/java.base/share/classes/java/io/Serializable.java line 50:

> 48:  * fields of non-serializable classes. During deserialization, the fields of
> 49:  * non-serializable classes will be initialized using the no-arg constructor of
> 50:  * the class. This constructor must be accessible to the subclass that is being

.. of the first non-serializable superclass.

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

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