File tree 1 file changed +6
-1
lines changed
1 file changed +6
-1
lines changed Original file line number Diff line number Diff line change @@ -76,12 +76,17 @@ pub mod le;
76
76
/// [`next_u32`] or [`next_u64`] since the latter methods are almost always used
77
77
/// with algorithmic generators (PRNGs), which are normally infallible.
78
78
///
79
+ /// Implementers should produce bits uniformly. Pathological RNGs (e.g. always
80
+ /// returning the same value, or never setting certain bits) can break rejection
81
+ /// sampling used by random distributions, and also break other RNGs when
82
+ /// seeding them via [`SeedableRng::from_rng`].
83
+ ///
79
84
/// Algorithmic generators implementing [`SeedableRng`] should normally have
80
85
/// *portable, reproducible* output, i.e. fix Endianness when converting values
81
86
/// to avoid platform differences, and avoid making any changes which affect
82
87
/// output (except by communicating that the release has breaking changes).
83
88
///
84
- /// Typically implementators will implement only one of the methods available
89
+ /// Typically an RNG will implement only one of the methods available
85
90
/// in this trait directly, then use the helper functions from the
86
91
/// [`impls`] module to implement the other methods.
87
92
///
You can’t perform that action at this time.
0 commit comments