[Python-Dev] [Python-checkins] cpython (merge 3.3 -> default): Merge issue #15936: Add link from os.urandom to random.SystemRandom

[Andrew Svetlov]

Well. I rephrased text following suggestion from Larry Hastings.

If there are need more clarification please reopen  #15936

On Tue, Oct 16, 2012 at 1:52 PM, Christian Heimes <christian at python.org> wrote:
> Am 16.10.2012 12:43, schrieb Larry Hastings:
>> On 10/16/2012 11:23 AM, Hynek Schlawack wrote:
>>> Am 16.10.2012 um 12:15 schrieb andrew.svetlov <python-checkins at python.org>:
>>>
>>>> +   For easy to use interface to system randomness please see
>>>> +   :class:`random.SystemRandom`.
>>> Is it just my non-native speaker ears, or should there be an “an” before “easy”?
>>
>> There should.  And "for system randomness" is hard to follow.  I would
>> have written it as
>>
>>     For an easy-to-use interface to the random number generator provided
>>     by your platform, please see :class:`random.SystemRandom`.
>
> I don't like the phrase "easy-to-use" at all. IMO it can't get any
> easier than "give my X random bytes". random.SystemRandom is simply a
> high level interface that is mostly compatible with the random module.
>
> _______________________________________________
> Python-Dev mailing list
> Python-Dev at python.org
> http://mail.python.org/mailman/listinfo/python-dev
> Unsubscribe: http://mail.python.org/mailman/options/python-dev/andrew.svetlov%40gmail.com



-- 
Thanks,
Andrew Svetlov