Mailman 3 November 2018 - docs

[issue33878] Doc: Assignment statement to tuple or list: case missing.
by Julien Palard Nov. 12, 2018

Nov. 12, 2018

New submission from Julien Palard <julien+python(a)palard.fr>: In [1] I read: > If the target list is a comma-separated list of targets, or a single target in square brackets This come from https://bugs.python.org/issue23275 (patch is [2]). I suspect there's a missing case "list of targets in square brackets" (and to be pedantic "list of targets in parenthesis"). The specialized documentation about single-valued targets in sequence-like construction come from this difference: >>> (a) = 42 >>> a 42 >>> [a] = [42] >>> a 42 which is correctly described the line before: > If the target list is a single target in parentheses: The object is assigned to that target. So the correct way to state it may be: > Else the object must be an iterable with the same number of items as there are targets in the target list, and the items are assigned, from left to right, to the corresponding targets. The `Else`, coupled with the existing "Assignment of an object to a target list, optionally enclosed in parentheses or square brackets" covers properly the cases: - Multiple target separated by comas (already covered) - Multiple target enclosed by parenthesis and brackets (not covered) - Single target enclosed by angle brackets (already covered) [1]: https://docs.python.org/3.7/reference/simple_stmts.html#assignment-statemen… [2]: https://bugs.python.org/file42878/issue23275_v4.diff ---------- assignee: docs@python components: Documentation messages: 319735 nosy: docs@python, martin.panter, mdk priority: normal severity: normal status: open title: Doc: Assignment statement to tuple or list: case missing. type: enhancement _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33878> _______________________________________

7 14

[issue33699] Don't describe try's else clause in a footnote
by Andrés Delfino Nov. 11, 2018

Nov. 11, 2018

New submission from Andrés Delfino <adelfino(a)gmail.com>: This behavior has not changed in 11 years so I think it's safe to describe the "else" clause along the rest of the "try" clause. Attached PR fixes this. ---------- assignee: docs@python components: Documentation messages: 318205 nosy: adelfino, docs@python priority: normal severity: normal status: open title: Don't describe try's else clause in a footnote type: enhancement versions: Python 2.7, Python 3.6, Python 3.7, Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33699> _______________________________________

3 10

[issue23220] IDLE: Document how Shell displays user code output
by Terry J. Reedy Nov. 10, 2018

Nov. 10, 2018

Terry J. Reedy <tjreedy(a)udel.edu> added the comment: In the patch for #33000, to cover MacOS behavior, I changed the comment about control chars from 'replaced' to 'replaced or deleted' Users can fill in the details by comparing IDLE on their system to a particular console or terminal. ---------- resolution: -> fixed stage: needs patch -> resolved status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue23220> _______________________________________

1 0

breaked links
by Ousmane Nov. 10, 2018

Nov. 10, 2018

Hello, I will to download for frequent offline consultation the doc on version 3.5. But any download link on the https://docs.python.org/en/3.5/download.html works. Thanks

1 0

Python Docs SEO
by Blue Postit Nov. 9, 2018

Nov. 9, 2018

Hello It’s quite frustrating that for many given search results (on DuckDuckGo), the first result from the Python documentation is for an old version of Python, usually 2.x. Here’s an example: Please fix the SEO ranking of the Python 3 documentation pages. Thanks! Regards, bluepostit

2 1

Permission to use few programs and part of the documentation found in Python.org
by Gowrishankar S Nath Nov. 8, 2018

Nov. 8, 2018

Hi, I would like to introduce myself as Dr.S.Gowrishankar working as Associate Professor at the Department of Computer Science and Engineering at Dr.Ambedkar Institute of Technology, Bengaluru, India. I like to adopt a few programs and part of the explanation as it is found in the documentation of Python.org for a book I'm working on. Can you please give permission to use these programs? I'll mention the source and give attribute to you. Please consider our request. Regards, Gowrishankar.S **************************************************************************Dr.S.Gowrishankar,Associate Professor,Department of Computer Science and Engineering,Dr.Ambedkar Institute of Technology,Bengaluru-560056, Karnataka, India.* *Mob: 9986374400* *http://www.gowrishankarnath.com <http://www.gowrishankarnath.com>* *Twitter: @g_s_nath* ***************************************************************************

2 1

[issue34885] asycnio documention has lost its paragraph about cancellation
by Amirouche Boubekki Nov. 8, 2018

Nov. 8, 2018

New submission from Amirouche Boubekki <amirouche.boubekki(a)gmail.com>: The paragraph was still there in 3.6 https://docs.python.org/3.6/library/asyncio-dev.html#cancellation ---------- assignee: docs@python components: Documentation, asyncio messages: 326966 nosy: abki, asvetlov, docs@python, yselivanov priority: normal severity: normal status: open title: asycnio documention has lost its paragraph about cancellation type: enhancement versions: Python 3.7, Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue34885> _______________________________________

3 4

[issue35015] availability directive breaks po files
by Julien Palard Nov. 7, 2018

Nov. 7, 2018

New submission from Julien Palard <julien+python(a)palard.fr>: The new availability directive introduced in 2d6097d027e0dd3debbabc702aa9c98d94ba32a3 (https://bugs.python.org/issue11233) breaks po files (sphinx-build -b gettext): Here's the diff I'm getting on os.po from os.rst: msgid "" -"Availability: Unix, Windows. :func:`spawnlp`, :func:`spawnlpe`, :func:" -"`spawnvp` and :func:`spawnvpe` are not available on Windows. :func:" -"`spawnle` and :func:`spawnve` are not thread-safe on Windows; we advise you " -"to use the :mod:`subprocess` module instead." +"Availability: Unix, Windows. spawnlp(), spawnlpe(), spawnvp() and " +"spawnvpe() are not available on Windows. spawnle() and spawnve() are not " +"thread-safe on Windows; we advise you to use the subprocess module instead." The roles has been removed in the po files (but not in the original rst files), so it looks like the availability directive caused the drop of roles, but I still don't understand why. ---------- assignee: docs@python components: Documentation messages: 327946 nosy: docs@python, georg.brandl, mdk priority: normal severity: normal status: open title: availability directive breaks po files versions: Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35015> _______________________________________

6 14

Documentation Issue: 6.15. Evaluation order , , Python evaluates expressions from left to right."
by Lorenz Fischer Nov. 7, 2018

Nov. 7, 2018

The documentation says: /6.15. Evaluation order/ /Python evaluates expressions from left to right./ But: Multiple power operators are evaluated right to left.

1 0

[issue35183] os.path.splitext documentation needs typical example
by Shaun Griffith Nov. 7, 2018

Nov. 7, 2018

New submission from Shaun Griffith <shaun.griffith.1964(a)gmail.com>: As with many entries on the os.path doc page, splitext needs a typical example. Not grokking the bare minimum text, I had to actually try it in the interpreter to see what it did. The one example that *is* there is an edge case, and does nothing to explain the normal behavior, or why this is the correct behavior for the edge case. Here is where I tripped up: Split the pathname path into a pair (root, ext) such that root + ext == path, and ext is empty or begins with a period and contains at most one period. One interpretation of this is that ext is either empty, or has a period, _and nothing else_. Here are 2 examples for typical use: >>> splitext('readme.txt') ('readme', '.txt') >>> splitext('/some/long/pathname/warble.csv') ('/some/long/pathname/warble', '.csv') ---------- assignee: docs@python components: Documentation messages: 329414 nosy: docs@python, shaungriffith priority: normal severity: normal status: open title: os.path.splitext documentation needs typical example type: enhancement versions: Python 3.6 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue35183> _______________________________________

1 0