Mailman 3 June 2018 - docs

[issue33766] Grammar Incongruence
by Terry J. Reedy 09 Jun '18

09 Jun '18

Terry J. Reedy <tjreedy(a)udel.edu> added the comment: A few years ago, there was a particular case in which compile failed without a trailing newline. We fixed it so that it would work anyway. Unless we are willing for a conforming Python interpreter to fail >>> exec('print("hello")') hello The Reference Manual should be clear that EOF and EOS (end-of-string) is treated as NEWLINE. ---------- nosy: +terry.reedy _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33766> _______________________________________

1 0

[issue33807] CONTRIBUTING.rst: 'Stable buildbots' links with 404 errors
by Suriyaa Sundararuban 08 Jun '18

08 Jun '18

New submission from Suriyaa Sundararuban <python(a)suriyaa.tk>: I'm working on this issue. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33807> _______________________________________

3 5

[issue33745] 3.7.0b5 changes the line number of empty functions with docstrings
by Nick Coghlan 08 Jun '18

08 Jun '18

Nick Coghlan <ncoghlan(a)gmail.com> added the comment: The rationale for documenting it in the porting section is that even though this isn't a guaranteed stable interface, the output *does* potentially affect development tools like Ned's coverage.py, as well as other implementations attempting to adhere closely to CPython's behaviour for any given version. (Although it doesn't usually help *Ned* much, since he's often the one letting us know that we inadvertently changed some details of the code generator's output...) ---------- assignee: -> docs@python components: +Documentation nosy: +docs@python _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33745> _______________________________________

1 0

[issue33798] Fix csv module comment regarding dict insertion order
by Andrés Delfino 08 Jun '18

08 Jun '18

New submission from Andrés Delfino <adelfino(a)gmail.com>: The csv module says "Python’s dict objects are not ordered". PR fixes this , leaving a comment on the rationale. ---------- assignee: docs@python components: Documentation messages: 318961 nosy: adelfino, docs@python priority: normal severity: normal status: open title: Fix csv module comment regarding dict insertion order type: enhancement versions: Python 3.7, Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33798> _______________________________________

3 5

[issue33807] CONTRIBUTING.rst: 'Stable buildbots' links with 404 errors
by Suriyaa Sundararuban 08 Jun '18

08 Jun '18

Change by Suriyaa Sundararuban <python(a)suriyaa.tk>: ---------- assignee: docs@python components: Documentation nosy: docs@python, suriyaa priority: normal severity: normal status: open title: CONTRIBUTING.rst: 'Stable buildbots' links with 404 errors type: behavior _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33807> _______________________________________

1 0

[issue32392] subprocess.run documentation does not have **kwargs
by Oleh Prypin 08 Jun '18

08 Jun '18

New submission from Oleh Prypin <blaxpirit(a)gmail.com>: I was just looking at documentation of https://docs.python.org/3.6/library/subprocess.html#subprocess.run and thought that it doesn't support passing `env` because the list of supported keyword arguments is exhaustive (no **kwargs). But it does support passing **kwargs to Popen, so that should be specified in the docs. ---------- assignee: docs@python components: Documentation messages: 308810 nosy: docs@python, oprypin priority: normal severity: normal status: open title: subprocess.run documentation does not have **kwargs versions: Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue32392> _______________________________________

5 11

About Document Download-Other Languages
by Staring the Star 06 Jun '18

06 Jun '18

Dear Python Team Hello, I'm one of the newbies who has just started (actually, few days ago) Python. However, while I tried to download the online document file of Python 3.6.5, I found out that the downloading page only supported English document download. Although I CAN read English, it would be a great help if the "download" supports other languages(French, Japanese, Korean). Also, could I know who translate this document? My friend, who started Python with me, is Korean, and he always wants to look at full-translated document. He even said that rather he could translate the documents than waiting all day XD Sorry for my bad English... :( Sincerely.

1 0

[issue33600] [EASY DOC] Python 2: document that platform.linux_distribution() has been removed
by STINNER Victor 06 Jun '18

06 Jun '18

New submission from STINNER Victor <vstinner(a)redhat.com>: The platform.linux_distribution() function has been removed from the future Python 3.8. The removal should be documented in Python 2.7 documentation, and mention the alternative. Python 2 documenation: https://docs.python.org/2/library/platform.html#platform.linux_distribution Python 3 documentation with the deprecation warning: https://docs.python.org/3/library/platform.html#platform.linux_distribution IMHO it's too late to deprecate the function from Python 2. We should only add a quick note. Function removed in: bpo-28167. ---------- assignee: docs@python components: Documentation messages: 317275 nosy: docs@python, vstinner priority: normal severity: normal status: open title: [EASY DOC] Python 2: document that platform.linux_distribution() has been removed versions: Python 2.7 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33600> _______________________________________

2 4

[issue33477] Document that compile(code, 'exec') has different behavior in 3.7+
by Matthias Bussonnier 05 Jun '18

05 Jun '18

New submission from Matthias Bussonnier <bussonniermatthias(a)gmail.com>: In recent Python the following >>> from ast import PyCF_ONLY_AST >>> compile("'a'", 'whatever', 'exec', PyCF_ONLY_AST).body In 3.6 it return [<_ast.Expr at 0x10b7441d0>] # that contail Str('a') While on master: [] This is inconveninent for alternative repl like IPython, where basically if the user is entering a single string, the result is nothing in Python 3.7+, while it _does_ return something on earlier Python [1]. The documentation of `compile` says: > ... it can be 'exec' if source consists of a sequence of statements, Which is not technically true any more as the first statement, if a string, will be removed. What's happening here is that since Python 3.7 if the _first_ statement is actually an expression containing a lonely string it is assign to the module docstring. So that's basically assuming you are parsing a module, and that the docstring make sens in this context, while in a REPL you are parsing a sucesssion of statements, in which case there is no need for a docstring that make no sens in this context. This is _usually_ not an issue, unless this lonely statement is also the last, and what the user wants to execute in a REPL, in which case it has no side effect. I don't have any objection to the new behavior, though I was wondering if this kind of side effect was anticipated. If that affect IPython, it will likely effect other alternative REPLs. Thus, I believe it would be good to have this at least documented a tiny bit better and added in what's new, and potentially clarified in the `exec` docs. I could argue that now the `exec` name may be a tiny bit unsuitable for the new behavior, and would love if this could be optional. 1: https://github.com/ipython/ipython/issues/11133#issuecomment-388591332 ---------- assignee: docs@python components: Documentation, Interpreter Core messages: 316441 nosy: docs@python, mbussonn priority: normal severity: normal status: open title: Document that compile(code, 'exec') has different behavior in 3.7+ versions: Python 3.7, Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33477> _______________________________________

2 5

[issue17045] Improve C-API doc for PyTypeObject
by Cheryl Sabella 05 Jun '18

05 Jun '18

Cheryl Sabella <cheryl.sabella(a)gmail.com> added the comment: This isn't directly related to this change, but I wanted to point out #23869 since you seem to understand the topic enough to respond to that ticket. Thanks! ---------- nosy: +cheryl.sabella _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue17045> _______________________________________

1 0