diff --git a/src/libcore/iter.rs b/src/libcore/iter.rs index e3e783329ec81..ddc4fb32cde4e 100644 --- a/src/libcore/iter.rs +++ b/src/libcore/iter.rs @@ -2740,7 +2740,13 @@ pub trait Extend { /// It is important to note that both back and forth work on the same range, /// and do not cross: iteration is over when they meet in the middle. /// +/// In a similar fashion to the [`Iterator`] protocol, once a +/// `DoubleEndedIterator` returns `None` from a `next_back()`, calling it again +/// may or may not ever return `Some` again. `next()` and `next_back()` are +/// interchangable for this purpose. +/// /// [`Iterator`]: trait.Iterator.html +/// /// # Examples /// /// Basic usage: