[jdk21] RFR: 8310033: Clarify return value of Java Time compareTo methods

Mon Jul 31 20:00:06 UTC 2023

A doc-only change to improve javadoc in java.time.

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

Commit messages:
 - Backport 8650026ff16e5c5eff897f9fd39c0c35fd8b7367

Changes: https://git.openjdk.org/jdk21/pull/153/files
 Webrev: https://webrevs.openjdk.org/?repo=jdk21&pr=153&range=00
  Issue: https://bugs.openjdk.org/browse/JDK-8310033
  Stats: 84 lines in 17 files changed: 49 ins; 0 del; 35 mod
  Patch: https://git.openjdk.org/jdk21/pull/153.diff
  Fetch: git fetch https://git.openjdk.org/jdk21.git pull/153/head:pull/153

PR: https://git.openjdk.org/jdk21/pull/153