src/java.base/share/classes/java/text/DateFormat.java

rev 47733 : 8176841: Additional Unicode Language-Tag Extensions
8189134: New system properties for the default Locale extensions
Reviewed-by:

*** 95,104 ****
--- 95,111 ----
   * <blockquote>
   * <pre>{@code
   * DateFormat df = DateFormat.getDateInstance(DateFormat.LONG, Locale.FRANCE);
   * }</pre>
   * </blockquote>
+  *
+  * <p>If the specified locale contains "ca" (calendar), "rg" (region override),
+  * and/or "tz" (timezone) <a href="../util/Locale.html#def_locale_extension">Unicode
+  * extensions</a>, the calendar, the country and/or the time zone for formatting
+  * are overriden. If both "ca" and "rg" are specified, the calendar from "ca"
+  * extension supersedes the implicit one from "rg" extension.
+  *
   * <p>You can use a DateFormat to parse also.
   * <blockquote>
   * <pre>{@code
   * myDate = df.parse(myString);
   * }</pre>