diff --git a/src/main/java/org/apache/commons/math4/util/CombinatoricsUtils.java b/src/main/java/org/apache/commons/math4/util/CombinatoricsUtils.java
index ea5a54056..33ad2552c 100644
--- a/src/main/java/org/apache/commons/math4/util/CombinatoricsUtils.java
+++ b/src/main/java/org/apache/commons/math4/util/CombinatoricsUtils.java
@@ -72,7 +72,7 @@ public final class CombinatoricsUtils {
*
The result is small enough to fit into a {@code long}. The
* largest value of {@code n} for which all coefficients are
* {@code < Long.MAX_VALUE} is 66. If the computed value exceeds
- * {@code Long.MAX_VALUE} an {@code ArithMeticException} is
+ * {@code Long.MAX_VALUE} a {@code MathArithMeticException} is
* thrown.
*
*
@@ -199,7 +199,7 @@ public final class CombinatoricsUtils {
* Preconditions:
*
* - {@code 0 <= k <= n } (otherwise
- * {@code IllegalArgumentException} is thrown)
+ * {@code MathIllegalArgumentException} is thrown)
*
*
* @param n the size of the set
@@ -265,12 +265,12 @@ public final class CombinatoricsUtils {
*
* Preconditions:
*
- * - {@code n >= 0} (otherwise
- * {@code IllegalArgumentException} is thrown)
+ * - {@code n ≥ 0} (otherwise
+ * {@code MathIllegalArgumentException} is thrown)
* - The result is small enough to fit into a {@code long}. The
- * largest value of {@code n} for which {@code n!} <
+ * largest value of {@code n} for which {@code n!} does not exceed
* Long.MAX_VALUE} is 20. If the computed value exceeds {@code Long.MAX_VALUE}
- * an {@code ArithMeticException } is thrown.
+ * an {@code MathArithMeticException } is thrown.
*
*
*
@@ -298,9 +298,9 @@ public final class CombinatoricsUtils {
* factorial of {@code n} (the product of the numbers 1 to n), as a
* {@code double}.
* The result should be small enough to fit into a {@code double}: The
- * largest {@code n} for which {@code n! < Double.MAX_VALUE} is 170.
- * If the computed value exceeds {@code Double.MAX_VALUE},
- * {@code Double.POSITIVE_INFINITY} is returned.
+ * largest {@code n} for which {@code n!} does not exceed
+ * {@code Double.MAX_VALUE} is 170. If the computed value exceeds
+ * {@code Double.MAX_VALUE}, {@code Double.POSITIVE_INFINITY} is returned.
*
* @param n Argument.
* @return {@code n!}
@@ -321,7 +321,7 @@ public final class CombinatoricsUtils {
* Compute the natural logarithm of the factorial of {@code n}.
*
* @param n Argument.
- * @return {@code n!}
+ * @return {@code log(n!)}
* @throws NotPositiveException if {@code n < 0}.
*/
public static double factorialLog(final int n) throws NotPositiveException {
@@ -422,11 +422,11 @@ public final class CombinatoricsUtils {
* they are visited in lexicographic order with significance from right to
* left. For example, combinationsIterator(4, 2) returns an Iterator that
* will generate the following sequence of arrays on successive calls to
- * {@code next()}:
+ * {@code next()}:
* {@code [0, 1], [0, 2], [1, 2], [0, 3], [1, 3], [2, 3]}
- *
+ *
* If {@code k == 0} an Iterator containing an empty array is returned and
- * if {@code k == n} an Iterator containing [0, ..., n -1] is returned.
+ * if {@code k == n} an Iterator containing [0, ..., n -1] is returned.
*
* @param n Size of the set from which subsets are selected.
* @param k Size of the subsets to be enumerated.
@@ -515,9 +515,9 @@ public final class CombinatoricsUtils {
* Creates an instance with the specified cache size.
*
* @param cacheSize Number of precomputed values of the function.
- * @return an new instance where {@code cacheSize} values have been
+ * @return a new instance where {@code cacheSize} values have been
* precomputed.
- * @throw NotPositiveException if {@code n < 0}.
+ * @throws NotPositiveException if {@code n < 0}.
*/
public FactorialLog withCache(final int cacheSize) {
return new FactorialLog(cacheSize, LOG_FACTORIALS);