This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author orsenthil
Recipients eric.araujo, georg.brandl, michael.driscoll, orsenthil, python-dev, rhettinger, sandro.tosi, smichr
Date 2013-09-16.00:06:06
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <CAPOVWOSpOk4cbRDhjodjqJ-Oywf=L9TeTk3C+fqDhF=UrYPonQ@mail.gmail.com>
In-reply-to <1379228781.66.0.248898457185.issue14927@psf.upfronthosting.co.za>
Content
> Georg Brandl added the comment:
>
> I would propose a leading underscore for these methods; they should make it clear to the user that the parameter is meant to be "private".

+1 to this proposal.
This style is present with randrange, randbelow and shuffle.

> With this line in the docstring, I would wonder "Why is the argument there in the first place?!" (because most people don't know about the optimization technique).

This style has been present since the introduction of these functions.
One attempt to clarify / cleanup shuffle here is: 29430:b80a22250e4f
Georg :  I am unaware of the optimization technique you refer to as
well, it will helpful if you could point to any resource.
History
Date User Action Args
2013-09-16 00:06:06orsenthilsetrecipients: + orsenthil, georg.brandl, rhettinger, smichr, eric.araujo, sandro.tosi, python-dev, michael.driscoll
2013-09-16 00:06:06orsenthillinkissue14927 messages
2013-09-16 00:06:06orsenthilcreate