From 2d0e4ed0aaa422c0fa6e797c635f22aa607469b0 Mon Sep 17 00:00:00 2001
From: Steve Klabnik <steve@steveklabnik.com>
Date: Mon, 25 Jan 2016 22:37:00 -0500
Subject: [PATCH] Describe next_back() wrt Iterator protocol

Fixes #30633
---
 src/libcore/iter.rs | 6 ++++++
 1 file changed, 6 insertions(+)

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<A> {
 /// 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: