--- old/src/java.base/share/classes/java/math/BigDecimal.java 2016-05-01 15:21:30.080538869 -0700 +++ new/src/java.base/share/classes/java/math/BigDecimal.java 2016-05-01 15:21:29.916456872 -0700 @@ -1993,6 +1993,40 @@ return result; } + + /** + * Returns an approximation to the square root of {@code this} + * with rounding according to the context settings. + * + *
The preferred scale of the returned result is equal to + * {@code floor(this.scale()/2.0)}. The value of the returned + * result is always within one ulp of the exact decimal value for + * the precision in question. If the rounding mode is {@link + * RoundingMode#HALF_UP HALF_UP}, {@link RoundingMode#HALF_DOWN + * HALF_DOWN}, or {@link RoundingMode#HALF_EVEN HALF_EVEN}, the + * result is within one half an ulp of the exact decimal value. + * + *
Special case: + *
(thisn)
, The power is computed exactly, to