From 46901b62c8dcada3feefb6b529999e17153c5f8f Mon Sep 17 00:00:00 2001
From: Kirill Mikhailov <konnor1980@yandex.ru>
Date: Mon, 1 Jul 2024 15:11:47 +0200
Subject: [PATCH] Doc comments fix

fmt
---
 esp-hal/src/rng.rs | 30 ++++++++++++++++++++----------
 1 file changed, 20 insertions(+), 10 deletions(-)

diff --git a/esp-hal/src/rng.rs b/esp-hal/src/rng.rs
index fba85585b21..f43f8a6d60f 100644
--- a/esp-hal/src/rng.rs
+++ b/esp-hal/src/rng.rs
@@ -131,27 +131,37 @@ impl rand_core::RngCore for Rng {
 /// Due to pulling the entropy source from the ADC, it uses the associated
 /// regiters, so to use TRNG we need to "occupy" the ADC peripheral.
 ///
-/// ```rust, ignore
+/// ```rust, no_run
+#[doc = crate::before_snippet!()]
+/// # use esp_hal::rng::Trng;
+/// # use esp_hal::peripherals::Peripherals;
+/// # use esp_hal::peripherals::ADC1;
+/// # use esp_hal::analog::adc::{AdcConfig, Attenuation, Adc};
+/// # use esp_hal::gpio::Io;
+///
+/// let mut peripherals = Peripherals::take();
+/// let io = Io::new(peripherals.GPIO, peripherals.IO_MUX);
 /// let mut buf = [0u8; 16];
+///
+/// // ADC is not available from now
 /// let mut trng = Trng::new(peripherals.RNG, &mut peripherals.ADC1);
 /// trng.read(&mut buf);
-///
-/// println!("TRNG: Random bytes: {:?}", buf);
-/// println!("TRNG: Random u32:  {}", rng.random());
+/// let mut true_rand = trng.random();
 ///
 /// let mut rng = trng.downgrade();
 ///
+/// // ADC is available now
 /// let analog_pin = io.pins.gpio3;
 /// let mut adc1_config = AdcConfig::new();
-/// let mut adc1_pin = adc1_config.enable_pin(analog_pin, Attenuation::Attenuation11dB);
-/// let mut adc1 = Adc::<ADC1>::new(peripherals.ADC1, adc1_config);
-/// let pin_value: u16 = nb::block!(adc1.read_oneshot(&mut adc1_pin)).unwrap();
+/// let mut adc1_pin = adc1_config.enable_pin(analog_pin,
+/// Attenuation::Attenuation11dB); let mut adc1 =
+/// Adc::<ADC1>::new(peripherals.ADC1, adc1_config); let pin_value: u16 =
+/// nb::block!(adc1.read_oneshot(&mut adc1_pin)).unwrap();
 ///
 /// rng.read(&mut buf);
-/// println!("Random bytes: {:?}", buf);
-/// println!("Random u32:  {}", rng.random());
+/// true_rand = rng.random();
 /// let pin_value: u16 = nb::block!(adc1.read_oneshot(&mut adc1_pin)).unwrap();
-/// println!("ADC reading = {}", pin_value);
+/// # }
 /// ```
 
 pub struct Trng<'d> {