diff --git a/tokio/src/stream/mod.rs b/tokio/src/stream/mod.rs
index 94ed6bd12..b427e3c42 100644
--- a/tokio/src/stream/mod.rs
+++ b/tokio/src/stream/mod.rs
@@ -39,7 +39,8 @@ pub use futures_core::Stream;
/// An extension trait for `Stream`s that provides a variety of convenient
/// combinator functions.
pub trait StreamExt: Stream {
- /// Creates a future that resolves to the next item in the stream.
+ /// Consumes and returns the next value in the stream or `None` if the
+ /// stream is finished.
///
/// Equivalent to:
///
@@ -76,8 +77,14 @@ pub trait StreamExt: Stream {
Next::new(self)
}
- /// Creates a future that attempts to resolve the next item in the stream.
- /// If an error is encountered before the next item, the error is returned instead.
+ /// Consumes and returns the next item in the stream. If an error is
+ /// encountered before the next item, the error is returned instead.
+ ///
+ /// Equivalent to:
+ ///
+ /// ```ignore
+ /// async fn try_next(&mut self) -> Result