Run doctests in CI

Author: Jonas Schievink

nrf-hal-common/src/saadc.rs

@@ -2,7 +2,8 @@
 //!
 //! Example usage:
 //!
-//! ```no_run
+#![cfg_attr(feature = "52840", doc = "```no_run")]
+#![cfg_attr(not(feature = "52840"), doc = "```ignore")]
 //! # use nrf_hal_common as hal;
 //! # use hal::pac::{saadc, SAADC};
 //! // subsititute `hal` with the HAL of your board, e.g. `nrf52840_hal`
@@ -115,7 +116,8 @@ pub struct SaadcConfig {
 /// Default SAADC configuration. 0 volts reads as 0, VDD volts reads as `u16::MAX`.
 /// The returned SaadcConfig is configured with the following values:
 ///
-/// ```rust
+#[cfg_attr(feature = "52840", doc = "```")]
+#[cfg_attr(not(feature = "52840"), doc = "```ignore")]
 /// # use nrf_hal_common::saadc::SaadcConfig;
 /// # use nrf_hal_common::pac::{saadc, SAADC};
 /// # use saadc::{

xtask/tests/ci.rs

@@ -47,6 +47,24 @@ fn main() {
         );
     }
 
+    // Build/Run doc-tests in `nrf-hal-common` for each chip.
+    for (hal, _) in HALS {
+        let feature = hal.trim_start_matches("nrf").trim_end_matches("-hal");
+
+        let mut cargo = Command::new("cargo");
+        let status = cargo
+            .current_dir("nrf-hal-common")
+            .args(&["test", "--features", feature])
+            .status()
+            .map_err(|e| format!("could not execute {:?}: {}", cargo, e))
+            .unwrap();
+        assert!(
+            status.success(),
+            "command exited with error status: {:?}",
+            cargo
+        );
+    }
+
     // Build-test every example with each supported feature.
     for (example, features) in EXAMPLES {
         // Features are exclusive (they select the target chip), so we test each one