Polish Javadoc

Author: sbrannen

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

@@ -90,8 +90,7 @@ public interface ClassOrderer {
 	 * <pre class="code">
 	 * public void orderClasses(ClassOrdererContext context) {
 	 *     Collections.shuffle(context.getClassDescriptors());
-	 * }
-	 * </pre>
+	 * }</pre>
 	 *
 	 * @param context the {@code ClassOrdererContext} containing the
 	 * {@linkplain ClassDescriptor class descriptors} to order; never {@code null}

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

@@ -88,8 +88,7 @@ public interface MethodOrderer {
 	 * <pre class="code">
 	 * public void orderMethods(MethodOrdererContext context) {
 	 *     Collections.shuffle(context.getMethodDescriptors());
-	 * }
-	 * </pre>
+	 * }</pre>
 	 *
 	 * @param context the {@code MethodOrdererContext} containing the
 	 * {@linkplain MethodDescriptor method descriptors} to order; never {@code null}

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

@@ -57,8 +57,7 @@
  *     class SecondaryTests {
  *         // {@literal @}Test methods ...
  *     }
- * }
- * </pre>
+ * }</pre>
  *
  * @since 5.8
  * @see ClassOrderer

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

@@ -68,8 +68,7 @@ public interface TestInfo {
 	 *      class NestedTests {}
 	 *
 	 *      static class StaticTests {}
-	 *   }
-	 * </pre>
+	 *   }</pre>
 	 *
 	 * <p>If the context in which {@code TestInfo} is used is at the test level,
 	 * the default display name is the name of the test method concatenated with
@@ -79,8 +78,7 @@ public interface TestInfo {
 	 *
 	 * <pre class="code">
 	 *   {@literal @}Test
-	 *   void testUser(TestInfo testInfo, {@literal @}Mock User user) {}
-	 * </pre>
+	 *   void testUser(TestInfo testInfo, {@literal @}Mock User user) {}</pre>
 	 *
 	 * <p>Note that display names are typically used for test reporting in IDEs
 	 * and build tools and may contain spaces, special characters, and even emoji.

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

@@ -62,8 +62,7 @@
  *     {@literal @}Test
  *     {@literal @}Order(3)
  *     void validValues() {}
- * }
- * </pre>
+ * }</pre>
  *
  * <h2>Parallel Execution</h2>
  * <p>Using a {@link MethodOrderer} disables parallel execution unless the test

junit-jupiter-api/src/module/org.junit.jupiter.api/module-info.java

@@ -9,7 +9,9 @@
  */
 
 /**
- * Defines JUnit Jupiter API for writing tests.
+ * Defines the JUnit Jupiter API for writing tests.
+ *
+ * @since 5.0
  */
 module org.junit.jupiter.api {
 	requires static transitive org.apiguardian.api;

junit-jupiter-engine/src/module/org.junit.jupiter.engine/module-info.java

@@ -9,7 +9,7 @@
  */
 
 /**
- * Provides the JUnit Jupiter {@linkplain org.junit.platform.engine.TestEngine}
+ * Provides the JUnit Jupiter {@link org.junit.platform.engine.TestEngine}
  * implementation.
  *
  * @since 5.0

junit-platform-commons/src/main/java/org/junit/platform/commons/util/CollectionUtils.java

@@ -126,8 +126,7 @@ public static <T> Set<T> toSet(T[] values) {
 	 * <pre class="code">
 	 * public static &lt;T&gt; Collector&lt;T, ?, List&lt;T&gt;&gt; toUnmodifiableList(Supplier&lt;List&lt;T&gt;&gt; listSupplier) {
 	 *     return Collectors.collectingAndThen(Collectors.toCollection(listSupplier), Collections::unmodifiableList);
-	 * }
-	 * </pre>
+	 * }</pre>
 	 *
 	 * @param <T> the type of the input elements
 	 * @return a {@code Collector} which collects all the input elements into

junit-platform-engine/src/module/org.junit.platform.engine/module-info.java

@@ -11,8 +11,8 @@
 /**
  * Public API for test engines.
  *
- * <p>Provides the {@linkplain org.junit.platform.engine.TestEngine} interface, test discovery
- * and execution reporting support.
+ * <p>Provides the {@link org.junit.platform.engine.TestEngine} interface,
+ * test discovery, and execution reporting support.
  *
  * @since 1.0
  */

junit-platform-launcher/src/main/java/org/junit/platform/launcher/core/LauncherDiscoveryRequestBuilder.java

@@ -78,8 +78,7 @@
  *     )
  *     .configurationParameter("key1", "value1")
  *     .configurationParameters(configParameterMap)
- *     .build();
- * </pre>
+ *     .build();</pre>
  *
  * @since 1.0
  * @see org.junit.platform.engine.discovery.DiscoverySelectors