Mailman 3 January 2022 - Docs-bugs

[issue29688] Add support for Path.absolute()
by Brett Cannon 28 Jan '22

28 Jan '22

Brett Cannon <brett(a)python.org> added the comment: New changeset 18cb2ef46c9998480f7182048435bc58265c88f2 by Barney Gale in branch 'main': bpo-29688: document and test `pathlib.Path.absolute()` (GH-26153) https://github.com/python/cpython/commit/18cb2ef46c9998480f7182048435bc5826… ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue29688> _______________________________________

1 0

[issue23291] Documentation about Py_Finalize(): Freeing objects
by Irit Katriel 28 Jan '22

28 Jan '22

Change by Irit Katriel <iritkatriel(a)gmail.com>: ---------- assignee: -> docs@python components: +Documentation nosy: +docs@python, iritkatriel, vstinner versions: +Python 3.10, Python 3.11, Python 3.9 -Python 2.7 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue23291> _______________________________________

1 0

[issue46560] ParamSpec: Typo in doc string
by Ken Jin 28 Jan '22

28 Jan '22

Ken Jin <kenjin4096(a)gmail.com> added the comment: Thanks for the fix Zackery. ---------- resolution: -> fixed stage: patch review -> resolved status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue46560> _______________________________________

1 0

[issue46560] ParamSpec: Typo in doc string
by miss-islington 28 Jan '22

28 Jan '22

miss-islington <mariatta.wijaya+miss-islington(a)gmail.com> added the comment: New changeset 315a60acd14dd730b2081574c09ccc29e92ee687 by Miss Islington (bot) in branch '3.10': bpo-46560: Fix a typo in `typing.ParamSpec's` doc string (GH-30995) https://github.com/python/cpython/commit/315a60acd14dd730b2081574c09ccc29e9… ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue46560> _______________________________________

1 0

[issue46560] ParamSpec: Typo in doc string
by miss-islington 28 Jan '22

28 Jan '22

Change by miss-islington <mariatta.wijaya+miss-islington(a)gmail.com>: ---------- nosy: +miss-islington nosy_count: 5.0 -> 6.0 pull_requests: +29177 pull_request: https://github.com/python/cpython/pull/30996 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue46560> _______________________________________

1 0

[issue46560] ParamSpec: Typo in doc string
by Ken Jin 28 Jan '22

28 Jan '22

Ken Jin <kenjin4096(a)gmail.com> added the comment: New changeset ffa505b580464d9d90c29e69bd4db8c52275280a by Zackery Spytz in branch 'main': bpo-46560: Fix a typo in `typing.ParamSpec's` doc string (GH-30995) https://github.com/python/cpython/commit/ffa505b580464d9d90c29e69bd4db8c522… ---------- nosy: +kj _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue46560> _______________________________________

1 0

[issue46560] ParamSpec: Typo in doc string
by Zackery Spytz 28 Jan '22

28 Jan '22

Change by Zackery Spytz <zspytz(a)gmail.com>: ---------- keywords: +patch nosy: +ZackerySpytz nosy_count: 3.0 -> 4.0 pull_requests: +29176 stage: needs patch -> patch review pull_request: https://github.com/python/cpython/pull/30995 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue46560> _______________________________________

1 0

[issue46560] ParamSpec: Typo in doc string
by Alex Waygood 28 Jan '22

28 Jan '22

Change by Alex Waygood <Alex.Waygood(a)Gmail.com>: ---------- assignee: -> docs@python components: +Documentation nosy: +docs@python stage: -> needs patch versions: +Python 3.11 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue46560> _______________________________________

1 0

[issue31582] Add _pth breadcrumb to sys.path documentation
by Russel Webber 28 Jan '22

28 Jan '22

Russel Webber <russel(a)computer.org> added the comment: I agree wholeheartedly, an explantation of sys.path initialisation would be very helpful. I've seen too many hacks in end user Python code due to misunderstandings around sys.path initialisation and the available ways to customise sys.path. I'll work on this, try to write an easy to follow explanantion and see where the other documentation needs to be amended to point to a new section. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue31582> _______________________________________

1 0

[issue46559] base64 documentation is out-dated; altchars has to have the exact length of 2.
by hello world 27 Jan '22

27 Jan '22

New submission from hello world <qp3839(a)gmail.com>: According to the documentation of base64 (https://docs.python.org/3/library/base64.html), > Optional altchars must be a bytes-like object of at least length 2 (additional characters are ignored) which specifies an alternative alphabet for the + and / characters. but this explanation is out-dated. Actually this had been correct until the commit `4581ae5fa2450db3f00384e4b2e86654605100d4` was made for cpython in "2007". (Thus, the explanation has been incorrect for about 15 years.) The current implementation requires the length of `altchars` to be exactly two, as explicitly written in the comment: > Optional altchars should be a byte string of length 2 which specifies an alternative alphabet for the '+' and '/' characters. and the corresponding assertion is: > assert len(altchars) == 2, repr(altchars) ---------- assignee: docs@python components: Documentation messages: 411967 nosy: docs@python, qp3839 priority: normal severity: normal status: open title: base64 documentation is out-dated; altchars has to have the exact length of 2. versions: Python 3.10 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue46559> _______________________________________

1 0