--- old/src/share/classes/java/lang/Character.java	2009-07-09 12:29:50.000000000 -0700
+++ new/src/share/classes/java/lang/Character.java	2009-07-09 12:29:50.000000000 -0700
@@ -2571,6 +2571,10 @@
      * significantly better space and time performance by caching
      * frequently requested values.
      *
+     * This method will always cache values in the range '\u0000'
+     * to '\u007f'", inclusive, and may cache other values outside
+     * of this range.
+     *
      * @param  c a char value.
      * @return a <tt>Character</tt> instance representing <tt>c</tt>.
      * @since  1.5