Mailman 3 June 2018 - docs

[issue33847] doc: Add '@' operator entry to index
by Andrés Delfino 15 Jun '18

15 Jun '18

New submission from Andrés Delfino <adelfino(a)gmail.com>: Currently, the index only refers to decorators for the @ symbol. PR adds entry for the matrix multiplication operator. ---------- assignee: docs@python components: Documentation messages: 319398 nosy: adelfino, docs@python priority: normal severity: normal status: open title: doc: Add '@' operator entry to index type: enhancement versions: Python 3.6, Python 3.7, Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33847> _______________________________________

3 8

[issue33852] doc Remove parentheses from
by Andrés Delfino 15 Jun '18

15 Jun '18

New submission from Andrés Delfino <adelfino(a)gmail.com>: I think the idea of having "list" inside parentheses is to document that in case of sequences, only "one-expression" expression lists are legal. That being said, IMHO, explaining that in actual prose would be better, but removing the parentheses (taking into account that there's a description of what the expected evaluation of sequences subscription expression lists is) is enough, plus, it's the production list term's name. If a prose is considered better, it could read: "If the primary is a sequence, the expression list must be formed by only one expression, and it must evaluate to an integer or a slice (as discussed in the following section)." Couldn't find the original author. It was committed before the move to mercurial, and I don't know if there's a subversion repo still available to see historical changes. ---------- assignee: docs@python components: Documentation messages: 319460 nosy: adelfino, docs@python priority: normal pull_requests: 7295 severity: normal status: open title: doc Remove parentheses from 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/issue33852> _______________________________________

4 11

https://docs.python.org/fr/3/download.html all links 404 <eom>
by James Huang 15 Jun '18

15 Jun '18

1 0

[issue33860] doc Avoid "ordered dictionary" references now that dictionaries are ordered
by Andrés Delfino 15 Jun '18

15 Jun '18

New submission from Andrés Delfino <adelfino(a)gmail.com>: IMHO, using "ordered dictionaries" references is somewhat confusing now that dictionaries preserve insertion order. PR changes this references to "OrderedDict object". ---------- assignee: docs@python components: Documentation messages: 319523 nosy: adelfino, docs@python priority: normal pull_requests: 7308 severity: normal status: open title: doc Avoid "ordered dictionary" references now that dictionaries are ordered type: enhancement versions: Python 3.7, Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33860> _______________________________________

3 7

[issue17045] Improve C-API doc for PyTypeObject
by Eric Snow 14 Jun '18

14 Jun '18

Change by Eric Snow <ericsnowcurrently(a)gmail.com>: ---------- resolution: -> fixed stage: patch review -> resolved status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue17045> _______________________________________

1 0

[issue17045] Improve C-API doc for PyTypeObject
by Eric Snow 14 Jun '18

14 Jun '18

Eric Snow <ericsnowcurrently(a)gmail.com> added the comment: New changeset 9e7c92193cc98fd3c2d4751c87851460a33b9118 by Eric Snow in branch 'master': bpo-17045: Improve C-API doc for PyTypeObject. (gh-7413) https://github.com/python/cpython/commit/9e7c92193cc98fd3c2d4751c87851460a3… ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue17045> _______________________________________

1 0

[issue33862] doc Fix Enum __members__ type
by Andrés Delfino 14 Jun '18

14 Jun '18

New submission from Andrés Delfino <adelfino(a)gmail.com>: Documentation says __members__ attribute returns an "ordered dictionary" but it returns a mappingproxy instead. PR fixes this. ---------- assignee: docs@python components: Documentation messages: 319532 nosy: adelfino, docs@python priority: normal severity: normal status: open title: doc Fix Enum __members__ type type: enhancement versions: Python 3.6, Python 3.7, Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33862> _______________________________________

3 4

[issue17045] Improve C-API doc for PyTypeObject
by Eric Snow 13 Jun '18

13 Jun '18

Eric Snow <ericsnowcurrently(a)gmail.com> added the comment: @Cheryl, thanks for pointing that out. I'll take a look. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue17045> _______________________________________

1 0

[issue31378] Missing documentation for sqlite3.OperationalError
by Leonardo Taglialegne 13 Jun '18

13 Jun '18

New submission from Leonardo Taglialegne: sqlite3.OperationalError has no documentation whatsoever in docs.python.org ---------- assignee: docs@python components: Documentation messages: 301575 nosy: Leonardo Taglialegne, docs@python priority: normal severity: normal status: open title: Missing documentation for sqlite3.OperationalError type: enhancement versions: Python 2.7, Python 3.3, Python 3.4, Python 3.5, Python 3.6, Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue31378> _______________________________________

4 9

[issue33828] Add versionchanged notes for string.Formatter
by Xiang Zhang 12 Jun '18

12 Jun '18

New submission from Xiang Zhang <angwerzx(a)126.com>: I propose to add versionchanged note about auto-numbering feature of string.Formatter, introduced in #13598. It's quite confusing which version could I use the feature reading the doc. Also it's better to note in 2.7 the feature is not available. Currently the doc gives me the feeling string.Formatter and str.format share the same feature and the auto-numbering feature is available in 2.7 and >3.1. ---------- assignee: docs@python components: Documentation messages: 319284 nosy: docs@python, eric.smith, xiang.zhang priority: normal severity: normal stage: needs patch status: open title: Add versionchanged notes for string.Formatter versions: Python 3.6, Python 3.7, Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33828> _______________________________________

2 9