Mailman 3 October 2019 - docs

[issue35826] Typo in example for async with statement with condition
by Kevin Mai-Hsuan Chia 11 Oct '19

11 Oct '19

New submission from Kevin Mai-Hsuan Chia <kevin(a)mhchia.com>: In the [example](https://docs.python.org/3.8/library/asyncio-sync.html#asyncio.Cond… of the equivalent code to the `async with statement`: ```python cond = asyncio.Condition() # ... later await lock.acquire() try: await cond.wait() finally: lock.release() ``` `lock.acquire()` should be replaced by `cond.acquire()`, and `lock.release()` replaced by `cond.release()`. So the resulting code snippet becomes: ```python cond = asyncio.Condition() # ... later await cond.acquire() try: await cond.wait() finally: cond.release() ``` ---------- assignee: docs@python components: Documentation messages: 334349 nosy: docs@python, mhchia priority: normal severity: normal status: open title: Typo in example for async with statement with condition type: enhancement versions: Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35826> _______________________________________

5 10

[issue38442] Doc/whatsnew/3.8.rst has an execution bit
by Serhiy Storchaka 11 Oct '19

11 Oct '19

New submission from Serhiy Storchaka <storchaka+cpython(a)gmail.com>: It likely happened when it was edited on Windows. ---------- assignee: docs@python components: Documentation messages: 354428 nosy: docs@python, lukasz.langa, serhiy.storchaka priority: normal severity: normal status: open title: Doc/whatsnew/3.8.rst has an execution bit versions: Python 3.8, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38442> _______________________________________

1 3

[issue38441] failing to build the Documentation
by Aurora 11 Oct '19

11 Oct '19

New submission from Aurora <auroraofearth(a)ya.ru>: I'm failing to build the cpython/Doc dir. The full build log is as follows: mkdir -p build Building NEWS from Misc/NEWS.d with blurb PATH=./venv/bin:$PATH sphinx-build -b epub -d build/doctrees -D latex_elements.papersize= -W . build/epub Running Sphinx v2.2.0 making output directory... done building [mo]: targets for 0 po files that are out of date building [epub]: targets for 476 source files that are out of date updating environment: [new config] 476 added, 0 changed, 0 removed reading sources... [100%] whatsnew/index Warning, treated as error: /home/aurora/A.Code/Python/Reference/python/cpython/Doc/library/email.message.rst:4:duplicate object description of email.message, other instance in library/email.compat32-message, use :noindex: for one of them make: *** [Makefile:46: build] Error 2 Running on Debian Experimental kernel v5.3 ---------- assignee: docs@python components: Documentation messages: 354425 nosy: aurora, docs@python priority: normal severity: normal status: open title: failing to build the Documentation type: compile error versions: Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38441> _______________________________________

2 1

[issue17894] Edits to descriptor howto
by Ned Batchelder 10 Oct '19

10 Oct '19

New submission from Ned Batchelder: I find the explanations in the Descriptor howto to be difficult to understand. I took a stab at changing the first few sections to introduce the concepts in an easier-to-grasp style. Issue 12077 also covers a little bit of this. ---------- assignee: docs@python components: Documentation files: descriptor_howto.patch keywords: patch messages: 188289 nosy: docs@python, nedbat priority: normal severity: normal status: open title: Edits to descriptor howto versions: Python 3.4 Added file: http://bugs.python.org/file30111/descriptor_howto.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue17894> _______________________________________

7 15

[issue13322] The io module doesn't support non-blocking files
by Matt Joiner 10 Oct '19

10 Oct '19

Change by Matt Joiner <anacrolix(a)gmail.com>: ---------- nosy: -anacrolix _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue13322> _______________________________________

1 0

[issue38339] [3.5] The doc job of Travis CI fails on Python 3.5: needs at least Sphinx v1.8
by STINNER Victor 10 Oct '19

10 Oct '19

New submission from STINNER Victor <vstinner(a)python.org>: Example: https://travis-ci.org/python/cpython/jobs/590339147 $ python --version Python 3.6.3 $ pip --version pip 9.0.1 from /home/travis/virtualenv/python3.6.3/lib/python3.6/site-packages (python 3.6) Could not locate requirements.txt. Override the install: key in your .travis.yml to install dependencies. before_script.1 0.00s$ cd Doc before_script.2 8.58s$ python -m pip install sphinx~=1.6.1 blurb 1.88s$ make check suspicious html SPHINXOPTS="-q -W -j4" python3 tools/rstlint.py -i tools -i ./venv -i README.rst No problems found. make[1]: Entering directory `/home/travis/build/python/cpython/Doc' mkdir -p build Building NEWS from Misc/NEWS.d with blurb PATH=./venv/bin:$PATH sphinx-build -b suspicious -d build/doctrees -D latex_elements.papersize= -q -W -j4 . build/suspicious Sphinx version error: This project needs at least Sphinx v1.8 and therefore cannot be built with this version. make[1]: *** [build] Error 1 make[1]: Leaving directory `/home/travis/build/python/cpython/Doc' Suspicious check complete; look for any errors in the above output or in build/suspicious/suspicious.csv. If all issues are false positives, append that file to tools/susp-ignored.csv. make: *** [suspicious] Error 1 The command "make check suspicious html SPHINXOPTS="-q -W -j4"" exited with 2. cache.2 store build cache ---------- assignee: docs@python components: Documentation messages: 353692 nosy: docs@python, mdk, vstinner priority: normal severity: normal status: open title: [3.5] The doc job of Travis CI fails on Python 3.5: needs at least Sphinx v1.8 versions: Python 3.5 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38339> _______________________________________

1 5

[issue13322] The io module doesn't support non-blocking files
by STINNER Victor 10 Oct '19

10 Oct '19

STINNER Victor <vstinner(a)python.org> added the comment: TextIOWrapper, and maybe also BufferedRead, may raise an exception if the underlying file descriptor is configured in non-blocking mode. It may require an additional syscall() to query the FD properties, which may slowdown the creation of file objects in Python :-/ ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue13322> _______________________________________

1 0

[issue13322] The io module doesn't support non-blocking files
by STINNER Victor 10 Oct '19

10 Oct '19

Change by STINNER Victor <vstinner(a)python.org>: ---------- components: -Documentation, IO title: buffered read() and write() does not raise BlockingIOError -> The io module doesn't support non-blocking files versions: +Python 3.9 -Python 2.7, Python 3.6, Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue13322> _______________________________________

1 0

[issue13322] buffered read() and write() does not raise BlockingIOError
by STINNER Victor 10 Oct '19

10 Oct '19

STINNER Victor <vstinner(a)python.org> added the comment: See also bpo-32561: Add API to io objects for non-blocking reads/writes. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue13322> _______________________________________

1 0

[issue13322] buffered read() and write() does not raise BlockingIOError
by Jakub Stasiak 10 Oct '19

10 Oct '19

Change by Jakub Stasiak <jakub+python.org(a)stasiak.at>: ---------- nosy: +jstasiak _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue13322> _______________________________________

1 0

docs October 2019