RFR: JDK-8257086: Clarify differences between {Float, Double}.equals and == [v5]

[Joe Darcy]

> Updates to the specifications of Double.{equals, compareTo} to explain more explicitly why the obvious wrappers around "==" and "<"/"==" are not sufficient for floating-point values.
> 
> Once the wording is worked out, I'll replicate it for the analogous methods on Float.

Joe Darcy has updated the pull request incrementally with one additional commit since the last revision:

  Fix typos noticed by @bplb.

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

Changes:
  - all: https://git.openjdk.java.net/jdk/pull/1699/files
  - new: https://git.openjdk.java.net/jdk/pull/1699/files/072c40d9..b419ca79

Webrevs:
 - full: https://webrevs.openjdk.java.net/?repo=jdk&pr=1699&range=04
 - incr: https://webrevs.openjdk.java.net/?repo=jdk&pr=1699&range=03-04

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

PR: https://git.openjdk.java.net/jdk/pull/1699