[commons-email] branch master updated: Update provenance as comment.

[ggregory]

This is an automated email from the ASF dual-hosted git repository.

ggregory pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-email.git


The following commit(s) were added to refs/heads/master by this push:
     new f679511  Update provenance as comment.
f679511 is described below

commit f679511dae2e89607ee6e6a45d1bdd32736012ca
Author: Gary Gregory <garydgreg...@gmail.com>
AuthorDate: Tue Aug 30 11:16:51 2022 -0400

    Update provenance as comment.
---
 .../java/org/apache/commons/mail/EmailUtils.java   | 33 ++++++++++------------
 1 file changed, 15 insertions(+), 18 deletions(-)

diff --git a/src/main/java/org/apache/commons/mail/EmailUtils.java 
b/src/main/java/org/apache/commons/mail/EmailUtils.java
index d97435a..a9fb1fe 100644
--- a/src/main/java/org/apache/commons/mail/EmailUtils.java
+++ b/src/main/java/org/apache/commons/mail/EmailUtils.java
@@ -111,12 +111,12 @@ final class EmailUtils
 
     /**
      * Checks if a String is empty ("") or null.
+     * <p>
+     * Copied from Commons Lang v2.1, svn 240418
+     * <p>
      *
      * @param str the String to check, may be null
-     *
      * @return {@code true} if the String is empty or null
-     *
-     * @since Commons Lang v2.1, svn 240418
      */
     static boolean isEmpty(final String str)
     {
@@ -125,12 +125,12 @@ final class EmailUtils
 
     /**
      * Checks if a String is not empty ("") and not null.
+     * <p>
+     * Copied from Commons Lang v2.1, svn 240418
+     * <p>
      *
      * @param str the String to check, may be null
-     *
      * @return {@code true} if the String is not empty and not null
-     *
-     * @since Commons Lang v2.1, svn 240418
      */
     static boolean isNotEmpty(final String str)
     {
@@ -140,13 +140,13 @@ final class EmailUtils
     /**
      * Validate an argument, throwing {@code IllegalArgumentException}
      * if the argument is {@code null}.
+     * <p>
+     * Copied from Commons Lang v2.1, svn 201930
+     * <p>
      *
      * @param object the object to check is not {@code null}
      * @param message the exception message you would like to see if the 
object is {@code null}
-     *
      * @throws IllegalArgumentException if the object is {@code null}
-     *
-     * @since Commons Lang v2.1, svn 201930
      */
     static void notNull(final Object object, final String message)
     {
@@ -158,16 +158,14 @@ final class EmailUtils
 
     /**
      * Creates a random string whose length is the number of characters 
specified.
-     *
      * <p>
      * Characters will be chosen from the set of alphabetic characters.
      * </p>
-     *
+     * <p>
+     * Copied from Commons Lang v2.1, svn 201930
+     * </p>
      * @param count the length of random string to create
-     *
      * @return the random string
-     *
-     * @since Commons Lang v2.1, svn 201930
      */
     static String randomAlphabetic(final int count)
     {
@@ -192,6 +190,9 @@ final class EmailUtils
      * single {@link Random} instance with a fixed seed and using it for each 
call, the same random sequence of strings
      * can be generated repeatedly and predictably.
      * </p>
+     * <p>
+     * Copied from Commons Lang v2.1, svn 201930
+     * </p>
      *
      * @param count the length of random string to create
      * @param start the position in set of chars to start at
@@ -201,12 +202,8 @@ final class EmailUtils
      * @param chars the set of chars to choose randoms from. If {@code null},
      *              then it will use the set of all chars.
      * @param random a source of randomness.
-     *
      * @return the random string
-     *
      * @throws IllegalArgumentException if {@code count} &lt; 0.
-     *
-     * @since Commons Lang v2.1, svn 201930
      */
     private static String random(
         int count,