Add example for using rand (#1347)

rand_pcg/Cargo.toml

@@ -26,6 +26,7 @@ rand_core = { path = "../rand_core", version = "0.7.0" }
 serde = { version = "1", features = ["derive"], optional = true }
 
 [dev-dependencies]
+rand = { path = "..", version = "0.9" }
 # This is for testing serde, unfortunately we can't specify feature-gated dev
 # deps yet, see: https://github.com/rust-lang/cargo/issues/1596
 # Versions prior to 1.1.4 had incorrect minimal dependencies.

rand_pcg/src/lib.rs

@@ -32,14 +32,24 @@
 //!
 //! To initialize a generator, use the [`SeedableRng`][rand_core::SeedableRng] trait:
 //!
-//! ```rust
+//! ```
 //! use rand_core::{SeedableRng, RngCore};
 //! use rand_pcg::Pcg64Mcg;
 //!
 //! let mut rng = Pcg64Mcg::seed_from_u64(0);
-//! // Alternatively, you may use `Pcg64Mcg::from_entropy()`.
 //! let x: u32 = rng.next_u32();
 //! ```
+//!
+//! The functionality of this crate is implemented using traits from the `rand_core` crate, but you may use the `rand`
+//! crate for further functionality to initialize the generator from various sources and to generate random values:
+//!
+//! ```
+//! use rand::{Rng, SeedableRng};
+//! use rand_pcg::Pcg64Mcg;
+//!
+//! let mut rng = Pcg64Mcg::from_entropy();
+//! let x: f64 = rng.gen();
+//! ```
 
 #![doc(
     html_logo_url = "https://www.rust-lang.org/logos/rust-logo-128x128-blk.png",