Berker Peksag added the comment:
I use "enhancement" for non-trivial documentation patches.
Also, quoting from https://docs.python.org/devguide/triaging.html#type
"Also used for improvements in the documentation and test suite and for other refactorings."
In this case, your patch fixes a documentation issue and improving current documentation by documenting {Lock,RLock}.acquire() and release() methods properly (documentation improvements can go into bugfix branches).
----------
_______________________________________
Python tracker <report(a)bugs.python.org>
<http://bugs.python.org/issue23484>
_______________________________________
R. David Murray added the comment:
behavior vs enhancment for doc changes is really pretty meaningless/arbitrary, IMO.
----------
nosy: +r.david.murray
_______________________________________
Python tracker <report(a)bugs.python.org>
<http://bugs.python.org/issue23484>
_______________________________________
Davin Potts added the comment:
@berker: I would have said this should not be marked an enhancement as the proposed solution (in the patch) is to correct the errors in the documentation to accurately describe the current implemented behavior. Does that make sense?
Whatever label we give it, do you think my logic (described in my comments on this issue) for why it is best to fix it this way makes sense to you?
----------
_______________________________________
Python tracker <report(a)bugs.python.org>
<http://bugs.python.org/issue23484>
_______________________________________
Roundup Robot added the comment:
New changeset 6244a5dbaf84 by Benjamin Peterson in branch '3.4':
document what exactly str.splitlines() splits on (closes #12855)
https://hg.python.org/cpython/rev/6244a5dbaf84
New changeset 87af6deb5d26 by Benjamin Peterson in branch 'default':
merge 3.4 (#12855)
https://hg.python.org/cpython/rev/87af6deb5d26
----------
nosy: +python-dev
resolution: -> fixed
stage: patch review -> resolved
status: open -> closed
_______________________________________
Python tracker <report(a)bugs.python.org>
<http://bugs.python.org/issue12855>
_______________________________________