Mailman 3 September 2018 - docs

[issue25299] TypeError: __init__() takes at least 4 arguments (4 given)
by A. Skrobov Oct. 28, 2019

Oct. 28, 2019

New submission from A. Skrobov: Python 2.7.3 (default, Dec 18 2014, 19:10:20) [GCC 4.6.3] on linux2 Type "help", "copyright", "credits" or "license" for more information. >>> from argparse import ArgumentParser >>> parser = ArgumentParser() >>> parser.add_argument("--foo", help="foo", action='store_const') Traceback (most recent call last): File "<stdin>", line 1, in <module> File "/usr/lib/python2.7/argparse.py", line 1281, in add_argument action = action_class(**kwargs) TypeError: __init__() takes at least 4 arguments (4 given) >>> First, the exception message is entirely unhelpful (you wanted at least 4, you got 4, what's your problem?) Second, adding "const=None" to the invocation makes it succeed; but, according to https://docs.python.org/2/library/argparse.html#const this argument defaults to "None", so it shouldn't be necessary to specify it explicitly. Thus, either the documentation or the implementation is wrong. ---------- assignee: docs@python components: Documentation, Extension Modules messages: 252106 nosy: A. Skrobov, docs@python priority: normal severity: normal status: open title: TypeError: __init__() takes at least 4 arguments (4 given) type: behavior versions: Python 2.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue25299> _______________________________________

6 17

[issue27992] In the argparse there is a misleading words about %(prog)s value
by py.user Oct. 24, 2019

Oct. 24, 2019

New submission from py.user: https://docs.python.org/3/library/argparse.html#argumentparser-objects "prog - The name of the program (default: sys.argv[0])" It doesn't take all sys.argv[0]. It splits sys.argv[0] and takes only the trailing part. An example: a.py #!/usr/bin/env python3 import argparse import sys parser = argparse.ArgumentParser() parser.add_argument("arg", help="The name is %(prog)s, the sys.argv[0] is " + sys.argv[0]) args = parser.parse_args() The output in the console: [guest@localhost bugs]$ ../bugs/a.py -h usage: a.py [-h] arg positional arguments: arg The name is a.py and sys.argv[0] is ../bugs/a.py optional arguments: -h, --help show this help message and exit [guest@localhost bugs]$ In the output we see that %(prog)s takes only trailing part of sys.argv[0] not all. Applied a patch to the issue that specifies about part of sys.argv[0]. ---------- assignee: docs@python components: Documentation, Library (Lib) files: argparse_sys-argv-0-part.diff keywords: patch messages: 274729 nosy: docs@python, py.user priority: normal severity: normal status: open title: In the argparse there is a misleading words about %(prog)s value type: behavior versions: Python 3.6 Added file: http://bugs.python.org/file44420/argparse_sys-argv-0-part.diff _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue27992> _______________________________________

2 5

[issue13562] Notes about module load path
by Nam Nguyen Oct. 22, 2019

Oct. 22, 2019

New submission from Nam Nguyen <bitsink(a)gmail.com>: A doc patch to remind Python embedder to set sys.path prior to Py_Initialize. This is to ensure a controlled module load path to work around these issues: http://bugs.python.org/issue12989 http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2008-5983 ---------- assignee: docs@python components: Documentation files: module.load.path.diff keywords: patch messages: 149071 nosy: Nam.Nguyen, docs@python priority: normal severity: normal status: open title: Notes about module load path type: feature request versions: Python 2.6, Python 2.7, Python 3.1, Python 3.2 Added file: http://bugs.python.org/file23888/module.load.path.diff _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue13562> _______________________________________

4 6

[issue32996] Improve What's New in 3.7
by Serhiy Storchaka Oct. 15, 2019

Oct. 15, 2019

New submission from Serhiy Storchaka <storchaka+cpython(a)gmail.com>: The following PR fixes and improves formatting in the "What's New in Python 3.7" document, adds links to issues and authors names. This is just one step. Somebody need to review NEWS entries and adds corresponding What's New entries if they are worth this, and later edit the wording of the final document. ---------- assignee: docs@python components: Documentation messages: 313243 nosy: docs@python, ned.deily, serhiy.storchaka priority: normal severity: normal status: open title: Improve What's New in 3.7 type: enhancement versions: Python 3.7, Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue32996> _______________________________________

9 26

[issue17894] Edits to descriptor howto
by Ned Batchelder Oct. 11, 2019

Oct. 11, 2019

New submission from Ned Batchelder: I find the explanations in the Descriptor howto to be difficult to understand. I took a stab at changing the first few sections to introduce the concepts in an easier-to-grasp style. Issue 12077 also covers a little bit of this. ---------- assignee: docs@python components: Documentation files: descriptor_howto.patch keywords: patch messages: 188289 nosy: docs@python, nedbat priority: normal severity: normal status: open title: Edits to descriptor howto versions: Python 3.4 Added file: http://bugs.python.org/file30111/descriptor_howto.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue17894> _______________________________________

7 15

[issue31589] Links for French documentation pdf is broken
by fabrice Oct. 8, 2019

Oct. 8, 2019

New submission from fabrice: Hi, In this page : https://docs.python.org/fr/2/download.html, all the documentation links aren't available, for example : - https://docs.python.org/fr/2/archives/python-2.7.14-docs-pdf-a4.zip - https://docs.python.org/fr/2/archives/python-2.7.14-docs-pdf-a4.tar.bz2 So, I can't read the documentation in French :) Regards, Fabrice ---------- assignee: docs@python components: Documentation messages: 303024 nosy: docs@python, fabrice priority: normal severity: normal status: open title: Links for French documentation pdf is broken versions: Python 2.7 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue31589> _______________________________________

8 31

[issue32200] Download of 3.7.0a2 docs giving a 404 error
by Carol Willing Oct. 8, 2019

Oct. 8, 2019

New submission from Carol Willing <willingc(a)gmail.com>: Currently, the 3.7.0a2 doc links are giving 404 errors. 3.6 docs are working just fine. https://docs.python.org/3.7/archives/python-3.7.0a2-docs-pdf-letter.tar.bz2 results in a 404. I wasn't sure if I should report here or in python.org issue tracker. ---------- assignee: docs@python components: Documentation messages: 307433 nosy: docs@python, willingc priority: normal severity: normal status: open title: Download of 3.7.0a2 docs giving a 404 error type: behavior versions: Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue32200> _______________________________________

7 16

[issue33082] multiprocessing docs bury very important 'callback=' args
by Chad Sept. 13, 2019

Sept. 13, 2019

New submission from Chad <millchad(a)amazon.com>: Callbacks are really important in multiprocessing. Doc writer almost ignores them. ---------- assignee: docs@python components: Documentation messages: 313905 nosy: chadmiller-amzn, docs@python priority: normal severity: normal status: open title: multiprocessing docs bury very important 'callback=' args type: enhancement versions: Python 2.7, Python 3.4, Python 3.5, Python 3.6, Python 3.7, Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33082> _______________________________________

6 12

[issue33459] Fix "tuple display" mention in Expressions
by Andrés Delfino Sept. 12, 2019

Sept. 12, 2019

New submission from Andrés Delfino <adelfino(a)gmail.com>: Expressions mentions "tuple displays" in 6.16 (Operator precedence). AFAIK, there ano "tuple displays". Expressions mentions list, dict, and set displays, and then talks about generator expressions. I guess "parenthesized expressions" should be the term that fits here? ---------- assignee: docs@python components: Documentation messages: 316380 nosy: adelfino, docs@python priority: normal severity: normal status: open title: Fix "tuple display" mention in Expressions type: enhancement versions: Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33459> _______________________________________

6 15

[issue13474] Mention of "-m" Flag Missing From Doc on Execution Model
by Eric Snow Sept. 12, 2019

Sept. 12, 2019

New submission from Eric Snow <ericsnowcurrently(a)gmail.com>: The doc on code execution[1] leaves out mention of the -m flag. Seems like it belongs there too. [1] Doc/reference/executionmodel.rst ---------- assignee: docs@python components: Documentation messages: 148288 nosy: docs@python, eric.snow priority: normal severity: normal status: open title: Mention of "-m" Flag Missing From Doc on Execution Model versions: Python 2.7, Python 3.2, Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue13474> _______________________________________

8 10