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

[Joe Darcy]

> 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:

  Update comments in Float and Float16.

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

Changes:
  - all: https://git.openjdk.org/jdk/pull/27356/files
  - new: https://git.openjdk.org/jdk/pull/27356/files/480151ba..8c12eb7f

Webrevs:
 - full: https://webrevs.openjdk.org/?repo=jdk&pr=27356&range=02
 - incr: https://webrevs.openjdk.org/?repo=jdk&pr=27356&range=01-02

  Stats: 6 lines in 2 files changed: 2 ins; 0 del; 4 mod
  Patch: https://git.openjdk.org/jdk/pull/27356.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/27356/head:pull/27356

PR: https://git.openjdk.org/jdk/pull/27356