Mailman 3 November 2020 - docs

[issue42272] Warning filter message/module documentation is misleading
by Kevin Locke Nov. 5, 2020

Nov. 5, 2020

New submission from Kevin Locke <kevin(a)kevinlocke.name>: "The Warnings Filter" section of the documentation for the warnings module describes the message and module filters as "a string containing a regular expression". While that is true when they are arguments to the filterwarnings function, it is not true when they appear in -W or $PYTHONWARNINGS where they are matched literally (after stripping any starting/ending whitespace). Additionally, in the "Describing Warning Filters" … [View More]

1 1

[issue37826] Document PEP 3134 in tutorials/errors.rst
by Abhilash Raj Nov. 5, 2020

Nov. 5, 2020

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 … [View More]

4 6

[issue26205] Inconsistency concerning nested scopes
by Roscoe R.Higgins Nov. 4, 2020

Nov. 4, 2020

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:… [View More]

10 26

[issue14379] Several traceback docs improvements
by anatoly techtonik Nov. 4, 2020

Nov. 4, 2020

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 … [View More]

4 4

[issue23915] [doc] traceback set with BaseException.with_traceback() pushed back on raise
by Irit Katriel Nov. 4, 2020

Nov. 4, 2020

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 Nov. 4, 2020

Nov. 4, 2020

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.… [View More]

1 0

[issue1767511] SocketServer.DatagramRequestHandler with empty response
by Irit Katriel Nov. 4, 2020

Nov. 4, 2020

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 Nov. 4, 2020

Nov. 4, 2020

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 Nov. 2, 2020

Nov. 2, 2020

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 … [View More]

3 4

[issue14219] start the Class tutorial in a more gentle manner
by Tshepang Lekhonkhobe Nov. 1, 2020

Nov. 1, 2020

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 … [View More]

4 5