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

[Brian Burkhalter]

On Fri, 13 Jun 2025 18:10:03 GMT, Raffaello Giulietti <rgiulietti at openjdk.org> wrote:

>> src/java.base/share/classes/java/math/BigDecimal.java line 1383:
>> 
>>> 1381:      * the result usually contains too many trailing digits compared
>>> 1382:      * to the precision of a {@code float}.
>>> 1383:      * Consider using {@code new BigDecimal(Float.toString(v))} instead.
>> 
>> Perhaps move "Consider using" to the previous line; otherwise, looks fine.
>
> I usually start a sentence on a new line because that generates less noise when diffing in the future.
> The HTML renders it in the same paragraph as the preceding text.

Makes sense.

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

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