Mailman 3 June 2021 - Docs-bugs

[issue44322] Document SyntaxError args and interpretation for f-string fields
by Terry J. Reedy June 6, 2021

June 6, 2021

New submission from Terry J. Reedy <tjreedy(a)udel.edu>: Document that SyntaxError args[1] is a tuple of the other attributes and how the meaning of the attributes is adjusted when the syntax error is in an f-string field replacement expression. Also add compile() to the list of builtins that can raise SyntaxError. PR to follow immediately. I wrote most of the text so that it works for 3.9 and 3.10+, with the new end info. In the example, the main part of the message changed from "invalid syntax" to "invalid syntax. Perhaps you forgot a comma?". I hid that with '...' but each could be given in the respective versions. args[1] changes from "('', 1, 4, '(a b)\n')" to "('', 1, 2, '(a b)\n', 1, 5)" and that will have to be changed in a 3.9 backport. Spinoff from #43705. I will create a separate issue for using this information in IDLE. ---------- assignee: docs@python components: Documentation messages: 395208 nosy: ammar2, docs@python, pablogsal, terry.reedy priority: normal severity: normal stage: patch review status: open title: Document SyntaxError args and interpretation for f-string fields versions: Python 3.10, Python 3.11, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue44322> _______________________________________

2 7

[issue44320] License for W3C C14N test suite is rendered as blockquote
by OSAMU NAKAMURA June 5, 2021

June 5, 2021

New submission from OSAMU NAKAMURA <osamu0329nakamura(a)gmail.com>: The License text for W3C C14N test suite is rendered as quoted text, but it should be rendered same as others. - change`:` to `::` ---------- assignee: docs@python components: Documentation messages: 395197 nosy: OSAMU.NAKAMURA, docs@python priority: normal severity: normal status: open title: License for W3C C14N test suite is rendered as blockquote versions: Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue44320> _______________________________________

3 8

[issue42194] Docs for argparse.BooleanOptionalAction missing "New in version 3.9"
by Joannah Nanjekye June 5, 2021

June 5, 2021

Joannah Nanjekye <nanjekyejoannah(a)gmail.com> added the comment: Am inclined to merge the former PR because yours is just an exact replica. Please note that we can merge such small fixes without the author signing the CLA but the author is advised to sign the CLA for future contributions. Source: informed by other core devs on reviewing similar PRs recently and a similar discussion was on a ML some time back. ---------- nosy: +nanjekyejoannah _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue42194> _______________________________________

1 0

[issue44275] Is there a mojibake problem rendering interactive help in the REPL on Windows?
by Jesse Silverman June 4, 2021

June 4, 2021

New submission from Jesse Silverman <jessevsilverman(a)gmail.com>: I didn't know whether to file this under DOCUMENTATION or WINDOWS. I recently discovered the joys of the interactive help in the REPL, rather than just help(whatever). I was exploring the topics and noticed multiple encoding or rendering errors. I realized I stupidly wasn't using the Windows Terminal program but the default console. I addressed that and they persisted in Windows Terminal. I upgraded from 3.9.1 to 3.9.5...same deal. I tried running: Set-Item -Path Env:PYTHONUTF8 -Value 1 before starting the REPL, still no dice. I confirmed this worked in the same session: >>> ustr2='ʑʒʓʔʕʗʘʙʚʛʜʝʞ' >>> ustr2 'ʑʒʓʔʕʗʘʙʚʛʜʝʞ' It does. The help stuff that doesn't render correctly is under topic COMPARISON: lines 20, 21 and 25 of this output contain head-scratch-inducing mystery characters: help> COMPARISON Comparisons *********** Unlike C, all comparison operations in Python have the same priority, which is lower than that of any arithmetic, shifting or bitwise operation. Also unlike C, expressions like "a < b < c" have the interpretation that is conventional in mathematics: comparison ::= or_expr (comp_operator or_expr)* comp_operator ::= "<" | ">" | "==" | ">=" | "<=" | "!=" | "is" ["not"] | ["not"] "in" Comparisons yield boolean values: "True" or "False". Comparisons can be chained arbitrarily, e.g., "x < y <= z" is equivalent to "x < y and y <= z", except that "y" is evaluated only once (but in both cases "z" is not evaluated at all when "x < y" is found to be false). Formally, if *a*, *b*, *c*, ΓÇª, *y*, *z* are expressions and *op1*, *op2*, ΓÇª, *opN* are comparison operators, then "a op1 b op2 c ... y opN z" is equivalent to "a op1 b and b op2 c and ... y opN z", except that each expression is evaluated at most once. Note that "a op1 b op2 c" doesnΓÇÖt imply any kind of comparison between *a* and *c*, so that, e.g., "x < y > z" is perfectly legal (though perhaps not pretty). That is: ΓÇª, ΓÇª, ΓÇÖ em-dash or ellipsis might be involved somehow...maybe fancy apostrophe? My current guess is that it isn't about rendering anymore, because something went awry further upstream? Thanks! ---------- assignee: docs@python components: Documentation messages: 394817 nosy: docs@python, jessevsilverman priority: normal severity: normal status: open title: Is there a mojibake problem rendering interactive help in the REPL on Windows? type: behavior versions: Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue44275> _______________________________________

7 17

[issue44279] doc: contextlib.suppress documentation is imprecise
by Irit Katriel June 4, 2021

June 4, 2021

New submission from Irit Katriel <iritkatriel(a)yahoo.com>: "suppresses any of the specified exceptions if they occur in the body of a with statement" Should be: "suppresses any of the specified exceptions if they are raised in the body of a with statement" ---------- assignee: docs@python components: Documentation, Library (Lib) messages: 394863 nosy: docs@python, iritkatriel priority: normal severity: normal status: open title: doc: contextlib.suppress documentation is imprecise versions: Python 3.10, Python 3.11, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue44279> _______________________________________

5 17

[issue29249] Pathlib glob ** bug
by Christian Heimes June 4, 2021

June 4, 2021

Change by Christian Heimes <lists(a)cheimes.de>: ---------- nosy: -christian.heimes _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue29249> _______________________________________

1 0

[issue29249] Pathlib glob ** bug
by Barney Gale June 4, 2021

June 4, 2021

Change by Barney Gale <barney.gale(a)gmail.com>: ---------- nosy: +barneygale _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue29249> _______________________________________

1 0

[issue44314] [doc] SSLContext.set_ciphers() link to OpenSSL cipher list format is outdated
by Chris Mayo June 4, 2021

June 4, 2021

New submission from Chris Mayo <aklhfex(a)gmail.com>: Current link is: https://www.openssl.org/docs/manmaster/man1/ciphers.html Manual page entries without the 'openssl-' prefix have been deprecated, and this link is now directed to a generic page for openssl cmd. Suggest an update to: https://www.openssl.org/docs/manmaster/man1/openssl-ciphers.html#CIPHER-LIS… Currently at: https://github.com/python/cpython/blame/main/Doc/library/ssl.rst#L1680 ---------- assignee: docs@python components: Documentation messages: 395108 nosy: cjmayo, docs@python priority: normal severity: normal status: open title: [doc] SSLContext.set_ciphers() link to OpenSSL cipher list format is outdated versions: Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue44314> _______________________________________

1 0

[issue29249] Pathlib glob ** bug
by wim glenn June 3, 2021

June 3, 2021

Change by wim glenn <wim.glenn(a)gmail.com>: ---------- nosy: +wim.glenn _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue29249> _______________________________________

1 0

[issue39560] PyUnicode_FromKindAndData kind transformation is not documented
by Joannah Nanjekye June 3, 2021

June 3, 2021

Change by Joannah Nanjekye <nanjekyejoannah(a)gmail.com>: ---------- stage: patch review -> resolved _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue39560> _______________________________________

1 0