Explain how to initialize the RNGs

Also fix some typos.

Author: vks

rand_hc/src/lib.rs

@@ -7,6 +7,8 @@
 // except according to those terms.
 
 //! The HC128 random number generator.
+//!
+//! To initialize a generator, use the [`SeedableRng`][rand_core::SeedableRng] trait.
 
 #![doc(
     html_logo_url = "https://www.rust-lang.org/logos/rust-logo-128x128-blk.png",

rand_isaac/src/lib.rs

@@ -1,4 +1,4 @@
-// Copyright 2018 Developers of the Rand project.
+// Copyright 2018-2023 Developers of the Rand project.
 //
 // Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
 // https://www.apache.org/licenses/LICENSE-2.0> or the MIT license
@@ -7,6 +7,8 @@
 // except according to those terms.
 
 //! The ISAAC and ISAAC-64 random number generators.
+//!
+//! To initialize a generator, use the [`SeedableRng`][rand_core::SeedableRng] trait.
 
 #![doc(html_logo_url = "https://www.rust-lang.org/logos/rust-logo-128x128-blk.png",
        html_favicon_url = "https://www.rust-lang.org/favicon.ico",

rand_xorshift/src/lib.rs

@@ -1,4 +1,4 @@
-// Copyright 2018 Developers of the Rand project.
+// Copyright 2018-2023 Developers of the Rand project.
 //
 // Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
 // https://www.apache.org/licenses/LICENSE-2.0> or the MIT license
@@ -7,6 +7,18 @@
 // except according to those terms.
 
 //! The xorshift random number generator.
+//!
+//! # Example
+//!
+//! To initialize a generator, use the [`SeedableRng`][rand_core::SeedableRng] trait:
+//!
+//! ```
+//! use rand_core::{SeedableRng, RngCore};
+//! use rand_xorshift::XorShiftRng;
+//!
+//! let mut rng = XorShiftRng::seed_from_u64(0);
+//! let x = rng.next_u32();
+//! ```
 
 #![doc(html_logo_url = "https://www.rust-lang.org/logos/rust-logo-128x128-blk.png",
        html_favicon_url = "https://www.rust-lang.org/favicon.ico",

rand_xoshiro/src/lib.rs

@@ -1,4 +1,4 @@
-// Copyright 2018 Developers of the Rand project.
+// Copyright 2018-2023 Developers of the Rand project.
 //
 // Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
 // https://www.apache.org/licenses/LICENSE-2.0> or the MIT license
@@ -8,7 +8,7 @@
 
 //! This crate implements the [xoshiro] family of pseudorandom number generators
 //! designed by David Blackman and Sebastiano Vigna. They feature high
-//! perfomance and a small state and supersede the previous xorshift-based
+//! performance and a small state and supersede the previous xorshift-based
 //! generators. However, they are not cryptographically secure and their output
 //! can be predicted by observing a few samples.
 //!
@@ -61,9 +61,21 @@
 //!   lowest bits (which are discarded when generating floats), making it fail
 //!   linearity tests. This is unlikely to have any impact in practise.
 //!
-//! The `*PlusPlus` generators perform similarily to the `*StarStar` generators.
+//! The `*PlusPlus` generators perform similarly to the `*StarStar` generators.
 //! See the [xoshiro paper], where the differences are discussed in detail.
 //!
+//! # Example
+//!
+//! To initialize a generator, use the [`SeedableRng`][rand_core::SeedableRng] trait:
+//!
+//! ```
+//! use rand_core::{SeedableRng, RngCore};
+//! use rand_xoshiro::Xoshiro256PlusPlus;
+//!
+//! let mut rng = Xoshiro256PlusPlus::seed_from_u64(0);
+//! let x = rng.next_u64();
+//! ```
+//!
 //! [xoshiro]: http://xoshiro.di.unimi.it/
 //! [xoshiro paper]: http://vigna.di.unimi.it/ftp/papers/ScrambledLinear.pdf
 //! [low linear complexity]: http://xoshiro.di.unimi.it/lowcomp.php