Iterator: document that this iterator behavior ...

Iterator: document that this iterator behavior is undefined after
takeWhile and dropWhile invocation (#1246)

1 files changed, 4 insertions, 0 deletions

diff --git a/src/library/scala/Iterator.scala b/src/library/scala/Iterator.scala
index 5374ffdb02..a73da940ae 100644
--- a/src/library/scala/Iterator.scala
+++ b/src/library/scala/Iterator.scala
@@ -351,6 +351,8 @@ trait Iterator[+A] {
    *  all elements of the result satisfy the predicate <code>p</code>.
    *  The order of the elements is preserved.
    *
+   *  The behavior of <code>this</code> iterator is undefined after this method invocation.
+   *
    *  @param p the predicate used to filter the iterator.
    *  @return  the longest prefix of this iterator satisfying <code>p</code>.
    */
@@ -359,6 +361,8 @@ trait Iterator[+A] {
   /** Skips longest sequence of elements of this iterator which satisfy given
    *  predicate <code>p</code>, and returns an iterator of the remaining elements.
    *
+   *  The behavior of <code>this</code> iterator is undefined after this method invocation.
+   *
    *  @param p the predicate used to skip elements.
    *  @return  an iterator consisting of the remaining elements
    */