On Wed, 25 May 2022 00:19:41 GMT, Joe Darcy <da...@openjdk.org> wrote:
> Generally add apiNote's to map from Java library methods to particular IEEE
> 754 operations. For now, I only added such notes to java.lang.Math and not
> java.lang.StrictMath.
src/java.base/share/classes/java/lang/Math.java line 771:
> 769: * This method corresponds to the convertToIntegerTiesToEven
> 770: * operation defined in IEEE 754.
> 771: *
IEEE `convertToIntegerTiesToEven` rounds ties to the even integer.
The method's spec, however, requires ties to round toward positive infinity.
Unfortunately, IEEE 754 doesn't offer a `convertToIntegerTiesToPositive`
src/java.base/share/classes/java/lang/Math.java line 824:
> 822: * This method corresponds to the convertToIntegerTiesToEven
> 823: * operation defined in IEEE 754.
> 824: *
see comment for `round(float)`
src/java.base/share/classes/java/math/RoundingMode.java line 49:
> 47: * exponent range of {@code BigDecimal}, the mathematical result will
> 48: * be exactly representable in the result precision or fall between
> 49: * two representable values. In the case of falling between two
Perhaps better would be
`two adjacent representable values.`
-------------
PR: https://git.openjdk.java.net/jdk/pull/8876
