A DESCRIPTION OF THE PROBLEM :
SDK 1.5 API
class: java.math.BigDecimal
method: toPlainString()

In particular, if this BigDecimal has a positive scale, the string resulting from this method will have a scale of zero when processed by the string constructor.

ERROR: positive
improvement: negative

In particular, if this BigDecimal has a negative scale, the string resulting from this method will have a scale of zero when processed by the string constructor.

EXPECTED VERSUS ACTUAL BEHAVIOR :
EXPECTED -
In particular, if this BigDecimal has a negative scale, the string resulting from this method will have a scale of zero when processed by the string constructor.

java.math.BigDecimal.toPlainString()
ACTUAL -
In particular, if this BigDecimal has a positive scale, the string resulting from this method will have a scale of zero when processed by the string constructor.

java.math.BigDecimal.toPlainString()

URL OF FAULTY DOCUMENTATION :
http://java.sun.com/j2se/1.5.0/docs/api/java/math/BigDecimal.html#toPlainString()