#2914: explain 'superseding' in javadoc of @[Before|After][All|Each] methods

Author: mmerdes

junit-jupiter-api/src/main/java/org/junit/jupiter/api/AfterAll.java

@@ -43,14 +43,17 @@
  * <h2>Inheritance and Execution Order</h2>
  *
  * <p>{@code @AfterAll} methods are inherited from superclasses as long as
- * they are not <em>hidden</em> or <em>overridden</em>. Furthermore,
- * {@code @AfterAll} methods from superclasses will be executed after
- * {@code @AfterAll} methods in subclasses.
+ * they are not <em>hidden</em> (default mode with {@code static} modifier) or
+ * <em>overridden</em> or 'superseded' (i.e., replaced based on signature only,
+ * irrespective of Java's visibility rules). Furthermore, {@code @AfterAll}
+ * methods from superclasses will be executed after {@code @AfterAll} methods
+ * in subclasses.
  *
  * <p>Similarly, {@code @AfterAll} methods declared in an interface are
- * inherited as long as they are not <em>hidden</em> or <em>overridden</em>,
- * and {@code @AfterAll} methods from an interface will be executed after
- * {@code @AfterAll} methods in the class that implements the interface.
+ * inherited as long as they are not <em>hidden</em> or <em>overridden</em>
+ * (or 'superseded', see above), and {@code @AfterAll} methods from an
+ * interface will be executed after {@code @AfterAll} methods in the class
+ * that implements the interface.
  *
  * <p>JUnit Jupiter does not guarantee the execution order of multiple
  * {@code @AfterAll} methods that are declared within a single test class or

junit-jupiter-api/src/main/java/org/junit/jupiter/api/AfterEach.java

@@ -36,8 +36,10 @@
  * <h2>Inheritance and Execution Order</h2>
  *
  * <p>{@code @AfterEach} methods are inherited from superclasses as long as
- * they are not overridden. Furthermore, {@code @AfterEach} methods from
- * superclasses will be executed after {@code @AfterEach} methods in subclasses.
+ * they are not overridden  or 'superseded' (i.e., replaced based on signature
+ * only, irrespective of Java's visibility rules). Furthermore,
+ * {@code @AfterEach} methods from superclasses will be executed after
+ * {@code @AfterEach} methods in subclasses.
  *
  * <p>Similarly, {@code @AfterEach} methods declared as <em>interface default
  * methods</em> are inherited as long as they are not overridden, and

junit-jupiter-api/src/main/java/org/junit/jupiter/api/BeforeAll.java

@@ -43,14 +43,17 @@
  * <h2>Inheritance and Execution Order</h2>
  *
  * <p>{@code @BeforeAll} methods are inherited from superclasses as long as
- * they are not <em>hidden</em> or <em>overridden</em>. Furthermore,
- * {@code @BeforeAll} methods from superclasses will be executed before
- * {@code @BeforeAll} methods in subclasses.
+ * they are not <em>hidden</em> (default mode with {@code static} modifier) or
+ * <em>overridden</em> or 'superseded' (i.e., replaced based on signature only,
+ * irrespective of Java's visibility rules). Furthermore, {@code @BeforeAll}
+ * methods from superclasses will be executed before {@code @BeforeAll} methods
+ * in subclasses.
  *
  * <p>Similarly, {@code @BeforeAll} methods declared in an interface are
- * inherited as long as they are not <em>hidden</em> or <em>overridden</em>,
- * and {@code @BeforeAll} methods from an interface will be executed before
- * {@code @BeforeAll} methods in the class that implements the interface.
+ * inherited as long as they are not <em>hidden</em> or <em>overridden</em>
+ * (or 'superseded', see above), and {@code @BeforeAll} methods from an
+ * interface will be executed before {@code @BeforeAll} methods in the class
+ * that implements the interface.
  *
  * <p>JUnit Jupiter does not guarantee the execution order of multiple
  * {@code @BeforeAll} methods that are declared within a single test class or

junit-jupiter-api/src/main/java/org/junit/jupiter/api/BeforeEach.java

@@ -36,8 +36,10 @@
  * <h2>Inheritance and Execution Order</h2>
  *
  * <p>{@code @BeforeEach} methods are inherited from superclasses as long as
- * they are not overridden. Furthermore, {@code @BeforeEach} methods from
- * superclasses will be executed before {@code @BeforeEach} methods in subclasses.
+ * they are not overridden  or 'superseded' (i.e., replaced based on signature
+ * only, irrespective of Java's visibility rules). Furthermore,
+ * {@code @BeforeEach} methods from superclasses will be executed before
+ * {@code @BeforeEach} methods in subclasses.
  *
  * <p>Similarly, {@code @BeforeEach} methods declared as <em>interface default
  * methods</em> are inherited as long as they are not overridden, and