archive/jdk
1
0
Fork 0
mirror of https://github.com/openjdk/jdk.git synced 2025-08-27 14:54:52 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

8262875: doccheck: empty paragraphs, etc in java.base module

Browse source 
Reviewed-by: alanb, darcy, lancea
This commit is contained in:
Jonathan Gibbons 2021-03-02 20:35:51 +00:00
parent f304b74e0a
commit 20b9ba53a5
8 changed files with 8 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

4
src/java.base/share/classes/java/util/Comparator.java
View file

@ -131,14 +131,14 @@ public interface Comparator<T> {
*
* Finally, the implementor must ensure that {@code compare(x,
* y)==0} implies that {@code signum(compare(x,
* z))==signum(compare(y, z))} for all {@code z}.<p>
* z))==signum(compare(y, z))} for all {@code z}.
*
* @apiNote
* It is generally the case, but <i>not</i> strictly required that
* {@code (compare(x, y)==0) == (x.equals(y))}. Generally speaking,
* any comparator that violates this condition should clearly indicate
* this fact. The recommended language is "Note: this comparator
* imposes orderings that are inconsistent with equals."<p>
* imposes orderings that are inconsistent with equals."
*
* @param o1 the first object to be compared.
* @param o2 the second object to be compared.