diff --git a/tokio/src/runtime/task/join.rs b/tokio/src/runtime/task/join.rs
index 60e26cc39d8..6c4e600b12c 100644
--- a/tokio/src/runtime/task/join.rs
+++ b/tokio/src/runtime/task/join.rs
@@ -184,6 +184,7 @@ impl<T> JoinHandle<T> {
     ///
     /// #[tokio::main]
     /// async fn main() {
+    /// #  tokio::time::pause();
     ///    let mut handles = Vec::new();
     ///
     ///    handles.push(tokio::spawn(async {
@@ -262,6 +263,7 @@ impl<T> JoinHandle<T> {
     ///
     /// #[tokio::main]
     /// async fn main() {
+    /// #  tokio::time::pause();
     ///    let mut handles = Vec::new();
     ///
     ///    handles.push(tokio::spawn(async {