Reformat javadoc and adoc to meet formatting conventions

Issue: #1454

Author: pietrygamat

documentation/src/docs/asciidoc/user-guide/extensions.adoc

@@ -450,26 +450,28 @@ but rethrow any other type of exception.
 include::{testDir}/example/exception/IgnoreIOExceptionExtension.java[tags=user_guide]
 ----
 
-Another example shows how to record the state of application under test exactly at the point of
-unexpected exception being thrown during setup and cleanup. Note that unlike relying on
-lifecycle callbacks, which may or may not be executed depending on the test status, this solution
-guarantees execution immediately after failing `@BeforeAll`, `@BeforeEach`, `@AfterEach` or `@AfterAll`.
+Another example shows how to record the state of application under test exactly at the
+point of unexpected exception being thrown during setup and cleanup. Note that unlike
+relying on lifecycle callbacks, which may or may not be executed depending on the test
+status, this solution guarantees execution immediately after failing `@BeforeAll`,
+`@BeforeEach`, `@AfterEach` or `@AfterAll`.
 
 [source,java,indent=0]
 .An exception handling extension that records application state on error
 ----
 include::{testDir}/example/exception/RecordStateOnErrorExtension.java[tags=user_guide]
 ----
 
-Multiple execution exception handlers may be invoked for the same lifecycle method in order of
-declaration. If one of the handlers swallows the handled exception, subsequent ones will not be executed,
-and no failure will be propagated to JUnit engine, as if the exception was never thrown. Handlers may also
-choose to rethrow the exception or throw a different one, potentially wrapping the original.
+Multiple execution exception handlers may be invoked for the same lifecycle method in
+order of declaration. If one of the handlers swallows the handled exception, subsequent
+ones will not be executed, and no failure will be propagated to JUnit engine, as if the
+exception was never thrown. Handlers may also choose to rethrow the exception or throw
+a different one, potentially wrapping the original.
 
-Extensions implementing `{BeforeAllExecutionExceptionHandler}` and `{AfterAllExecutionExceptionHandler}`
-need to be registered on a class level, while `{BeforeEachExecutionExceptionHandler}`,
-`{TestExecutionExceptionHandler}` and `{AfterEachExecutionExceptionHandler}` may be also registered for
-individual test methods.
+Extensions implementing `{BeforeAllExecutionExceptionHandler}` and
+`{AfterAllExecutionExceptionHandler}`need to be registered on a class level, while
+`{BeforeEachExecutionExceptionHandler}`, `{TestExecutionExceptionHandler}` and
+`{AfterEachExecutionExceptionHandler}` may be also registered for individual test methods.
 
 [source,java,indent=0]
 .An exception handling extension that records application state on error

junit-jupiter-api/src/main/java/org/junit/jupiter/api/extension/AfterAllExecutionExceptionHandler.java

@@ -15,17 +15,19 @@
 import org.apiguardian.api.API;
 
 /**
- * {@code AfterAllExecutionExceptionHandler} defines the API for {@link Extension Extensions} that wish to
- * handle exceptions thrown during execution of lifecycle methods annotated with {@code @AfterAll}.
+ * {@code AfterAllExecutionExceptionHandler} defines the API for
+ * {@link Extension Extensions} that wish to handle exceptions thrown during
+ * execution of lifecycle methods annotated with {@code @AfterAll}.
  *
- * <p>Common use cases include swallowing an exception if it's anticipated or rolling back a transaction
- * in certain error scenarios.
+ * <p>Common use cases include swallowing an exception if it's anticipated or
+ * rolling back a transaction in certain error scenarios.
  *
  * <p>This extension needs to be declared on a class level
  *
  * <h3>Constructor Requirements</h3>
  *
- * <p>Consult the documentation in {@link Extension} for details on constructor requirements.
+ * <p>Consult the documentation in {@link Extension} for details on constructor
+ * requirements.
  *
  * @see TestExecutionExceptionHandler
  * @see BeforeAllExecutionExceptionHandler
@@ -48,9 +50,10 @@ public interface AfterAllExecutionExceptionHandler extends Extension {
 	 * <li>Throw a new exception, potentially wrapping the supplied {@code throwable}.</li>
 	 * </ol>
 	 *
-	 * <p>If the supplied {@code throwable} is swallowed, subsequent {@code AfterAllExecutionExceptionHandler}
-	 * will not be invoked; otherwise, the next registered {@code AfterAllExecutionExceptionHandler} (if there is one)
-	 * will be invoked with any {@link Throwable} thrown by this handler.
+	 * <p>If the supplied {@code throwable} is swallowed, subsequent
+	 * {@code AfterAllExecutionExceptionHandler} will not be invoked; otherwise,
+	 * the next registered {@code AfterAllExecutionExceptionHandler} (if there
+	 * is one) will be invoked with any {@link Throwable} thrown by this handler.
 	 *
 	 * @param context the current extension context; never {@code null}
 	 * @param throwable the {@code Throwable} to handle; never {@code null}

junit-jupiter-api/src/main/java/org/junit/jupiter/api/extension/AfterEachExecutionExceptionHandler.java

@@ -15,15 +15,17 @@
 import org.apiguardian.api.API;
 
 /**
- * {@code AfterEachExecutionExceptionHandler} defines the API for {@link Extension Extensions} that wish to
- * handle exceptions thrown during execution of lifecycle methods annotated with {@code @AfterEach}.
+ * {@code AfterEachExecutionExceptionHandler} defines the API for
+ * {@link Extension Extensions} that wish to handle exceptions thrown during
+ * execution of lifecycle methods annotated with {@code @AfterEach}.
  *
- * <p>Common use cases include swallowing an exception if it's anticipated or rolling back a transaction
- * in certain error scenarios.
+ * <p>Common use cases include swallowing an exception if it's anticipated or
+ * rolling back a transaction in certain error scenarios.
  *
  * <h3>Constructor Requirements</h3>
  *
- * <p>Consult the documentation in {@link Extension} for details on constructor requirements.
+ * <p>Consult the documentation in {@link Extension} for details on constructor
+ * requirements.
  *
  * @see TestExecutionExceptionHandler
  * @see BeforeAllExecutionExceptionHandler
@@ -46,9 +48,11 @@ public interface AfterEachExecutionExceptionHandler extends Extension {
 	 * <li>Throw a new exception, potentially wrapping the supplied {@code throwable}.</li>
 	 * </ol>
 	 *
-	 * <p>If the supplied {@code throwable} is swallowed, subsequent {@code AfterEachExecutionExceptionHandler}
-	 * will not be invoked; otherwise, the next registered {@code AfterEachExecutionExceptionHandler} (if there is one)
-	 * will be invoked with any {@link Throwable} thrown by this handler.
+	 * <p>If the supplied {@code throwable} is swallowed, subsequent
+	 * {@code AfterEachExecutionExceptionHandler} will not be invoked;
+	 * otherwise, the next registered {@code AfterEachExecutionExceptionHandler}
+	 * (if there is one) will be invoked with any {@link Throwable} thrown by
+	 * this handler.
 	 *
 	 * @param context the current extension context; never {@code null}
 	 * @param throwable the {@code Throwable} to handle; never {@code null}

junit-jupiter-api/src/main/java/org/junit/jupiter/api/extension/BeforeAllExecutionExceptionHandler.java

@@ -15,17 +15,19 @@
 import org.apiguardian.api.API;
 
 /**
- * {@code BeforeAllExecutionExceptionHandler} defines the API for {@link Extension Extensions} that wish to
- * handle exceptions thrown during execution of lifecycle methods annotated with {@code @BeforeAll}.
+ * {@code BeforeAllExecutionExceptionHandler} defines the API for
+ * {@link Extension Extensions} that wish to handle exceptions thrown during
+ * execution of lifecycle methods annotated with {@code @BeforeAll}.
  *
- * <p>Common use cases include swallowing an exception if it's anticipated or rolling back a transaction
- * in certain error scenarios.
+ * <p>Common use cases include swallowing an exception if it's anticipated or
+ * rolling back a transaction in certain error scenarios.
  *
  * <p>This extension needs to be declared on a class level
  *
  * <h3>Constructor Requirements</h3>
  *
- * <p>Consult the documentation in {@link Extension} for details on constructor requirements.
+ * <p>Consult the documentation in {@link Extension} for details on constructor
+ * requirements.
  *
  * @see TestExecutionExceptionHandler
  * @see BeforeEachExecutionExceptionHandler
@@ -48,9 +50,11 @@ public interface BeforeAllExecutionExceptionHandler extends Extension {
 	 * <li>Throw a new exception, potentially wrapping the supplied {@code throwable}.</li>
 	 * </ol>
 	 *
-	 * <p>If the supplied {@code throwable} is swallowed, subsequent {@code BeforeAllExecutionExceptionHandler}
-	 * will not be invoked; otherwise, the next registered {@code BeforeAllExecutionExceptionHandler} (if there is one)
-	 * will be invoked with any {@link Throwable} thrown by this handler.
+	 * <p>If the supplied {@code throwable} is swallowed, subsequent
+	 * {@code BeforeAllExecutionExceptionHandler} will not be invoked;
+	 * otherwise, the next registered {@code BeforeAllExecutionExceptionHandler}
+	 * (if there is one) will be invoked with any {@link Throwable} thrown by
+	 * this handler.
 	 *
 	 * @param context the current extension context; never {@code null}
 	 * @param throwable the {@code Throwable} to handle; never {@code null}

junit-jupiter-api/src/main/java/org/junit/jupiter/api/extension/BeforeEachExecutionExceptionHandler.java

@@ -15,15 +15,17 @@
 import org.apiguardian.api.API;
 
 /**
- * {@code BeforeEachExecutionExceptionHandler} defines the API for {@link Extension Extensions} that wish to
- * handle exceptions thrown during execution of lifecycle methods annotated with {@code @BeforeEach}.
+ * {@code BeforeEachExecutionExceptionHandler} defines the API for
+ * {@link Extension Extensions} that wish to handle exceptions thrown during
+ * execution of lifecycle methods annotated with {@code @BeforeEach}.
  *
- * <p>Common use cases include swallowing an exception if it's anticipated or rolling back a transaction
- * in certain error scenarios.
+ * <p>Common use cases include swallowing an exception if it's anticipated or
+ * rolling back a transaction in certain error scenarios.
  *
  * <h3>Constructor Requirements</h3>
  *
- * <p>Consult the documentation in {@link Extension} for details on constructor requirements.
+ * <p>Consult the documentation in {@link Extension} for details on constructor
+ * requirements.
  *
  * @see TestExecutionExceptionHandler
  * @see BeforeAllExecutionExceptionHandler
@@ -41,13 +43,16 @@ public interface BeforeEachExecutionExceptionHandler extends Extension {
 	 *
 	 * <p>Implementors must perform one of the following.
 	 * <ol>
-	 * <li>Swallow the supplied {@code throwable}, thereby preventing propagation.</li>
+	 * <li>Swallow the supplied {@code throwable}, thereby preventing
+	 * propagation.</li>
 	 * <li>Rethrow the supplied {@code throwable} <em>as is</em>.</li>
 	 * <li>Throw a new exception, potentially wrapping the supplied {@code throwable}.</li>
 	 * </ol>
 	 *
-	 * <p>If the supplied {@code throwable} is swallowed, subsequent {@code BeforeEachExecutionExceptionHandler}
-	 * will not be invoked; otherwise, the next registered {@code BeforeEachExecutionExceptionHandler} (if there is one)
+	 * <p>If the supplied {@code throwable} is swallowed, subsequent
+	 * {@code BeforeEachExecutionExceptionHandler}
+	 * will not be invoked; otherwise, the next registered
+	 * {@code BeforeEachExecutionExceptionHandler} (if there is one)
 	 * will be invoked with any {@link Throwable} thrown by this handler.
 	 *
 	 * @param context the current extension context; never {@code null}