Fix JavaDoc grammar issues (#1246)

* Remove dangling JavaDoc

* Fix grammar issues

---------

Co-authored-by: David Szigecsan <david.szigecsan@sagemcom.com>

src/main/java/org/apache/commons/lang3/ArrayUtils.java

@@ -3240,7 +3240,7 @@ public class ArrayUtils {
     }
 
     /**
-     * Compares two arrays, using equals(), handling multi-dimensional arrays
+     * Compares two arrays, using equals(), handling multidimensional arrays
      * correctly.
      * <p>
      * Multi-dimensional primitive arrays are also handled correctly by this method.

src/main/java/org/apache/commons/lang3/BooleanUtils.java

@@ -960,7 +960,7 @@ public class BooleanUtils {
     }
 
     /**
-     * Converts a Boolean to a Integer using the convention that
+     * Converts a Boolean to an Integer using the convention that
      * {@code zero} is {@code false}.
      *
      * <p>{@code null} will be converted to {@code null}.</p>

src/main/java/org/apache/commons/lang3/Range.java

@@ -289,7 +289,7 @@ public class Range<T> implements Serializable {
     }
 
     /**
-     * Compares this range to another object to test if they are equal..
+     * Compares this range to another object to test if they are equal.
      *
      * <p>To be equal, the minimum and maximum values must be equal, which
      * ignores any differences in the comparator.</p>

src/main/java/org/apache/commons/lang3/StringUtils.java

@@ -1742,7 +1742,7 @@ public class StringUtils {
     }
 
     /**
-     * Check if a CharSequence ends with a specified suffix (optionally case insensitive).
+     * Check if a CharSequence ends with a specified suffix (optionally case-insensitive).
      *
      * @see String#endsWith(String)
      * @param str  the CharSequence to check, may be null
@@ -1797,7 +1797,7 @@ public class StringUtils {
     }
 
     /**
-     * Case insensitive check if a CharSequence ends with a specified suffix.
+     * Case-insensitive check if a CharSequence ends with a specified suffix.
      *
      * <p>{@code null}s are handled without exceptions. Two {@code null}
      * references are considered to be equal. The comparison is case insensitive.</p>
@@ -5958,7 +5958,7 @@ public class StringUtils {
     }
 
     /**
-     * Case insensitive removal of a substring if it is at the end of a source string,
+     * Case-insensitive removal of a substring if it is at the end of a source string,
      * otherwise returns the source string.
      *
      * <p>A {@code null} source string will return {@code null}.
@@ -6043,7 +6043,7 @@ public class StringUtils {
     }
 
     /**
-     * Case insensitive removal of all occurrences of a substring from within
+     * Case-insensitive removal of all occurrences of a substring from within
      * the source string.
      *
      * <p>
@@ -6178,7 +6178,7 @@ public class StringUtils {
     }
 
     /**
-     * Case insensitive removal of a substring if it is at the beginning of a source string,
+     * Case-insensitive removal of a substring if it is at the beginning of a source string,
      * otherwise returns the source string.
      *
      * <p>A {@code null} source string will return {@code null}.
@@ -8024,7 +8024,7 @@ public class StringUtils {
     }
 
     /**
-     * Check if a CharSequence starts with a specified prefix (optionally case insensitive).
+     * Check if a CharSequence starts with a specified prefix (optionally case-insensitive).
      *
      * @see String#startsWith(String)
      * @param str  the CharSequence to check, may be null
@@ -8081,7 +8081,7 @@ public class StringUtils {
     }
 
     /**
-     * Case insensitive check if a CharSequence starts with a specified prefix.
+     * Case-insensitive check if a CharSequence starts with a specified prefix.
      *
      * <p>{@code null}s are handled without exceptions. Two {@code null}
      * references are considered to be equal. The comparison is case insensitive.</p>
@@ -9013,10 +9013,10 @@ public class StringUtils {
     }
 
     /**
-     * Converts the given source String as a upper-case using the {@link Locale#ROOT} locale in a null-safe manner.
+     * Converts the given source String as an upper-case using the {@link Locale#ROOT} locale in a null-safe manner.
      *
      * @param source A source String or null.
-     * @return the given source String as a upper-case using the {@link Locale#ROOT} locale or null.
+     * @return the given source String as an upper-case using the {@link Locale#ROOT} locale or null.
      * @since 3.10
      */
     public static String toRootUpperCase(final String source) {

src/main/java/org/apache/commons/lang3/SystemProperties.java

@@ -2456,26 +2456,6 @@ public final class SystemProperties {
         return getProperty(JAVA_UTIL_LOGGING_CONFIG_FILE);
     }
 
-    /**
-     * Gets the current value from the system properties map.
-     * <p>
-     * Returns {@code null} if the property cannot be read due to a {@link SecurityException}.
-     * </p>
-     *
-     * @return the current value from the system properties map.
-     * @since 3.15.0
-     */
-
-    /**
-     * Gets the current value from the system properties map.
-     * <p>
-     * Returns {@code null} if the property cannot be read due to a {@link SecurityException}.
-     * </p>
-     *
-     * @return the current value from the system properties map.
-     * @since 3.15.0
-     */
-
     /**
      * Gets the current value from the system properties map.
      * <p>

src/main/java/org/apache/commons/lang3/builder/EqualsBuilder.java

@@ -1033,7 +1033,7 @@ public class EqualsBuilder implements Builder<Boolean> {
 
     /**
      * Sets {@link Class}es whose instances should be compared by calling their {@code equals}
-     * although being in recursive mode. So the fields of theses classes will not be compared recursively by reflection.
+     * although being in recursive mode. So the fields of these classes will not be compared recursively by reflection.
      *
      * <p>Here you should name classes having non-transient fields which are cache fields being set lazily.<br>
      * Prominent example being {@link String} class with its hash code cache field. Due to the importance

src/main/java/org/apache/commons/lang3/concurrent/ConcurrentUtils.java

@@ -25,7 +25,7 @@ import org.apache.commons.lang3.Validate;
 import org.apache.commons.lang3.exception.ExceptionUtils;
 
 /**
- * An utility class providing functionality related to the {@code
+ * A utility class providing functionality related to the {@code
  * java.util.concurrent} package.
  *
  * @since 3.0

src/main/java/org/apache/commons/lang3/function/TriConsumer.java

@@ -23,7 +23,7 @@ import java.util.function.Consumer;
 /**
  * Represents an operation that accepts three input arguments and returns no result. This is the three-arity
  * specialization of {@link Consumer}. Unlike most other functional interfaces, {@link TriConsumer} is expected to
- * operate via side-effects.
+ * operate via side effects.
  *
  * <p>
  * This is a {@link FunctionalInterface} whose functional method is {@link #accept(Object, Object, Object)}.

src/main/java/org/apache/commons/lang3/math/Fraction.java

@@ -612,7 +612,7 @@ public final class Fraction extends Number implements Comparable<Fraction> {
     }
 
     /**
-     * Compares this fraction to another object to test if they are equal..
+     * Compares this fraction to another object to test if they are equal.
      *
      * <p>To be equal, both values must be equal. Thus 2/4 is not equal to 1/2.</p>
      *

src/main/java/org/apache/commons/lang3/time/DateUtils.java

@@ -1229,7 +1229,7 @@ public class DateUtils {
                 final int max = val.getActualMaximum(aField[0]);
                 //Calculate the offset from the minimum allowed value
                 offset = val.get(aField[0]) - min;
-                //Set roundUp if this is more than half way between the minimum and maximum
+                //Set roundUp if this is more than halfway between the minimum and maximum
                 roundUp = offset > (max - min) / 2;
             }
             //We need to remove this field
@@ -1282,7 +1282,7 @@ public class DateUtils {
 
     /**
      * Parses a string representing a date by trying a variety of different parsers,
-     * using the default date format symbols for the given locale..
+     * using the default date format symbols for the given locale.
      *
      * <p>The parse will try each parse pattern in turn.
      * A parse is only deemed successful if it parses the whole of the input string.