Mailman 3 January 2022 - Docs-bugs

[issue46196] documentation for cmd library should include columnize() function
by sharewell 02 Jan '22

02 Jan '22

New submission from sharewell <jawed(a)sharewellnow.com>: Cmd.columnize is an extremely useful function in Python, that can be used in many situations. It is part of the Cmd library. Unfortunately, the Cmd documentation does not mention it. It should. I only found out about it via https://stackoverflow.com/a/59627245 Please add to the documentation: https://docs.python.org/3/library/cmd.html ---------- assignee: docs@python components: Documentation messages: 409332 nosy: docs@python, sharewell priority: normal severity: normal status: open title: documentation for cmd library should include columnize() function versions: Python 3.11 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue46196> _______________________________________

3 5

[issue23952] cgi: Document the 'maxlen' member of the cgi module
by Hugo van Kemenade 02 Jan '22

02 Jan '22

Change by Hugo van Kemenade <hugovk+python(a)gmail.com>: ---------- keywords: +patch nosy: +hugovk nosy_count: 4.0 -> 5.0 pull_requests: +28550 stage: needs patch -> patch review pull_request: https://github.com/python/cpython/pull/30338 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue23952> _______________________________________

1 0

[issue46228] argparse docs: default for prog= in ArgumentParser() should be basename of argv[0], not argv[0], to match behaviour
by Éric Araujo 02 Jan '22

02 Jan '22

Change by Éric Araujo <merwok(a)netwok.org>: ---------- assignee: -> docs@python components: +Documentation nosy: +docs@python stage: -> patch review type: enhancement -> behavior versions: -Python 3.6, Python 3.7, Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue46228> _______________________________________

1 0

[issue45903] What’s New In Python 3.11: wrong reference to Signature.from_callable
by Jakub Wilk 02 Jan '22

02 Jan '22

New submission from Jakub Wilk <jwilk(a)jwilk.net>: <https://docs.python.org/3.11/whatsnew/3.11.html#removed> says: "Removed from the inspect module: […] the undocumented Signature.from_callable and Signature.from_function functions, deprecated since Python 3.5; use the Signature.from_callable() method instead." But Signature.from_callable can't possibly be removed and the suggested replacement at the same time. I think it should say: "… the undocumented Signature.from_builtin and …" ---------- assignee: docs@python components: Documentation messages: 407054 nosy: docs@python, hugovk, jwilk priority: normal severity: normal status: open title: What’s New In Python 3.11: wrong reference to Signature.from_callable versions: Python 3.11 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue45903> _______________________________________

4 5

[issue46095] Warning about iterate/modify has unwarranted detail
by Ture Pålsson 01 Jan '22

01 Jan '22

New submission from Ture Pålsson <ture(a)turepalsson.se>: The language reference about the 'for' statement (https://docs.python.org/3/reference/compound_stmts.html#the-for-statement) has a "Note" box that states that the for statement uses an "internal counter" which is "incremented", and goes into detail about what happens when modifications happen before or after the current loop position. Surely this depends on the underlying iterator? For example, with a balanced tree an insert or a delete could completely re-jigger the tree with hard-to-predict results on an iterator. ---------- assignee: docs@python components: Documentation messages: 408680 nosy: docs@python, turepalsson priority: normal severity: normal status: open title: Warning about iterate/modify has unwarranted detail type: enhancement versions: Python 3.10 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue46095> _______________________________________

4 8

[issue46079] Broken URL in tutorial
by Vivek Vashist 01 Jan '22

01 Jan '22

New submission from Vivek Vashist <vivekvashist(a)gmail.com>: URL: http://tycho.usno.navy.mil/cgi-bin/timer.pl is broken in the example https://docs.python.org/3/tutorial/stdlib.html#internet-access > curl -v http://tycho.usno.navy.mil/cgi-bin/timer.pl * Could not resolve host: tycho.usno.navy.mil * Closing connection 0 curl: (6) Could not resolve host: tycho.usno.navy.mil ---------- assignee: docs@python components: Documentation messages: 408585 nosy: docs@python, vivekvashist priority: normal severity: normal status: open title: Broken URL in tutorial versions: Python 3.10 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue46079> _______________________________________

4 11