docs May 2021

docs@python.org

9 participants
53 discussions

[issue32822] finally block doesn't re-raise exception if return statement exists inside
by miss-islington 04 May '21

04 May '21

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

1 0

[issue37605] CI should not depend on gmane response
by Terry J. Reedy 04 May '21

04 May '21

Terry J. Reedy <tjreedy(a)udel.edu> added the comment: nntp.rst, line 23, has already been updated to "s = NNTP('news.gmane.io'). But that also occasionally fails to respond. I have not seen any test failures recently, so maybe something else has changes. Should this be closed pending current failures? ---------- versions: +Python 3.11 -Python 2.7, Python 3.7, Python 3.8, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue37605> _______________________________________

1 0

[issue44030] Markup with_traceback code example
by Terry J. Reedy 04 May '21

04 May '21

New submission from Terry J. Reedy <tjreedy(a)udel.edu>: .../Doc/library/exceptions.rst, lines 99-105 has original ``SomeException`` had we allowed it to propagate to the caller. try: ... except SomeException: tb = sys.exc_info()[2] raise OtherException(...).with_traceback(tb) The code example with no markup except indents does not work because without a new indent, the last line is merged with the preceding one as part of the same paragraph. https://docs.python.org/3.10/library/exceptions.html#BaseException.with_tra… traceback of the original SomeException had we allowed it to propagate to the caller. try: … except SomeException: tb = sys.exc_info()[2] raise OtherException(…).with_traceback(tb) Note also the uneven line spacing, which is different for me here with Firefox that in the web page (also with Firefox). Something different is needed, but I do not know what. ---------- assignee: docs@python components: Documentation messages: 392871 nosy: docs@python, terry.reedy priority: normal severity: normal stage: needs patch status: open title: Markup with_traceback code example type: behavior versions: Python 3.10, Python 3.11, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue44030> _______________________________________

1 0

[issue37605] CI should not depend on gmane response
by robin 04 May '21

04 May '21

robin <robin.eriksson(a)f-secure.com> added the comment: In other news, news.gmane.org is now news.gmane.io; see also https://bugs.python.org/issue39343 ---------- nosy: +eriker _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue37605> _______________________________________

1 0

[issue44021] enum docs in 3.10: missing "New in version 3.10"
by Akuli 03 May '21

03 May '21

New submission from Akuli <akuviljanen17(a)gmail.com>: https://docs.python.org/3.10/library/enum.html says "New in version 3.10: StrEnum". That's true, but these are also new in 3.10: - property (I mean enum.property, not the built-in property) - global_enum - FlagBoundary - StrEnum - EnumType (does this even exist? I compiled the latest python today and I don't have this) ---------- assignee: docs@python components: Documentation messages: 392824 nosy: Akuli, docs@python priority: normal severity: normal status: open title: enum docs in 3.10: missing "New in version 3.10" versions: Python 3.10 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue44021> _______________________________________

3 2

[issue44006] symbol documentation still exists
by Jelle Zijlstra 03 May '21

03 May '21

New submission from Jelle Zijlstra <jelle.zijlstra(a)gmail.com>: symbol is being removed in 3.10, but https://docs.python.org/3.10/library/symbol.html still exists and claims it will be removed in "future versions". It was removed in bpo-40939 / GH-21005. ---------- assignee: docs@python components: Documentation messages: 392653 nosy: Jelle Zijlstra, docs@python, lys.nikolaou priority: normal severity: normal status: open title: symbol documentation still exists versions: Python 3.10 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue44006> _______________________________________

4 7

Error in documentation of "6.14 Evaluation order"
by Oliver Biwer 03 May '21

03 May '21

https://docs.python.org/3.8/reference/expressions.html#evaluation-order the example states "expressions will be evaluated in the arithmetic order of their suffixes" but for the line: `expr1(expr2, expr3, *expr4, **expr5)` this is not true - or at least misleading. this error goes way back until version 2.5: https://documentation.help/Python-2.5/evalorder.html were the outer 'expr1' was labeled 'func' the actual order should be (if I'm not totally mistaken): expr5(expr1, expr2, *expr3, **expr4) the simple program: def expr(*args, **kwargs): print(*args, *(zip(kwargs.keys(), kwargs.values()))) expr(expr("1"), expr("2"), expr("3"), d=expr("4")) returns: 1 2 3 4 None None None ('d', None)

2 1

About Changing The Python Docs Site Theme
by Abdur-Rahmaan Janhangeer 03 May '21

03 May '21

Greetings list, I have been reading the Python docs since long. I have enjoyed it, it has great pieces of information. You have how-tos, faqs etc. Really awesome to read. However, I feel that the style is a bit bland and off putting for newcomers. I suggest we consider changing the theme to a crisper and cleaner look. I find docs such as Masonite really enjoyable to read: https://docs.masoniteproject.com/ I do hope we can advance something along these lines. Kind Regards, Abdur-Rahmaan Janhangeer about <https://compileralchemy.github.io/> | blog <https://www.pythonkitchen.com> github <https://github.com/Abdur-RahmaanJ> Mauritius

2 1

[issue43990] In documentation Section 6.17, Operator precedence, footnotes 5 & 6 are reversed
by Webb Scales 03 May '21

03 May '21

New submission from Webb Scales <wscales(a)redhat.com>: In Section 6.17 ("Operator precedence"; https://docs.python.org/3/reference/expressions.html#operator-precedence) of the documentation, footnote 5 (https://docs.python.org/3/reference/expressions.html#id15) refers to text (https://docs.python.org/3/reference/expressions.html#id21) which applies to reference 6, while footnote 6 refers to text which applies to reference 5. ---------- assignee: docs@python components: Documentation messages: 392481 nosy: docs@python, webbnh priority: normal severity: normal status: open title: In documentation Section 6.17, Operator precedence, footnotes 5 & 6 are reversed versions: Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue43990> _______________________________________

4 7

[issue38291] Unclear status of the typing.io and typing.re pseudo-modules in docs and runtime
by dgelessus 03 May '21

03 May '21

New submission from dgelessus <dgelessus+bugs.python.org(a)me.com>: According to bpo-35089 (and the GitHub issues linked there), the typing.io and typing.re modules should no longer be used. Starting with Python 3.6, the typing documentation no longer mentions the typing.io and typing.re modules, and instead documents their contents as part of the main typing module. However, the typing module at runtime still supports typing.io and typing.re as before. Since these modules are not meant to be used anymore and are no longer documented, I would expect at least a DeprecationWarning when using them at runtime. The documentation on this could also be a bit clearer. As long as the modules are still supported at runtime, I would expect the documentation to mention that they still exist, but shouldn't be used anymore. In its current state, the documentation is confusing when coming from Python 3.5 (where typing.io and typing.re were the only documented way to access IO, Pattern, etc., but accessing typing.IO and typing.Pattern directly also works at runtime). ---------- assignee: docs@python components: Documentation, Library (Lib) messages: 353356 nosy: dgelessus, docs@python priority: normal severity: normal status: open title: Unclear status of the typing.io and typing.re pseudo-modules in docs and runtime type: behavior versions: Python 3.6, Python 3.7, Python 3.8, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue38291> _______________________________________

4 3

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

docs May 2021