diff --git a/src/share/classes/java/lang/Byte.java b/src/share/classes/java/lang/Byte.java index 2bb6480c539e1c896c2b8a86131a40697d40ea08..ba7486377d6c9d0402cee4ecc21c7cfe79cddba0 100644 --- a/src/share/classes/java/lang/Byte.java +++ b/src/share/classes/java/lang/Byte.java @@ -90,8 +90,8 @@ public final class Byte extends Number implements Comparable { * If a new {@code Byte} instance is not required, this method * should generally be used in preference to the constructor * {@link #Byte(byte)}, as this method is likely to yield - * significantly better space and time performance by caching - * frequently requested values. + * significantly better space and time performance since + * all byte values are cached. * * @param b a byte value. * @return a {@code Byte} instance representing {@code b}. diff --git a/src/share/classes/java/lang/Character.java b/src/share/classes/java/lang/Character.java index e33052ee170c6f951b49e9866a50618ac7089b2a..9b9c938fa1e1ecc30e717eee7fd7c6054097bdd7 100644 --- a/src/share/classes/java/lang/Character.java +++ b/src/share/classes/java/lang/Character.java @@ -2571,6 +2571,10 @@ class Character extends Object implements java.io.Serializable, ComparableCharacter instance representing c. * @since 1.5 diff --git a/src/share/classes/java/lang/Integer.java b/src/share/classes/java/lang/Integer.java index 50863dd7e9fa646f6312ddb856b3aa1c56abee76..da35d2f7a4e47ca7b2761d7596afe43b329dcae1 100644 --- a/src/share/classes/java/lang/Integer.java +++ b/src/share/classes/java/lang/Integer.java @@ -638,6 +638,9 @@ public final class Integer extends Number implements Comparable { * to yield significantly better space and time performance by * caching frequently requested values. * + * This method will always cache values in the range -128 to 127, + * inclusive, and may cache other values outside of this range. + * * @param i an {@code int} value. * @return an {@code Integer} instance representing {@code i}. * @since 1.5 diff --git a/src/share/classes/java/lang/Long.java b/src/share/classes/java/lang/Long.java index c632d5df2d9b15af976ac8632744362478762d24..a2fe09c959d6121029c09c7097a37a2040091852 100644 --- a/src/share/classes/java/lang/Long.java +++ b/src/share/classes/java/lang/Long.java @@ -560,6 +560,11 @@ public final class Long extends Number implements Comparable { * significantly better space and time performance by caching * frequently requested values. * + * Note that unlike the {@linkplain Integer#valueOf(int) + * corresponding method} in the {@code Integer} class, this method + * is not required to cache values within a particular + * range. + * * @param l a long value. * @return a {@code Long} instance representing {@code l}. * @since 1.5 diff --git a/src/share/classes/java/lang/Short.java b/src/share/classes/java/lang/Short.java index 8abbf65d61a428313db3fb3f44f08d6b8e698687..a5d72120dfbfbee86f2688e5f9f6721689e11322 100644 --- a/src/share/classes/java/lang/Short.java +++ b/src/share/classes/java/lang/Short.java @@ -219,6 +219,9 @@ public final class Short extends Number implements Comparable { * significantly better space and time performance by caching * frequently requested values. * + * This method will always cache values in the range -128 to 127, + * inclusive, and may cache other values outside of this range. + * * @param s a short value. * @return a {@code Short} instance representing {@code s}. * @since 1.5