RFR: 8367942: Add API note discussing Double.compareTo total order and IEEE 754 total order [v2]

[Brian Burkhalter]

On Thu, 18 Sep 2025 17:56:35 GMT, Joe Darcy <darcy at openjdk.org> wrote:

>> Add a total that the total order used by {Double, Float}.compareTo is different than the total order defined by IEEE 754, starting the 2008 version of that standard.
>
> Joe Darcy has updated the pull request incrementally with one additional commit since the last revision:
> 
>   Respond to review feedback.

Looks all right to me once the placeholder text is replaced.

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

PR Comment: https://git.openjdk.org/jdk/pull/27356#issuecomment-3309826703