[issue14927] add "Do not supply 'int' argument" to random.shuffle docstring

Georg Brandl report at bugs.python.org
Sun Sep 15 09:06:21 CEST 2013


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".

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).

----------
nosy: +georg.brandl

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue14927>
_______________________________________


More information about the Python-bugs-list mailing list