Javadoc: More precise generic type documentation

Author: garydgregory

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

@@ -22,7 +22,7 @@
 /**
  * Abstracts supplying an instance of {@code T}. Use to implement the builder pattern.
  *
- * @param <T> the type of instances to build.
+ * @param <T> The type of results supplied by this supplier.
  * @param <B> the type of builder.
  * @param <E> The kind of thrown exception or error.
  * @since 3.14.0

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

@@ -36,9 +36,9 @@ public abstract class AbstractConcurrentInitializer<T, E extends Exception> impl
     /**
      * Builds a new instance for subclasses.
      *
-     * @param <T> the type of the object managed by the initializer class.
-     * @param <I> the type of the initializer class.
-     * @param <B> the type of builder.
+     * @param <I> The type of results supplied by this builder.
+     * @param <T> The type of the object managed by the initializer class.
+     * @param <B> The type of builder.
      * @param <E> The exception type thrown by {@link #initialize()}.
      */
     public abstract static class AbstractBuilder<I extends AbstractConcurrentInitializer<T, E>, T, B extends AbstractBuilder<I, T, B, E>, E extends Exception>

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

@@ -70,8 +70,8 @@ public class AtomicInitializer<T> extends AbstractConcurrentInitializer<T, Concu
     /**
      * Builds a new instance.
      *
-     * @param <T> the type of the object managed by the initializer.
-     * @param <I> the type of the initializer managed by this builder.
+     * @param <T> The type of results supplied by this builder.
+     * @param <I> The type of the initializer managed by this builder.
      * @since 3.14.0
      */
     public static class Builder<I extends AtomicInitializer<T>, T> extends AbstractBuilder<I, T, Builder<I, T>, ConcurrentException> {

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

@@ -59,8 +59,8 @@ public class AtomicSafeInitializer<T> extends AbstractConcurrentInitializer<T, C
     /**
      * Builds a new instance.
      *
-     * @param <T> the type of the object managed by the initializer.
-     * @param <I> the type of the initializer managed by this builder.
+     * @param <T> The type of results supplied by this builder.
+     * @param <I> The type of the initializer managed by this builder.
      * @since 3.14.0
      */
     public static class Builder<I extends AtomicSafeInitializer<T>, T> extends AbstractBuilder<I, T, Builder<I, T>, ConcurrentException> {

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

@@ -90,8 +90,8 @@ public class BackgroundInitializer<T> extends AbstractConcurrentInitializer<T, E
     /**
      * Builds a new instance.
      *
-     * @param <T> the type of the object managed by the initializer.
-     * @param <I> the type of the initializer managed by this builder.
+     * @param <T> The type of results supplied by this builder.
+     * @param <I> The type of the initializer managed by this builder.
      * @since 3.14.0
      */
     public static class Builder<I extends BackgroundInitializer<T>, T> extends AbstractBuilder<I, T, Builder<I, T>, Exception> {

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

@@ -74,8 +74,8 @@ public class LazyInitializer<T> extends AbstractConcurrentInitializer<T, Concurr
     /**
      * Builds a new instance.
      *
-     * @param <T> the type of the object managed by the initializer.
-     * @param <I> the type of the initializer managed by this builder.
+     * @param <T> The type of results supplied by this builder.
+     * @param <I> The type of the initializer managed by this builder.
      * @since 3.14.0
      */
     public static class Builder<I extends LazyInitializer<T>, T> extends AbstractBuilder<I, T, Builder<I, T>, ConcurrentException> {

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

@@ -22,7 +22,7 @@
 /**
  * A functional interface like {@link Supplier} that declares a {@link Throwable}.
  *
- * @param <T> Return type.
+ * @param <T> The type of results supplied by this supplier.
  * @param <E> The kind of thrown exception or error.
  * @since 3.11
  */