docs April 2015

docs@python.org

26 participants
566 discussions

SemLock acquire() keyword arg 'blocking' is invalid (issue 23484)

by berker.peksag＠gmail.com

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/

6 years, 5 months

[issue23484] SemLock acquire() keyword arg 'blocking' is invalid

by Berker Peksag

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

6 years, 5 months

[issue23484] SemLock acquire() keyword arg 'blocking' is invalid

by R. David Murray

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

6 years, 5 months

Tighten definition of bytes-like objects (issue 23756)

by storchaka＠gmail.com

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/

6 years, 5 months

[issue23484] SemLock acquire() keyword arg 'blocking' is invalid

by Davin Potts

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

6 years, 5 months

[issue12855] linebreak sequences should be better documented

by Roundup Robot

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

6 years, 5 months

Jump to page:

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

docs April 2015