Mailman 3 October 2019 - docs

Broken link on docs.python.org
by Karen Woodman Oct. 15, 2019

Oct. 15, 2019

Hi there, I noticed that you have a broken link to a website called Qmail.org. That site was first published 23 years ago (back in 1996!) but unfortunately, it is no longer a working website. You link to Qmail.org on this page: https://docs.python.org/3/library/mailbox.html We just published an article that explores what happened to the site. I think it's an interesting story, and it could be useful to your readers. In addition, since all of the original articles are gone, we included a curated list of the best Qmail resources and mirrors. Here's the article if you want to take a look: https://www.getmailbird.com/what-resources-are-available-now-that-qmail-org… Would you consider swapping out the broken link for our article? Please let me know if you have any questions and thank you for your time. Sincerely, -Karen -- Karen Woodman, Editor 5 Ross Rd Durham, NH 03824 By the way, if you didn't like getting this email you can unsubscribe <http://ec2-52-26-194-35.us-west-2.compute.amazonaws.com/x/u?u=3072cf29-f52f…> and I won't email you anymore. :)

2 3

[issue38484] HTMLParser.handle_starttag should mention that value can be None
by Sebastian Rittau Oct. 15, 2019

Oct. 15, 2019

New submission from Sebastian Rittau <srittau(a)rittau.biz>: The documentation for HTMLParser.handle_starttag (https://docs.python.org/3/library/html.parser.html#html.parser.HTMLParser.h…) should mention that the value of an attribute can be `None` for argument-less attributes. I can submit a PR if wanted. ---------- assignee: docs@python components: Documentation messages: 354719 nosy: docs@python, srittau priority: normal severity: normal status: open title: HTMLParser.handle_starttag should mention that value can be None versions: Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38484> _______________________________________

1 0

No shlex.join() docs in 3.8?
by Avy Faingezicht Oct. 15, 2019

Oct. 15, 2019

Hi, I noticed the "What's New in Python 3.8" doc lists a new shlex.join() method, but it seems there are no relevant docs for it under the shlex module's doc. https://docs.python.org/3/library/shlex.html#shlex.join Excited to try out 3.8! Thanks for all the hard work. Best, Avy *Avy Faingezicht* www.faingezicht.com

2 1

[issue16575] ctypes: unions as arguments
by Vinay Sajip Oct. 15, 2019

Oct. 15, 2019

Change by Vinay Sajip <vinay_sajip(a)yahoo.co.uk>: ---------- pull_requests: +16355 pull_request: https://github.com/python/cpython/pull/16799 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue16575> _______________________________________

1 0

[issue38294] Documentation on 3.6->3.7 re.escape no longer escaping "/" or ":" should be obvious
by Ned Deily Oct. 15, 2019

Oct. 15, 2019

Ned Deily <nad(a)python.org> added the comment: New changeset ae41f629e187e1f0cf4d62f5a7b181c64da26466 by Ned Deily (Ricardo Bánffy) in branch '3.7': [3.7] bpo-38294: Add list of no-longer-escaped chars to re.escape documentation. (GH-16442) (GH-16647) https://github.com/python/cpython/commit/ae41f629e187e1f0cf4d62f5a7b181c64d… ---------- nosy: +ned.deily _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38294> _______________________________________

1 0

[issue38235] Docs of logging module says argument is named "lvl". TypeError.
by Daniel Andersson Oct. 15, 2019

Oct. 15, 2019

New submission from Daniel Andersson <daniel.4ndersson(a)gmail.com>: How to reproduce: >>> import logging >>> logging.disable(lvl=logging.ERROR) Traceback (most recent call last): File "<stdin>", line 1, in <module> TypeError: disable() got an unexpected keyword argument 'lvl' The correct keyword argument name is `level` as can be seen in the Python code Lib/logging/__init__.py: ---> def disable(level=CRITICAL): The documentation uses `lvl`, see Doc/library/logging.rst: ---> .. function:: disable(lvl=CRITICAL) The solution would be to rename the argument from `lvl` to `level` in the documentation. I also noticed some more cases in the logging module docs where `lvl` is used (and `level` is used in the Python code): * logging.Logger.isEnabledFor(lvl) * logging.Logger.log(lvl, msg, *args, **kwargs) * logging.Logger.makeRecord(name, lvl, fn, lno, msg, args, exc_info, func=None, extra=None, sinfo=None) * logging.addLevelName(lvl, levelName) * logging.getLevelName(lvl) Maybe there are some historical reasons for this that I'm not aware about. I also found an inconsistency. In the `Handler` class the docs does use `level`: * logging.Handler.setLevel(level) I can understand that the English in the documentation might be clearer when written as: "Associates level `lvl` with text `levelName`" instead of, "Associates level `level` with text `levelName`" - avoids the double-"level". But at the same time, I usually trust the documentation blindly and was surprised by this error. In the five listed examples above, `lvl` is only used as a positional argument. Maybe it is more OK to deviate from the actual name in the code in this case compared to keyword arguments, as in logging.disable. ---------- assignee: docs@python components: Documentation, Library (Lib) messages: 352866 nosy: docs@python, penlect, vinay.sajip priority: normal severity: normal status: open title: Docs of logging module says argument is named "lvl". TypeError. versions: Python 2.7, Python 3.5, Python 3.6, Python 3.7, Python 3.8, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38235> _______________________________________

6 11

[issue38391] Typo in tutorial code (does not compile)
by Ned Deily Oct. 15, 2019

Oct. 15, 2019

Ned Deily <nad(a)python.org> added the comment: New changeset e9c65b4ae765ccd381eccdfc4617dc46899406e1 by Ned Deily (Miss Islington (bot)) in branch '3.7': bpo-38391: Fixing a typo for Py_DECREF (GH-16616) https://github.com/python/cpython/commit/e9c65b4ae765ccd381eccdfc4617dc4689… ---------- nosy: +ned.deily _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38391> _______________________________________

1 0

[issue32996] Improve What's New in 3.7
by Serhiy Storchaka Oct. 15, 2019

Oct. 15, 2019

New submission from Serhiy Storchaka <storchaka+cpython(a)gmail.com>: The following PR fixes and improves formatting in the "What's New in Python 3.7" document, adds links to issues and authors names. This is just one step. Somebody need to review NEWS entries and adds corresponding What's New entries if they are worth this, and later edit the wording of the final document. ---------- assignee: docs@python components: Documentation messages: 313243 nosy: docs@python, ned.deily, serhiy.storchaka priority: normal severity: normal status: open title: Improve What's New in 3.7 type: enhancement versions: Python 3.7, Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue32996> _______________________________________

9 26

Python pdf documentation
by steve Jacobson Oct. 14, 2019

Oct. 14, 2019

How can I re-create the python pdf documentation with larger fonts (10pt) for the text and different font and size for the coding examples? When I print out the documents, the coding examples are nearly unreadable. Thank you. Steve

1 0

[issue38463] 3.8 Release Notes: Link to SSLContext.post_handshake_auth missing
by Sebastian Rittau Oct. 14, 2019

Oct. 14, 2019

New submission from Sebastian Rittau <srittau(a)rittau.biz>: The link to SSLContext.post_handshake_auth in the "ssl" section in the release notes is missing. ---------- assignee: docs@python components: Documentation messages: 354582 nosy: docs@python, srittau priority: normal severity: normal status: open title: 3.8 Release Notes: Link to SSLContext.post_handshake_auth missing versions: Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38463> _______________________________________

4 7

[issue38464] documentation for NormalDist.quantiles(): missing argument
by Sebastian Rittau Oct. 14, 2019

Oct. 14, 2019

New submission from Sebastian Rittau <srittau(a)rittau.biz>: The documentation for NormalDist.quantiles() (https://docs.python.org/3.8/library/statistics.html#statistics.NormalDist) is missing the "n" argument from the definition. ---------- assignee: docs@python components: Documentation messages: 354584 nosy: docs@python, rhettinger, srittau priority: normal severity: normal status: open title: documentation for NormalDist.quantiles(): missing argument versions: Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38464> _______________________________________

3 6

[issue38467] Misspelled argument names for typing.get_origin and get_args
by Sebastian Rittau Oct. 13, 2019

Oct. 13, 2019

New submission from Sebastian Rittau <srittau(a)rittau.biz>: The arguments for typing.get_origin() and typing.get_args() are named "typ" in the documentation (https://docs.python.org/3.8/library/typing.html#typing.get_origin), while they are named "tp" in the implementation. Important if used as keyword argument. ---------- assignee: docs@python components: Documentation messages: 354590 nosy: docs@python, srittau priority: normal severity: normal status: open title: Misspelled argument names for typing.get_origin and get_args versions: Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38467> _______________________________________

4 8

[issue38056] Add examples for common text encoding Error Handlers
by Ma Lin Oct. 13, 2019

Oct. 13, 2019

New submission from Ma Lin <malincns(a)163.com>: Text descriptions about `Error Handlers` are not very friendly to novices. https://docs.python.org/3/library/codecs.html#error-handlers For example: 'xmlcharrefreplace' Replace with the appropriate XML character reference (only for encoding). Implemented in :func:`xmlcharrefreplace_errors`. 'backslashreplace' Replace with backslashed escape sequences. Implemented in :func:`backslashreplace_errors`. 'namereplace' Replace with ``\N{...}`` escape sequences (only for encoding). Implemented in :func:`namereplace_errors`. Novices may not know what these are. Giving some examples may help the reader to understand more intuitively. The effect picture is attached. I picked two characters: ß https://www.compart.com/en/unicode/U+00DF ♬ https://www.compart.com/en/unicode/U+266C ---------- assignee: docs@python components: Documentation files: effect.png messages: 351329 nosy: Ma Lin, docs@python priority: normal severity: normal status: open title: Add examples for common text encoding Error Handlers versions: Python 3.7, Python 3.8, Python 3.9 Added file: https://bugs.python.org/file48599/effect.png _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38056> _______________________________________

1 2

[issue38446] Ambiguous signature for builtins.__build_class__
by Pablo Galindo Salgado Oct. 12, 2019

Oct. 12, 2019

Change by Pablo Galindo Salgado <pablogsal(a)gmail.com>: ---------- keywords: +patch pull_requests: +16314 stage: -> patch review pull_request: https://github.com/python/cpython/pull/16735 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38446> _______________________________________

1 0

[issue38424] typing.Generator shorthand
by Dima Tisnek Oct. 12, 2019

Oct. 12, 2019

Dima Tisnek <dimaqq(a)gmail.com> added the comment: Clearly my attention span does not exceed 5 paragraphs, so sorry! ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38424> _______________________________________

1 0

[issue38450] 3.8 Release Notes: IDLE section dupe
by Sebastian Rittau Oct. 11, 2019

Oct. 11, 2019

New submission from Sebastian Rittau <srittau(a)rittau.biz>: In the 3.8 release notes (https://docs.python.org/3.8/whatsnew/3.8.html), the section "IDLE and idlelib" is duplicated as "idlelib and IDLE". Also, the section "gc" and "gzip" between them are not sorted alphabetically like the rest of the list. ---------- assignee: docs@python components: Documentation messages: 354464 nosy: docs@python, srittau priority: normal severity: normal status: open title: 3.8 Release Notes: IDLE section dupe versions: Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38450> _______________________________________

3 2

[issue38401] Make dataclass attribute docstrings accessible
by John Parejko Oct. 11, 2019

Oct. 11, 2019

New submission from John Parejko <parejkoj(a)uw.edu>: Dataclasses provide a very straightforward way to specify structured data. One can trivally document a dataclass's attributes via triple-quoted attribute docstrings per PEP 257. However, those docstrings are not accessible to pydoc, so they are lost to users of the dataclass. For example, the attribute docstrings in the below dataclass should be available when looking at `help(SpectralData)`, but that help command does not show the docstrings. ``` @dataclasses.dataclass class SpectralData: """Class to hold data and metadata from a fiber spectrograph.""" wavelength: astropy.units.Quantity """The wavelength array produced by the instrument.""" spectrum: np.ndarray """The flux array in instrumental units.""" duration: float """The duration of the exposure in seconds.""" ``` ---------- assignee: docs@python components: Documentation messages: 354154 nosy: John Parejko2, docs@python priority: normal severity: normal status: open title: Make dataclass attribute docstrings accessible type: enhancement _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38401> _______________________________________

4 3

[issue38424] typing.Generator shorthand
by Ivan Levkivskyi Oct. 11, 2019

Oct. 11, 2019

Ivan Levkivskyi <levkivskyi(a)gmail.com> added the comment: Actually Serhiy is right, I just checked and found this sentence: ``` Alternatively, annotate your generator as having a return type of either Iterable[YieldType] or Iterator[YieldType] ``` ---------- resolution: -> works for me stage: -> resolved status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38424> _______________________________________

1 0

[issue38424] typing.Generator shorthand
by Serhiy Storchaka Oct. 11, 2019

Oct. 11, 2019

Serhiy Storchaka <storchaka+cpython(a)gmail.com> added the comment: It is already documented, with examples. I do not think the documentation can be made better. ---------- nosy: +serhiy.storchaka _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38424> _______________________________________

1 0

[issue38424] typing.Generator shorthand
by Ivan Levkivskyi Oct. 11, 2019

Oct. 11, 2019

Change by Ivan Levkivskyi <levkivskyi(a)gmail.com>: ---------- assignee: -> docs@python components: +Documentation -Library (Lib) nosy: +docs@python _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38424> _______________________________________

1 0

[issue38446] Ambiguous signature for builtins.__build_class__
by Ivan Levkivskyi Oct. 11, 2019

Oct. 11, 2019

Change by Ivan Levkivskyi <levkivskyi(a)gmail.com>: ---------- assignee: -> docs@python components: +Documentation nosy: +docs@python _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38446> _______________________________________

1 0

[issue35826] Typo in example for async with statement with condition
by Kevin Mai-Hsuan Chia Oct. 11, 2019

Oct. 11, 2019

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 Oct. 11, 2019

Oct. 11, 2019

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 Oct. 11, 2019

Oct. 11, 2019

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 Oct. 11, 2019

Oct. 11, 2019

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 Oct. 11, 2019

Oct. 11, 2019

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 Oct. 10, 2019

Oct. 10, 2019

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 Oct. 10, 2019

Oct. 10, 2019

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 Oct. 10, 2019

Oct. 10, 2019

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 Oct. 10, 2019

Oct. 10, 2019

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 Oct. 10, 2019

Oct. 10, 2019

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

[issue13322] buffered read() and write() does not raise BlockingIOError
by STINNER Victor Oct. 10, 2019

Oct. 10, 2019

STINNER Victor <vstinner(a)python.org> added the comment: I closed bpo-24560 as a duplicate of this issue: codecs.StreamReader doesn't work with nonblocking streams: TypeError: can't concat bytes to NoneType. ---------- _______________________________________ 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 Oct. 10, 2019

Oct. 10, 2019

STINNER Victor <vstinner(a)python.org> added the comment: I closed bpo-26292 as a duplicate of this issue: Raw I/O writelines() broken for non-blocking I/O. ---------- _______________________________________ 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 Oct. 10, 2019

Oct. 10, 2019

STINNER Victor <vstinner(a)python.org> added the comment: I closed bpo-35762 as a duplicate of this issue: subprocess.Popen with universal_newlines and nonblocking streams fails with "can't concat NoneType to bytes". ---------- nosy: +vstinner _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue13322> _______________________________________

1 0

[issue38427] Issue URL on translated Python docs site is always pointed to English version
by Shengjing Zhu Oct. 10, 2019

Oct. 10, 2019

New submission from Shengjing Zhu <zsj950618(a)gmail.com>: On footer of https://docs.python.org/fr/3.8, "Found a bug?" links to https://docs.python.org/3/bugs.html It should be https://docs.python.org/fr/3.8/bugs.html as 3.7 version. ---------- assignee: docs@python components: Documentation messages: 354314 nosy: docs@python, zhsj priority: normal severity: normal status: open title: Issue URL on translated Python docs site is always pointed to English version versions: Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38427> _______________________________________

2 2

[issue38421] email.utils.parsetime_tz does not return "None" as the tz offset
by Roundup Robot Oct. 9, 2019

Oct. 9, 2019

Change by Roundup Robot <devnull(a)psf.upfronthosting.co.za>: ---------- keywords: +patch pull_requests: +16261 stage: -> patch review pull_request: https://github.com/python/cpython/pull/16678 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38421> _______________________________________

1 0

[issue38421] email.utils.parsetime_tz does not return "None" as the tz offset
by David Kernan Oct. 9, 2019

Oct. 9, 2019

Change by David Kernan <davidsmurf(a)gmail.com>: ---------- assignee: -> docs@python components: +Documentation -email nosy: +docs@python _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38421> _______________________________________

1 0

Typo in docs
by Дмитрий Стародубцев Oct. 9, 2019

Oct. 9, 2019

Typo in https://docs.python.org/3/library/unittest.mock.html assret_called_with -- *Sola scriptura. Sola fide. Sola gratia. Solus Christus. Soli Deo gloria.*

1 0

[issue38294] Documentation on 3.6->3.7 re.escape no longer escaping "/" or ":" should be obvious
by Serhiy Storchaka Oct. 9, 2019

Oct. 9, 2019

Serhiy Storchaka <storchaka+cpython(a)gmail.com> added the comment: Thank you for your contribution Ricardo! ---------- resolution: -> fixed stage: patch review -> resolved status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38294> _______________________________________

1 0

[issue38294] Documentation on 3.6->3.7 re.escape no longer escaping "/" or ":" should be obvious
by Serhiy Storchaka Oct. 8, 2019

Oct. 8, 2019

Serhiy Storchaka <storchaka+cpython(a)gmail.com> added the comment: New changeset 43f5c0c4d0a608c04c3978adb45117f3943203b7 by Serhiy Storchaka (Ricardo Bánffy) in branch '3.7': [3.7] bpo-38294: Add list of no-longer-escaped chars to re.escape documentation. (GH-16442) (GH-16647) https://github.com/python/cpython/commit/43f5c0c4d0a608c04c3978adb45117f394… ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38294> _______________________________________

1 0

[issue38294] Documentation on 3.6->3.7 re.escape no longer escaping "/" or ":" should be obvious
by Ricardo Bánffy Oct. 8, 2019

Oct. 8, 2019

Change by Ricardo Bánffy <rbanffy(a)gmail.com>: ---------- pull_requests: +16230 pull_request: https://github.com/python/cpython/pull/16647 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38294> _______________________________________

1 0

[issue26103] Contradiction in definition of "data descriptor" between (dotted lookup behavior/datamodel documentation) and (inspect lib/descriptor how-to)
by hongweipeng Oct. 8, 2019

Oct. 8, 2019

Change by hongweipeng <hongweichen8888(a)sina.com>: ---------- pull_requests: +16228 pull_request: https://github.com/python/cpython/pull/16645 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue26103> _______________________________________

1 0

[issue31589] Links for French documentation pdf is broken
by fabrice Oct. 8, 2019

Oct. 8, 2019

New submission from fabrice: Hi, In this page : https://docs.python.org/fr/2/download.html, all the documentation links aren't available, for example : - https://docs.python.org/fr/2/archives/python-2.7.14-docs-pdf-a4.zip - https://docs.python.org/fr/2/archives/python-2.7.14-docs-pdf-a4.tar.bz2 So, I can't read the documentation in French :) Regards, Fabrice ---------- assignee: docs@python components: Documentation messages: 303024 nosy: docs@python, fabrice priority: normal severity: normal status: open title: Links for French documentation pdf is broken versions: Python 2.7 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue31589> _______________________________________

8 31

[issue32200] Download of 3.7.0a2 docs giving a 404 error
by Carol Willing Oct. 8, 2019

Oct. 8, 2019

New submission from Carol Willing <willingc(a)gmail.com>: Currently, the 3.7.0a2 doc links are giving 404 errors. 3.6 docs are working just fine. https://docs.python.org/3.7/archives/python-3.7.0a2-docs-pdf-letter.tar.bz2 results in a 404. I wasn't sure if I should report here or in python.org issue tracker. ---------- assignee: docs@python components: Documentation messages: 307433 nosy: docs@python, willingc priority: normal severity: normal status: open title: Download of 3.7.0a2 docs giving a 404 error type: behavior versions: Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue32200> _______________________________________

7 16

[issue38294] Documentation on 3.6->3.7 re.escape no longer escaping "/" or ":" should be obvious
by miss-islington Oct. 7, 2019

Oct. 7, 2019

miss-islington <mariatta.wijaya+miss-islington(a)gmail.com> added the comment: New changeset b731fc521cf78e53268e35777d836ca80e7ab305 by Miss Islington (bot) in branch '3.8': bpo-38294: Add list of no-longer-escaped chars to re.escape documentation. (GH-16442) https://github.com/python/cpython/commit/b731fc521cf78e53268e35777d836ca80e… ---------- nosy: +miss-islington _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38294> _______________________________________

1 0

[issue38294] Documentation on 3.6->3.7 re.escape no longer escaping "/" or ":" should be obvious
by miss-islington Oct. 7, 2019

Oct. 7, 2019

Change by miss-islington <mariatta.wijaya+miss-islington(a)gmail.com>: ---------- pull_requests: +16212 pull_request: https://github.com/python/cpython/pull/16626 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38294> _______________________________________

1 0

[issue38294] Documentation on 3.6->3.7 re.escape no longer escaping "/" or ":" should be obvious
by Serhiy Storchaka Oct. 7, 2019

Oct. 7, 2019

Serhiy Storchaka <storchaka+cpython(a)gmail.com> added the comment: New changeset 15ae75d660befe643ed42eb2707a557cea97256c by Serhiy Storchaka (Ricardo Bánffy) in branch 'master': bpo-38294: Add list of no-longer-escaped chars to re.escape documentation. (GH-16442) https://github.com/python/cpython/commit/15ae75d660befe643ed42eb2707a557cea… ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38294> _______________________________________

1 0

[issue38391] Typo in tutorial code (does not compile)
by Xiang Zhang Oct. 7, 2019

Oct. 7, 2019

Change by Xiang Zhang <angwerzx(a)126.com>: ---------- assignee: -> docs@python components: +Documentation -Demos and Tools nosy: +docs@python resolution: -> fixed stage: patch review -> resolved status: open -> closed versions: +Python 3.8, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38391> _______________________________________

1 0

Docs contain funky appostrophes and quotes
by Boris Verkhovskiy Oct. 6, 2019

Oct. 6, 2019

The Python docs have some apostrophes and quotes that should be normal ' and " that are instead using their fancy versions, which is probably not good. Just `sudo apt install ripgrep` and then run rg ” or rg ’ in the root of the CPython source code. The biggest culprit by far is Lib/pydoc_data/topics.py which I guess is generated by Shpinx, but they happen in some other places in the source code and should probably be removed.

1 0

[issue18578] Rename and document test.bytecode_helper as test.support.bytecode_helper
by Nick Coghlan Oct. 5, 2019

Oct. 5, 2019

Nick Coghlan <ncoghlan(a)gmail.com> added the comment: Just noting for the record that the reason a new warning wasn't needed here is because there is already a general "No compatibility guarantees" warning for the entire test package: https://docs.python.org/3/library/test.html Thanks for getting this resolved! ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue18578> _______________________________________

1 0

Hello
by Ishaan Mundra Oct. 5, 2019

Oct. 5, 2019

I need to get a download a python program and write a squaresprial.py program can you help out with that?

1 0

Typo error for text shown
by Amol Kobal Oct. 5, 2019

Oct. 5, 2019

Hello,I suppose, there's slight typo error on documentation page: https://docs.python.org/3/library/index.htmlThe text for zlib is mentioned as gzip.Thanks & Regards,Amol Kobal.

1 0

[issue38349] Email example using imaginary library installation error. The install shows that it only supports python 2.x but is listed for python 3.6+
by jackotonye Oct. 5, 2019

Oct. 5, 2019

New submission from jackotonye <tonyejck(a)gmail.com>: https://docs.python.org/3.7/library/email.examples.html ---------- assignee: docs@python components: Documentation messages: 353743 nosy: docs@python, jackotonye priority: normal severity: normal status: open title: Email example using imaginary library installation error. The install shows that it only supports python 2.x but is listed for python 3.6+ type: resource usage versions: Python 3.6, Python 3.7, Python 3.8, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38349> _______________________________________

4 9

[issue32758] Stack overflow when parse long expression to AST
by Roundup Robot Oct. 3, 2019

Oct. 3, 2019

Change by Roundup Robot <devnull(a)psf.upfronthosting.co.za>: ---------- pull_requests: +16157 pull_request: https://github.com/python/cpython/pull/16566 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue32758> _______________________________________

1 0

[issue32758] Stack overflow when parse long expression to AST
by Roundup Robot Oct. 3, 2019

Oct. 3, 2019

Change by Roundup Robot <devnull(a)psf.upfronthosting.co.za>: ---------- keywords: +patch pull_requests: +16156 pull_request: https://github.com/python/cpython/pull/16565 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue32758> _______________________________________

1 0

[issue38333] add type signatures to library function docs
by paul rubin Oct. 3, 2019

Oct. 3, 2019

New submission from paul rubin <phr-pythonbugs(a)nightsong.com>: It would be nice if the library reference manual had type signatures for all the stdlib functions at some point. It might be possible to extract a lot of them automatically from typeshed and semi-automatically paste them into the doc files. It might also be ok to do this gradually. I can help with this but wouldn't want to take on the entire task. ---------- assignee: docs@python components: Documentation messages: 353634 nosy: docs@python, phr priority: normal severity: normal status: open title: add type signatures to library function docs type: enhancement versions: Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38333> _______________________________________

4 16

broken link
by rwrwb wrt Oct. 3, 2019

Oct. 3, 2019

https://docs.python.org/3/library/http.client.html broken link in « The Requests package is recommended for a higher-level HTTP client interface. »

1 0

Docs page issue
by Rory Oct. 2, 2019

Oct. 2, 2019

Hi, When i try and download your documentation files (pdf or html) i get HTTP 404 response. is this down ? I want to download some docs so I can code on my plane ride :) https://docs.python.org/3/download.html regards, Rory

1 0

Missing download files
by Alexander Bulko Oct. 2, 2019

Oct. 2, 2019

Hello All links to download files (https://docs.python.org/3/download.html) return 404 error. Could You please take a look? Thank You. Alexander Sent with [ProtonMail](https://protonmail.com) Secure Email.

1 0

Undocumented attribute scanner for compiled regular expression objects
by jm allard Oct. 1, 2019

Oct. 1, 2019

Hello Compiled regular expression objects have 13 attributes 12 are documented |Pattern.||search, | ||Pattern.||match,|||| |||Pattern.||fullmatch||| |||.... ||||Pattern.||pattern| |||||| But one is not |Pattern.||scanner| | | |Here|: https://docs.python.org/3.8/library/re.html Example: tokens = [ r'(?P<NUMBER>\d+)', r'(?P<PLUS>\+)', r'(?P<MINUS>-)', r'(?P<TIMES>\*)', r'(?P<DIVIDE>/)', r'(?P<WS>\s+)'] lex = re.compile('|'.join(tokens)) scan = lex.scanner(text) Regards JM Allard

1 0

[issue38294] Documentation on 3.6->3.7 re.escape no longer escaping "/" or ":" should be obvious
by Ricardo Bánffy Oct. 1, 2019

Oct. 1, 2019

Change by Ricardo Bánffy <rbanffy(a)gmail.com>: ---------- title: re.escape no longer escapes "/" or ":" -> Documentation on 3.6->3.7 re.escape no longer escaping "/" or ":" should be obvious _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38294> _______________________________________

1 0