RFR: 8299498: Usage of constructors of primitive wrapper classes should be avoided in java.lang API docs [v2]

[Roger Riggs]

On Tue, 10 Jan 2023 18:02:22 GMT, Justin Lu <duke at openjdk.org> wrote:

>> The javadocs of the following methods used deprecated constructors of the primitive wrapper classes:
>> 
>> java.lang.ArrayStoreException
>> java.lang.ClassCastException
>> java.lang.Double.compare(double, double)
>> java.lang.Float.compare(float, float)
>> java.lang.Integer.getInteger(String, int)
>> java.lang.Integer.valueOf(String)
>> java.lang.Integer.valueOf(String, int)
>> java.lang.Long.getLong(String, long)
>> java.lang.Long.valueOf(String)
>> java.lang.Long.valueOf(String, int)
>> java.lang.Short.valueOf(String)
>> java.lang.Short.valueOf(String, int) 
>> 
>> This change replaces the constructors with .valueOf() methods except java.lang.ClassCastException which was already fixed in JDK-8289730
>
> Justin Lu has updated the pull request incrementally with one additional commit since the last revision:
> 
>   Include Byte in changes

Given that type conversions create the primitive wrapper instances when they are needed, I think the examples should be reconsidered. They needlessly suggest that the wrapper instances need to be explicitly created.

-------------

Changes requested by rriggs (Reviewer).

PR: https://git.openjdk.org/jdk/pull/11912