8310033: Clarify return value of Java Time compareTo methods

src/java.base/share/classes/java/time/chrono/ChronoLocalDateTime.java

@@ -500,7 +500,7 @@ default long toEpochSecond(ZoneOffset offset) {
      * This default implementation performs the comparison defined above.
      *
      * @param other  the other date-time to compare to, not null
-     * @return the comparator value, that is the comparison of this local date-time compared with
+     * @return the comparator value, that is the comparison of this local date-time with
      *          the {@code other} local date-time and this chronology with the {@code other} chronology,
      *          in order, returning the first non-zero result, and otherwise returning zero
      * @see #isBefore

src/java.base/share/classes/java/time/zone/ZoneOffsetTransition.java

@@ -399,13 +399,13 @@ List<ZoneOffset> getValidOffsets() {
      * This compares the instants of each transition.
      * The offsets are ignored, making this order inconsistent with equals.
      *
-     * @param transition  the transition to compare to, not null
-     * @return the comparator value, that is the comparison of this {@code transition} instant
-     *          with {@code transition} instant
+     * @param otherTransition  the transition to compare to, not null
+     * @return the comparator value, that is the comparison of this transition instant
+     *          with {@code otherTransition} instant
      */
     @Override
-    public int compareTo(ZoneOffsetTransition transition) {
-        return Long.compare(epochSecond, transition.epochSecond);
+    public int compareTo(ZoneOffsetTransition otherTransition) {
+        return Long.compare(epochSecond, otherTransition.epochSecond);
     }
 
     //-----------------------------------------------------------------------