Senthil Kumaran added the comment: > 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. ---------- _______________________________________ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue14927> _______________________________________ _______________________________________________ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
