Mailman 3 April 2015 - docs

SemLock acquire() keyword arg 'blocking' is invalid (issue 23484)
by berker.peksag＠gmail.com 01 Apr '15

01 Apr '15

http://bugs.python.org/review/23484/diff/14347/Doc/library/multiprocessing.… File Doc/library/multiprocessing.rst (right): http://bugs.python.org/review/23484/diff/14347/Doc/library/multiprocessing.… Doc/library/multiprocessing.rst:1199: .. versionchanged:: 2.7 If the timeout parameter was added in 2.7 and 3.0, we can remove this directive on 3.4 and default branches since it's there for the beginning of Python 3. On the other hand, for example, if it was added in 2.7 and 3.2, we should change it to .. versionchanged:: 3.2 in Python 3 documentation. http://bugs.python.org/review/23484/

1 0

[issue23484] SemLock acquire() keyword arg 'blocking' is invalid
by Berker Peksag 01 Apr '15

01 Apr '15

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> _______________________________________

1 0

[issue23484] SemLock acquire() keyword arg 'blocking' is invalid
by R. David Murray 01 Apr '15

01 Apr '15

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> _______________________________________

1 0

Tighten definition of bytes-like objects (issue 23756)
by storchaka＠gmail.com 01 Apr '15

01 Apr '15

http://bugs.python.org/review/23756/diff/14408/Doc/c-api/buffer.rst File Doc/c-api/buffer.rst (right): http://bugs.python.org/review/23756/diff/14408/Doc/c-api/buffer.rst#newcode… Doc/c-api/buffer.rst:294: buffers (with a single element) are considered both C- and May be one-dimensional too? http://bugs.python.org/review/23756/diff/14408/Doc/glossary.rst File Doc/glossary.rst (right): http://bugs.python.org/review/23756/diff/14408/Doc/glossary.rst#newcode91 Doc/glossary.rst:91: :class:`bytearray` or :class:`memoryview`. Bytes-like objects can May be worth to mention array.array (is it always C-contiguous?)? http://bugs.python.org/review/23756/

1 0

[issue23484] SemLock acquire() keyword arg 'blocking' is invalid
by Davin Potts 01 Apr '15

01 Apr '15

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> _______________________________________

1 0

[issue12855] linebreak sequences should be better documented
by Roundup Robot 01 Apr '15

01 Apr '15

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> _______________________________________

1 0