--- a/jdk/src/java.base/share/classes/java/text/NumberFormat.java	Tue Aug 29 00:01:00 2017 +0000
+++ b/jdk/src/java.base/share/classes/java/text/NumberFormat.java	Tue Aug 29 12:16:22 2017 +0530
@@ -181,6 +181,17 @@
  * The subclass may provide its own implementation and specification about
  * {@code NullPointerException}.
  *
+ * <p>
+ * The default implementation provides rounding modes defined
+ * in {@link java.math.RoundingMode} for formatting numbers. It
+ * uses the {@linkplain java.math.RoundingMode#HALF_EVEN
+ * round half-even algorithm}. To change the rounding mode use
+ * {@link #setRoundingMode(java.math.RoundingMode) setRoundingMode}.
+ * The {@code NumberFormat} returned by the static factory methods is
+ * configured to round floating point numbers using half-even
+ * rounding (see {@link java.math.RoundingMode#HALF_EVEN
+ * RoundingMode.HALF_EVEN}) for formatting.
+ *
  * @see          DecimalFormat
  * @see          ChoiceFormat
  * @author       Mark Davis