Mailman 3 March 2022 - Docs-bugs

[issue37430] [doc] range is not a built-in function
by Irit Katriel March 24, 2022

March 24, 2022

Change by Irit Katriel <iritkatriel(a)gmail.com>: ---------- keywords: +easy title: range is not a built-in function -> [doc] range is not a built-in function versions: +Python 3.10, Python 3.11 -Python 3.7, Python 3.8 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue37430> _______________________________________

1 0

[issue47107] Navigation bar in python3103.chm is broken
by stephan March 24, 2022

March 24, 2022

New submission from stephan <stephane.matamontero(a)eu.takata.com>: As you see in 2022-03-24_python3.10.3.png the navigation bar in python3103.chm is broken. In 2022-03-24_python3.10.2.png you see the same the same for python3102.chm. I suppose it would make sense: - to hide this navigation bar when you create a chm - to have a file download of the html docs as zip file for offline working (like in the djangoproject.com) ---------- assignee: docs@python components: Documentation, Windows files: 2022-03-24_python3.10.3.png messages: 415930 nosy: docs@python, paul.moore, stephan, steve.dower, tim.golden, zach.ware priority: normal severity: normal status: open title: Navigation bar in python3103.chm is broken versions: Python 3.11 Added file: https://bugs.python.org/file50697/2022-03-24_python3.10.3.png _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue47107> _______________________________________

2 3

[issue46972] Documentation: Reference says AssertionError is raised by `assert`, but not all AssertionErrors are.
by Thomas Fischbacher March 24, 2022

March 24, 2022

Thomas Fischbacher <tfish(a)google.com> added the comment: Addendum Serhiy, I agree that my assessment was incorrect. It actually is unittest/mock.py that has quite a few 'raise AssertionError' that are not coming from an 'assert' keyword statement. At a deeper level, the problem here is as follows: Every programming language has to make an awkward choice: either it excludes some authors ("must be forklift certified"), or it adds a lot of bureaucratic scaffolding to have some mechanisms that allow code authors to enforce API contracts (as if this would help to "keep out the tide" of unprincipled code authors), or it takes a more relaxed perspective - as also Perl did - of "we are all responsible users" / "do not do this because you are not invited, not because the owner has a shotgun". I'd call this third approach quite reasonable overall, but then the understanding is that "everybody treats documentation as binding and knows how to write good documentation". After all, we need to be able to reason about code, and in order to do that, it matters to have guarantees such as for example: "Looking up a nonexistent key for a mapping by evaluating the_mapping[the_key] can raise an exception, and when it does, that exception is guaranteed to be an instance of KeyError". Unfortunately, Python on the one hand emphasizes "responsible behavior" - i.e. "people know how to write and read documentation, and the written documentation creates a shared understanding between its author and reader", but on the other hand is often really bad at properly documenting its interfaces. If I had to name one thing that really needs fixing with Python, it would be this. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue46972> _______________________________________

1 0

[issue47108] asyncio-stream does not document exceptions
by Christian Bodt March 24, 2022

March 24, 2022

New submission from Christian Bodt <christian.bodt(a)gmail.com>: reader.read() might raise ConnectionResetError and possibly other exceptions, but this is not explained in the documentation. See this stacktrace example: Traceback (most recent call last): File "D:\Dropbox\repos\wxasync\src\examples\server.py", line 23, in handle_connection data = await reader.read(100) File "C:\Python-3.9\lib\asyncio\streams.py", line 684, in read await self._wait_for_data('read') File "C:\Python-3.9\lib\asyncio\streams.py", line 517, in _wait_for_data await self._waiter File "C:\Python-3.9\lib\asyncio\proactor_events.py", line 280, in _loop_reading data = fut.result() File "C:\Python-3.9\lib\asyncio\windows_events.py", line 812, in _poll value = callback(transferred, key, ov) File "C:\Python-3.9\lib\asyncio\windows_events.py", line 461, in finish_recv raise ConnectionResetError(*exc.args) ConnectionResetError: [WinError 64] Le nom réseau spécifié n’est plus disponible ---------- assignee: docs@python components: Documentation messages: 415933 nosy: christian.bodt, docs@python priority: normal severity: normal status: open title: asyncio-stream does not document exceptions versions: Python 3.11 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue47108> _______________________________________

1 0

[issue31582] Add _pth breadcrumb to sys.path documentation
by Steve Dower March 23, 2022

March 23, 2022

Steve Dower <steve.dower(a)python.org> added the comment: New changeset c62b944dfc98911a5050389fa6ac753e283fee1f by Russel Webber in branch 'main': bpo-31582: Created a new documentation section describing sys.path initialization (GH-31082) https://github.com/python/cpython/commit/c62b944dfc98911a5050389fa6ac753e28… ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue31582> _______________________________________

1 0

[issue33028] [doc] tempfile.TemporaryDirectory documentation improvements
by Irit Katriel March 23, 2022

March 23, 2022

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

1 0

[issue33028] [doc] tempfile.TemporaryDirectory documentation improvements
by miss-islington March 23, 2022

March 23, 2022

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

1 0

[issue33028] [doc] tempfile.TemporaryDirectory documentation improvements
by Irit Katriel March 23, 2022

March 23, 2022

Change by Irit Katriel <iritkatriel(a)gmail.com>: ---------- nosy: +iritkatriel nosy_count: 5.0 -> 6.0 pull_requests: +30165 pull_request: https://github.com/python/cpython/pull/32078 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue33028> _______________________________________

1 0

[issue23743] Python crashes upon exit if importing g++ compiled mod after importing gcc compiled mod
by Irit Katriel March 22, 2022

March 22, 2022

Change by Irit Katriel <iritkatriel(a)gmail.com>: ---------- stage: -> resolved status: pending -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue23743> _______________________________________

1 0

[issue47022] PEP 594: Document removal of asynchat, asyncore and smtpd
by Brett Cannon March 22, 2022

March 22, 2022

Brett Cannon <brett(a)python.org> added the comment: New changeset af341ebf00d9a45cadea4c07810564d8e8962b96 by Hugo van Kemenade in branch '3.9': [3.9] bpo-47022: Document asynchat, asyncore and smtpd removals in 3.12 (GH-31891) (#31998) https://github.com/python/cpython/commit/af341ebf00d9a45cadea4c07810564d8e8… ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue47022> _______________________________________

1 0