On Fri, 9 Oct 2020 16:14:59 GMT, Ignasi Marimon-Clos <github.com+762126+ignas...@openjdk.org> wrote:
> The API Docs for `BigDecimal` introduce the meaning of `scale`. The current > writeup can be missleading when presenting the meaning of a `scale` value > that's negative. Hopefully, with this PR, the sentence is more clear. > > The ambiguity is on this sentence: > >> If negative, the unscaled value of the number is ... > > Instead, I suggest the more verbose: > >> If the scale is negative, the unscaled value of the number is ... > > To keep symmetry, I've also reviewed the positive case from: > >> If zero or positive, the scale is the number of digits ... > > to: > >> If the scale is zero or positive, the scale is the number of digits ... Apologies on the incredible delay. I've been offline on sick leave and barely returning to work. ------------- PR: https://git.openjdk.java.net/jdk/pull/582