--- a/src/java.base/share/classes/java/lang/Long.java	Wed Apr 25 14:08:19 2018 -0700
+++ b/src/java.base/share/classes/java/lang/Long.java	Wed Apr 25 22:12:06 2018 -0700
@@ -1164,10 +1164,8 @@
      * 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 <em>not</em> required to cache values within a particular
-     * range.
+     * This method will always cache values in the range -128 to 127,
+     * inclusive, and may cache other values outside of this range.
      *
      * @param  l a long value.
      * @return a {@code Long} instance representing {@code l}.