diff --git a/library/core/src/task/wake.rs b/library/core/src/task/wake.rs index 301cfacb554ad..9e74bcc541ea2 100644 --- a/library/core/src/task/wake.rs +++ b/library/core/src/task/wake.rs @@ -228,6 +228,10 @@ impl Waker { /// /// Note that the above implies that multiple wake-ups may be coalesced into a /// single `poll` invocation by the runtime. + /// + /// Also note that yielding to competing tasks is not guaranteed: it is the + /// executor’s choice which task to run and the executor may choose to run the + /// current task again. #[inline] #[stable(feature = "futures_api", since = "1.36.0")] pub fn wake(self) {