src/java.base/share/classes/java/lang/Character.java

rev 53050 : [mq]: 8215303

@@ -41,11 +41,13 @@
  * <p>
  * In addition, this class provides several methods for determining
  * a character's category (lowercase letter, digit, etc.) and for converting
  * characters from uppercase to lowercase and vice versa.
  * <p>
- * Character information is based on the Unicode Standard, version 11.0.0.
+ * Character information is based on <a id="UnicodeVer">the Unicode Standard,
+ * version 11.0.0</a>. Additional currency symbols (and Japanese Era Square
+ * character) defined subsequent to that Unicode version may be present.
  * <p>
  * The methods and data of class {@code Character} are defined by
  * the information in the <i>UnicodeData</i> file that is part of the
  * Unicode Character Database maintained by the Unicode
  * Consortium. This file specifies various properties including name

@@ -62,10 +64,17 @@
  * May 2019. Relevant methods in the Character class return the same
  * properties as for the existing Japanese era characters (e.g., U+337E for
  * "Meizi"). For the details of the code point, refer to
  * <a href="http://blog.unicode.org/2018/09/new-japanese-era.html">
  * http://blog.unicode.org/2018/09/new-japanese-era.html</a>.
+ * <p>
+ * @implSpec The code points in {@link Character.UnicodeBlock#CURRENCY_SYMBOLS
+ * Currency Symbols} {@code UnicodeBlock} that are unassigned as of the
+ * <a href="#UnicodeVer">Unicode version noted above</a>,
+ * may be defined for currency symbols assigned by the Unicode
+ * Consortium from later updates. The definition of additionally assigned
+ * code points is implementation specific.
  *
  * <h3><a id="unicode">Unicode Character Representations</a></h3>
  *
  * <p>The {@code char} data type (and therefore the value that a
  * {@code Character} object encapsulates) are based on the