New submission from Gary E. Miller:
The man page for random.SystemRandom([seed]]) fails to mention that the
parameter 'seed' is never used. This should be prominent in the documentation.
I have found several cases where a seed was provided to SystemRandom().
https://docs.python.org/2.7
Gary E. Miller added the comment:
Is there a better place to submit documentation problems to? After my
programming team spends a lot of valuable time figuring what the Python doc
failed to mention I would like this knowledge to be put to good use by others.
Paying it forward if you
Gary E. Miller added the comment:
> The docs are clear that System Random uses os.urandom() for creating random
> numbers, that there is not state, that sequences aren't reproducible, and
> that seed method has no effect and is ignored.
Agreed, but not relevant. I have anecdo
Gary E. Miller added the comment:
> > why have an ignored parameter that is not plainly documented as ignored.
> Because it improves the substitutability of one RNG for another (i.e. the
> same reason that we even have a seed() method).
I understand why it the parameter it the
Gary E. Miller added the comment:
I would change:
"Accordingly, the seed() method has no effect and is ignored."
To:
"Accordingly, the optional seed parameter and the seed() method have no effect
and are ignored."
It was not obvious to me that the seed paramrter go