Remove redundant paragraph tags in JavaDoc comments. (#42)

Author: devopsix

assertj-mail/src/main/java/org/devopsix/assertj/mail/AbstractPartAssert.java

@@ -21,7 +21,7 @@ protected AbstractPartAssert(A part, Class<? extends AbstractPartAssert<S, A>> s
   }
 
   /**
-   * <p>Returns a {@code String} assertion for the message part's header with the given name.</p>
+   * Returns a {@code String} assertion for the message part's header with the given name.
    *
    * @param name Header name
    * @return An assertion for the message part's given header
@@ -32,8 +32,8 @@ public AbstractCharSequenceAssert<?, String> headerValue(String name) {
   }
 
   /**
-   * <p>Returns a {@code String} array assertion for the message part's header with the given
-   * name.</p>
+   * Returns a {@code String} array assertion for the message part's header with the given
+   * name.
    *
    * @param name Header name
    * @return An assertion for the message part's given header
@@ -43,8 +43,8 @@ public AbstractObjectArrayAssert<?, String> headerValues(String name) {
   }
 
   /**
-   * <p>Returns a {@code OffsetDateTime} assertion for the message part's header with the given
-   * name.</p>
+   * Returns a {@code OffsetDateTime} assertion for the message part's header with the given
+   * name.
    *
    * @param name Header name
    * @return An assertion for the message part's given header
@@ -56,8 +56,8 @@ public AbstractOffsetDateTimeAssert<?> dateHeaderValue(String name) {
   }
 
   /**
-   * <p>Returns a {@code OffsetDateTime} array assertion for the message part's header with the
-   * given name.</p>
+   * Returns a {@code OffsetDateTime} array assertion for the message part's header with the
+   * given name.
    *
    * @param name Header name
    * @return An assertion for the message part's given header
@@ -68,7 +68,7 @@ public AbstractObjectArrayAssert<?, OffsetDateTime> dateHeaderValues(String name
   }
 
   /**
-   * <p>Returns a {@code String} assertion for the message part's plain text content.</p>
+   * Returns a {@code String} assertion for the message part's plain text content.
    *
    * @return An assertion for the message part's text content
    * @throws AssertionError If the content is not plain text or reading it fails
@@ -78,7 +78,7 @@ public AbstractCharSequenceAssert<?, String> textContent() {
   }
 
   /**
-   * <p>Returns a {@code byte[]} assertion for the message part's binary content.</p>
+   * Returns a {@code byte[]} assertion for the message part's binary content.
    *
    * @return An assertion for the message part's binary content
    * @throws AssertionError If the content is not binary content or reading it fails
@@ -88,7 +88,7 @@ public AbstractByteArrayAssert<?> binaryContent() {
   }
 
   /**
-   * <p>Asserts that the message part has multipart content ({@code Content-Type: multipart/*}).</p>
+   * Asserts that the message part has multipart content ({@code Content-Type: multipart/*}).
    *
    * @return The original assertion for further chaining
    * @throws AssertionError If the content is not multipart content or reading it fails
@@ -101,8 +101,8 @@ public S isMultipart() {
   }
 
   /**
-   * <p>Returns a {@code Multipart} assertion for the message part's multipart content
-   * ({@code Content-Type: multipart/*}).</p>
+   * Returns a {@code Multipart} assertion for the message part's multipart content
+   * ({@code Content-Type: multipart/*}).
    *
    * @return An assertion for the message part's multipart content
    * @throws AssertionError If the content is not multipart content or reading it fails
@@ -112,8 +112,8 @@ public MultipartAssert multipartContent() {
   }
 
   /**
-   * <p>Returns a {@code Multipart} array assertion for all the message part's multipart contents
-   * ({@code Content-Type: multipart/*}). Multipart contents are searched recursively.</p>
+   * Returns a {@code Multipart} array assertion for all the message part's multipart contents
+   * ({@code Content-Type: multipart/*}). Multipart contents are searched recursively.
    *
    * <p>Please note that no assertion error occurs if the message part is not of multipart type.
    * The returned assertion contains an empty array in this case.</p>

assertj-mail/src/main/java/org/devopsix/assertj/mail/DkimSignatureAssert.java

@@ -34,7 +34,7 @@ private DkimSignatureAssert(Part message, Map<String, String> publicKeys) {
   }
 
   /**
-   * <p>Creates a new instance.</p>
+   * Creates a new instance.
    *
    * @param message Assertion subject
    * @param publicKeys Map of public keys as they would be published in DNS TXT records
@@ -45,7 +45,7 @@ public static DkimSignatureAssert assertThat(Part message, Map<String, String> p
   }
 
   /**
-   * <p>Asserts that the DKIM signature is valid.</p>
+   * Asserts that the DKIM signature is valid.
    *
    * @return The original assertion for further chaining
    * @throws AssertionError If the DKIM signature is not valid
@@ -63,7 +63,7 @@ public DkimSignatureAssert isValid() {
   }
 
   /**
-   * <p>Returns a {@code SignatureRecord} array assertion for the signature's records.</p>
+   * Returns a {@code SignatureRecord} array assertion for the signature's records.
    *
    * @return An assertion for the DKIM signature's records
    * @throws AssertionError If validating the signature fails

assertj-mail/src/main/java/org/devopsix/assertj/mail/InternetAddressAssert.java

@@ -13,7 +13,7 @@ public final class InternetAddressAssert
     extends AbstractAssert<InternetAddressAssert, InternetAddress> {
 
   /**
-   * <p>Creates a new instance.</p>
+   * Creates a new instance.
    *
    * @param internetAddress Assertion subject
    */
@@ -22,8 +22,8 @@ public InternetAddressAssert(InternetAddress internetAddress) {
   }
 
   /**
-   * <p>Returns a {@code String} assertion for the internet address' actual address part.
-   * I.e. “[email protected]” in {@code "Anna <[email protected]>"}</p>
+   * Returns a {@code String} assertion for the internet address' actual address part.
+   * I.e. “[email protected]” in {@code "Anna <[email protected]>"}
    *
    * @return An assertion for the address part
    */
@@ -32,8 +32,8 @@ public AbstractCharSequenceAssert<?, String> address() {
   }
 
   /**
-   * <p>Returns a {@code String} assertion for the internet address' personal name part.
-   * I.e. “Anna” in {@code "Anna <[email protected]>"}.</p>
+   * Returns a {@code String} assertion for the internet address' personal name part.
+   * I.e. “Anna” in {@code "Anna <[email protected]>"}.
    *
    * @return An assertion for the name part
    */

assertj-mail/src/main/java/org/devopsix/assertj/mail/MailAssertions.java

@@ -8,39 +8,39 @@
 import org.assertj.core.api.InstanceOfAssertFactory;
 
 /**
- * <p>This class provides access to all AssertJ Mail assertions.</p>
+ * This class provides access to all AssertJ Mail assertions.
  */
 public final class MailAssertions {
 
   private MailAssertions() {
   }
 
   /**
-   * <p>A factory for creating instances of {@link MessageAssert}.</p>
+   * A factory for creating instances of {@link MessageAssert}.
    *
    * @see Assertions#as(InstanceOfAssertFactory)
    */
   public static final InstanceOfAssertFactory<Message, MessageAssert> MESSAGE =
       new InstanceOfAssertFactory<>(Message.class, MailAssertions::assertThat);
 
   /**
-   * <p>A factory for creating instances of {@link PartAssert}.</p>
+   * A factory for creating instances of {@link PartAssert}.
    *
    * @see Assertions#as(InstanceOfAssertFactory)
    */
   public static final InstanceOfAssertFactory<Part, PartAssert> PART =
       new InstanceOfAssertFactory<>(Part.class, MailAssertions::assertThat);
 
   /**
-   * <p>A factory for creating instances of {@link MultipartAssert}.</p>
+   * A factory for creating instances of {@link MultipartAssert}.
    *
    * @see Assertions#as(InstanceOfAssertFactory)
    */
   public static final InstanceOfAssertFactory<Multipart, MultipartAssert> MULTIPART =
       new InstanceOfAssertFactory<>(Multipart.class, MailAssertions::assertThat);
 
   /**
-   * <p>A factory for creating instances of {@link InternetAddressAssert}.</p>
+   * A factory for creating instances of {@link InternetAddressAssert}.
    *
    * @see Assertions#as(InstanceOfAssertFactory)
    */
@@ -49,8 +49,8 @@ private MailAssertions() {
       new InstanceOfAssertFactory<>(InternetAddress.class, MailAssertions::assertThat);
 
   /**
-   * <p>Returns an instance of {@code MessageAssert} which can be used to verify assertions
-   * for the given message.</p>
+   * Returns an instance of {@code MessageAssert} which can be used to verify assertions
+   * for the given message.
    *
    * @param message The message to assert
    * @return An instance of {@code MessageAssert} for the given message
@@ -60,8 +60,8 @@ public static MessageAssert assertThat(Message message) {
   }
 
   /**
-   * <p>Returns an instance of {@code PartAssert} which can be used to verify assertions
-   * for the given message part.</p>
+   * Returns an instance of {@code PartAssert} which can be used to verify assertions
+   * for the given message part.
    *
    * @param part The message part to assert
    * @return An instance of {@code PartAssert} for the given message
@@ -71,8 +71,8 @@ public static PartAssert assertThat(Part part) {
   }
 
   /**
-   * <p>Returns an instance of {@code MultipartAssert} which can be used to verify assertions
-   * for the given multipart.</p>
+   * Returns an instance of {@code MultipartAssert} which can be used to verify assertions
+   * for the given multipart.
    *
    * @param multipart The multipart to assert
    * @return An instance of {@code MultipartAssert} for the given multipart
@@ -82,8 +82,8 @@ public static MultipartAssert assertThat(Multipart multipart) {
   }
 
   /**
-   * <p>Returns an instance of {@code InternetAddressAssert} which can be used to verify assertions
-   * for the given internet address.</p>
+   * Returns an instance of {@code InternetAddressAssert} which can be used to verify assertions
+   * for the given internet address.
    *
    * @param address The internet address to assert
    * @return An instance of {@code InternetAddressAssert} for the given message

assertj-mail/src/main/java/org/devopsix/assertj/mail/MailDateTimeFormatter.java

@@ -21,8 +21,8 @@
 import java.util.regex.Pattern;
 
 /**
- * <p>This class supplies a date time formatter relaxed enough to read both,
- * RFC 822 (two-digit year) and RFC 2822/1123 (four-digit year) notation.</p>
+ * This class supplies a date time formatter relaxed enough to read both,
+ * RFC 822 (two-digit year) and RFC 2822/1123 (four-digit year) notation.
  *
  * @author devopsix
  */
@@ -94,7 +94,7 @@ private static Map<Long, String> monthNames() {
   private static final Pattern TRAILING_ZONE = compile("\\s+\\([^(]+\\)\\s*$");
 
   /**
-   * <p>Trims trailing time zone name in parentheses after the zone offset.</p>
+   * Trims trailing time zone name in parentheses after the zone offset.
    *
    * <p>Some mailer programs seem to append the zone name although that is not covered by the
    * RFCs.</p>

assertj-mail/src/main/java/org/devopsix/assertj/mail/MessageAssert.java

@@ -24,7 +24,7 @@
 public final class MessageAssert extends AbstractPartAssert<MessageAssert, Message> {
 
   /**
-   * <p>Creates a new instance.</p>
+   * Creates a new instance.
    *
    * @param message Assertion subject
    */
@@ -33,7 +33,7 @@ public MessageAssert(Message message) {
   }
 
   /**
-   * <p>Returns a {@code OffsetDateTime} assertion for the message's “Date” header.</p>
+   * Returns a {@code OffsetDateTime} assertion for the message's “Date” header.
    *
    * @return An assertion for the message's “Date” header
    * @throws AssertionError If there is more than one “Date” header or parsing the header value
@@ -44,7 +44,7 @@ public AbstractOffsetDateTimeAssert<?> date() {
   }
 
   /**
-   * <p>Returns an {@code InternetAddress} array assertion for the message's “From” header.</p>
+   * Returns an {@code InternetAddress} array assertion for the message's “From” header.
    *
    * @return An assertion for the message's “From” header
    * @throws AssertionError If there is more than one “From” header or parsing the header value
@@ -55,7 +55,7 @@ public AbstractObjectArrayAssert<?, InternetAddress> from() {
   }
 
   /**
-   * <p>Returns an {@code InternetAddress} assertion for the message's “Sender” header.</p>
+   * Returns an {@code InternetAddress} assertion for the message's “Sender” header.
    *
    * @return An assertion for the message's “Sender” header
    * @throws AssertionError If there is more than one “Sender” header or parsing the header value
@@ -66,7 +66,7 @@ public InternetAddressAssert sender() {
   }
 
   /**
-   * <p>Returns an {@code InternetAddress} array assertion for the message's “Reply-To” header.</p>
+   * Returns an {@code InternetAddress} array assertion for the message's “Reply-To” header.
    *
    * @return An assertion for the message's “Reply-To” header
    * @throws AssertionError If there is more than one “Reply-To” header or parsing the header value
@@ -77,7 +77,7 @@ public AbstractObjectArrayAssert<?, InternetAddress> replyTo() {
   }
 
   /**
-   * <p>Returns an {@code InternetAddress} array assertion for the message's “To” header.</p>
+   * Returns an {@code InternetAddress} array assertion for the message's “To” header.
    *
    * @return An assertion for the message's “To” header
    * @throws AssertionError If there is more than one “To” header or parsing the header value fails
@@ -87,7 +87,7 @@ public AbstractObjectArrayAssert<?, InternetAddress> to() {
   }
 
   /**
-   * <p>Returns an {@code InternetAddress} array assertion for the message's “Cc” header.</p>
+   * Returns an {@code InternetAddress} array assertion for the message's “Cc” header.
    *
    * @return An assertion for the message's “Cc” header
    * @throws AssertionError If there is more than one “Cc” header or parsing the header value fails
@@ -97,7 +97,7 @@ public AbstractObjectArrayAssert<?, InternetAddress> cc() {
   }
 
   /**
-   * <p>Returns an {@code InternetAddress} array assertion for the message's “Bcc” header.</p>
+   * Returns an {@code InternetAddress} array assertion for the message's “Bcc” header.
    *
    * @return An assertion for the message's “Bcc” header
    * @throws AssertionError If there is more than one “Bcc” header or parsing the header value fails
@@ -107,7 +107,7 @@ public AbstractObjectArrayAssert<?, InternetAddress> bcc() {
   }
 
   /**
-   * <p>Returns a {@code String} assertion for the message's “Subject” header.</p>
+   * Returns a {@code String} assertion for the message's “Subject” header.
    *
    * @return An assertion for the message's “Subject” header
    * @throws AssertionError If there is more than one “Subject” header
@@ -117,7 +117,7 @@ public AbstractCharSequenceAssert<?, String> subject() {
   }
 
   /**
-   * <p>Returns a {@code DkimSignatureAssert} assertion for the message's DKIM signature.</p>
+   * Returns a {@code DkimSignatureAssert} assertion for the message's DKIM signature.
    *
    * <p>DKIM public keys are distributed as DNS TXT records. As tests should not depend
    * on any real DNS records this method accepts a map of virtual TXT records. The map keys

assertj-mail/src/main/java/org/devopsix/assertj/mail/MultipartAssert.java

@@ -15,7 +15,7 @@ public final class MultipartAssert extends AbstractAssert<MultipartAssert, Multi
   private final MultipartReader multipartReader;
 
   /**
-   * <p>Creates a new instance.</p>
+   * Creates a new instance.
    *
    * @param multipart Assertion subject
    */
@@ -25,7 +25,7 @@ public MultipartAssert(Multipart multipart) {
   }
 
   /**
-   * <p>Returns a {@code String} assertion for the multipart's content type.</p>
+   * Returns a {@code String} assertion for the multipart's content type.
    *
    * @return An assertion for the multipart's content type
    */
@@ -34,7 +34,7 @@ public AbstractCharSequenceAssert<?, String> contentType() {
   }
 
   /**
-   * <p>Returns an {@code BodyPart} array assertion for the multipart's parts.</p>
+   * Returns an {@code BodyPart} array assertion for the multipart's parts.
    *
    * @return An assertion for the multipart's parts
    * @throws AssertionError If reading the parts fails

assertj-mail/src/main/java/org/devopsix/assertj/mail/PartAssert.java

@@ -8,7 +8,7 @@
 public final class PartAssert extends AbstractPartAssert<PartAssert, Part> {
 
   /**
-   * <p>Creates a new instance.</p>
+   * Creates a new instance.
    *
    * @param part Assertion subject
    */

examples-jakarta/src/test/java/examples/GreenMailExampleTest.java

@@ -20,8 +20,8 @@
 import static org.assertj.core.api.Assertions.as;
 
 /**
- * <p>This class demonstrates how the AssertJ Mail assertions can be used together
- * with GreenMail for verifying an email sent by an application.</p>
+ * This class demonstrates how the AssertJ Mail assertions can be used together
+ * with GreenMail for verifying an email sent by an application.
  *
  * <p><a href="https://greenmail-mail-test.github.io/greenmail/">GreenMail</a> is an email server for testing purposes.</p>
  *