RFR: JDK-8305206: Add @spec tags in java.base/java.* (part 1) [v2]

[Jonathan Gibbons]

On Fri, 31 Mar 2023 17:14:01 GMT, Iris Clark <iris at openjdk.org> wrote:

>> Jonathan Gibbons has updated the pull request incrementally with one additional commit since the last revision:
>> 
>>   address review feedback
>
> src/java.base/share/classes/java/io/ObjectOutputStream.java line 165:
> 
>> 163:  * @see java.io.Serializable
>> 164:  * @see java.io.Externalizable
>> 165:  * @since       1.1
> 
> Just confirming... The changes to the java.io classes for the Serialization Spec now all point to the index rather than particular chapters/sections. I'm assuming that's intentional so that when the top-level Spec page appears, there is a single entry for that specification.

The `@spec` tag should point to the root, but we should not remove more specific references to within the spec. I will review places where `@see` has been removed/replaced.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/13248#discussion_r1154774688