Commit 0e115958 authored by Tim Peters's avatar Tim Peters

shuffle() doscstring: Removed warning about sequence length

versus generator period.  While this was a real weakness of the
older WH generator for lists with just a few dozen elements,
and so could potentially bite the naive ;-), the Twister should
show excellent behavior up to at least 600 elements.

Module docstring:  reflowed some jarringly short lines.
parent 9a8ae8f4
...@@ -29,13 +29,12 @@ ...@@ -29,13 +29,12 @@
General notes on the underlying Mersenne Twister core generator: General notes on the underlying Mersenne Twister core generator:
* The period is 2**19937-1. * The period is 2**19937-1.
* It is one of the most extensively tested generators in existence * It is one of the most extensively tested generators in existence.
* Without a direct way to compute N steps forward, the * Without a direct way to compute N steps forward, the semantics of
semantics of jumpahead(n) are weakened to simply jump jumpahead(n) are weakened to simply jump to another distant state and rely
to another distant state and rely on the large period on the large period to avoid overlapping sequences.
to avoid overlapping sequences. * The random() method is implemented in C, executes in a single Python step,
* The random() method is implemented in C, executes in and is, therefore, threadsafe.
a single Python step, and is, therefore, threadsafe.
""" """
...@@ -253,11 +252,6 @@ class Random(_random.Random): ...@@ -253,11 +252,6 @@ class Random(_random.Random):
Optional arg random is a 0-argument function returning a random Optional arg random is a 0-argument function returning a random
float in [0.0, 1.0); by default, the standard random.random. float in [0.0, 1.0); by default, the standard random.random.
Note that for even rather small len(x), the total number of
permutations of x is larger than the period of most random number
generators; this implies that "most" permutations of a long
sequence can never be generated.
""" """
if random is None: if random is None:
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment