--- old/src/java.base/share/classes/java/util/Locale.java 2015-08-07 21:15:11.474584361 +0400 +++ new/src/java.base/share/classes/java/util/Locale.java 2015-08-07 21:15:11.270584370 +0400 @@ -413,24 +413,24 @@ * *

For compatibility reasons, two * non-conforming locales are treated as special cases. These are - * ja_JP_JP and th_TH_TH. These are ill-formed + * {@code ja_JP_JP} and {@code th_TH_TH}. These are ill-formed * in BCP 47 since the variants are too short. To ease migration to BCP 47, * these are treated specially during construction. These two cases (and only * these) cause a constructor to generate an extension, all other values behave * exactly as they did prior to Java 7. * - *

Java has used ja_JP_JP to represent Japanese as used in + *

Java has used {@code ja_JP_JP} to represent Japanese as used in * Japan together with the Japanese Imperial calendar. This is now * representable using a Unicode locale extension, by specifying the - * Unicode locale key ca (for "calendar") and type - * japanese. When the Locale constructor is called with the + * Unicode locale key {@code ca} (for "calendar") and type + * {@code japanese}. When the Locale constructor is called with the * arguments "ja", "JP", "JP", the extension "u-ca-japanese" is * automatically added. * - *

Java has used th_TH_TH to represent Thai as used in + *

Java has used {@code th_TH_TH} to represent Thai as used in * Thailand together with Thai digits. This is also now representable using * a Unicode locale extension, by specifying the Unicode locale key - * nu (for "number") and value thai. When the Locale + * {@code nu} (for "number") and value {@code thai}. When the Locale * constructor is called with the arguments "th", "TH", "TH", the * extension "u-nu-thai" is automatically added. * @@ -446,9 +446,9 @@ *

Legacy language codes
* *

Locale's constructor has always converted three language codes to - * their earlier, obsoleted forms: he maps to iw, - * yi maps to ji, and id maps to - * in. This continues to be the case, in order to not break + * their earlier, obsoleted forms: {@code he} maps to {@code iw}, + * {@code yi} maps to {@code ji}, and {@code id} maps to + * {@code in}. This continues to be the case, in order to not break * backwards compatibility. * *

The APIs added in 1.7 map between the old and new language codes, @@ -1272,14 +1272,14 @@ * {@link #toLanguageTag}. * *

Examples:

+ *
  • {@code en}
  • + *
  • {@code de_DE}
  • + *
  • {@code _GB}
  • + *
  • {@code en_US_WIN}
  • + *
  • {@code de__POSIX}
  • + *
  • {@code zh_CN_#Hans}
  • + *
  • {@code zh_TW_#Hant-x-java}
  • + *
  • {@code th_TH_TH_#u-nu-thai}
  • * * @return A string representation of the Locale, for debugging. * @see #getDisplayName