[docs] [issue10789] Lock.acquire documentation is misleading
Raymond Hettinger
report at bugs.python.org
Sun Jan 2 02:16:49 CET 2011
Raymond Hettinger <rhettinger at users.sourceforge.net> added the comment:
I concur that the one warning is enough. Implementations have been given wide latitude in this regard. Even within CPython there is not much uniformity -- some funcs/methods don't accept keywords, some will disregard keywords, and others may have keywords that are different from the name in the docs.
I believe it would be a mistake to make to lock in the present state of accidental implementation details by documenting them in the main docs.
----------
nosy: +rhettinger
_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue10789>
_______________________________________
More information about the docs
mailing list