--- old/src/java.base/share/classes/java/text/NumberFormat.java	2017-11-10 15:30:14.994267067 -0800
+++ new/src/java.base/share/classes/java/text/NumberFormat.java	2017-11-10 15:30:14.649260618 -0800
@@ -96,7 +96,14 @@
  * NumberFormat nf = NumberFormat.getInstance(Locale.FRENCH);
  * }</pre>
  * </blockquote>
- * You can also use a <code>NumberFormat</code> to parse numbers:
+ *
+ * <p>If the locale contains "nu" (numbers) and/or "rg" (region override)
+ * <a href="../util/Locale.html#def_locale_extension">Unicode extensions</a>,
+ * the decimal digits, and/or the country used for formatting are overriden.
+ * If both "nu" and "rg" are specified, the decimal digits from "nu"
+ * extension supersedes the implicit one from "rg" extension.
+ *
+ * <p>You can also use a <code>NumberFormat</code> to parse numbers:
  * <blockquote>
  * <pre>{@code
  * myNumber = nf.parse(myString);