From b89aa4827d1d96c51597364cdf350b13b48b6fc3 Mon Sep 17 00:00:00 2001
From: Sam Brannen <sam@sambrannen.com>
Date: Wed, 6 Feb 2019 15:56:47 +0100
Subject: [PATCH] Document wrapping semantics for @BeforeAll/@AfterAll methods
 in Javadoc

This commit introduces Javadoc for wrapping semantics for
@BeforeAll/@AfterAll methods declared in interfaces.

Issue: #1620
---
 .../src/main/java/org/junit/jupiter/api/AfterAll.java        | 5 +++++
 .../src/main/java/org/junit/jupiter/api/BeforeAll.java       | 5 +++++
 2 files changed, 10 insertions(+)

diff --git a/junit-jupiter-api/src/main/java/org/junit/jupiter/api/AfterAll.java b/junit-jupiter-api/src/main/java/org/junit/jupiter/api/AfterAll.java
index e565f7be8b00..90aca7c39585 100644
--- a/junit-jupiter-api/src/main/java/org/junit/jupiter/api/AfterAll.java
+++ b/junit-jupiter-api/src/main/java/org/junit/jupiter/api/AfterAll.java
@@ -45,6 +45,11 @@
  * {@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.
+ *
  * <h3>Composition</h3>
  *
  * <p>{@code @AfterAll} may be used as a meta-annotation in order to create
diff --git a/junit-jupiter-api/src/main/java/org/junit/jupiter/api/BeforeAll.java b/junit-jupiter-api/src/main/java/org/junit/jupiter/api/BeforeAll.java
index e441813a9aea..d567a0e25696 100644
--- a/junit-jupiter-api/src/main/java/org/junit/jupiter/api/BeforeAll.java
+++ b/junit-jupiter-api/src/main/java/org/junit/jupiter/api/BeforeAll.java
@@ -45,6 +45,11 @@
  * {@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.
+ *
  * <h3>Composition</h3>
  *
  * <p>{@code @BeforeAll} may be used as a meta-annotation in order to create