Mailman 3 April 2022 - Docs-bugs

[issue45099] asyncio.Task's documentation says that loop arg is removed when it's not
by jack1142 02 Apr '22

02 Apr '22

New submission from jack1142 <kuba.kuczys(a)gmail.com>: The documentation here: https://docs.python.org/3.10/library/asyncio-task.html#asyncio.Task Says that `loop` parameter was removed but it's still part of the signature. It gets even more confusing when the deprecation right below it is saying that *not* passing it when there is no running event loop is deprecated :) I could make a PR removing this information but I'm not sure whether there should be also some information put about it being deprecated in 3.8 but not actually getting removed in 3.10? ---------- assignee: docs@python components: Documentation messages: 401047 nosy: docs@python, jack1142 priority: normal severity: normal status: open title: asyncio.Task's documentation says that loop arg is removed when it's not type: behavior versions: Python 3.10 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue45099> _______________________________________

4 10

[issue45584] Clarifying truncating in documentation
by Arthur Milchior 02 Apr '22

02 Apr '22

New submission from Arthur Milchior <arthur(a)milchior.fr>: While floor/ceil 's documentation are very precise, `truncate` was not explained. I actually had to search online to understand the difference between `truncate` and `floor` (admittedly, once I remembered that numbers are signed, and that floating numbers actually uses a bit for negation symbol instead of two complement, it became obvious) I assume that I won't be the only user having this trouble, especially for people whose mother tongue is not English. So I suggest adding a clarification to help make what should be obvious to most actually explicit ---------- assignee: docs@python components: Documentation messages: 404850 nosy: ArthurMilchior, docs@python priority: normal severity: normal status: open title: Clarifying truncating in documentation type: enhancement versions: Python 3.10, Python 3.11, Python 3.6, Python 3.7, Python 3.8, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue45584> _______________________________________

5 11

[issue45114] bad example for os.stat
by Harri 02 Apr '22

02 Apr '22

New submission from Harri <harri(a)afaics.de>: The example on https://docs.python.org/3/library/stat.html should be improved to avoid endless recursion, if there is a symlink loop. I would suggest to use os.lstat instead of os.stat. ---------- assignee: docs@python components: Documentation messages: 401133 nosy: docs@python, harridu priority: normal severity: normal status: open title: bad example for os.stat versions: Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue45114> _______________________________________

4 7

[issue26792] docstrings of runpy.run_{module,path} are rather sparse
by Jelle Zijlstra 02 Apr '22

02 Apr '22

Change by Jelle Zijlstra <jelle.zijlstra(a)gmail.com>: ---------- nosy: +JelleZijlstra nosy_count: 4.0 -> 5.0 pull_requests: +30330 pull_request: https://github.com/python/cpython/pull/32265 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue26792> _______________________________________

1 0

[issue29920] Document cgitb.text and cgitb.html
by Irit Katriel 02 Apr '22

02 Apr '22

Irit Katriel <iritkatriel(a)gmail.com> added the comment: Closing as the backport to 3.5/3.6 is no longer relevant and also cgitb is deprecated under 594. ---------- nosy: +iritkatriel resolution: -> fixed stage: -> resolved status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue29920> _______________________________________

1 0

[issue24563] [doc] Encoding declaration: doc supported encodings
by Irit Katriel 02 Apr '22

02 Apr '22

Change by Irit Katriel <iritkatriel(a)gmail.com>: ---------- keywords: +easy title: Encoding declaration: doc supported encodings -> [doc] Encoding declaration: doc supported encodings versions: +Python 3.10, Python 3.11, Python 3.9 -Python 2.7, Python 3.4, Python 3.5, Python 3.6 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue24563> _______________________________________

1 0

[issue22738] improve 'python -h' documentation for '-c'
by Irit Katriel 02 Apr '22

02 Apr '22

Irit Katriel <iritkatriel(a)gmail.com> added the comment: Closing as the discussion stalled about 7 years ago and was then leaning towards rejecting the suggestion. ---------- nosy: +iritkatriel resolution: -> rejected stage: needs patch -> resolved status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue22738> _______________________________________

1 0

[issue39090] Document various options for getting the absolute path from pathlib.Path objects
by Brett Cannon 01 Apr '22

01 Apr '22

Change by Brett Cannon <brett(a)python.org>: ---------- nosy: +barneygale _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue39090> _______________________________________

1 0

[issue47189] What's new in Python 3.11: Faster CPython
by Ken Jin 01 Apr '22

01 Apr '22

Change by Ken Jin <kenjin4096(a)gmail.com>: ---------- keywords: +patch pull_requests: +30307 stage: -> patch review pull_request: https://github.com/python/cpython/pull/32235 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue47189> _______________________________________

1 0

[issue47189] What's new in Python 3.11: Faster CPython
by Ken Jin 01 Apr '22

01 Apr '22

Change by Ken Jin <kenjin4096(a)gmail.com>: ---------- assignee: docs@python components: Documentation nosy: docs@python, kj priority: normal severity: normal status: open title: What's new in Python 3.11: Faster CPython versions: Python 3.11 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue47189> _______________________________________

1 0