8240957: Clarify BadAttributeValueExpException readObject method

Reviewed-by: bpb
diff --git a/src/java.management/share/classes/javax/management/BadAttributeValueExpException.java b/src/java.management/share/classes/javax/management/BadAttributeValueExpException.java
index 68bd9fc..6290449 100644
--- a/src/java.management/share/classes/javax/management/BadAttributeValueExpException.java
+++ b/src/java.management/share/classes/javax/management/BadAttributeValueExpException.java
@@ -45,7 +45,7 @@
 
     /**
      * @serial A string representation of the attribute that originated this exception.
-     * for example, the string value can be the return of {@code attribute.toString()}
+     * For example, the string value can be the return of {@code attribute.toString()}.
      */
     @SuppressWarnings("serial") // See handling in constructor and readObject
     private String val;
@@ -68,6 +68,16 @@
         return "BadAttributeValueException: " + val;
     }
 
+    /**
+     * Restores the fields of a BadAttributeValueExpException from the stream.
+     * If the 'val' field in the stream does not contain a string
+     * it is replaced with an implementation specific string representation
+     * of the value in the stream.
+     *
+     * @param ois an ObjectInput Stream
+     * @throws IOException thrown if an error occurs
+     * @throws ClassNotFoundException if a class can not be found
+     */
     private void readObject(ObjectInputStream ois) throws IOException, ClassNotFoundException {
         ObjectInputStream.GetField gf = ois.readFields();
         Object valObj = gf.get("val", null);