RFR: 8266578: Disambiguate BigDecimal description of scale

[Brian Burkhalter]

On Fri, 9 Oct 2020 16:14:59 GMT, Ignasi Marimon-Clos <github.com+762126+ignasi35 at 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 ...

The `jcheck` test fails because "The commit message does not reference any issue. To add an issue reference to this PR, edit the title to be of the format `issue number: message`."

-------------

PR: https://git.openjdk.java.net/jdk/pull/582