diff --git a/tokio/src/sync/mpsc/mod.rs b/tokio/src/sync/mpsc/mod.rs index 3df612ca4..46363f933 100644 --- a/tokio/src/sync/mpsc/mod.rs +++ b/tokio/src/sync/mpsc/mod.rs @@ -29,7 +29,9 @@ //! //! When all [`Sender`] handles have been dropped, it is no longer //! possible to send values into the channel. This is considered the termination -//! event of the stream. As such, `Receiver::poll` returns `Ok(Ready(None))`. +//! event of the stream. Once all senders have been dropped and any remaining +//! buffered values have been received, `Receiver::recv` returns `None` +//! (and `Receiver::poll_recv` returns `Poll::Ready(None)`). //! //! If the [`Receiver`] handle is dropped, then messages can no longer //! be read out of the channel. In this case, all further attempts to send will