--- old/src/java.base/share/classes/sun/misc/FDBigInteger.java 2015-05-18 17:53:15.060753430 +0400 +++ new/src/java.base/share/classes/sun/misc/FDBigInteger.java 2015-05-18 17:53:14.916753430 +0400 @@ -384,8 +384,8 @@ * Retrieves the normalization bias of the FDBigIntger. The * normalization bias is a left shift such that after it the highest word * of the value will have the 4 highest bits equal to zero: - * (highestWord & 0xf0000000) == 0, but the next bit should be 1 - * (highestWord & 0x08000000) != 0. + * {@code (highestWord & 0xf0000000) == 0}, but the next bit should be 1 + * {@code (highestWord & 0x08000000) != 0}. * * @return The normalization bias. */ @@ -546,9 +546,9 @@ * We assume that S has been normalized, as above, and that * "this" has been left-shifted accordingly. * Also assumed, of course, is that the result, q, can be expressed - * as an integer, 0 <= q < 10. + * as an integer, {@code 0 <= q < 10}. * - * @param The divisor of this FDBigInteger. + * @param S The divisor of this FDBigInteger. * @return q = (int)(this / S). */ /*@ @@ -685,7 +685,7 @@ * * @param p5 The exponent of the power-of-five factor. * @param p2 The exponent of the power-of-two factor. - * @return + * @return The multiplication result. */ /*@ @ requires this.value() == 0 || p5 == 0 && p2 == 0; @@ -931,11 +931,11 @@ /** * Compares the parameter with this FDBigInteger. Returns an * integer accordingly as: - *
-     * >0: this > other
-     *  0: this == other
-     * <0: this < other
-     * 
+ *
{@code
+     * > 0: this > other
+     *   0: this == other
+     * < 0: this < other
+     * }
* * @param other The FDBigInteger to compare. * @return A negative value, zero, or a positive value according to the @@ -974,11 +974,11 @@ * Compares this FDBigInteger with * 5p5 * 2p2. * Returns an integer accordingly as: - *
-     * >0: this > other
-     *  0: this == other
-     * <0: this < other
-     * 
+ *
{@code
+     * > 0: this > other
+     *   0: this == other
+     * < 0: this < other
+     * }
* @param p5 The exponent of the power-of-five factor. * @param p2 The exponent of the power-of-two factor. * @return A negative value, zero, or a positive value according to the @@ -1011,11 +1011,11 @@ /** * Compares this FDBigInteger with x + y. Returns a * value according to the comparison as: - *
+     * 
{@code
      * -1: this <  x + y
      *  0: this == x + y
      *  1: this >  x + y
-     * 
+ * }
* @param x The first addend of the sum to compare. * @param y The second addend of the sum to compare. * @return -1, 0, or 1 according to the result of the comparison.