8032502: java.time add @param tags to readObject

Summary: Add @param tags
Reviewed-by: lancea, darcy

src/share/classes/java/time/Duration.java

@@ -1326,6 +1326,7 @@ public final class Duration
     /**
      * Defend against malicious streams.
      *
+     * @param s the stream to read
      * @throws InvalidObjectException always
      */
     private void readObject(ObjectInputStream s) throws InvalidObjectException {

src/share/classes/java/time/Instant.java

@@ -1343,6 +1343,7 @@ public final class Instant
     /**
      * Defend against malicious streams.
      *
+     * @param s the stream to read
      * @throws InvalidObjectException always
      */
     private void readObject(ObjectInputStream s) throws InvalidObjectException {

src/share/classes/java/time/LocalDate.java

@@ -2053,6 +2053,7 @@ public final class LocalDate
     /**
      * Defend against malicious streams.
      *
+     * @param s the stream to read
      * @throws InvalidObjectException always
      */
     private void readObject(ObjectInputStream s) throws InvalidObjectException {

src/share/classes/java/time/LocalDateTime.java

@@ -1986,6 +1986,7 @@ public final class LocalDateTime
     /**
      * Defend against malicious streams.
      *
+     * @param s the stream to read
      * @throws InvalidObjectException always
      */
     private void readObject(ObjectInputStream s) throws InvalidObjectException {

src/share/classes/java/time/LocalTime.java

@@ -1638,6 +1638,7 @@ public final class LocalTime
     /**
      * Defend against malicious streams.
      *
+     * @param s the stream to read
      * @throws InvalidObjectException always
      */
     private void readObject(ObjectInputStream s) throws InvalidObjectException {

src/share/classes/java/time/MonthDay.java

@@ -771,6 +771,7 @@ public final class MonthDay
     /**
      * Defend against malicious streams.
      *
+     * @param s the stream to read
      * @throws InvalidObjectException always
      */
     private void readObject(ObjectInputStream s) throws InvalidObjectException {

src/share/classes/java/time/OffsetDateTime.java

@@ -1925,6 +1925,7 @@ public final class OffsetDateTime
     /**
      * Defend against malicious streams.
      *
+     * @param s the stream to read
      * @throws InvalidObjectException always
      */
     private void readObject(ObjectInputStream s) throws InvalidObjectException {

src/share/classes/java/time/OffsetTime.java

@@ -1396,6 +1396,7 @@ public final class OffsetTime
     /**
      * Defend against malicious streams.
      *
+     * @param s the stream to read
      * @throws InvalidObjectException always
      */
     private void readObject(ObjectInputStream s) throws InvalidObjectException {

src/share/classes/java/time/Period.java

@@ -1058,6 +1058,7 @@ public final class Period
     /**
      * Defend against malicious streams.
      *
+     * @param s the stream to read
      * @throws java.io.InvalidObjectException always
      */
     private void readObject(ObjectInputStream s) throws InvalidObjectException {

src/share/classes/java/time/Year.java

@@ -1104,6 +1104,7 @@ public final class Year
     /**
      * Defend against malicious streams.
      *
+     * @param s the stream to read
      * @throws InvalidObjectException always
      */
     private void readObject(ObjectInputStream s) throws InvalidObjectException {

src/share/classes/java/time/YearMonth.java

@@ -1230,6 +1230,7 @@ public final class YearMonth
     /**
      * Defend against malicious streams.
      *
+     * @param s the stream to read
      * @throws InvalidObjectException always
      */
     private void readObject(ObjectInputStream s) throws InvalidObjectException {

src/share/classes/java/time/ZoneId.java

@@ -624,6 +624,7 @@ public abstract class ZoneId implements Serializable {
     /**
      * Defend against malicious streams.
      *
+     * @param s the stream to read
      * @throws InvalidObjectException always
      */
     private void readObject(ObjectInputStream s) throws InvalidObjectException {

src/share/classes/java/time/ZoneOffset.java

@@ -769,6 +769,7 @@ public final class ZoneOffset
     /**
      * Defend against malicious streams.
      *
+     * @param s the stream to read
      * @throws InvalidObjectException always
      */
     private void readObject(ObjectInputStream s) throws InvalidObjectException {

src/share/classes/java/time/ZoneRegion.java

@@ -196,6 +196,7 @@ final class ZoneRegion extends ZoneId implements Serializable {
     /**
      * Defend against malicious streams.
      *
+     * @param s the stream to read
      * @throws InvalidObjectException always
      */
     private void readObject(ObjectInputStream s) throws InvalidObjectException {

src/share/classes/java/time/ZonedDateTime.java

@@ -2225,6 +2225,7 @@ public final class ZonedDateTime
     /**
      * Defend against malicious streams.
      *
+     * @param s the stream to read
      * @throws InvalidObjectException always
      */
     private void readObject(ObjectInputStream s) throws InvalidObjectException {

src/share/classes/java/time/chrono/AbstractChronology.java

@@ -766,6 +766,7 @@ public abstract class AbstractChronology implements Chronology {
     /**
      * Defend against malicious streams.
      *
+     * @param s the stream to read
      * @throws java.io.InvalidObjectException always
      */
     private void readObject(ObjectInputStream s) throws ObjectStreamException {

src/share/classes/java/time/chrono/ChronoLocalDateTimeImpl.java

@@ -416,6 +416,7 @@ final class ChronoLocalDateTimeImpl<D extends ChronoLocalDate>
     /**
      * Defend against malicious streams.
      *
+     * @param s the stream to read
      * @throws InvalidObjectException always
      */
     private void readObject(ObjectInputStream s) throws InvalidObjectException {

src/share/classes/java/time/chrono/ChronoPeriodImpl.java

@@ -376,6 +376,7 @@ final class ChronoPeriodImpl
     /**
      * Defend against malicious streams.
      *
+     * @param s the stream to read
      * @throws InvalidObjectException always
      */
     private void readObject(ObjectInputStream s) throws ObjectStreamException {

src/share/classes/java/time/chrono/ChronoZonedDateTimeImpl.java

@@ -340,6 +340,7 @@ final class ChronoZonedDateTimeImpl<D extends ChronoLocalDate>
     /**
      * Defend against malicious streams.
      *
+     * @param s the stream to read
      * @throws InvalidObjectException always
      */
     private void readObject(ObjectInputStream s) throws InvalidObjectException {

src/share/classes/java/time/chrono/HijrahChronology.java

@@ -1096,6 +1096,7 @@ public final class HijrahChronology extends AbstractChronology implements Serial
     /**
      * Defend against malicious streams.
      *
+     * @param s the stream to read
      * @throws InvalidObjectException always
      */
     private void readObject(ObjectInputStream s) throws InvalidObjectException {

src/share/classes/java/time/chrono/HijrahDate.java

@@ -654,6 +654,7 @@ public final class HijrahDate
     /**
      * Defend against malicious streams.
      *
+     * @param s the stream to read
      * @throws InvalidObjectException always
      */
     private void readObject(ObjectInputStream s) throws InvalidObjectException {

src/share/classes/java/time/chrono/IsoChronology.java

@@ -604,6 +604,7 @@ public final class IsoChronology extends AbstractChronology implements Serializa
     /**
      * Defend against malicious streams.
      *
+     * @param s the stream to read
      * @throws InvalidObjectException always
      */
     private void readObject(ObjectInputStream s) throws InvalidObjectException {

src/share/classes/java/time/chrono/JapaneseChronology.java

@@ -525,6 +525,7 @@ public final class JapaneseChronology extends AbstractChronology implements Seri
     /**
      * Defend against malicious streams.
      *
+     * @param s the stream to read
      * @throws InvalidObjectException always
      */
     private void readObject(ObjectInputStream s) throws InvalidObjectException {

src/share/classes/java/time/chrono/JapaneseDate.java

@@ -716,6 +716,7 @@ public final class JapaneseDate
     /**
      * Defend against malicious streams.
      *
+     * @param s the stream to read
      * @throws InvalidObjectException always
      */
     private void readObject(ObjectInputStream s) throws InvalidObjectException {

src/share/classes/java/time/chrono/JapaneseEra.java

@@ -357,6 +357,7 @@ public final class JapaneseEra
     /**
      * Defend against malicious streams.
      *
+     * @param s the stream to read
      * @throws InvalidObjectException always
      */
     private void readObject(ObjectInputStream s) throws InvalidObjectException {

src/share/classes/java/time/chrono/MinguoChronology.java

@@ -355,6 +355,7 @@ public final class MinguoChronology extends AbstractChronology implements Serial
     /**
      * Defend against malicious streams.
      *
+     * @param s the stream to read
      * @throws InvalidObjectException always
      */
     private void readObject(ObjectInputStream s) throws InvalidObjectException {

src/share/classes/java/time/chrono/MinguoDate.java

@@ -478,6 +478,7 @@ public final class MinguoDate
     /**
      * Defend against malicious streams.
      *
+     * @param s the stream to read
      * @throws InvalidObjectException always
      */
     private void readObject(ObjectInputStream s) throws InvalidObjectException {

src/share/classes/java/time/chrono/ThaiBuddhistChronology.java

@@ -391,6 +391,7 @@ public final class ThaiBuddhistChronology extends AbstractChronology implements
     /**
      * Defend against malicious streams.
      *
+     * @param s the stream to read
      * @throws InvalidObjectException always
      */
     private void readObject(ObjectInputStream s) throws InvalidObjectException {

src/share/classes/java/time/chrono/ThaiBuddhistDate.java

@@ -478,6 +478,7 @@ public final class ThaiBuddhistDate
     /**
      * Defend against malicious streams.
      *
+     * @param s the stream to read
      * @throws InvalidObjectException always
      */
     private void readObject(ObjectInputStream s) throws InvalidObjectException {

src/share/classes/java/time/temporal/ValueRange.java

@@ -344,10 +344,13 @@ public final class ValueRange implements Serializable {
     /**
      * Restore the state of an ValueRange from the stream.
      * Check that the values are valid.
+     *
+     * @param s the stream to read
      * @throws InvalidObjectException if
      *     the smallest minimum is greater than the smallest maximum,
      *  or the smallest maximum is greater than the largest maximum
      *  or the largest minimum is greater than the largest maximum
+     * @throws ClassNotFoundException if a class cannot be resolved
      */
     private void readObject(ObjectInputStream s)
          throws IOException, ClassNotFoundException, InvalidObjectException

src/share/classes/java/time/temporal/WeekFields.java

@@ -344,8 +344,11 @@ public final class WeekFields implements Serializable {
     /**
      * Restore the state of a WeekFields from the stream.
      * Check that the values are valid.
+     *
+     * @param s the stream to read
      * @throws InvalidObjectException if the serialized object has an invalid
      *     value for firstDayOfWeek or minimalDays.
+     * @throws ClassNotFoundException if a class cannot be resolved
      */
     private void readObject(ObjectInputStream s)
          throws IOException, ClassNotFoundException, InvalidObjectException

src/share/classes/java/time/zone/ZoneOffsetTransition.java

@@ -173,6 +173,8 @@ public final class ZoneOffsetTransition
     //-----------------------------------------------------------------------
     /**
      * Defend against malicious streams.
+     *
+     * @param s the stream to read
      * @throws InvalidObjectException always
      */
     private void readObject(ObjectInputStream s) throws InvalidObjectException {

src/share/classes/java/time/zone/ZoneOffsetTransitionRule.java

@@ -235,6 +235,7 @@ public final class ZoneOffsetTransitionRule implements Serializable {
     /**
      * Defend against malicious streams.
      *
+     * @param s the stream to read
      * @throws InvalidObjectException always
      */
     private void readObject(ObjectInputStream s) throws InvalidObjectException {

src/share/classes/java/time/zone/ZoneRules.java

@@ -319,6 +319,7 @@ public final class ZoneRules implements Serializable {
     /**
      * Defend against malicious streams.
      *
+     * @param s the stream to read
      * @throws InvalidObjectException always
      */
     private void readObject(ObjectInputStream s) throws InvalidObjectException {