comment!

Author: pchickey

src/runtime/block_on.rs

@@ -49,6 +49,10 @@ where
     res
 }
 
+/// This waker is used in the Context of block_on. If a Future executing in
+/// the block_on calls context.wake(), it sets this boolean state so that
+/// block_on's Future is polled again immediately, rather than waiting for
+/// an external (WASI pollable) event before polling again.
 struct RootWaker {
     wake: AtomicBool,
 }

src/runtime/reactor.rs

@@ -281,6 +281,8 @@ mod test {
             let later = wasi::clocks::monotonic_clock::subscribe_duration(LONG_DURATION);
             let later = reactor.schedule(later);
             let mut polled_before = false;
+            // This is basically futures_lite::future::yield_now, except with a boolean
+            // `polled_before` so we can definitively observe what happened
             let wasi_independent_future = futures_lite::future::poll_fn(|cx| {
                 if polled_before {
                     std::task::Poll::Ready(true)