- Reverting changes since these break binary compatibility. Setting Jira

tickets to 5.0.
- [COLLECTIONS-675] Modify IteratorUtils.peekingIterator signature to
return PeekingIterator.
- [COLLECTIONS-676] Modify IteratorUtils.pushbackIterator signature to
return PushbackIterator.

src/changes/changes.xml

@@ -87,12 +87,6 @@
     <action issue="COLLECTIONS-671" dev="ggregory" type="add" due-to="Gary Gregory">
       Add org.apache.commons.collections4.IterableUtils.first(Iterable).
     </action>
-    <action issue="COLLECTIONS-675" dev="ggregory" type="add" due-to="Matthew Knight">
-      Modify IteratorUtils.peekingIterator signature to return PeekingIterator.
-    </action>
-    <action issue="COLLECTIONS-676" dev="ggregory" type="add" due-to="Matthew Knight">
-      Modify IteratorUtils.pushbackIterator signature to return PushbackIterator.
-    </action>
     <action issue="COLLECTIONS-678" dev="ggregory" type="fix" due-to="Oscar Luis Vera Pérez">
       The verification of unsupported iterator methods is not complete.
     </action>

src/main/java/org/apache/commons/collections4/IteratorUtils.java

@@ -856,9 +856,8 @@ public class IteratorUtils {
      * @return a peeking iterator
      * @throws NullPointerException if the iterator is null
      * @since 4.0
-     * @since 4.2 returns a {@link PeekingIterator} instead of a {@link Iterator}.
      */
-    public static <E> PeekingIterator<E> peekingIterator(final Iterator<? extends E> iterator) {
+    public static <E> Iterator<E> peekingIterator(final Iterator<? extends E> iterator) {
         return PeekingIterator.peekingIterator(iterator);
     }
 
@@ -873,9 +872,8 @@ public class IteratorUtils {
      * @return a pushback iterator
      * @throws NullPointerException if the iterator is null
      * @since 4.0
-     * @since 4.2 returns a {@link PushbackIterator} instead of a {@link Iterator}.
      */
-    public static <E> PushbackIterator<E> pushbackIterator(final Iterator<? extends E> iterator) {
+    public static <E> Iterator<E> pushbackIterator(final Iterator<? extends E> iterator) {
         return PushbackIterator.pushbackIterator(iterator);
     }