--- a/jdk/src/share/classes/java/lang/Long.java Wed Jul 08 09:12:17 2009 -0700
+++ b/jdk/src/share/classes/java/lang/Long.java Thu Jul 09 12:31:30 2009 -0700
@@ -560,6 +560,11 @@
* 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.
+ *
* @param l a long value.
* @return a {@code Long} instance representing {@code l}.
* @since 1.5