8305206: Add @spec tags in java.base/java.* (part 1)

Reviewed-by: alanb, naoto, darcy, lancea, dfuchs, iris, mchung

src/java.base/share/classes/java/io/ObjectInputStream.java

@@ -242,6 +242,7 @@ import sun.security.action.GetIntegerAction;
  * <cite>Java Object Serialization Specification,</cite> Section 1.13,
  * "Serialization of Records"</a> for additional information.
  *
+ * @spec serialization/index.html Java Object Serialization Specification
  * @author      Mike Warres
  * @author      Roger Riggs
  * @see java.io.DataInput

src/java.base/share/classes/java/io/ObjectOutputStream.java

@@ -155,6 +155,7 @@ import sun.reflect.misc.ReflectUtil;
  * <p>Records are serialized differently than ordinary serializable or externalizable
  * objects, see <a href="ObjectInputStream.html#record-serialization">record serialization</a>.
  *
+ * @spec serialization/index.html Java Object Serialization Specification
  * @author      Mike Warres
  * @author      Roger Riggs
  * @see java.io.DataOutput
@@ -670,6 +671,7 @@ public class ObjectOutputStream
      *
      * @param   desc class descriptor to write to the stream
      * @throws  IOException If an I/O error has occurred.
+     * @spec serialization/index.html Java Object Serialization Specification
      * @see java.io.ObjectInputStream#readClassDescriptor()
      * @see #useProtocolVersion(int)
      * @see java.io.ObjectStreamConstants#PROTOCOL_VERSION_1

src/java.base/share/classes/java/io/ObjectStreamClass.java

@@ -73,6 +73,7 @@ import sun.reflect.misc.ReflectUtil;
  * <a href="{@docRoot}/../specs/serialization/class.html#stream-unique-identifiers">
  *    <cite>Java Object Serialization Specification,</cite> Section 4.6, "Stream Unique Identifiers"</a>.
  *
+ * @spec serialization/index.html Java Object Serialization Specification
  * @author      Mike Warres
  * @author      Roger Riggs
  * @see ObjectStreamField

src/java.base/share/classes/java/io/Serial.java

@@ -94,6 +94,7 @@ import java.lang.annotation.*;
  * and methods reflectively and those fields and methods may appear
  * otherwise unused in a {@code Serializable} class.
  *
+ * @spec serialization/index.html Java Object Serialization Specification
  * @see Serializable
  * @see Externalizable
  * @since 14

src/java.base/share/classes/java/io/Serializable.java

@@ -181,13 +181,12 @@ package java.io;
  * the default computed value, but the requirement for matching
  * serialVersionUID values is waived for array classes.
  *
+ * @spec serialization/index.html Java Object Serialization Specification
  * @see java.io.ObjectOutputStream
  * @see java.io.ObjectInputStream
  * @see java.io.ObjectOutput
  * @see java.io.ObjectInput
  * @see java.io.Externalizable
- * @see <a href="{@docRoot}/../specs/serialization/index.html">
- *      <cite>Java Object Serialization Specification</cite></a>
  * @since   1.1
  */
 public interface Serializable {

src/java.base/share/classes/java/io/package-info.java

@@ -48,6 +48,7 @@
  *   <li>{@extLink serialver_tool_reference The serialver tool}</li>
  * </ul>
  *
+ * @spec serialization/index.html Java Object Serialization Specification
  * @since 1.0
  */
 package java.io;