Mailman 3 April 2021 - docs

[issue43815] documentation for types.new_class() mention misleading default for exec_body
by Eric V. Smith 01 May '21

01 May '21

New submission from Eric V. Smith <eric(a)trueblade.com>: https://github.com/python/cpython/blob/3.8/Lib/types.py The documentation says "If no callback is provided, it has the same effect as passing in lambda ns: ns." I read this as saying that the callback should return the namespace, but in reality the return value is ignored. I think the lambda should be "lambda ns: None". ---------- assignee: docs@python components: Documentation keywords: easy, newcomer friendly messages: 390854 nosy: docs@python, eric.smith priority: normal severity: normal status: open title: documentation for types.new_class() mention misleading default for exec_body versions: Python 3.10, Python 3.8, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue43815> _______________________________________

3 4

Example of uniform on random page appears to have the wrong comment
by Theodore Greene 01 May '21

01 May '21

Hi! I'm a little confused. In the examples section of the docs for the random module it shows uniform(2.5, 10.0) # Random float: 2.5 <= x < 10.0 But the docs say random.uniform(a, b) Return a random floating point number N such that a <= N <= b for a <= b and b <= N <= a for b < a. So, shouldn't the example really say # Random float: 2.5 <= x <= 10.0 or am I not understanding random.uniform? Best wishes, Ted

2 1

[issue43971] documentation: no spacing around default args in annotated function
by Mohamed Moselhy 01 May '21

01 May '21

New submission from Mohamed Moselhy <look4d(a)gmail.com>: See https://www.python.org/dev/peps/pep-0008/#function-annotations The first section of https://docs.python.org/3/library/dataclasses.html shows quantity_on_hand: int=0, when there should be spacing around the '=' according to PEP 8 (see link above). ---------- assignee: docs@python components: Documentation files: screen.png messages: 392271 nosy: docs@python, eric.araujo, ezio.melotti, mdk, moselhy, willingc priority: normal severity: normal status: open title: documentation: no spacing around default args in annotated function versions: Python 3.10, Python 3.11, Python 3.7, Python 3.8, Python 3.9 Added file: https://bugs.python.org/file49998/screen.png _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue43971> _______________________________________

4 8

[issue43869] Fix documentation of epoch/time.time
by Ofek Lev 01 May '21

01 May '21

New submission from Ofek Lev <ofekmeister(a)gmail.com>: The descriptions for the following: - https://docs.python.org/3/library/time.html#epoch - https://docs.python.org/3/library/time.html#time.time indicate that it is platform dependent. However, that is likely untrue. See the brief discussion here: https://github.com/DataDog/integrations-core/pull/6692#discussion_r427469097 ---------- assignee: docs@python components: Documentation messages: 391214 nosy: Ofekmeister, docs@python, p-ganssle priority: normal severity: normal status: open title: Fix documentation of epoch/time.time type: enhancement versions: Python 3.10, Python 3.6, Python 3.7, Python 3.8, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue43869> _______________________________________

3 5

[issue22167] iglob() has misleading documentation (does indeed store names internally)
by Roy Smith 30 Apr '21

30 Apr '21

New submission from Roy Smith: For background, see: https://mail.python.org/pipermail/python-list/2014-August/676291.html In a nutshell, the iglob() docs say, "Return an iterator which yields the same values as glob() without actually storing them all simultaneously." The problem is, internally, it calls os.listdir(), which apparently *does* store the entire list internally, defeating the whole purpose of iglob() I recognize that iglob() is not going to get fixed in 2.7, but at least the documentation should be updated to point out that it doesn't really do what it says it does. Or rather, it doesn't really not do what it says it doesn't :-) ---------- assignee: docs@python components: Documentation messages: 225048 nosy: docs@python, roysmith priority: normal severity: normal status: open title: iglob() has misleading documentation (does indeed store names internally) type: enhancement versions: Python 2.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue22167> _______________________________________

8 19

[issue43928] Fix the typo in documentation
by Terry J. Reedy 30 Apr '21

30 Apr '21

New submission from Terry J. Reedy <tjreedy(a)udel.edu>: New changeset e08c67372d62236409da296353827985a3202e8a by JT in branch 'master': bpo-43928: Fix 'succesfully' typo in document (GH-25569) https://github.com/python/cpython/commit/e08c67372d62236409da296353827985a3… ---------- nosy: +terry.reedy _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue43928> _______________________________________

1 1

[issue43935] Fix typo in Turtle.back docstring
by Stéphane Wirtel 30 Apr '21

30 Apr '21

New submission from Stéphane Wirtel <stephane(a)wirtel.be>: Thank you for your contribution but as you know, you have to sign the CLA. https://github.com/python/cpython/pull/25581#issuecomment-826150064 ---------- nosy: +matrixise _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue43935> _______________________________________

3 6

[issue42589] doc: Wrong "from" keyword link in Exceptions doc
by Irit Katriel 30 Apr '21

30 Apr '21

New submission from Irit Katriel <iritkatriel(a)yahoo.com>: In the Exceptions doc: https://docs.python.org/3/library/exceptions.html#built-in-exceptions In the sentence "The expression following from must be an exception or None." "from" is a keyword which links to https://docs.python.org/3/reference/simple_stmts.html#from But that is related to the from in "from X import Y" rather than "raise X from Y". ---------- assignee: docs@python components: Documentation messages: 382649 nosy: docs@python, iritkatriel priority: normal severity: normal status: open title: doc: Wrong "from" keyword link in Exceptions doc type: behavior versions: Python 3.10, Python 3.8, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue42589> _______________________________________

4 8

[issue36384] [security] CVE-2021-29921: ipaddress Should not reject IPv4 addresses with leading zeroes as ambiguously octal
by STINNER Victor 30 Apr '21

30 Apr '21

STINNER Victor <vstinner(a)python.org> added the comment: The CVE-2021-29921 was assigned to this vulnerability. ---------- title: ipaddress Should not reject IPv4 addresses with leading zeroes as ambiguously octal -> [security] CVE-2021-29921: ipaddress Should not reject IPv4 addresses with leading zeroes as ambiguously octal _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue36384> _______________________________________

1 0

[issue41277] documentation: os.setxattr() errno EEXIST and ENODATA
by Roundup Robot 30 Apr '21

30 Apr '21

Change by Roundup Robot <devnull(a)psf.upfronthosting.co.za>: ---------- nosy: +python-dev nosy_count: 3.0 -> 4.0 pull_requests: +24432 pull_request: https://github.com/python/cpython/pull/25742 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue41277> _______________________________________

1 0