Clarified the documentation on core::iter::from_fn and core::iter::successors

Author: ranger-ross

library/core/src/iter/sources/from_fn.rs

@@ -1,7 +1,7 @@
 use crate::fmt;
 
 /// Creates a new iterator where each iteration calls the provided closure
-/// `F: FnMut() -> Option<T>`.
+/// `F: FnMut() -> Option<T>`. The iterator will yield the `T`'s returned from the closure until it returns `None`.
 ///
 /// This allows creating a custom iterator with any behavior
 /// without using the more verbose syntax of creating a dedicated type

library/core/src/iter/sources/successors.rs

@@ -5,6 +5,7 @@ use crate::iter::FusedIterator;
 ///
 /// The iterator starts with the given first item (if any)
 /// and calls the given `FnMut(&T) -> Option<T>` closure to compute each item’s successor.
+/// The iterator will yield the `T`'s returned from the closure until it returns `None`.
 ///
 /// ```
 /// use std::iter::successors;