Merge remote-tracking branch 'origin/master' into dsharifi/watch-dont…

…-return-error-unseen-value

tokio/src/sync/watch.rs

@@ -732,18 +732,17 @@ impl<T> Receiver<T> {
     ///
     /// If the current value in the channel has not yet been marked seen when
     /// this method is called, the method marks that value seen and returns
-    /// immediately. If the current value has already been marked seen, then the
-    /// method sleeps until a new message is sent by the [`Sender`] connected to
-    /// this `Receiver`, or until the [`Sender`] is dropped.
-    ///
+    /// immediately. If the newest value has already been marked seen, then the
+    /// method sleeps until a new message is sent by a [`Sender`] connected to
+    /// this `Receiver`, or until all [`Sender`]s are dropped.
     ///
     /// For more information, see
     /// [*Change notifications*](self#change-notifications) in the module-level documentation.
     ///
     /// # Errors
     ///
-    /// Returns a [`RecvError`](error::RecvError) if the channel has been closed __AND__
-    /// the current value is seen.
+    /// This method returns a [`RecvError`](error::RecvError) if and only if all [`Sender`]s
+    /// are dropped.
     ///
     /// # Cancel safety
     ///