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.pyth
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
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 there.
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 will
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