JDK 8 code review request for java.math doclint / accessibility cleanup

[Joe Darcy]

Hello,

Please review the changes in the patch below; these change address the 
doclint and HTML accessibility issues in java.math.

I'll find an existing bug or if one is not present, file a new bug to 
cover this work.

Thanks,

-Joe

diff -r 336e5a862013 src/share/classes/java/math/BigDecimal.java
--- a/src/share/classes/java/math/BigDecimal.java    Wed Jun 26 11:21:01 
2013 -0700
+++ b/src/share/classes/java/math/BigDecimal.java    Wed Jun 26 12:20:28 
2013 -0700
@@ -2572,6 +2572,9 @@
       * ({@code this} * 10<sup>n</sup>).  The scale of
       * the result is {@code (this.scale() - n)}.
       *
+     * @param n the exponent power to ten to scale by
+     * @return a BigDecimal whose numerical value is equal to
+     * ({@code this} * 10<sup>n</sup>)
       * @throws ArithmeticException if the scale would be
       *         outside the range of a 32-bit integer.
       *
diff -r 336e5a862013 src/share/classes/java/math/RoundingMode.java
--- a/src/share/classes/java/math/RoundingMode.java    Wed Jun 26 
11:21:01 2013 -0700
+++ b/src/share/classes/java/math/RoundingMode.java    Wed Jun 26 
12:20:28 2013 -0700
@@ -1,5 +1,5 @@
  /*
- * Copyright (c) 2003, 2011, Oracle and/or its affiliates. All rights 
reserved.
+ * Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights 
reserved.
   * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   *
   * This code is free software; you can redistribute it and/or modify it
@@ -101,6 +101,7 @@
           *
           *<p>Example:
           *<table border>
+         * <caption><b>Rounding mode UP Examples</b></caption>
           *<tr valign=top><th>Input Number</th>
           *    <th>Input rounded to one digit<br> with {@code UP} rounding
           *<tr align=right><td>5.5</td> <td>6</td>
@@ -124,6 +125,7 @@
           *
           *<p>Example:
           *<table border>
+         * <caption><b>Rounding mode DOWN Examples</b></caption>
           *<tr valign=top><th>Input Number</th>
           *    <th>Input rounded to one digit<br> with {@code DOWN} 
rounding
           *<tr align=right><td>5.5</td> <td>5</td>
@@ -148,6 +150,7 @@
           *
           *<p>Example:
           *<table border>
+         * <caption><b>Rounding mode CEILING Examples</b></caption>
           *<tr valign=top><th>Input Number</th>
           *    <th>Input rounded to one digit<br> with {@code CEILING} 
rounding
           *<tr align=right><td>5.5</td> <td>6</td>
@@ -172,6 +175,7 @@
           *
           *<p>Example:
           *<table border>
+         * <caption><b>Rounding mode FLOOR Examples</b></caption>
           *<tr valign=top><th>Input Number</th>
           *    <th>Input rounded to one digit<br> with {@code FLOOR} 
rounding
           *<tr align=right><td>5.5</td> <td>5</td>
@@ -198,6 +202,7 @@
           *
           *<p>Example:
           *<table border>
+         * <caption><b>Rounding mode HALF_UP Examples</b></caption>
           *<tr valign=top><th>Input Number</th>
           *    <th>Input rounded to one digit<br> with {@code HALF_UP} 
rounding
           *<tr align=right><td>5.5</td> <td>6</td>
@@ -223,6 +228,7 @@
           *
           *<p>Example:
           *<table border>
+         * <caption><b>Rounding mode HALF_DOWN Examples</b></caption>
           *<tr valign=top><th>Input Number</th>
           *    <th>Input rounded to one digit<br> with {@code 
HALF_DOWN} rounding
           *<tr align=right><td>5.5</td> <td>5</td>
@@ -255,6 +261,7 @@
           *
           *<p>Example:
           *<table border>
+         * <caption><b>Rounding mode HALF_EVEN Examples</b></caption>
           *<tr valign=top><th>Input Number</th>
           *    <th>Input rounded to one digit<br> with {@code 
HALF_EVEN} rounding
           *<tr align=right><td>5.5</td> <td>6</td>
@@ -278,6 +285,7 @@
           * {@code ArithmeticException} is thrown.
           *<p>Example:
           *<table border>
+         * <caption><b>Rounding mode UNNECESSARY Examples</b></caption>
           *<tr valign=top><th>Input Number</th>
           *    <th>Input rounded to one digit<br> with {@code 
UNNECESSARY} rounding
           *<tr align=right><td>5.5</td> <td>throw {@code 
ArithmeticException}</td>