Mailman 3 February 2019 - docs

[issue25592] distutils docs: data_files always uses sys.prefix
by Jeroen Demeyer Feb. 2, 2019

Feb. 2, 2019

New submission from Jeroen Demeyer: The documentation for distutils claims that sys.exec_prefix is used in certain cases to install data_files, but this is simply not true (maybe it was true in the past or this sentence was copy/pasted from somewhere else?) ---------- assignee: docs@python components: Documentation files: data_files_doc.patch keywords: patch messages: 254432 nosy: docs@python, jdemeyer priority: normal severity: normal status: open title: distutils docs: data_files always uses sys.prefix versions: Python 2.7 Added file: http://bugs.python.org/file40993/data_files_doc.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue25592> _______________________________________

5 32

Liens cassés !!!
by Harketti BENDAOUD Feb. 2, 2019

Feb. 2, 2019

Format Packed as .zip Packed as .tar.bz2 PDF (US-Letter paper size) Download<https://docs.python.org/fr/3/archives/python-3.7.2-docs-pdf-letter.zip> (ca. 13 MiB) Download<https://docs.python.org/fr/3/archives/python-3.7.2-docs-pdf-letter.tar.bz2> (ca. 13 MiB) PDF (A4 paper size) Download<https://docs.python.org/fr/3/archives/python-3.7.2-docs-pdf-a4.zip> (ca. 13 MiB) Download<https://docs.python.org/fr/3/archives/python-3.7.2-docs-pdf-a4.tar.bz2> (ca. 13 MiB) Provenance : Courrier<https://go.microsoft.com/fwlink/?LinkId=550986> pour Windows 10

1 0

[issue17972] inspect module leak docs
by xiaobing jiang Feb. 1, 2019

Feb. 1, 2019

New submission from xiaobing jiang: the inspect module leak docs. all these functions have no doc. getlineno getabsfile getblock formatannotation walktree findsource indentsize getargs formatannotationrelativeto classify_class_attrs ---------- assignee: docs@python components: Documentation messages: 189193 nosy: docs@python, s7v7nislands(a)gmail.com priority: normal severity: normal status: open title: inspect module leak docs type: enhancement versions: Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue17972> _______________________________________

12 19

Tiny Typo in "Strings" Documentation
by vavrek Feb. 1, 2019

Feb. 1, 2019

Warm wishes Python friends! Found a small documentation bug: https://docs.python.org/3/tutorial/introduction.html#strings "In addition to indexing, slicing is also supported. While indexing is used to obtain individual characters, slicing allows you to obtain <a> substring:" This sentence is merely missing an "a" as indicated. Cheers! Andrew Vavrek https://vavrek.com

1 0

[issue35869] io.BufferReader.read() returns None
by Martin Panter Feb. 1, 2019

Feb. 1, 2019

Martin Panter <vadmium+py(a)gmail.com> added the comment: This is covered by Issue 13322. There are a few other BufferedReader methods that contradict the documentation for non-blocking mode. A while ago I posted a patch to change the implementation to match the documentation, but nobody reviewed it or gave their opinion. These days I would prefer to just documentat the reality: the methods might raise an exception rather than returning None, or perhaps no particular behaviour at all is expected in general in the non-blocking case. But I don’t spend much time on Python now, so you might have to find someone else to move this forward. Regarding the entry for “BufferedReader.read”, it would make more sense to remove the last “if”: “if ‘size’ is not given . . ., until EOF, or the ‘read’ call would block”. But I don’t think even that is complete, because it should also say the read stops and returns short in the non-blocking case even when “size” is positive. ---------- assignee: -> docs@python components: +Documentation, IO nosy: +docs@python, martin.panter superseder: -> buffered read() and write() does not raise BlockingIOError _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35869> _______________________________________

1 0