On Tue, 16 Oct 2012 12:52:25 +0200
Christian Heimes <christ...@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-check...@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.

I guess it's easy to use if you need something other than raw bytes.
But, yes, I would call it "higher level" rather than "easy to use"
(I don't think there's a need for hyphens, by the way).

Regards

Antoine.


-- 
Software development and contracting: http://pro.pitrou.net


_______________________________________________
Python-Dev mailing list
Python-Dev@python.org
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: 
http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com

Reply via email to