This is an automated email from the ASF dual-hosted git repository. ggregory 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 de7cb01 Javadoc: Add missing tags. de7cb01 is described below commit de7cb0105b574c98485f2f230a882000fc5f1480 Author: Gary Gregory <garydgreg...@gmail.com> AuthorDate: Sat Jan 11 20:15:31 2020 -0500 Javadoc: Add missing tags. --- src/main/java/org/apache/commons/collections4/OrderedIterator.java | 2 +- src/main/java/org/apache/commons/collections4/ResettableIterator.java | 2 +- .../java/org/apache/commons/collections4/ResettableListIterator.java | 4 ++-- .../java/org/apache/commons/collections4/iterators/ArrayIterator.java | 2 +- .../org/apache/commons/collections4/iterators/ArrayListIterator.java | 1 + .../org/apache/commons/collections4/iterators/BoundedIterator.java | 1 + .../org/apache/commons/collections4/iterators/CollatingIterator.java | 1 + .../java/org/apache/commons/collections4/iterators/EmptyIterator.java | 1 + .../org/apache/commons/collections4/iterators/EmptyListIterator.java | 1 + .../apache/commons/collections4/iterators/EmptyOrderedIterator.java | 2 +- .../apache/commons/collections4/iterators/EnumerationIterator.java | 1 + .../org/apache/commons/collections4/iterators/FilterIterator.java | 1 + .../org/apache/commons/collections4/iterators/FilterListIterator.java | 1 + .../apache/commons/collections4/iterators/IteratorEnumeration.java | 1 + .../org/apache/commons/collections4/iterators/IteratorIterable.java | 1 + .../org/apache/commons/collections4/iterators/LoopingIterator.java | 1 + .../apache/commons/collections4/iterators/LoopingListIterator.java | 1 + .../apache/commons/collections4/iterators/ObjectArrayIterator.java | 2 +- .../commons/collections4/iterators/ObjectArrayListIterator.java | 1 + .../apache/commons/collections4/iterators/ObjectGraphIterator.java | 1 + .../org/apache/commons/collections4/iterators/PeekingIterator.java | 1 + .../org/apache/commons/collections4/iterators/PushbackIterator.java | 1 + .../apache/commons/collections4/iterators/ReverseListIterator.java | 1 + .../org/apache/commons/collections4/iterators/SingletonIterator.java | 1 + .../apache/commons/collections4/iterators/SingletonListIterator.java | 1 + .../org/apache/commons/collections4/iterators/SkippingIterator.java | 1 + .../apache/commons/collections4/iterators/UniqueFilterIterator.java | 1 + .../apache/commons/collections4/iterators/UnmodifiableIterator.java | 1 + .../commons/collections4/iterators/UnmodifiableListIterator.java | 1 + .../org/apache/commons/collections4/iterators/ZippingIterator.java | 1 + 30 files changed, 31 insertions(+), 7 deletions(-) diff --git a/src/main/java/org/apache/commons/collections4/OrderedIterator.java b/src/main/java/org/apache/commons/collections4/OrderedIterator.java index 9782515..5a13bd4 100644 --- a/src/main/java/org/apache/commons/collections4/OrderedIterator.java +++ b/src/main/java/org/apache/commons/collections4/OrderedIterator.java @@ -24,7 +24,7 @@ import java.util.Iterator; * This iterator allows both forward and reverse iteration through the container. * </p> * - * @param <E> the type of elements returned by this iterator + * @param <E> the type of elements returned by this iterator. * @since 3.0 */ public interface OrderedIterator<E> extends Iterator<E> { diff --git a/src/main/java/org/apache/commons/collections4/ResettableIterator.java b/src/main/java/org/apache/commons/collections4/ResettableIterator.java index 91d1762..91c2b2e 100644 --- a/src/main/java/org/apache/commons/collections4/ResettableIterator.java +++ b/src/main/java/org/apache/commons/collections4/ResettableIterator.java @@ -24,7 +24,7 @@ import java.util.Iterator; * This interface allows an iterator to be repeatedly reused. * </p> * - * @param <E> the type of elements returned by this iterator + * @param <E> the type of elements returned by this iterator. * @since 3.0 */ public interface ResettableIterator<E> extends Iterator<E> { diff --git a/src/main/java/org/apache/commons/collections4/ResettableListIterator.java b/src/main/java/org/apache/commons/collections4/ResettableListIterator.java index cec2048..b3f6407 100644 --- a/src/main/java/org/apache/commons/collections4/ResettableListIterator.java +++ b/src/main/java/org/apache/commons/collections4/ResettableListIterator.java @@ -24,9 +24,9 @@ import java.util.ListIterator; * This interface allows an iterator to be repeatedly reused. * </p> * - * @param <E> the type of elements returned by this iterator + * @param <E> the type of elements returned by this iterator. * @since 3.0 */ public interface ResettableListIterator<E> extends ListIterator<E>, ResettableIterator<E>, OrderedIterator<E> { - + // empty } diff --git a/src/main/java/org/apache/commons/collections4/iterators/ArrayIterator.java b/src/main/java/org/apache/commons/collections4/iterators/ArrayIterator.java index f3d3599..84ee303 100644 --- a/src/main/java/org/apache/commons/collections4/iterators/ArrayIterator.java +++ b/src/main/java/org/apache/commons/collections4/iterators/ArrayIterator.java @@ -32,7 +32,7 @@ import org.apache.commons.collections4.ResettableIterator; * The iterator implements a {@link #reset} method, allowing the reset of * the iterator back to the start if required. * - * @param <E> the type of elements returned by this iterator + * @param <E> the type of elements returned by this iterator. * @since 1.0 */ public class ArrayIterator<E> implements ResettableIterator<E> { diff --git a/src/main/java/org/apache/commons/collections4/iterators/ArrayListIterator.java b/src/main/java/org/apache/commons/collections4/iterators/ArrayListIterator.java index d01597c..08452b7 100644 --- a/src/main/java/org/apache/commons/collections4/iterators/ArrayListIterator.java +++ b/src/main/java/org/apache/commons/collections4/iterators/ArrayListIterator.java @@ -32,6 +32,7 @@ import org.apache.commons.collections4.ResettableListIterator; * This iterator does not support {@link #add(Object)} or {@link #remove()}, as the array * cannot be changed in size. The {@link #set(Object)} method is supported however. * + * @param <E> the type of elements returned by this iterator. * @see org.apache.commons.collections4.iterators.ArrayIterator * @see java.util.Iterator * @see java.util.ListIterator diff --git a/src/main/java/org/apache/commons/collections4/iterators/BoundedIterator.java b/src/main/java/org/apache/commons/collections4/iterators/BoundedIterator.java index b8aa08c..266b28c 100644 --- a/src/main/java/org/apache/commons/collections4/iterators/BoundedIterator.java +++ b/src/main/java/org/apache/commons/collections4/iterators/BoundedIterator.java @@ -29,6 +29,7 @@ import java.util.Objects; * iterator is immediately advanced to this position, skipping all elements * before that position. * + * @param <E> the type of elements returned by this iterator. * @since 4.1 */ public class BoundedIterator<E> implements Iterator<E> { diff --git a/src/main/java/org/apache/commons/collections4/iterators/CollatingIterator.java b/src/main/java/org/apache/commons/collections4/iterators/CollatingIterator.java index a1ae4c1..e02ffe7 100644 --- a/src/main/java/org/apache/commons/collections4/iterators/CollatingIterator.java +++ b/src/main/java/org/apache/commons/collections4/iterators/CollatingIterator.java @@ -36,6 +36,7 @@ import org.apache.commons.collections4.list.UnmodifiableList; * {@code B}, the {@link #next} method on this iterator will return the * lesser of {@code A.next()} and {@code B.next()}. * + * @param <E> the type of elements returned by this iterator. * @since 2.1 */ public class CollatingIterator<E> implements Iterator<E> { diff --git a/src/main/java/org/apache/commons/collections4/iterators/EmptyIterator.java b/src/main/java/org/apache/commons/collections4/iterators/EmptyIterator.java index 2bcf193..76b2b04 100644 --- a/src/main/java/org/apache/commons/collections4/iterators/EmptyIterator.java +++ b/src/main/java/org/apache/commons/collections4/iterators/EmptyIterator.java @@ -27,6 +27,7 @@ import org.apache.commons.collections4.ResettableIterator; * This class provides for binary compatibility between Commons Collections * 2.1.1 and 3.1 due to issues with {@code IteratorUtils}. * + * @param <E> the type of elements returned by this iterator. * @since 2.1.1 and 3.1 */ public class EmptyIterator<E> extends AbstractEmptyIterator<E> implements ResettableIterator<E> { diff --git a/src/main/java/org/apache/commons/collections4/iterators/EmptyListIterator.java b/src/main/java/org/apache/commons/collections4/iterators/EmptyListIterator.java index 0b9f672..0bd1c27 100644 --- a/src/main/java/org/apache/commons/collections4/iterators/EmptyListIterator.java +++ b/src/main/java/org/apache/commons/collections4/iterators/EmptyListIterator.java @@ -27,6 +27,7 @@ import org.apache.commons.collections4.ResettableListIterator; * provides for binary compatibility between Commons Collections 2.1.1 and 3.1 * due to issues with {@code IteratorUtils}. * + * @param <E> the type of elements returned by this iterator. * @since 2.1.1 and 3.1 */ public class EmptyListIterator<E> extends AbstractEmptyIterator<E> implements diff --git a/src/main/java/org/apache/commons/collections4/iterators/EmptyOrderedIterator.java b/src/main/java/org/apache/commons/collections4/iterators/EmptyOrderedIterator.java index 113d223..1923ee4 100644 --- a/src/main/java/org/apache/commons/collections4/iterators/EmptyOrderedIterator.java +++ b/src/main/java/org/apache/commons/collections4/iterators/EmptyOrderedIterator.java @@ -22,7 +22,7 @@ import org.apache.commons.collections4.ResettableIterator; /** * Provides an implementation of an empty ordered iterator. * - * @param <E> the type to iterate. + * @param <E> the type of elements returned by this iterator. * @since 3.1 */ public class EmptyOrderedIterator<E> extends AbstractEmptyIterator<E> diff --git a/src/main/java/org/apache/commons/collections4/iterators/EnumerationIterator.java b/src/main/java/org/apache/commons/collections4/iterators/EnumerationIterator.java index 518ffdd..8e08a2f 100644 --- a/src/main/java/org/apache/commons/collections4/iterators/EnumerationIterator.java +++ b/src/main/java/org/apache/commons/collections4/iterators/EnumerationIterator.java @@ -24,6 +24,7 @@ import java.util.Iterator; * Adapter to make {@link Enumeration Enumeration} instances appear * to be {@link Iterator Iterator} instances. * + * @param <E> the type of elements returned by this iterator. * @since 1.0 */ public class EnumerationIterator<E> implements Iterator<E> { diff --git a/src/main/java/org/apache/commons/collections4/iterators/FilterIterator.java b/src/main/java/org/apache/commons/collections4/iterators/FilterIterator.java index 3da4b71..20d9861 100644 --- a/src/main/java/org/apache/commons/collections4/iterators/FilterIterator.java +++ b/src/main/java/org/apache/commons/collections4/iterators/FilterIterator.java @@ -27,6 +27,7 @@ import org.apache.commons.collections4.Predicate; * This iterator decorates the underlying iterator, only allowing through * those elements that match the specified {@link Predicate Predicate}. * + * @param <E> the type of elements returned by this iterator. * @since 1.0 */ public class FilterIterator<E> implements Iterator<E> { diff --git a/src/main/java/org/apache/commons/collections4/iterators/FilterListIterator.java b/src/main/java/org/apache/commons/collections4/iterators/FilterListIterator.java index 8e4f83b..958a5d7 100644 --- a/src/main/java/org/apache/commons/collections4/iterators/FilterListIterator.java +++ b/src/main/java/org/apache/commons/collections4/iterators/FilterListIterator.java @@ -27,6 +27,7 @@ import org.apache.commons.collections4.Predicate; * This iterator decorates the underlying iterator, only allowing through * those elements that match the specified {@link Predicate Predicate}. * + * @param <E> the type of elements returned by this iterator. * @since 2.0 */ public class FilterListIterator<E> implements ListIterator<E> { diff --git a/src/main/java/org/apache/commons/collections4/iterators/IteratorEnumeration.java b/src/main/java/org/apache/commons/collections4/iterators/IteratorEnumeration.java index 289ebf5..23c9c79 100644 --- a/src/main/java/org/apache/commons/collections4/iterators/IteratorEnumeration.java +++ b/src/main/java/org/apache/commons/collections4/iterators/IteratorEnumeration.java @@ -23,6 +23,7 @@ import java.util.Iterator; * Adapter to make an {@link Iterator Iterator} instance appear to be an * {@link Enumeration Enumeration} instance. * + * @param <E> the type of elements returned by this iterator. * @since 1.0 */ public class IteratorEnumeration<E> implements Enumeration<E> { diff --git a/src/main/java/org/apache/commons/collections4/iterators/IteratorIterable.java b/src/main/java/org/apache/commons/collections4/iterators/IteratorIterable.java index 86b7bd1..f193d83 100644 --- a/src/main/java/org/apache/commons/collections4/iterators/IteratorIterable.java +++ b/src/main/java/org/apache/commons/collections4/iterators/IteratorIterable.java @@ -60,6 +60,7 @@ import org.apache.commons.collections4.ResettableIterator; * Iterable<Integer> iterable = new IteratorIterable<Integer>(iterator, true); * </pre> * + * @param <E> the type of elements returned by this iterator. * @since 4.0 */ public class IteratorIterable<E> implements Iterable<E> { diff --git a/src/main/java/org/apache/commons/collections4/iterators/LoopingIterator.java b/src/main/java/org/apache/commons/collections4/iterators/LoopingIterator.java index a3cbb4f..4c2614b 100644 --- a/src/main/java/org/apache/commons/collections4/iterators/LoopingIterator.java +++ b/src/main/java/org/apache/commons/collections4/iterators/LoopingIterator.java @@ -33,6 +33,7 @@ import org.apache.commons.collections4.ResettableIterator; * Concurrent modifications are not directly supported, and for most collection * implementations will throw a ConcurrentModificationException. * + * @param <E> the type of elements returned by this iterator. * @since 3.0 */ public class LoopingIterator<E> implements ResettableIterator<E> { diff --git a/src/main/java/org/apache/commons/collections4/iterators/LoopingListIterator.java b/src/main/java/org/apache/commons/collections4/iterators/LoopingListIterator.java index 50b5c6a..0f1fc3d 100644 --- a/src/main/java/org/apache/commons/collections4/iterators/LoopingListIterator.java +++ b/src/main/java/org/apache/commons/collections4/iterators/LoopingListIterator.java @@ -35,6 +35,7 @@ import org.apache.commons.collections4.ResettableListIterator; * collection implementations will throw a * ConcurrentModificationException. * + * @param <E> the type of elements returned by this iterator. * @since 3.2 */ public class LoopingListIterator<E> implements ResettableListIterator<E> { diff --git a/src/main/java/org/apache/commons/collections4/iterators/ObjectArrayIterator.java b/src/main/java/org/apache/commons/collections4/iterators/ObjectArrayIterator.java index 7d6883e..da6c864 100644 --- a/src/main/java/org/apache/commons/collections4/iterators/ObjectArrayIterator.java +++ b/src/main/java/org/apache/commons/collections4/iterators/ObjectArrayIterator.java @@ -29,7 +29,7 @@ import org.apache.commons.collections4.ResettableIterator; * The iterator implements a {@link #reset} method, allowing the reset of the iterator * back to the start if required. * - * @param <E> the type of elements returned by this iterator + * @param <E> the type of elements returned by this iterator. * @since 3.0 */ public class ObjectArrayIterator<E> implements ResettableIterator<E> { diff --git a/src/main/java/org/apache/commons/collections4/iterators/ObjectArrayListIterator.java b/src/main/java/org/apache/commons/collections4/iterators/ObjectArrayListIterator.java index 758f1e2..ae9e1d0 100644 --- a/src/main/java/org/apache/commons/collections4/iterators/ObjectArrayListIterator.java +++ b/src/main/java/org/apache/commons/collections4/iterators/ObjectArrayListIterator.java @@ -29,6 +29,7 @@ import org.apache.commons.collections4.ResettableListIterator; * The iterator implements a {@link #reset} method, allowing the reset of the iterator * back to the start if required. * + * @param <E> the type of elements returned by this iterator. * @see org.apache.commons.collections4.iterators.ObjectArrayIterator * @see java.util.Iterator * @see java.util.ListIterator diff --git a/src/main/java/org/apache/commons/collections4/iterators/ObjectGraphIterator.java b/src/main/java/org/apache/commons/collections4/iterators/ObjectGraphIterator.java index 0eb97a0..4ae0c87 100644 --- a/src/main/java/org/apache/commons/collections4/iterators/ObjectGraphIterator.java +++ b/src/main/java/org/apache/commons/collections4/iterators/ObjectGraphIterator.java @@ -71,6 +71,7 @@ import org.apache.commons.collections4.Transformer; * Under many circumstances, linking Iterators together in this manner is * more efficient (and convenient) than using nested for loops to extract a list. * + * @param <E> the type of elements returned by this iterator. * @since 3.1 */ public class ObjectGraphIterator<E> implements Iterator<E> { diff --git a/src/main/java/org/apache/commons/collections4/iterators/PeekingIterator.java b/src/main/java/org/apache/commons/collections4/iterators/PeekingIterator.java index f795fbe..d28060b 100644 --- a/src/main/java/org/apache/commons/collections4/iterators/PeekingIterator.java +++ b/src/main/java/org/apache/commons/collections4/iterators/PeekingIterator.java @@ -28,6 +28,7 @@ import java.util.Objects; * will be thrown if {@link #remove()} is called directly after a call to * {@link #peek()} or {@link #element()}. * + * @param <E> the type of elements returned by this iterator. * @since 4.0 */ public class PeekingIterator<E> implements Iterator<E> { diff --git a/src/main/java/org/apache/commons/collections4/iterators/PushbackIterator.java b/src/main/java/org/apache/commons/collections4/iterators/PushbackIterator.java index 3f79721..a529354 100644 --- a/src/main/java/org/apache/commons/collections4/iterators/PushbackIterator.java +++ b/src/main/java/org/apache/commons/collections4/iterators/PushbackIterator.java @@ -31,6 +31,7 @@ import java.util.Objects; * The decorator does not support the removal operation. Any call to {@link #remove()} will * result in an {@link UnsupportedOperationException}. * + * @param <E> the type of elements returned by this iterator. * @since 4.0 */ public class PushbackIterator<E> implements Iterator<E> { diff --git a/src/main/java/org/apache/commons/collections4/iterators/ReverseListIterator.java b/src/main/java/org/apache/commons/collections4/iterators/ReverseListIterator.java index ff4c2d8..3e45aa8 100644 --- a/src/main/java/org/apache/commons/collections4/iterators/ReverseListIterator.java +++ b/src/main/java/org/apache/commons/collections4/iterators/ReverseListIterator.java @@ -34,6 +34,7 @@ import org.apache.commons.collections4.ResettableListIterator; * index in the list, thus it starts high and reduces as the iteration * continues. The previous methods work similarly. * + * @param <E> the type of elements returned by this iterator. * @since 3.2 */ public class ReverseListIterator<E> implements ResettableListIterator<E> { diff --git a/src/main/java/org/apache/commons/collections4/iterators/SingletonIterator.java b/src/main/java/org/apache/commons/collections4/iterators/SingletonIterator.java index 6ccec88..95b018f 100644 --- a/src/main/java/org/apache/commons/collections4/iterators/SingletonIterator.java +++ b/src/main/java/org/apache/commons/collections4/iterators/SingletonIterator.java @@ -24,6 +24,7 @@ import org.apache.commons.collections4.ResettableIterator; * {@code SingletonIterator} is an {@link java.util.Iterator} over a single * object instance. * + * @param <E> the type of elements returned by this iterator. * @since 2.0 */ public class SingletonIterator<E> diff --git a/src/main/java/org/apache/commons/collections4/iterators/SingletonListIterator.java b/src/main/java/org/apache/commons/collections4/iterators/SingletonListIterator.java index 312f393..5f4ea60 100644 --- a/src/main/java/org/apache/commons/collections4/iterators/SingletonListIterator.java +++ b/src/main/java/org/apache/commons/collections4/iterators/SingletonListIterator.java @@ -24,6 +24,7 @@ import org.apache.commons.collections4.ResettableListIterator; * {@code SingletonIterator} is an {@link java.util.ListIterator} over a single * object instance. * + * @param <E> the type of elements returned by this iterator. * @since 2.1 */ public class SingletonListIterator<E> implements ResettableListIterator<E> { diff --git a/src/main/java/org/apache/commons/collections4/iterators/SkippingIterator.java b/src/main/java/org/apache/commons/collections4/iterators/SkippingIterator.java index 5be06cf..f86559b 100644 --- a/src/main/java/org/apache/commons/collections4/iterators/SkippingIterator.java +++ b/src/main/java/org/apache/commons/collections4/iterators/SkippingIterator.java @@ -23,6 +23,7 @@ import java.util.Iterator; * before that position. * </p> * + * @param <E> the type of elements returned by this iterator. * @since 4.1 */ public class SkippingIterator<E> extends AbstractIteratorDecorator<E> { diff --git a/src/main/java/org/apache/commons/collections4/iterators/UniqueFilterIterator.java b/src/main/java/org/apache/commons/collections4/iterators/UniqueFilterIterator.java index 80b01de..059bbec 100644 --- a/src/main/java/org/apache/commons/collections4/iterators/UniqueFilterIterator.java +++ b/src/main/java/org/apache/commons/collections4/iterators/UniqueFilterIterator.java @@ -25,6 +25,7 @@ import org.apache.commons.collections4.functors.UniquePredicate; * the Iterator maintains a Set of objects it has already encountered, * and duplicate Objects are skipped. * + * @param <E> the type of elements returned by this iterator. * @since 2.1 */ public class UniqueFilterIterator<E> extends FilterIterator<E> { diff --git a/src/main/java/org/apache/commons/collections4/iterators/UnmodifiableIterator.java b/src/main/java/org/apache/commons/collections4/iterators/UnmodifiableIterator.java index 0992cb8..13b8052 100644 --- a/src/main/java/org/apache/commons/collections4/iterators/UnmodifiableIterator.java +++ b/src/main/java/org/apache/commons/collections4/iterators/UnmodifiableIterator.java @@ -27,6 +27,7 @@ import org.apache.commons.collections4.Unmodifiable; * Attempts to modify it will result in an UnsupportedOperationException. * </p> * + * @param <E> the type of elements returned by this iterator. * @since 3.0 */ public final class UnmodifiableIterator<E> implements Iterator<E>, Unmodifiable { diff --git a/src/main/java/org/apache/commons/collections4/iterators/UnmodifiableListIterator.java b/src/main/java/org/apache/commons/collections4/iterators/UnmodifiableListIterator.java index 3178d5e..a325b34 100644 --- a/src/main/java/org/apache/commons/collections4/iterators/UnmodifiableListIterator.java +++ b/src/main/java/org/apache/commons/collections4/iterators/UnmodifiableListIterator.java @@ -27,6 +27,7 @@ import org.apache.commons.collections4.Unmodifiable; * Attempts to modify it will result in an UnsupportedOperationException. * </p> * + * @param <E> the type of elements returned by this iterator. * @since 3.0 */ public final class UnmodifiableListIterator<E> implements ListIterator<E>, Unmodifiable { diff --git a/src/main/java/org/apache/commons/collections4/iterators/ZippingIterator.java b/src/main/java/org/apache/commons/collections4/iterators/ZippingIterator.java index 5e6ba8d..0844385 100644 --- a/src/main/java/org/apache/commons/collections4/iterators/ZippingIterator.java +++ b/src/main/java/org/apache/commons/collections4/iterators/ZippingIterator.java @@ -33,6 +33,7 @@ import org.apache.commons.collections4.FluentIterable; * and {@code B.next()} until both iterators are exhausted. * </p> * + * @param <E> the type of elements returned by this iterator. * @since 4.1 */ public class ZippingIterator<E> implements Iterator<E> {