Remove await example

Author: eldruin

src/lib.rs

@@ -375,94 +375,6 @@
 //! # }
 //! ```
 //!
-//! ### `await`
-//!
-//! Same example as above but using `await!` instead of `futures`
-//! (same remark concerning the availability of `libstd` on the
-//! target).
-//!
-//! ```no_run
-//! #![feature(generator_trait)]
-//! #![feature(generators)]
-//!
-//! extern crate embedded_hal as hal;
-//!
-//! #[macro_use(r#await)]
-//! extern crate nb;
-//!
-//! use core::ops::Generator;
-//! use core::pin::Pin;
-//!
-//! use hal::prelude::*;
-//! use stm32f30x_hal::{Led, Serial1, Timer6};
-//!
-//! fn main() {
-//!     // HAL implementers
-//!     let mut timer: Timer6 = {
-//!         // ..
-//! #       Timer6
-//!     };
-//!     let mut serial: Serial1 = {
-//!         // ..
-//! #       Serial1
-//!     };
-//!     let mut led: Led = {
-//!         // ..
-//! #       Led
-//!     };
-//!
-//!     // Tasks
-//!     let mut blinky = (move || {
-//!         let mut state = false;
-//!         loop {
-//!             // `await!` means "suspend / yield here" instead of "block until
-//!             // completion"
-//!             nb::r#await!(timer.try_wait()).unwrap(); // NOTE(unwrap) E = Infallible
-//!
-//!             state = !state;
-//!
-//!             if state {
-//!                 led.on();
-//!             } else {
-//!                 led.off();
-//!             }
-//!         }
-//!     });
-//!
-//!     let mut loopback = (move || {
-//!         loop {
-//!             let byte = nb::r#await!(serial.try_read()).unwrap();
-//!             nb::r#await!(serial.try_write(byte)).unwrap();
-//!         }
-//!     });
-//!
-//!     // Event loop
-//!     loop {
-//!         Pin::new(&mut blinky).resume(());
-//!         Pin::new(&mut loopback).resume(());
-//!         # break;
-//!     }
-//! }
-//!
-//! # mod stm32f30x_hal {
-//! #   use core::convert::Infallible;
-//! #   pub struct Serial1;
-//! #   impl Serial1 {
-//! #       pub fn try_read(&mut self) -> ::nb::Result<u8, Infallible> { Err(::nb::Error::WouldBlock) }
-//! #       pub fn try_write(&mut self, _: u8) -> ::nb::Result<(), Infallible> { Err(::nb::Error::WouldBlock) }
-//! #   }
-//! #   pub struct Timer6;
-//! #   impl Timer6 {
-//! #       pub fn try_wait(&mut self) -> ::nb::Result<(), Infallible> { Err(::nb::Error::WouldBlock) }
-//! #   }
-//! #   pub struct Led;
-//! #   impl Led {
-//! #       pub fn off(&mut self) {}
-//! #       pub fn on(&mut self) {}
-//! #   }
-//! # }
-//! ```
-//!
 //! ## Generic programming and higher level abstractions
 //!
 //! The core of the HAL has been kept minimal on purpose to encourage building **generic** higher