Re: [Python-Dev] [Python-checkins] cpython (merge 3.3 -> default): Merge issue #15936: Add link from os.urandom to random.SystemRandom
Am 16.10.2012 um 12:15 schrieb andrew.svetlov
+ 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”?
I dont feel anything wrong with it, but I'm also not native speaker.
On Tue, Oct 16, 2012 at 1:23 PM, Hynek Schlawack
Am 16.10.2012 um 12:15 schrieb andrew.svetlov
: + 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”? _______________________________________________ Python-checkins mailing list Python-checkins@python.org http://mail.python.org/mailman/listinfo/python-checkins
-- Thanks, Andrew Svetlov
On 10/16/2012 11:23 AM, Hynek Schlawack wrote:
Am 16.10.2012 um 12:15 schrieb andrew.svetlov
: + 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`. //arry/
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
: + 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.
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
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
: + 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@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
On Tue, 16 Oct 2012 12:52:25 +0200
Christian Heimes
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
: + 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
Antoine Pitrou writes:
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).
You don't need them to get the point across, but elderly grammar pedants will think better of you if you use the hyphens. Personally, I hope they'll be used. I'm tired of the assumption that "illiterate techie" is a redundant phrase.
On 2012-10-16 12:59, Stephen J. Turnbull wrote:
Antoine Pitrou writes:
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).
You don't need them to get the point across, but elderly grammar pedants will think better of you if you use the hyphens.
Personally, I hope they'll be used. +1
I'm tired of the assumption that "illiterate techie" is a redundant phrase.
participants (7)
-
Andrew Svetlov
-
Antoine Pitrou
-
Christian Heimes
-
Hynek Schlawack
-
Larry Hastings
-
MRAB
-
Stephen J. Turnbull