From 5310d85809d6b8677aa9b689fc2e21a74ceaccc8 Mon Sep 17 00:00:00 2001 From: Brian Burkhalter Date: Tue, 29 Sep 2020 22:46:16 +0000 Subject: [PATCH] 8252937: Correct "no comment" warnings from javadoc in java.math package Reviewed-by: darcy --- src/java.base/share/classes/java/math/BigDecimal.java | 7 +++++-- src/java.base/share/classes/java/math/BigInteger.java | 7 +++++++ src/java.base/share/classes/java/math/MathContext.java | 6 ++++-- 3 files changed, 16 insertions(+), 4 deletions(-) diff --git a/src/java.base/share/classes/java/math/BigDecimal.java b/src/java.base/share/classes/java/math/BigDecimal.java index dd9a7c1f97c..bb698a555b6 100644 --- a/src/java.base/share/classes/java/math/BigDecimal.java +++ b/src/java.base/share/classes/java/math/BigDecimal.java @@ -4208,7 +4208,9 @@ static void setIntValVolatile(BigDecimal bd, BigInteger val) { * Reconstitute the {@code BigDecimal} instance from a stream (that is, * deserialize it). * - * @param s the stream being read. + * @param s the stream being read. + * @throws IOException if an I/O error occurs + * @throws ClassNotFoundException if a serialized class cannot be loaded */ @java.io.Serial private void readObject(java.io.ObjectInputStream s) @@ -4227,7 +4229,8 @@ private void readObject(java.io.ObjectInputStream s) /** * Serialize this {@code BigDecimal} to the stream in question * - * @param s the stream to serialize to. + * @param s the stream to serialize to. + * @throws IOException if an I/O error occurs */ @java.io.Serial private void writeObject(java.io.ObjectOutputStream s) diff --git a/src/java.base/share/classes/java/math/BigInteger.java b/src/java.base/share/classes/java/math/BigInteger.java index 1a73abcf1b7..febe1fac99a 100644 --- a/src/java.base/share/classes/java/math/BigInteger.java +++ b/src/java.base/share/classes/java/math/BigInteger.java @@ -4657,6 +4657,10 @@ private int firstNonzeroIntNum() { * marker value. Therefore, no explicit action to set these fields needs to * be taken in readObject because those fields already have a 0 value by * default since defaultReadObject is not being used. + * + * @param s the stream being read. + * @throws IOException if an I/O error occurs + * @throws ClassNotFoundException if a serialized class cannot be loaded */ @java.io.Serial private void readObject(java.io.ObjectInputStream s) @@ -4724,6 +4728,9 @@ static void putMag(BigInteger bi, int[] magnitude) { * {@code firstNonzeroByteNum}, respectively. These values are compatible * with older implementations, but will be ignored by current * implementations. + * + * @param s the stream to serialize to. + * @throws IOException if an I/O error occurs */ @java.io.Serial private void writeObject(ObjectOutputStream s) throws IOException { diff --git a/src/java.base/share/classes/java/math/MathContext.java b/src/java.base/share/classes/java/math/MathContext.java index 9d40482ee49..028ede34de6 100644 --- a/src/java.base/share/classes/java/math/MathContext.java +++ b/src/java.base/share/classes/java/math/MathContext.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2019, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2020, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -308,7 +308,9 @@ public java.lang.String toString() { * Reconstitute the {@code MathContext} instance from a stream (that is, * deserialize it). * - * @param s the stream being read. + * @param s the stream being read. + * @throws IOException if an I/O error occurs + * @throws ClassNotFoundException if a serialized class cannot be loaded */ @java.io.Serial private void readObject(java.io.ObjectInputStream s)