From 9c5bf7a5be105acf6ebb1f397e4dc1d6d270ce0f Mon Sep 17 00:00:00 2001
From: Gary Gregory <garydgregory@gmail.com>
Date: Thu, 11 Jul 2024 18:21:21 -0400
Subject: [PATCH] Javadoc

---
 src/main/java/org/apache/commons/collections4/Factory.java  | 3 +--
 .../commons/collections4/functors/ConstantFactory.java      | 1 +
 .../commons/collections4/functors/ExceptionFactory.java     | 1 +
 .../commons/collections4/functors/InstantiateFactory.java   | 1 +
 .../commons/collections4/functors/PrototypeFactory.java     | 6 ++++--
 .../org/apache/commons/collections4/map/MultiValueMap.java  | 2 ++
 6 files changed, 10 insertions(+), 4 deletions(-)

diff --git a/src/main/java/org/apache/commons/collections4/Factory.java b/src/main/java/org/apache/commons/collections4/Factory.java
index 527e31c243..56fd5d5f62 100644
--- a/src/main/java/org/apache/commons/collections4/Factory.java
+++ b/src/main/java/org/apache/commons/collections4/Factory.java
@@ -30,8 +30,7 @@
  * a copy of a prototype or a new instance.
  * </p>
  *
- * @param <T> the type that the factory creates
- *
+ * @param <T> the type of results supplied by this supplier.
  * @since 2.1
  * @deprecated Use {@link Supplier}.
  */
diff --git a/src/main/java/org/apache/commons/collections4/functors/ConstantFactory.java b/src/main/java/org/apache/commons/collections4/functors/ConstantFactory.java
index d9f0ecd942..5785a97985 100644
--- a/src/main/java/org/apache/commons/collections4/functors/ConstantFactory.java
+++ b/src/main/java/org/apache/commons/collections4/functors/ConstantFactory.java
@@ -28,6 +28,7 @@
  * use the prototype factory.
  * </p>
  *
+ * @param <T> the type of results supplied by this supplier.
  * @since 3.0
  */
 public class ConstantFactory<T> implements Factory<T>, Serializable {
diff --git a/src/main/java/org/apache/commons/collections4/functors/ExceptionFactory.java b/src/main/java/org/apache/commons/collections4/functors/ExceptionFactory.java
index 04925c9a4a..9b1bc4c4a2 100644
--- a/src/main/java/org/apache/commons/collections4/functors/ExceptionFactory.java
+++ b/src/main/java/org/apache/commons/collections4/functors/ExceptionFactory.java
@@ -24,6 +24,7 @@
 /**
  * Factory implementation that always throws an exception.
  *
+ * @param <T> the type of results supplied by this supplier.
  * @since 3.0
  */
 public final class ExceptionFactory<T> implements Factory<T>, Serializable {
diff --git a/src/main/java/org/apache/commons/collections4/functors/InstantiateFactory.java b/src/main/java/org/apache/commons/collections4/functors/InstantiateFactory.java
index 007b8d39e1..e80cdeda1b 100644
--- a/src/main/java/org/apache/commons/collections4/functors/InstantiateFactory.java
+++ b/src/main/java/org/apache/commons/collections4/functors/InstantiateFactory.java
@@ -32,6 +32,7 @@
  * for more details.
  * </p>
  *
+ * @param <T> the type of results supplied by this supplier.
  * @since 3.0
  */
 public class InstantiateFactory<T> implements Factory<T> {
diff --git a/src/main/java/org/apache/commons/collections4/functors/PrototypeFactory.java b/src/main/java/org/apache/commons/collections4/functors/PrototypeFactory.java
index 204cef999d..65ac42caee 100644
--- a/src/main/java/org/apache/commons/collections4/functors/PrototypeFactory.java
+++ b/src/main/java/org/apache/commons/collections4/functors/PrototypeFactory.java
@@ -42,9 +42,10 @@
  */
 public class PrototypeFactory {
 
-    // PrototypeCloneFactory
     /**
      * PrototypeCloneFactory creates objects by copying a prototype using the clone method.
+     *
+     * @param <T> the type of results supplied by this supplier.
      */
     static class PrototypeCloneFactory<T> implements Factory<T> {
 
@@ -95,9 +96,10 @@ private void findCloneMethod() {
         }
     }
 
-    // PrototypeSerializationFactory
     /**
      * PrototypeSerializationFactory creates objects by cloning a prototype using serialization.
+     *
+     * @param <T> the type of results supplied by this supplier.
      */
     static class PrototypeSerializationFactory<T extends Serializable> implements Factory<T> {
 
diff --git a/src/main/java/org/apache/commons/collections4/map/MultiValueMap.java b/src/main/java/org/apache/commons/collections4/map/MultiValueMap.java
index b80ce92f32..a2dfa7a3e4 100644
--- a/src/main/java/org/apache/commons/collections4/map/MultiValueMap.java
+++ b/src/main/java/org/apache/commons/collections4/map/MultiValueMap.java
@@ -73,6 +73,8 @@ public class MultiValueMap<K, V> extends AbstractMapDecorator<K, Object> impleme
 
     /**
      * Inner class that provides a simple reflection factory.
+     *
+     * @param <T> the type of results supplied by this supplier.
      */
     private static final class ReflectionFactory<T extends Collection<?>> implements Factory<T>, Serializable {