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

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


The following commit(s) were added to refs/heads/master by this push:
     new ef519685c Javadoc
ef519685c is described below

commit ef519685cb0deb4bdeef89003a4505fad9c9b0a7
Author: Gary Gregory <[email protected]>
AuthorDate: Sun Aug 2 15:31:41 2026 -0400

    Javadoc
---
 .../java/org/apache/commons/collections4/bag/CollectionBag.java     | 4 ++--
 .../org/apache/commons/collections4/bag/CollectionSortedBag.java    | 2 +-
 src/main/java/org/apache/commons/collections4/bag/HashBag.java      | 2 +-
 src/main/java/org/apache/commons/collections4/bag/TreeBag.java      | 2 +-
 .../java/org/apache/commons/collections4/bag/UnmodifiableBag.java   | 2 +-
 .../org/apache/commons/collections4/bag/UnmodifiableSortedBag.java  | 2 +-
 .../java/org/apache/commons/collections4/bidimap/TreeBidiMap.java   | 2 +-
 .../commons/collections4/collection/PredicatedCollection.java       | 2 +-
 .../collections4/list/AbstractSerializableListDecorator.java        | 2 +-
 .../org/apache/commons/collections4/list/CursorableLinkedList.java  | 2 +-
 .../org/apache/commons/collections4/list/NodeCachingLinkedList.java | 2 +-
 .../java/org/apache/commons/collections4/list/SetUniqueList.java    | 2 +-
 .../java/org/apache/commons/collections4/map/AbstractHashedMap.java | 4 ++--
 .../org/apache/commons/collections4/map/AbstractReferenceMap.java   | 4 ++--
 .../org/apache/commons/collections4/map/CaseInsensitiveMap.java     | 2 +-
 src/main/java/org/apache/commons/collections4/map/DefaultedMap.java | 2 +-
 src/main/java/org/apache/commons/collections4/map/FixedSizeMap.java | 2 +-
 .../org/apache/commons/collections4/map/FixedSizeSortedMap.java     | 4 ++--
 src/main/java/org/apache/commons/collections4/map/Flat3Map.java     | 2 +-
 src/main/java/org/apache/commons/collections4/map/HashedMap.java    | 2 +-
 src/main/java/org/apache/commons/collections4/map/LRUMap.java       | 6 +++---
 src/main/java/org/apache/commons/collections4/map/LazyMap.java      | 2 +-
 src/main/java/org/apache/commons/collections4/map/LinkedMap.java    | 2 +-
 .../java/org/apache/commons/collections4/map/ListOrderedMap.java    | 2 +-
 src/main/java/org/apache/commons/collections4/map/MultiKeyMap.java  | 2 +-
 .../java/org/apache/commons/collections4/map/MultiValueMap.java     | 2 +-
 .../org/apache/commons/collections4/map/PassiveExpiringMap.java     | 2 +-
 .../java/org/apache/commons/collections4/map/PredicatedMap.java     | 2 +-
 .../org/apache/commons/collections4/map/ReferenceIdentityMap.java   | 2 +-
 src/main/java/org/apache/commons/collections4/map/ReferenceMap.java | 2 +-
 .../java/org/apache/commons/collections4/map/TransformedMap.java    | 2 +-
 .../java/org/apache/commons/collections4/map/UnmodifiableMap.java   | 2 +-
 .../org/apache/commons/collections4/map/UnmodifiableOrderedMap.java | 2 +-
 .../org/apache/commons/collections4/map/UnmodifiableSortedMap.java  | 2 +-
 .../java/org/apache/commons/collections4/multiset/HashMultiSet.java | 2 +-
 .../java/org/apache/commons/collections4/multiset/TreeMultiSet.java | 2 +-
 .../apache/commons/collections4/multiset/UnmodifiableMultiSet.java  | 2 +-
 .../commons/collections4/multiset/UnmodifiableSortedMultiSet.java   | 2 +-
 .../org/apache/commons/collections4/queue/CircularFifoQueue.java    | 2 +-
 .../org/apache/commons/collections4/queue/UnmodifiableQueue.java    | 2 +-
 .../commons/collections4/set/AbstractSerializableSetDecorator.java  | 2 +-
 .../java/org/apache/commons/collections4/set/ListOrderedSet.java    | 2 +-
 .../apache/commons/collections4/set/UnmodifiableNavigableSet.java   | 2 +-
 .../org/apache/commons/collections4/set/UnmodifiableSortedSet.java  | 2 +-
 .../apache/commons/collections4/splitmap/TransformedSplitMap.java   | 2 +-
 45 files changed, 51 insertions(+), 51 deletions(-)

diff --git 
a/src/main/java/org/apache/commons/collections4/bag/CollectionBag.java 
b/src/main/java/org/apache/commons/collections4/bag/CollectionBag.java
index 70d9bdd46..106a80cb7 100644
--- a/src/main/java/org/apache/commons/collections4/bag/CollectionBag.java
+++ b/src/main/java/org/apache/commons/collections4/bag/CollectionBag.java
@@ -131,7 +131,7 @@ public final class CollectionBag<E> extends 
AbstractBagDecorator<E> {
      * Reads the collection in using a custom routine.
      *
      * @param in  The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      * @throws ClassCastException if deserialized object has wrong type
      */
@@ -219,7 +219,7 @@ public final class CollectionBag<E> extends 
AbstractBagDecorator<E> {
      * Writes the collection out using a custom routine.
      *
      * @param out  The output stream
-     * @throws IOException if an error occurs while writing to the stream
+     * @throws IOException Thrown if an error occurs while writing to the 
stream
      */
     private void writeObject(final ObjectOutputStream out) throws IOException {
         out.defaultWriteObject();
diff --git 
a/src/main/java/org/apache/commons/collections4/bag/CollectionSortedBag.java 
b/src/main/java/org/apache/commons/collections4/bag/CollectionSortedBag.java
index 1a4ef2435..e7cc10a0e 100644
--- a/src/main/java/org/apache/commons/collections4/bag/CollectionSortedBag.java
+++ b/src/main/java/org/apache/commons/collections4/bag/CollectionSortedBag.java
@@ -92,7 +92,7 @@ public final class CollectionSortedBag<E> extends 
AbstractSortedBagDecorator<E>
      * Deserializes the collection in using a custom routine.
      *
      * @param in  The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      * @throws ClassCastException if deserialized object has wrong type
      */
diff --git a/src/main/java/org/apache/commons/collections4/bag/HashBag.java 
b/src/main/java/org/apache/commons/collections4/bag/HashBag.java
index 99901dc88..207682f8d 100644
--- a/src/main/java/org/apache/commons/collections4/bag/HashBag.java
+++ b/src/main/java/org/apache/commons/collections4/bag/HashBag.java
@@ -87,7 +87,7 @@ public class HashBag<E> extends AbstractMapBag<E> implements 
Serializable {
      * Deserializes the bag in using a custom routine.
      *
      * @param in  The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      */
     private void readObject(final ObjectInputStream in) throws IOException, 
ClassNotFoundException {
diff --git a/src/main/java/org/apache/commons/collections4/bag/TreeBag.java 
b/src/main/java/org/apache/commons/collections4/bag/TreeBag.java
index 14ddd0320..f89c6e629 100644
--- a/src/main/java/org/apache/commons/collections4/bag/TreeBag.java
+++ b/src/main/java/org/apache/commons/collections4/bag/TreeBag.java
@@ -142,7 +142,7 @@ public class TreeBag<E> extends AbstractMapBag<E> 
implements SortedBag<E>, Seria
      * Deserializes the bag in using a custom routine.
      *
      * @param in  The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      */
     private void readObject(final ObjectInputStream in) throws IOException, 
ClassNotFoundException {
diff --git 
a/src/main/java/org/apache/commons/collections4/bag/UnmodifiableBag.java 
b/src/main/java/org/apache/commons/collections4/bag/UnmodifiableBag.java
index 990d52a59..ac4a6272a 100644
--- a/src/main/java/org/apache/commons/collections4/bag/UnmodifiableBag.java
+++ b/src/main/java/org/apache/commons/collections4/bag/UnmodifiableBag.java
@@ -134,7 +134,7 @@ public final class UnmodifiableBag<E>
      * Deserializes the collection in using a custom routine.
      *
      * @param in  The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      * @throws ClassCastException if deserialized object has wrong type
      */
diff --git 
a/src/main/java/org/apache/commons/collections4/bag/UnmodifiableSortedBag.java 
b/src/main/java/org/apache/commons/collections4/bag/UnmodifiableSortedBag.java
index 93a54195b..1b4efc2b7 100644
--- 
a/src/main/java/org/apache/commons/collections4/bag/UnmodifiableSortedBag.java
+++ 
b/src/main/java/org/apache/commons/collections4/bag/UnmodifiableSortedBag.java
@@ -131,7 +131,7 @@ public final class UnmodifiableSortedBag<E>
      * Deserializes the collection in using a custom routine.
      *
      * @param in  The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      * @throws ClassCastException if deserialized object has wrong type
      */
diff --git 
a/src/main/java/org/apache/commons/collections4/bidimap/TreeBidiMap.java 
b/src/main/java/org/apache/commons/collections4/bidimap/TreeBidiMap.java
index 98048b483..b95ad541b 100644
--- a/src/main/java/org/apache/commons/collections4/bidimap/TreeBidiMap.java
+++ b/src/main/java/org/apache/commons/collections4/bidimap/TreeBidiMap.java
@@ -1972,7 +1972,7 @@ public class TreeBidiMap<K extends Comparable<K>, V 
extends Comparable<V>>
      * Deserializes the content of the stream.
      *
      * @param stream The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      */
     @SuppressWarnings("unchecked") // This will fail at runtime if the stream 
is incorrect
diff --git 
a/src/main/java/org/apache/commons/collections4/collection/PredicatedCollection.java
 
b/src/main/java/org/apache/commons/collections4/collection/PredicatedCollection.java
index 14e564d34..df02771bd 100644
--- 
a/src/main/java/org/apache/commons/collections4/collection/PredicatedCollection.java
+++ 
b/src/main/java/org/apache/commons/collections4/collection/PredicatedCollection.java
@@ -431,7 +431,7 @@ public class PredicatedCollection<E> extends 
AbstractCollectionDecorator<E> {
      * Deserializes the collection in using a custom routine.
      *
      * @param in  The input stream.
-     * @throws IOException if an error occurs while reading from the stream.
+     * @throws IOException Thrown if an error occurs while reading from the 
stream.
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded.
      */
     private void readObject(final ObjectInputStream in) throws IOException, 
ClassNotFoundException {
diff --git 
a/src/main/java/org/apache/commons/collections4/list/AbstractSerializableListDecorator.java
 
b/src/main/java/org/apache/commons/collections4/list/AbstractSerializableListDecorator.java
index ff08645f4..8bdfce807 100644
--- 
a/src/main/java/org/apache/commons/collections4/list/AbstractSerializableListDecorator.java
+++ 
b/src/main/java/org/apache/commons/collections4/list/AbstractSerializableListDecorator.java
@@ -47,7 +47,7 @@ public abstract class AbstractSerializableListDecorator<E> 
extends AbstractListD
      * Deserializes the list in using a custom routine.
      *
      * @param in  The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      */
     @SuppressWarnings("unchecked")
diff --git 
a/src/main/java/org/apache/commons/collections4/list/CursorableLinkedList.java 
b/src/main/java/org/apache/commons/collections4/list/CursorableLinkedList.java
index 25123075c..0a97aeb96 100644
--- 
a/src/main/java/org/apache/commons/collections4/list/CursorableLinkedList.java
+++ 
b/src/main/java/org/apache/commons/collections4/list/CursorableLinkedList.java
@@ -526,7 +526,7 @@ public class CursorableLinkedList<E> extends 
AbstractLinkedList<E> implements Se
      * Deserializes the data held in this object to the stream specified.
      *
      * @param in  The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      */
     private void readObject(final ObjectInputStream in) throws IOException, 
ClassNotFoundException {
diff --git 
a/src/main/java/org/apache/commons/collections4/list/NodeCachingLinkedList.java 
b/src/main/java/org/apache/commons/collections4/list/NodeCachingLinkedList.java
index 03663796b..a08d606d1 100644
--- 
a/src/main/java/org/apache/commons/collections4/list/NodeCachingLinkedList.java
+++ 
b/src/main/java/org/apache/commons/collections4/list/NodeCachingLinkedList.java
@@ -176,7 +176,7 @@ public class NodeCachingLinkedList<E> extends 
AbstractLinkedList<E> implements S
      * Deserializes the data held in this object to the stream specified.
      *
      * @param in  The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      */
     private void readObject(final ObjectInputStream in) throws IOException, 
ClassNotFoundException {
diff --git 
a/src/main/java/org/apache/commons/collections4/list/SetUniqueList.java 
b/src/main/java/org/apache/commons/collections4/list/SetUniqueList.java
index 4548eac41..2cd9c2239 100644
--- a/src/main/java/org/apache/commons/collections4/list/SetUniqueList.java
+++ b/src/main/java/org/apache/commons/collections4/list/SetUniqueList.java
@@ -348,7 +348,7 @@ public class SetUniqueList<E> extends 
AbstractSerializableListDecorator<E> {
      * constructors guarantee.
      *
      * @param in  The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if a class read from the stream cannot 
be loaded
      */
     private void readObject(final ObjectInputStream in) throws IOException, 
ClassNotFoundException {
diff --git 
a/src/main/java/org/apache/commons/collections4/map/AbstractHashedMap.java 
b/src/main/java/org/apache/commons/collections4/map/AbstractHashedMap.java
index 5180690d7..e65ddd568 100644
--- a/src/main/java/org/apache/commons/collections4/map/AbstractHashedMap.java
+++ b/src/main/java/org/apache/commons/collections4/map/AbstractHashedMap.java
@@ -938,7 +938,7 @@ public class AbstractHashedMap<K, V> extends AbstractMap<K, 
V> implements Iterab
      * </p>
      *
      * @param in  The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      */
     @SuppressWarnings("unchecked")
@@ -980,7 +980,7 @@ public class AbstractHashedMap<K, V> extends AbstractMap<K, 
V> implements Iterab
      * </p>
      *
      * @param out  The output stream
-     * @throws IOException if an error occurs while writing to the stream
+     * @throws IOException Thrown if an error occurs while writing to the 
stream
      */
     protected void doWriteObject(final ObjectOutputStream out) throws 
IOException {
         out.writeFloat(loadFactor);
diff --git 
a/src/main/java/org/apache/commons/collections4/map/AbstractReferenceMap.java 
b/src/main/java/org/apache/commons/collections4/map/AbstractReferenceMap.java
index 0c9ed0088..7ef0095d2 100644
--- 
a/src/main/java/org/apache/commons/collections4/map/AbstractReferenceMap.java
+++ 
b/src/main/java/org/apache/commons/collections4/map/AbstractReferenceMap.java
@@ -814,7 +814,7 @@ public abstract class AbstractReferenceMap<K, V> extends 
AbstractHashedMap<K, V>
      * </p>
      *
      * @param in  The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      */
     @Override
@@ -870,7 +870,7 @@ public abstract class AbstractReferenceMap<K, V> extends 
AbstractHashedMap<K, V>
      * </p>
      *
      * @param out  The output stream
-     * @throws IOException if an error occurs while writing to the stream
+     * @throws IOException Thrown if an error occurs while writing to the 
stream
      */
     @Override
     protected void doWriteObject(final ObjectOutputStream out) throws 
IOException {
diff --git 
a/src/main/java/org/apache/commons/collections4/map/CaseInsensitiveMap.java 
b/src/main/java/org/apache/commons/collections4/map/CaseInsensitiveMap.java
index 8d7f142bb..b2c6d24f8 100644
--- a/src/main/java/org/apache/commons/collections4/map/CaseInsensitiveMap.java
+++ b/src/main/java/org/apache/commons/collections4/map/CaseInsensitiveMap.java
@@ -155,7 +155,7 @@ public class CaseInsensitiveMap<K, V> extends 
AbstractHashedMap<K, V> implements
      * Deserializes the map in using a custom routine.
      *
      * @param in The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      */
     private void readObject(final ObjectInputStream in) throws IOException, 
ClassNotFoundException {
diff --git 
a/src/main/java/org/apache/commons/collections4/map/DefaultedMap.java 
b/src/main/java/org/apache/commons/collections4/map/DefaultedMap.java
index f4cc8ceff..71365479e 100644
--- a/src/main/java/org/apache/commons/collections4/map/DefaultedMap.java
+++ b/src/main/java/org/apache/commons/collections4/map/DefaultedMap.java
@@ -182,7 +182,7 @@ public class DefaultedMap<K, V> extends 
AbstractMapDecorator<K, V> implements Se
      * Deserializes the map in using a custom routine.
      *
      * @param in  The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      */
     @SuppressWarnings("unchecked")
diff --git 
a/src/main/java/org/apache/commons/collections4/map/FixedSizeMap.java 
b/src/main/java/org/apache/commons/collections4/map/FixedSizeMap.java
index ab1ac1837..a023ebbcd 100644
--- a/src/main/java/org/apache/commons/collections4/map/FixedSizeMap.java
+++ b/src/main/java/org/apache/commons/collections4/map/FixedSizeMap.java
@@ -143,7 +143,7 @@ public class FixedSizeMap<K, V>
      * Deserializes the map in using a custom routine.
      *
      * @param in  The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      * @since 3.1
      */
diff --git 
a/src/main/java/org/apache/commons/collections4/map/FixedSizeSortedMap.java 
b/src/main/java/org/apache/commons/collections4/map/FixedSizeSortedMap.java
index 2c1a4963e..6eec237d2 100644
--- a/src/main/java/org/apache/commons/collections4/map/FixedSizeSortedMap.java
+++ b/src/main/java/org/apache/commons/collections4/map/FixedSizeSortedMap.java
@@ -154,7 +154,7 @@ public class FixedSizeSortedMap<K, V>
      * Deserializes the map in using a custom routine.
      *
      * @param in The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      */
     @SuppressWarnings("unchecked") // (1) should only fail if input stream is 
incorrect
@@ -193,7 +193,7 @@ public class FixedSizeSortedMap<K, V>
      * Writes the map out using a custom routine.
      *
      * @param out  The output stream
-     * @throws IOException if an error occurs while writing to the stream
+     * @throws IOException Thrown if an error occurs while writing to the 
stream
      */
     private void writeObject(final ObjectOutputStream out) throws IOException {
         out.defaultWriteObject();
diff --git a/src/main/java/org/apache/commons/collections4/map/Flat3Map.java 
b/src/main/java/org/apache/commons/collections4/map/Flat3Map.java
index 45b07fb13..ddfa7b3f0 100644
--- a/src/main/java/org/apache/commons/collections4/map/Flat3Map.java
+++ b/src/main/java/org/apache/commons/collections4/map/Flat3Map.java
@@ -1036,7 +1036,7 @@ public class Flat3Map<K, V> implements IterableMap<K, V>, 
Serializable, Cloneabl
      * Deserializes the map in using a custom routine.
      *
      * @param in The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      */
     @SuppressWarnings("unchecked")
diff --git a/src/main/java/org/apache/commons/collections4/map/HashedMap.java 
b/src/main/java/org/apache/commons/collections4/map/HashedMap.java
index 406f9abd8..77e1aa49c 100644
--- a/src/main/java/org/apache/commons/collections4/map/HashedMap.java
+++ b/src/main/java/org/apache/commons/collections4/map/HashedMap.java
@@ -104,7 +104,7 @@ public class HashedMap<K, V>
      * Deserializes the map in using a custom routine.
      *
      * @param in The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      */
     private void readObject(final ObjectInputStream in) throws IOException, 
ClassNotFoundException {
diff --git a/src/main/java/org/apache/commons/collections4/map/LRUMap.java 
b/src/main/java/org/apache/commons/collections4/map/LRUMap.java
index a043d74b9..87958a4c5 100644
--- a/src/main/java/org/apache/commons/collections4/map/LRUMap.java
+++ b/src/main/java/org/apache/commons/collections4/map/LRUMap.java
@@ -293,7 +293,7 @@ public class LRUMap<K, V>
      * Reads the data necessary for {@code put()} to work in the superclass.
      *
      * @param in  The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      */
     @Override
@@ -309,7 +309,7 @@ public class LRUMap<K, V>
      * Writes the data necessary for {@code put()} to work in deserialization.
      *
      * @param out  The output stream
-     * @throws IOException if an error occurs while writing to the stream
+     * @throws IOException Thrown if an error occurs while writing to the 
stream
      */
     @Override
     protected void doWriteObject(final ObjectOutputStream out) throws 
IOException {
@@ -420,7 +420,7 @@ public class LRUMap<K, V>
      * Deserializes the map in using a custom routine.
      *
      * @param in The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      */
     private void readObject(final ObjectInputStream in) throws IOException, 
ClassNotFoundException {
diff --git a/src/main/java/org/apache/commons/collections4/map/LazyMap.java 
b/src/main/java/org/apache/commons/collections4/map/LazyMap.java
index fbe4018ef..e44ffbef2 100644
--- a/src/main/java/org/apache/commons/collections4/map/LazyMap.java
+++ b/src/main/java/org/apache/commons/collections4/map/LazyMap.java
@@ -146,7 +146,7 @@ public class LazyMap<K, V> extends AbstractMapDecorator<K, 
V> implements Seriali
      * Deserializes the map in using a custom routine.
      *
      * @param in  The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      * @since 3.1
      */
diff --git a/src/main/java/org/apache/commons/collections4/map/LinkedMap.java 
b/src/main/java/org/apache/commons/collections4/map/LinkedMap.java
index 8ddc3c50c..afaa5f43e 100644
--- a/src/main/java/org/apache/commons/collections4/map/LinkedMap.java
+++ b/src/main/java/org/apache/commons/collections4/map/LinkedMap.java
@@ -326,7 +326,7 @@ public class LinkedMap<K, V> extends AbstractLinkedMap<K, 
V> implements Serializ
      * Deserializes the map in using a custom routine.
      *
      * @param in The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      */
     private void readObject(final ObjectInputStream in) throws IOException, 
ClassNotFoundException {
diff --git 
a/src/main/java/org/apache/commons/collections4/map/ListOrderedMap.java 
b/src/main/java/org/apache/commons/collections4/map/ListOrderedMap.java
index e413cf3be..b2813825e 100644
--- a/src/main/java/org/apache/commons/collections4/map/ListOrderedMap.java
+++ b/src/main/java/org/apache/commons/collections4/map/ListOrderedMap.java
@@ -682,7 +682,7 @@ public class ListOrderedMap<K, V>
      * Deserializes the map in using a custom routine.
      *
      * @param in  The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      * @since 3.1
      */
diff --git a/src/main/java/org/apache/commons/collections4/map/MultiKeyMap.java 
b/src/main/java/org/apache/commons/collections4/map/MultiKeyMap.java
index e30a7e196..c89632d55 100644
--- a/src/main/java/org/apache/commons/collections4/map/MultiKeyMap.java
+++ b/src/main/java/org/apache/commons/collections4/map/MultiKeyMap.java
@@ -670,7 +670,7 @@ public class MultiKeyMap<K, V> extends 
AbstractMapDecorator<MultiKey<? extends K
      * Deserializes the map in using a custom routine.
      *
      * @param in  The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      */
     @SuppressWarnings("unchecked")
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 a9258ccbe..2835bb3c3 100644
--- a/src/main/java/org/apache/commons/collections4/map/MultiValueMap.java
+++ b/src/main/java/org/apache/commons/collections4/map/MultiValueMap.java
@@ -498,7 +498,7 @@ public class MultiValueMap<K, V> extends 
AbstractMapDecorator<K, Object> impleme
      * Deserializes the map in using a custom routine.
      *
      * @param in  The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      * @since 4.0
      */
diff --git 
a/src/main/java/org/apache/commons/collections4/map/PassiveExpiringMap.java 
b/src/main/java/org/apache/commons/collections4/map/PassiveExpiringMap.java
index 55f2ef7a6..c5d6e36c2 100644
--- a/src/main/java/org/apache/commons/collections4/map/PassiveExpiringMap.java
+++ b/src/main/java/org/apache/commons/collections4/map/PassiveExpiringMap.java
@@ -866,7 +866,7 @@ public class PassiveExpiringMap<K, V>
      * Deserializes the map in using a custom routine.
      *
      * @param in The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      */
     @SuppressWarnings("unchecked")
diff --git 
a/src/main/java/org/apache/commons/collections4/map/PredicatedMap.java 
b/src/main/java/org/apache/commons/collections4/map/PredicatedMap.java
index a462ad8a5..eff29a064 100644
--- a/src/main/java/org/apache/commons/collections4/map/PredicatedMap.java
+++ b/src/main/java/org/apache/commons/collections4/map/PredicatedMap.java
@@ -148,7 +148,7 @@ public class PredicatedMap<K, V>
      * Deserializes the map in using a custom routine.
      *
      * @param in  The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      * @since 3.1
      */
diff --git 
a/src/main/java/org/apache/commons/collections4/map/ReferenceIdentityMap.java 
b/src/main/java/org/apache/commons/collections4/map/ReferenceIdentityMap.java
index d1acb2176..ca695c918 100644
--- 
a/src/main/java/org/apache/commons/collections4/map/ReferenceIdentityMap.java
+++ 
b/src/main/java/org/apache/commons/collections4/map/ReferenceIdentityMap.java
@@ -235,7 +235,7 @@ public class ReferenceIdentityMap<K, V> extends 
AbstractReferenceMap<K, V> imple
      * Deserializes the map in using a custom routine.
      *
      * @param in The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      */
     private void readObject(final ObjectInputStream in) throws IOException, 
ClassNotFoundException {
diff --git 
a/src/main/java/org/apache/commons/collections4/map/ReferenceMap.java 
b/src/main/java/org/apache/commons/collections4/map/ReferenceMap.java
index 5a160dd4e..6b40192db 100644
--- a/src/main/java/org/apache/commons/collections4/map/ReferenceMap.java
+++ b/src/main/java/org/apache/commons/collections4/map/ReferenceMap.java
@@ -178,7 +178,7 @@ public class ReferenceMap<K, V> extends 
AbstractReferenceMap<K, V> implements Se
      * Deserializes the map in using a custom routine.
      *
      * @param in The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      */
     private void readObject(final ObjectInputStream in) throws IOException, 
ClassNotFoundException {
diff --git 
a/src/main/java/org/apache/commons/collections4/map/TransformedMap.java 
b/src/main/java/org/apache/commons/collections4/map/TransformedMap.java
index 0ef3a9919..c99ebb159 100644
--- a/src/main/java/org/apache/commons/collections4/map/TransformedMap.java
+++ b/src/main/java/org/apache/commons/collections4/map/TransformedMap.java
@@ -173,7 +173,7 @@ public class TransformedMap<K, V>
      * Deserializes the map in using a custom routine.
      *
      * @param in  The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      * @since 3.1
      */
diff --git 
a/src/main/java/org/apache/commons/collections4/map/UnmodifiableMap.java 
b/src/main/java/org/apache/commons/collections4/map/UnmodifiableMap.java
index 8fac8f347..45ab79319 100644
--- a/src/main/java/org/apache/commons/collections4/map/UnmodifiableMap.java
+++ b/src/main/java/org/apache/commons/collections4/map/UnmodifiableMap.java
@@ -140,7 +140,7 @@ public final class UnmodifiableMap<K, V>
      * Deserializes the map in using a custom routine.
      *
      * @param in  The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      * @since 3.1
      */
diff --git 
a/src/main/java/org/apache/commons/collections4/map/UnmodifiableOrderedMap.java 
b/src/main/java/org/apache/commons/collections4/map/UnmodifiableOrderedMap.java
index 7017bfdce..5808b4e83 100644
--- 
a/src/main/java/org/apache/commons/collections4/map/UnmodifiableOrderedMap.java
+++ 
b/src/main/java/org/apache/commons/collections4/map/UnmodifiableOrderedMap.java
@@ -133,7 +133,7 @@ public final class UnmodifiableOrderedMap<K, V> extends 
AbstractOrderedMapDecora
      * Deseializes the map in using a custom routine.
      *
      * @param in  The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      * @since 3.1
      */
diff --git 
a/src/main/java/org/apache/commons/collections4/map/UnmodifiableSortedMap.java 
b/src/main/java/org/apache/commons/collections4/map/UnmodifiableSortedMap.java
index 9369dd803..e1513afc9 100644
--- 
a/src/main/java/org/apache/commons/collections4/map/UnmodifiableSortedMap.java
+++ 
b/src/main/java/org/apache/commons/collections4/map/UnmodifiableSortedMap.java
@@ -147,7 +147,7 @@ public final class UnmodifiableSortedMap<K, V>
      * Deserializes the map in using a custom routine.
      *
      * @param in  The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      * @since 3.1
      */
diff --git 
a/src/main/java/org/apache/commons/collections4/multiset/HashMultiSet.java 
b/src/main/java/org/apache/commons/collections4/multiset/HashMultiSet.java
index 2f6b9ba1b..a697af519 100644
--- a/src/main/java/org/apache/commons/collections4/multiset/HashMultiSet.java
+++ b/src/main/java/org/apache/commons/collections4/multiset/HashMultiSet.java
@@ -81,7 +81,7 @@ public class HashMultiSet<E> extends AbstractMapMultiSet<E> 
implements Serializa
      * Deserializes the multiset in using a custom routine.
      *
      * @param in The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      */
     private void readObject(final ObjectInputStream in) throws IOException, 
ClassNotFoundException {
diff --git 
a/src/main/java/org/apache/commons/collections4/multiset/TreeMultiSet.java 
b/src/main/java/org/apache/commons/collections4/multiset/TreeMultiSet.java
index f0cf22570..2df289823 100644
--- a/src/main/java/org/apache/commons/collections4/multiset/TreeMultiSet.java
+++ b/src/main/java/org/apache/commons/collections4/multiset/TreeMultiSet.java
@@ -138,7 +138,7 @@ public class TreeMultiSet<E> extends AbstractMapMultiSet<E> 
implements SortedMul
      * Deserializes the multiset in using a custom routine.
      *
      * @param in  The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      */
     private void readObject(final ObjectInputStream in) throws IOException, 
ClassNotFoundException {
diff --git 
a/src/main/java/org/apache/commons/collections4/multiset/UnmodifiableMultiSet.java
 
b/src/main/java/org/apache/commons/collections4/multiset/UnmodifiableMultiSet.java
index f24354e31..0c9ef9729 100644
--- 
a/src/main/java/org/apache/commons/collections4/multiset/UnmodifiableMultiSet.java
+++ 
b/src/main/java/org/apache/commons/collections4/multiset/UnmodifiableMultiSet.java
@@ -133,7 +133,7 @@ public final class UnmodifiableMultiSet<E>
      * Deserializes the collection in using a custom routine.
      *
      * @param in  The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      * @throws ClassCastException if deserialized object has wrong type
      */
diff --git 
a/src/main/java/org/apache/commons/collections4/multiset/UnmodifiableSortedMultiSet.java
 
b/src/main/java/org/apache/commons/collections4/multiset/UnmodifiableSortedMultiSet.java
index b29837604..ce7a61349 100644
--- 
a/src/main/java/org/apache/commons/collections4/multiset/UnmodifiableSortedMultiSet.java
+++ 
b/src/main/java/org/apache/commons/collections4/multiset/UnmodifiableSortedMultiSet.java
@@ -111,7 +111,7 @@ public final class UnmodifiableSortedMultiSet<E>
      * Deserializes the collection in using a custom routine.
      *
      * @param in  The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      * @throws ClassCastException if deserialized object has wrong type
      */
diff --git 
a/src/main/java/org/apache/commons/collections4/queue/CircularFifoQueue.java 
b/src/main/java/org/apache/commons/collections4/queue/CircularFifoQueue.java
index 719ee90a7..6bfdebe3f 100644
--- a/src/main/java/org/apache/commons/collections4/queue/CircularFifoQueue.java
+++ b/src/main/java/org/apache/commons/collections4/queue/CircularFifoQueue.java
@@ -353,7 +353,7 @@ public class CircularFifoQueue<E> extends 
AbstractCollection<E>
      * Deserializes the queue in using a custom routine.
      *
      * @param in  The input stream
-     * @throws IOException if an I/O error occurs while writing to the output 
stream
+     * @throws IOException Thrown if an I/O error occurs while writing to the 
output stream
      * @throws ClassNotFoundException if the class of a serialized object 
cannot be found
      */
     @SuppressWarnings("unchecked")
diff --git 
a/src/main/java/org/apache/commons/collections4/queue/UnmodifiableQueue.java 
b/src/main/java/org/apache/commons/collections4/queue/UnmodifiableQueue.java
index 740af1e83..9c03ecbe6 100644
--- a/src/main/java/org/apache/commons/collections4/queue/UnmodifiableQueue.java
+++ b/src/main/java/org/apache/commons/collections4/queue/UnmodifiableQueue.java
@@ -135,7 +135,7 @@ public final class UnmodifiableQueue<E>
      * Deserializes the collection in using a custom routine.
      *
      * @param in  The input stream
-     * @throws IOException if an I/O error occurs while reading from the input 
stream
+     * @throws IOException Thrown if an I/O error occurs while reading from 
the input stream
      * @throws ClassNotFoundException if the class of a serialized object 
cannot be found
      */
     @SuppressWarnings("unchecked")
diff --git 
a/src/main/java/org/apache/commons/collections4/set/AbstractSerializableSetDecorator.java
 
b/src/main/java/org/apache/commons/collections4/set/AbstractSerializableSetDecorator.java
index 39913496d..64c6c7aac 100644
--- 
a/src/main/java/org/apache/commons/collections4/set/AbstractSerializableSetDecorator.java
+++ 
b/src/main/java/org/apache/commons/collections4/set/AbstractSerializableSetDecorator.java
@@ -48,7 +48,7 @@ public abstract class AbstractSerializableSetDecorator<E>
      * Deserializes the set in using a custom routine.
      *
      * @param in  The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      */
     @SuppressWarnings("unchecked")
diff --git 
a/src/main/java/org/apache/commons/collections4/set/ListOrderedSet.java 
b/src/main/java/org/apache/commons/collections4/set/ListOrderedSet.java
index 664d97411..cec026739 100644
--- a/src/main/java/org/apache/commons/collections4/set/ListOrderedSet.java
+++ b/src/main/java/org/apache/commons/collections4/set/ListOrderedSet.java
@@ -333,7 +333,7 @@ public class ListOrderedSet<E>
      * decorated set, as the constructors guarantee.
      *
      * @param in  The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if a class read from the stream cannot 
be loaded
      */
     private void readObject(final ObjectInputStream in) throws IOException, 
ClassNotFoundException {
diff --git 
a/src/main/java/org/apache/commons/collections4/set/UnmodifiableNavigableSet.java
 
b/src/main/java/org/apache/commons/collections4/set/UnmodifiableNavigableSet.java
index b789eef37..5865f05a1 100644
--- 
a/src/main/java/org/apache/commons/collections4/set/UnmodifiableNavigableSet.java
+++ 
b/src/main/java/org/apache/commons/collections4/set/UnmodifiableNavigableSet.java
@@ -153,7 +153,7 @@ public final class UnmodifiableNavigableSet<E>
      * Deserializes the collection in using a custom routine.
      *
      * @param in  The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      */
     @SuppressWarnings("unchecked") // (1) should only fail if input stream is 
incorrect
diff --git 
a/src/main/java/org/apache/commons/collections4/set/UnmodifiableSortedSet.java 
b/src/main/java/org/apache/commons/collections4/set/UnmodifiableSortedSet.java
index 4d5894c1a..effb488f1 100644
--- 
a/src/main/java/org/apache/commons/collections4/set/UnmodifiableSortedSet.java
+++ 
b/src/main/java/org/apache/commons/collections4/set/UnmodifiableSortedSet.java
@@ -118,7 +118,7 @@ public final class UnmodifiableSortedSet<E>
      * Deserializes the collection in using a custom routine.
      *
      * @param in  The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      */
     @SuppressWarnings("unchecked") // (1) should only fail if input stream is 
incorrect
diff --git 
a/src/main/java/org/apache/commons/collections4/splitmap/TransformedSplitMap.java
 
b/src/main/java/org/apache/commons/collections4/splitmap/TransformedSplitMap.java
index 0a2f601c5..572d2cd65 100644
--- 
a/src/main/java/org/apache/commons/collections4/splitmap/TransformedSplitMap.java
+++ 
b/src/main/java/org/apache/commons/collections4/splitmap/TransformedSplitMap.java
@@ -148,7 +148,7 @@ public class TransformedSplitMap<J, K, U, V> extends 
AbstractIterableGetMapDecor
      * Deserializes the map in using a custom routine.
      *
      * @param in The input stream
-     * @throws IOException if an error occurs while reading from the stream
+     * @throws IOException Thrown if an error occurs while reading from the 
stream
      * @throws ClassNotFoundException if an object read from the stream cannot 
be loaded
      * @since 3.1
      */

Reply via email to