The BigDecimal class is part of the java.math package, not java.lang. The Javadoc for methods using BigDecimal should refer to the correct package: java.math.BigDecimal. If you're able to submit an issue, submit the reference to java.math.BigDecimal to avoid confusion.