Mailman 3 March 2017 - docs

[issue29349] Update old Python 2 code in Docs/tools/extensions/patchlevel.py
by Jim Fasarakis-Hilliard March 31, 2017

March 31, 2017

New submission from Jim Fasarakis-Hilliard: There's a hidden Python 2 print call in the script that only gets reached after you move the Doc/ folder outside the main CPython directory and run `make html`. Additionally, an obsolete way of assuring a file gets closed is used (changed to use `with` statement). P.S: Tagged this with the Documentation component, maybe build is more applicable but I wasn't sure. ---------- assignee: docs@python components: Documentation files: patchlevel.patch keywords: patch messages: 286065 nosy: Jim Fasarakis-Hilliard, docs@python priority: normal severity: normal status: open title: Update old Python 2 code in Docs/tools/extensions/patchlevel.py type: behavior versions: Python 3.4, Python 3.5, Python 3.6, Python 3.7 Added file: http://bugs.python.org/file46387/patchlevel.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29349> _______________________________________

6 15

[issue27998] Bytes paths now are supported in os.scandir() on Windows
by Donald Stufft March 31, 2017

March 31, 2017

Changes by Donald Stufft <donald(a)stufft.io>: ---------- pull_requests: +977 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue27998> _______________________________________

1 0

[issue28513] Documment zipfile CLI
by Serhiy Storchaka March 31, 2017

March 31, 2017

New submission from Serhiy Storchaka: Command-line interface of the zipfile module is supported long time, but it is not documented. Proposed patch documents it. It is based on the documentation of tarfile CLI. ---------- assignee: docs@python components: Documentation files: zipfile_cli_docs.patch keywords: patch messages: 279250 nosy: alanmcintyre, berker.peksag, docs@python, serhiy.storchaka, twouters priority: normal severity: normal stage: patch review status: open title: Documment zipfile CLI type: enhancement versions: Python 2.7, Python 3.5, Python 3.6, Python 3.7 Added file: http://bugs.python.org/file45195/zipfile_cli_docs.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue28513> _______________________________________

8 15

[issue15369] pybench and test.pystone poorly documented
by Florent Xicluna March 31, 2017

March 31, 2017

New submission from Florent Xicluna <florent.xicluna(a)gmail.com>: The benchmarking tools "pystones" and "pybench" which are shipped with the Python standard distribution are not documented. The only information is in the what's-new for Python 2.5: http://docs.python.org/dev/whatsnew/2.5.html?highlight=pybench#new-improved… IMHO, they should be mentioned somewhere in the HOWTOs, the FAQ or the standard library documentation ("Development Tools" or "Debugging and Profiling") ---------- assignee: docs@python components: Benchmarks, Documentation messages: 165603 nosy: docs@python, flox priority: normal severity: normal status: open title: pybench and test.pystone poorly documented type: behavior versions: Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue15369> _______________________________________

7 17

[issue28739] PEP 498: docstrings as f-strings
by Donald Stufft March 31, 2017

March 31, 2017

Changes by Donald Stufft <donald(a)stufft.io>: ---------- pull_requests: +885 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue28739> _______________________________________

1 0

[issue27778] PEP 524: Add os.getrandom()
by Donald Stufft March 31, 2017

March 31, 2017

Changes by Donald Stufft <donald(a)stufft.io>: ---------- pull_requests: +848 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue27778> _______________________________________

1 0

[issue28810] Document bytecode changes in 3.6
by Serhiy Storchaka March 31, 2017

March 31, 2017

New submission from Serhiy Storchaka: There are many bytecode changes in 3.6, but seems most of them are not documented (besides short line in _bootstrap_external.py). * The bytecode now uses 16 bit units (wordcode) (issue26647). * Added FORMAT_VALUE opcode (issue25483). * Added BUILD_CONST_KEY_MAP opcode (issue27140). * Added BUILD_STRING opcode (issue27078). * Added BUILD_TUPLE_UNPACK_WITH_CALL opcode (issue28257). * Added SETUP_ANNOTATIONS and STORE_ANNOTATION opcodes (issue27985). * Changed CALL_FUNCTION, CALL_FUNCTION_KW and BUILD_MAP_UNPACK_WITH_CALL opcodes, removed CALL_FUNCTION_VAR, CALL_FUNCTION_VAR_KW opcodes, added CALL_FUNCTION_EX opcode (issue27213). * Changed MAKE_FUNCTION opcode, removed MAKE_CLOSURE opcode (issue27095). * Not related to the bytecode itself: lineno delta of code.co_lnotab now is signed (issue26107). There are third-party projects that need correct information about bytecode changes. ---------- assignee: docs@python components: Documentation messages: 281788 nosy: docs@python, serhiy.storchaka priority: high severity: normal stage: needs patch status: open title: Document bytecode changes in 3.6 type: enhancement versions: Python 3.6, Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue28810> _______________________________________

6 32

[issue29251] Class __dict__ is only a mapping proxy
by Martin Panter March 30, 2017

March 30, 2017

New submission from Martin Panter: The __dict__ attribute of class objects is documented as being a (standard) dictionary, but implemented with a proxy object. I propose to clarify the documentation in “Custom classes” under <https://docs.python.org/3.5/reference/datamodel.html#the-standard-type-hier…>, and in <https://docs.python.org/3.5/library/functions.html#type>. I believe my changes are also applicable to Python 2, as long as I point out the proxy is specific to “new-style” classes. ---------- assignee: docs@python components: Documentation files: class-dict.patch keywords: patch messages: 285313 nosy: docs@python, martin.panter priority: normal severity: normal stage: patch review status: open title: Class __dict__ is only a mapping proxy type: behavior versions: Python 2.7, Python 3.5, Python 3.6, Python 3.7 Added file: http://bugs.python.org/file46268/class-dict.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29251> _______________________________________

2 3

[issue28415] PyUnicode_FromFormat integer format handling different from printf about zeropad
by Terry J. Reedy March 30, 2017

March 30, 2017

Terry J. Reedy added the comment: *Way* too wordy. In msg278666, I suggested minimal and terse alternatives. a. /exactly/nearly/ b. add "except that a 0 conversion flag is not ignored when a precision is given for d, i, o, u, x and X conversion types" ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue28415> _______________________________________

1 0

[issue22392] Clarify documentation of __getinitargs__
by David Gilman March 30, 2017

March 30, 2017

New submission from David Gilman: Implementations of __getinitargs__ return a tuple of the positional arguments for __init__. This wasn't initially apparent to me after reading the docs: I thought you were passing a tuple (args, kwargs) that would get called f(*args, **kwargs) and had to go to the pickle implementation to find out what you were supposed to do. The proposed documentation enhancement: mention that you're just supposed to return a tuple of positional args and that it doesn't support kwargs. ---------- assignee: docs@python components: Documentation messages: 226795 nosy: David.Gilman, docs@python priority: normal severity: normal status: open title: Clarify documentation of __getinitargs__ type: enhancement versions: Python 2.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue22392> _______________________________________

5 8