Include this code as blocks instead

book/en/src/by-example/delay.md

@@ -9,13 +9,8 @@ This can be achieved by instantiating a monotonic timer (for implementations, se
 
 ``` rust
 ...
-#[init]
+{{#include ../../../../rtic/examples/async-timeout.rs:init}}
-fn init(cx: init::Context) -> (Shared, Local) {
+        ...
-    hprintln!("init");
-
-    let token = rtic_monotonics::create_systick_token!();
-    Systick::start(cx.core.SYST, 12_000_000, token);
-    ...
 ```
 
 A *software* task can `await` the delay to expire:
@@ -63,12 +58,8 @@ A common use case is transactions with an associated timeout. In the examples sh
 
 Using the `select_biased` macro from the `futures` crate it may look like this:
 
-``` rust
+``` rust,noplayground
-// Call hal with short relative timeout using `select_biased`
+{{#include ../../../../rtic/examples/async-timeout.rs:select_biased}}
-select_biased! {
-    v = hal_get(1).fuse() => hprintln!("hal returned {}", v),
-    _ = Systick::delay(200.millis()).fuse() =>  hprintln!("timeout", ), // this will finish first
-}
 ```
 
 Assuming the `hal_get` will take 450ms to finish, a short timeout of 200ms will expire before `hal_get` can complete.
@@ -80,11 +71,7 @@ Using `select_biased` any number of futures can be combined, so its very powerfu
 Rewriting the second example from above using `timeout_after` gives:
 
 ``` rust
-// Call hal with long relative timeout using monotonic `timeout_after`
+{{#include ../../../../rtic/examples/async-timeout.rs:timeout_at_basic}}
-match Systick::timeout_after(1000.millis(), hal_get(1)).await {
-    Ok(v) => hprintln!("hal returned {}", v),
-    _ => hprintln!("timeout"),
-}
 ```
 
 In cases where you want exact control over time without drift we can use exact points in time using `Instant`, and spans of time using `Duration`. Operations on the `Instant` and `Duration` types come from the [`fugit`] crate.
@@ -92,24 +79,9 @@ In cases where you want exact control over time without drift we can use exact p
 [fugit]: https://crates.io/crates/fugit
 
 ``` rust
-// get the current time instance
-let mut instant = Systick::now();
 
-// do this 3 times
+{{#include ../../../../rtic/examples/async-timeout.rs:timeout_at}}
-for n in 0..3 {
-    // absolute point in time without drift
-    instant += 1000.millis();
-    Systick::delay_until(instant).await;
 
-    // absolute point it time for timeout
-    let timeout = instant + 500.millis();
-    hprintln!("now is {:?}, timeout at {:?}", Systick::now(), timeout);
-
-    match Systick::timeout_at(timeout, hal_get(n)).await {
-        Ok(v) => hprintln!("hal returned {} at time {:?}", v, Systick::now()),
-        _ => hprintln!("timeout"),
-    }
-}
 ```
 
 `let mut instant = Systick::now()` sets the starting time of execution. 

rtic/examples/async-timeout.rs

@@ -23,12 +23,14 @@ mod app {
     #[local]
     struct Local {}
 
+    // ANCHOR: init
     #[init]
     fn init(cx: init::Context) -> (Shared, Local) {
         hprintln!("init");
 
         let systick_token = rtic_monotonics::create_systick_token!();
         Systick::start(cx.core.SYST, 12_000_000, systick_token);
+        // ANCHOR_END: init
 
         foo::spawn().ok();
 
@@ -37,6 +39,7 @@ mod app {
 
     #[task]
     async fn foo(_cx: foo::Context) {
+        // ANCHOR: select_biased
         // Call hal with short relative timeout using `select_biased`
         select_biased! {
             v = hal_get(1).fuse() => hprintln!("hal returned {}", v),
@@ -48,13 +51,17 @@ mod app {
             v = hal_get(1).fuse() => hprintln!("hal returned {}", v), // hal finish first
             _ = Systick::delay(1000.millis()).fuse() =>  hprintln!("timeout", ),
         }
+        // ANCHOR_END: select_biased
 
+        // ANCHOR: timeout_after_basic
         // Call hal with long relative timeout using monotonic `timeout_after`
         match Systick::timeout_after(1000.millis(), hal_get(1)).await {
             Ok(v) => hprintln!("hal returned {}", v),
             _ => hprintln!("timeout"),
         }
+        // ANCHOR_END: timeout_after_basic
 
+        // ANCHOR: timeout_at
         // get the current time instance
         let mut instant = Systick::now();
 
@@ -73,6 +80,7 @@ mod app {
                 _ => hprintln!("timeout"),
             }
         }
+        // ANCHOR_END: timeout_at
 
         debug::exit(debug::EXIT_SUCCESS);
     }