Mailman 3 November 2021 - Docs-bugs

[issue45712] so it not allowed
by Andreas Ley Nov. 8, 2021

Nov. 8, 2021

New submission from Andreas Ley <andreas.ley(a)kit.edu>: https://docs.python.org/3.11/tutorial/controlflow.html (and earlier versions) have the sentence: An unpacking like **rest is also supported. (But **_ would be redundant, so it not allowed.) Although I'm not a native speaker, I suppose this is missing a verb and should read: … so it is not allowed ---------- assignee: docs@python components: Documentation messages: 405714 nosy: Andy, docs@python priority: normal severity: normal status: open title: so it not allowed versions: Python 3.11 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue45712> _______________________________________

5 7

[issue45741] entry points singular?
by Rafael Fontenelle Nov. 8, 2021

Nov. 8, 2021

New submission from Rafael Fontenelle <rffontenelle(a)gmail.com>: whatsnew/3.10 on importlib.metadata has the following paragraph: "importlib.metadata entry points now provides a nicer experience for selecting entry points by group and name through a new importlib.metadata.EntryPoints class. See the Compatibility Note in the docs for more info on the deprecation and usage." In the above paragraph should "provides" -> "provide", or "entry points" is somehow considered singular? [1] https://docs.python.org/pt-br/3/whatsnew/3.10.html#importlib-metadata ---------- assignee: docs@python components: Documentation messages: 405888 nosy: docs@python, rffontenelle priority: normal severity: normal status: open title: entry points singular? versions: Python 3.10, Python 3.11 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue45741> _______________________________________

3 6

[issue40051] Give proper link in help(idlelib/turtledemo/tkinter.sub/test_*/?)
by Éric Araujo Nov. 8, 2021

Nov. 8, 2021

Éric Araujo <merwok(a)netwok.org> added the comment: I think that second PR was linked using the GitHub PR link field present in the bug comment form. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue40051> _______________________________________

1 0

[issue40051] Give proper link in help(idlelib/turtledemo/tkinter.sub/test_*/?)
by Terry J. Reedy Nov. 8, 2021

Nov. 8, 2021

Terry J. Reedy <tjreedy(a)udel.edu> added the comment: PR-29419 solves the issue in #45717 of not giving a link for _* modules with no doc. It does not solve this issue of giving the proper link for module that need non-standard links, which typically need a '#' suffix, as in '.../library/2to3.html#module-lib2to3'. I suggest to continue calculating standard links as done now as the precalculation needs much space for a trivial time saving. Restrict the new dict to non-standard links. They can be calculated, with the needed suffixes, as they are now for the index. The link logic would be to try the lookup first and if module name does not start with '_', calculate the link. I will add an idlelib section to idle.rst so that 'idlelib' appears in the module index and get entered into the exceptions dict. I don't see how PR-29459 get linked here as it has no reference to this issue. So I will ignore it at least for know. ---------- stage: patch review -> test needed _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue40051> _______________________________________

1 0

[issue40051] Give proper link in help(idlelib/turtledemo/tkinter.sub/test_*/?)
by Zachary Ware Nov. 7, 2021

Nov. 7, 2021

Change by Zachary Ware <zachary.ware(a)gmail.com>: ---------- pull_requests: +27713 stage: test needed -> patch review pull_request: https://github.com/python/cpython/pull/29459 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue40051> _______________________________________

1 0

[issue39452] Improve the __main__ module documentation
by Łukasz Langa Nov. 6, 2021

Nov. 6, 2021

Łukasz Langa <lukasz(a)langa.pl> added the comment: New changeset e53cb9811f97ded5a20872fe0f3486bc7f8f1b6e by Miss Islington (bot) in branch '3.10': bpo-39452: [doc] Change "must" to "can" on relative import style in `__main__` (GH-29379) (GH-29449) https://github.com/python/cpython/commit/e53cb9811f97ded5a20872fe0f3486bc7f… ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue39452> _______________________________________

1 0

[issue39452] Improve the __main__ module documentation
by miss-islington Nov. 6, 2021

Nov. 6, 2021

Change by miss-islington <mariatta.wijaya+miss-islington(a)gmail.com>: ---------- pull_requests: +27704 pull_request: https://github.com/python/cpython/pull/29449 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue39452> _______________________________________

1 0

[issue39452] Improve the __main__ module documentation
by Łukasz Langa Nov. 6, 2021

Nov. 6, 2021

Łukasz Langa <lukasz(a)langa.pl> added the comment: New changeset 57457a1e5caf714034a75fe4f382b8b669ce6ed8 by Andre Delfino in branch 'main': bpo-39452: [doc] Change "must" to "can" on relative import style in `__main__` (GH-29379) https://github.com/python/cpython/commit/57457a1e5caf714034a75fe4f382b8b669… ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue39452> _______________________________________

1 0

[issue39452] Improve the __main__ module documentation
by Andrés Delfino Nov. 6, 2021

Nov. 6, 2021

Change by Andrés Delfino <adelfino(a)gmail.com>: ---------- nosy: +adelfino nosy_count: 11.0 -> 12.0 pull_requests: +27703 pull_request: https://github.com/python/cpython/pull/29379 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue39452> _______________________________________

1 0

[issue45740] StrEnum entry doesn't mention its introduction in 3.11
by Dutcho Nov. 6, 2021

Nov. 6, 2021

New submission from Dutcho <dutcho(a)ziggo.nl>: At https://docs.python.org/3.11/library/enum.html#enum.StrEnum no mention is made of 'New in version 3.11', whereas e.g. https://docs.python.org/3.11/library/enum.html#enum.EnumCheck does. Note https://docs.python.org/3.11/library/enum.html#module-contents DOES document: 'New in version 3.11: StrEnum, EnumCheck, FlagBoundary'. ---------- assignee: docs@python components: Documentation messages: 405863 nosy: Dutcho, docs@python priority: normal severity: normal status: open title: StrEnum entry doesn't mention its introduction in 3.11 type: enhancement versions: Python 3.11 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue45740> _______________________________________

2 4