fix docs

Author: newpavlov

thread-rng/src/lib.rs

@@ -85,7 +85,7 @@ impl RngCore for ReseedingRng {
 
 impl CryptoRng for ReseedingRng {}
 
-/// A reference to the thread-local generator
+/// A reference to the thread-local generator.
 ///
 /// This type is a reference to a lazily-initialized thread-local generator.
 /// An instance can be obtained via [`rand::rng()`][crate::rng()] or via
@@ -98,15 +98,13 @@ impl CryptoRng for ReseedingRng {}
 /// requirements. The Rand project can provide no guarantee of fitness for
 /// purpose. The design criteria for `ThreadRng` are as follows:
 ///
-/// - Automatic seeding via [`OsRng`] and periodically thereafter (see
-///   ([`ReseedingRng`] documentation). Limitation: there is no automatic
+/// - Automatic seeding via [`OsRng`] and periodically thereafter after every 64 KiB of
+///   generated data. Limitation: there is no automatic
 ///   reseeding on process fork (see [below](#fork)).
 /// - A rigorusly analyzed, unpredictable (cryptographic) pseudo-random generator
 ///   (see [the book on security](https://rust-random.github.io/book/guide-rngs.html#security)).
 ///   The currently selected algorithm is ChaCha (12-rounds).
-///   See also [`StdRng`] documentation.
-/// - Not to leak internal state through [`Debug`] or serialization
-///   implementations.
+/// - Not to leak internal state through [`Debug`] or serialization implementations.
 /// - No further protections exist to in-memory state. In particular, the
 ///   implementation is not required to zero memory on exit (of the process or
 ///   thread). (This may change in the future.)
@@ -135,8 +133,7 @@ impl CryptoRng for ReseedingRng {}
 /// from an interrupt (e.g. a fork handler) unless it can be guaranteed that no
 /// other method on the same `ThreadRng` is currently executing.
 ///
-/// [`ReseedingRng`]: crate::rngs::ReseedingRng
-/// [`StdRng`]: crate::rngs::StdRng
+/// [`OsRng`]: rand_core::OsRng
 #[derive(Clone)]
 pub struct ThreadRng {
     // Rc is explicitly !Send and !Sync
@@ -170,7 +167,7 @@ impl fmt::Debug for ThreadRng {
 
 thread_local!(
     // We require Rc<..> to avoid premature freeing when ThreadRng is used
-    // within thread-local destructors. See #968.
+    // within thread-local destructors. See https://github.com/rust-random/rand/issues/968.
     static THREAD_RNG_KEY: Rc<UnsafeCell<ReseedingRng>> = {
         let rng = ChaCha12Rng::try_from_os_rng().unwrap_or_else(|err|
                 panic!("could not initialize ThreadRng: {}", err));
@@ -183,8 +180,6 @@ thread_local!(
 ///
 /// This is a handle to the local [`ThreadRng`].
 ///
-/// See also [`crate::rngs`] for alternatives.
-///
 /// # Example
 ///
 /// ```