RFR: JDK-8318476: Add resource consumption note to BigInteger and BigDecimal

[Joe Darcy]

On Sun, 22 Oct 2023 11:22:27 GMT, Raffaello Giulietti <rgiulietti at openjdk.org> wrote:

>> Add informative notes to BigInteger and BigDecimal about possible running times, etc.
>
> src/java.base/share/classes/java/math/BigInteger.java line 152:
> 
>> 150:  * time of operations can screen out {@code BigInteger} values above a
>> 151:  * chosen magnitude.
>> 152:  *
> 
> This explains the execution time characteristics but not the memory consumption aspects of the class.
> I think that a couple of sentences about them would make this note more complete.

A reasonable suggestion; I was considering mentioning memory usage in the initial version. I'll craft something brief for both classes on memory usage.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/16298#discussion_r1367957742