JDK 15 RFR of JDK-8240624: Note mapping of RoundingMode constants to equivalent IEEE 754-2019 policy

Brian Burkhalter brian.burkhalter at oracle.com
Thu Mar 5 22:46:36 UTC 2020


Hi Joe,

> On Mar 5, 2020, at 2:43 PM, Joe Darcy <joe.darcy at oracle.com> wrote:
> 
>> Looks fine. Do you think the IEEE 754-2019 attribute names should have some kind of formatting, e.g., @code or italics?
> The IEEE standard uses normal next for those terms, no italics, bold, etc. ; in this context, I think preserving that convention is fine.
> 
That make sense.
> I'll push with a slightly reworked opening API note:
> 
> + * @apiNote
> + * Five of the rounding modes declared in this class correspond to
> + * rounding direction attributes defined in the <cite>IEEE Standard
> + * for Floating-Point Arithmetic</cite>, IEEE 754-2019. Where present,
> + * this correspondence will be noted in the documentation of the
> + * particular constant.
> + *
> 
Looks good.

Brian


More information about the core-libs-dev mailing list