--- old/src/java.base/share/classes/java/text/NumberFormat.java	2017-08-28 12:19:51.722155839 +0530
+++ new/src/java.base/share/classes/java/text/NumberFormat.java	2017-08-28 12:19:51.426155839 +0530
@@ -181,6 +181,18 @@
  * The subclass may provide its own implementation and specification about
  * {@code NullPointerException}.
  *
+ * @implSpec
+ * <p>
+ * {@code NumberFormat} provides rounding modes defined
+ * in {@link java.math.RoundingMode} for formatting numbers. By default,
+ * 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