[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