Code review request for 6463998: Undocumented NullPointerExeption from Float.parseFloat and Double.parseDouble

[Joseph D. Darcy]

Hello.

Please review this simple patch below to document the long-standing 
behavior of parseFloat and parseDouble regarding null inputs.  (Yes, the 
various string -> value methods have inconsistent behavior with respect 
to null inputs; however, at this point the safest course of action is 
just to document the present behavior.)

Thanks,

-Joe

--- old/src/share/classes/java/lang/Double.java    2009-07-15 
13:28:38.000000000 -0700
+++ new/src/share/classes/java/lang/Double.java    2009-07-15 
13:28:38.000000000 -0700
@@ -529,6 +529,7 @@
     * @param  s   the string to be parsed.
     * @return the {...@code double} value represented by the string
     *         argument.
+     * @throws  NullPointerException if the argument string is null
     * @throws NumberFormatException if the string does not contain
     *         a parsable {...@code double}.
     * @see    java.lang.Double#valueOf(String)
--- old/src/share/classes/java/lang/Float.java    2009-07-15 
13:28:39.000000000 -0700
+++ new/src/share/classes/java/lang/Float.java    2009-07-15 
13:28:39.000000000 -0700
@@ -441,6 +441,7 @@
     * @param      s   the string to be parsed.
     * @return the {...@code float} value represented by the string
     *         argument.
+     * @throws  NullPointerException if the argument string is null
     * @throws  NumberFormatException  if the string does not contain a
     *               parsable {...@code float}.
     * @see        java.lang.Float#valueOf(String)