RFR: 8358804: Improve the API Note of BigDecimal.valueOf(double)

[Joe Darcy]

On Fri, 13 Jun 2025 15:21:38 GMT, Raffaello Giulietti <rgiulietti at openjdk.org> wrote:

> Documenting a suggestion for `float` arguments.

src/java.base/share/classes/java/math/BigDecimal.java line 1380:

> 1378:      * Double#toString(double)}.
> 1379:      * <p>
> 1380:      * While a {@code float} argument {@code v} can be passed to this method,

I recommend a slightly different wording; suggestion:

"...the result often contains many more trailing digits than the precision of a `float`.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/25805#discussion_r2146108818