Mailman 3 November 2020 - docs

[issue37826] Document PEP 3134 in tutorials/errors.rst
by Abhilash Raj 05 Nov '20

05 Nov '20

New submission from Abhilash Raj <raj.abhilash1(a)gmail.com>: Looking at the docs, I couldn't find the `raise from` documentation anywhere in the Errors and Exceptions page (https://docs.python.org/3/tutorial/errors.html) page, which seems to be the landing page for Python Exceptions. I do see however that it is documented on the top page of https://docs.python.org/3/library/exceptions.html and raise statement's docs (https://docs.python.org/3/reference/simple_stmts.html#raise), both of which are pretty hard to discover. It would be nice to add the docs for `raise from` in the Errors and Exception page too. ---------- assignee: docs@python components: Documentation messages: 349406 nosy: docs@python, maxking priority: normal severity: normal status: open title: Document PEP 3134 in tutorials/errors.rst _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue37826> _______________________________________

4 6

[issue26205] Inconsistency concerning nested scopes
by Roscoe R.Higgins 04 Nov '20

04 Nov '20

New submission from Roscoe R.Higgins: In chapter 9. Classes of the Python3.5 documentation it says: "At any time during execution, there are at least three nested scopes whose namespaces are directly accessible:", followed by a list containing 4 items. Further down a middle scope is mentioned (although mentioned by name). This was confusing for a while. ---------- assignee: docs@python components: Documentation messages: 258941 nosy: Roscoe R. Higgins, docs@python priority: normal severity: normal status: open title: Inconsistency concerning nested scopes type: behavior versions: Python 3.5 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue26205> _______________________________________

10 26

[issue14379] Several traceback docs improvements
by anatoly techtonik 04 Nov '20

04 Nov '20

New submission from anatoly techtonik <techtonik(a)gmail.com>: Some notes about current `traceback` documentation: http://docs.python.org/library/traceback.html 1. It needs a mentioning that traceback module works with traceback objects and frame objects 2. Functions that work with frames should probably be grouped together 3. Docs for frame function should include info about where to get frames (e.g. http://docs.python.org/library/inspect.html#the-interpreter-stack) 4. There is no traceback object description, which should be at http://docs.python.org/library/sys.html#sys.exc_info ---------- assignee: docs@python components: Documentation messages: 156486 nosy: docs@python, techtonik priority: normal severity: normal status: open title: Several traceback docs improvements _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue14379> _______________________________________

4 4

[issue23915] [doc] traceback set with BaseException.with_traceback() pushed back on raise
by Irit Katriel 04 Nov '20

04 Nov '20

Change by Irit Katriel <iritkatriel(a)yahoo.com>: ---------- title: traceback set with BaseException.with_traceback() overwritten on raise -> [doc] traceback set with BaseException.with_traceback() pushed back on raise versions: +Python 3.10, Python 3.8, Python 3.9 -Python 3.4, Python 3.5 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue23915> _______________________________________

1 0

[issue14655] traceback module docs should show how to print/fomat an exception object
by Irit Katriel 04 Nov '20

04 Nov '20

Irit Katriel <iritkatriel(a)yahoo.com> added the comment: As of 3.5 there is this option: traceback.TracebackException.from_exception(exc).format() Perhaps that can be mentioned in the doc for traceback.format_exception(). ---------- assignee: -> docs@python components: +Documentation nosy: +docs@python, iritkatriel versions: +Python 3.10, Python 3.8, Python 3.9 -Python 2.7, Python 3.2, Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue14655> _______________________________________

1 0

[issue1767511] SocketServer.DatagramRequestHandler with empty response
by Irit Katriel 04 Nov '20

04 Nov '20

Change by Irit Katriel <iritkatriel(a)yahoo.com>: ---------- assignee: -> docs@python components: +Documentation nosy: +docs@python stage: patch review -> needs patch versions: +Python 3.10, Python 3.8, Python 3.9 -Python 2.6 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue1767511> _______________________________________

1 0

[issue1643712] Emphasize buffering issues when sys.stdin is used
by Irit Katriel 03 Nov '20

03 Nov '20

Irit Katriel <iritkatriel(a)yahoo.com> added the comment: Closed along with 1633941. ---------- nosy: +iritkatriel resolution: -> out of date stage: needs patch -> resolved status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue1643712> _______________________________________

1 0

[issue9499] Python C/API Execution namespace undocumented. (patch included)
by Campbell Barton 01 Nov '20

01 Nov '20

New submission from Campbell Barton <ideasman42(a)gmail.com>: Some parts of the python api expect __main__ module dictionary to be the namespace when executing a script, this is true when running a python script from the python binary but NOT true when running a compiled script from the C/API which can lead to bugs which are not easy to solve unless the C/API author knows this. ---------- assignee: docs@python components: Documentation files: doc_py3_main_mod.diff keywords: patch messages: 112706 nosy: docs@python, ideasman42 priority: normal severity: normal status: open title: Python C/API Execution namespace undocumented. (patch included) type: behavior versions: Python 3.2 Added file: http://bugs.python.org/file18357/doc_py3_main_mod.diff _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9499> _______________________________________

3 4

[issue14219] start the Class tutorial in a more gentle manner
by Tshepang Lekhonkhobe 31 Oct '20

31 Oct '20

New submission from Tshepang Lekhonkhobe <tshepang(a)gmail.com>: Looking at Doc/tutorial/classes, the section "Python Scopes and Namespaces" is full of heavy/deep information. I expect that people who would be able to properly digest that info are people who are already advanced at Python, and therefore maybe it should be moved to some cookbook (or language reference). I would prefer something gentler, since the tutorial is for Python newbies who aren't necessarily conversant with OO concepts. There can of course be links to heavier material for deeper understanding. ---------- assignee: docs@python components: Documentation messages: 155065 nosy: docs@python, tshepang priority: normal severity: normal status: open title: start the Class tutorial in a more gentle manner type: enhancement _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue14219> _______________________________________

4 5

[issue763043] unable to specify another compiler
by Irit Katriel 31 Oct '20

31 Oct '20

Change by Irit Katriel <iritkatriel(a)yahoo.com>: ---------- versions: +Python 3.10, Python 3.9 -Python 2.7, Python 3.2 _______________________________________ Python tracker <report(a)bugs.python.org> <https://bugs.python.org/issue763043> _______________________________________

1 0

docs November 2020