8297305: Clarify that javax.lang.model.util.Elements.overrides is irreflexive

Reviewed-by: jjg
2026-02-07 00:48:38 +00:00 · 2022-12-13 20:48:13 +00:00 · 2022-12-13 20:48:13 +00:00 · c6f22b4160
commit c6f22b4160
parent bf78f716bd
1 changed files with 2 additions and 0 deletions
--- a/src/java.compiler/share/classes/javax/lang/model/util/Elements.java
+++ b/src/java.compiler/share/classes/javax/lang/model/util/Elements.java
@ -622,6 +622,8 @@ public interface Elements {
     * overrides another method.
     * When a non-abstract method overrides an abstract one, the
     * former is also said to <i>implement</i> the latter.
+     * As implied by JLS {@jls 8.4.8.1}, a method does <em>not</em>
+     * override itself. The overrides relation is <i>irreflexive</i>.
     *
     * <p> In the simplest and most typical usage, the value of the
     * {@code type} parameter will simply be the class or interface