Mailman 3 March 2022 - Docs-bugs

[issue47022] PEP 594: Document removal of asynchat, asyncore and smtpd
by Alex Waygood March 18, 2022

March 18, 2022

Change by Alex Waygood <Alex.Waygood(a)Gmail.com>: ---------- assignee: -> docs@python components: +Documentation nosy: +docs@python stage: patch review -> backport needed versions: +Python 3.10, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue47022> _______________________________________

1 0

[issue47051] Windows v3.10.3 .chm file (in python310\doc) page headings are messed up and spread out over several lines. Also the font has changed from the former san serif font to a smaller and harder to read serif font.
by Donald O'Donnell March 17, 2022

March 17, 2022

Change by Donald O'Donnell <DonnieODonnell(a)gmail.com>: ---------- assignee: docs@python components: Documentation nosy: DonnieODonnell, docs@python priority: normal severity: normal status: open title: Windows v3.10.3 .chm file (in python310\doc) page headings are messed up and spread out over several lines. Also the font has changed from the former san serif font to a smaller and harder to read serif font. type: behavior versions: Python 3.10 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue47051> _______________________________________

1 0

[issue31327] [doc] Add example of platform-specific support for negative timestamps to the time doc
by Irit Katriel March 16, 2022

March 16, 2022

Change by Irit Katriel <iritkatriel(a)gmail.com>: ---------- resolution: -> fixed stage: patch review -> resolved status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue31327> _______________________________________

1 0

[issue31327] [doc] Add example of platform-specific support for negative timestamps to the time doc
by Łukasz Langa March 16, 2022

March 16, 2022

Łukasz Langa <lukasz(a)langa.pl> added the comment: New changeset 4d8e08b21ce5d2cc08da82cf9f3ca50d9617cbdc by Miss Islington (bot) in branch '3.8': bpo-31327: Update time documentation to reflect possible errors (GH-31460) (GH-31827) https://github.com/python/cpython/commit/4d8e08b21ce5d2cc08da82cf9f3ca50d96… ---------- nosy: +lukasz.langa _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue31327> _______________________________________

1 0

[issue26545] [doc] os.walk is limited by python's recursion limit
by Irit Katriel March 16, 2022

March 16, 2022

Irit Katriel <iritkatriel(a)gmail.com> added the comment: I agree with Stanley. The documentation for os is clear that recursion is used and the documentation for RecursionError links to getrecursionlimit(). This seems sufficient. ---------- nosy: +iritkatriel resolution: -> wont fix stage: -> resolved status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue26545> _______________________________________

1 0

[issue46291] [doc] First argument to raise can also be BaseException
by Gregor Titze March 15, 2022

March 15, 2022

New submission from Gregor Titze <gregor.titze(a)gmail.com>: The Python Tutorial describes the first argument to the raise statement as follows: """ This must be either an exception instance or an exception class (a class that derives from Exception). """ https://docs.python.org/3/tutorial/errors.html#raising-exceptions However, the Python Language Reference states, that exceptions should be a subclass or instance of BaseException. https://docs.python.org/3/reference/simple_stmts.html#grammar-token-python-… I think it would be correct, to adapt the Tutorial to match the Reference. ---------- assignee: docs@python components: Documentation messages: 409961 nosy: docs@python, gtitze priority: normal severity: normal status: open title: [doc] First argument to raise can also be BaseException 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/issue46291> _______________________________________

5 18

[issue46884] [doc] msilib.rst uses data directive to document modules
by Martin Fischer March 15, 2022

March 15, 2022

New submission from Martin Fischer <martin(a)push-f.com>: As per [1] the py:data directive describes data in a module. It should not be used for submodules, that's what the module directive is for. A side-effect that this is causing is that msilib.schema, msilib.sequence and msilib.text do not show up in the Python Module Index[2] as they should. [1]: https://www.sphinx-doc.org/en/master/usage/restructuredtext/domains.html [2]: file:///home/martin/repos-contrib/cpython/Doc/build/html/py-modindex.html#cap-m ---------- assignee: docs@python components: Documentation messages: 414209 nosy: docs@python, push-f priority: normal severity: normal status: open title: [doc] msilib.rst uses data directive to document modules type: enhancement versions: Python 3.10, Python 3.11, Python 3.7, Python 3.8, Python 3.9 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue46884> _______________________________________

2 3

[issue43721] Documentation of property.{getter, setter, deleter} fails to mention that a *new* property is returned
by Hugo van Kemenade March 15, 2022

March 15, 2022

Change by Hugo van Kemenade <hugovk+python(a)gmail.com>: ---------- nosy: +hugovk nosy_count: 4.0 -> 5.0 pull_requests: +29991 pull_request: https://github.com/python/cpython/pull/31893 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue43721> _______________________________________

1 0

[issue47020] float('nan')==math.nan does NOT evaluate to True (as suggested by documentation).
by Pablo Dumas March 15, 2022

March 15, 2022

New submission from Pablo Dumas <pablodumas94(a)gmail.com>: float('nan')==math.nan does NOT evaluate to True (as suggested by documentation). On the other hand, float('inf')==math.inf DOES evaluate to True (as suggested by documentation). Documentation we're referring to: https://docs.python.org/3.8/library/math.html ---------- assignee: docs@python components: Documentation messages: 415213 nosy: docs@python, w0rthle$$ priority: normal severity: normal status: open title: float('nan')==math.nan does NOT evaluate to True (as suggested by documentation). type: behavior versions: Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue47020> _______________________________________

3 2

[issue43721] Documentation of property.{getter, setter, deleter} fails to mention that a *new* property is returned
by Alex Waygood March 15, 2022

March 15, 2022

Change by Alex Waygood <Alex.Waygood(a)Gmail.com>: ---------- resolution: -> fixed stage: patch review -> resolved status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue43721> _______________________________________

1 0