Use docsrs doc(cfg(...)) feature

Author: Sh3Rm4n

Cargo.toml

@@ -22,6 +22,7 @@ exclude = [
 [package.metadata.docs.rs]
 features = ["stm32f303xc", "rt", "stm32-usbd", "can"]
 targets = ["thumbv7em-none-eabihf"]
+rustc-args = ["--cfg", "docsrs"]
 
 [dependencies]
 cfg-if = "1"

src/adc.rs

@@ -1,4 +1,4 @@
-//! Analog to Digital Converter. (Requires feature `stm32f303x[bcde]`)
+//! Analog to Digital Converter.
 //!
 //! # Examples
 //!

src/can.rs

@@ -1,4 +1,4 @@
-//! Controller Area Network (Requires feature `can`)
+//! Controller Area Network.
 //!
 //! CAN is currently not enabled by default, and
 //! can be enabled by the `can` feature.

src/dma.rs

@@ -1,4 +1,4 @@
-//! Direct memory access (DMA) controller. (Requires feature `stm32f303*` or `stm32f302*`)
+//! Direct memory access (DMA) controller.
 //!
 //! Currently DMA is only supported for STM32F303 or STM32F302 MCUs.
 //!

src/lib.rs

@@ -125,11 +125,14 @@ pub use stm32f3::stm32f3x4 as pac;
 pub use crate::pac::interrupt;
 
 #[cfg(feature = "stm32f303")]
+#[cfg_attr(docsrs, doc(cfg(feature = "stm32f303")))]
 pub mod adc;
 #[cfg(feature = "can")]
+#[cfg_attr(docsrs, doc(cfg(feature = "can")))]
 pub mod can;
 pub mod delay;
 #[cfg(any(feature = "stm32f302", feature = "stm32f303"))]
+#[cfg_attr(docsrs, doc(cfg(any(feature = "stm32f302", feature = "stm32f303"))))]
 pub mod dma;
 pub mod flash;
 pub mod gpio;
@@ -151,6 +154,7 @@ pub mod timer;
         feature = "stm32f303xe",
     ),
 ))]
+#[cfg_attr(docsrs, doc(cfg(feature = "stm32-usbd")))]
 pub mod usb;
 pub mod watchdog;
 

src/usb.rs

@@ -1,4 +1,4 @@
-//! USB peripheral. (Requires feature `stm32-usbd`)
+//! USB peripheral.
 //!
 //! See [examples/usb_serial.rs] for a usage example.
 //!