[issue14379] Several traceback docs improvements
New submission from anatoly techtonik <techtonik@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@bugs.python.org> <http://bugs.python.org/issue14379> _______________________________________
Changes by R. David Murray <rdmurray@bitdance.com>: ---------- type: -> enhancement _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue14379> _______________________________________
Mark Lawrence added the comment: As nobody has even commented on this, let alone proposed a patch, I'd be inclined to close as "won't fix" or "out of date". ---------- nosy: +BreamoreBoy _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue14379> _______________________________________
Change by Mark Lawrence <breamoreboy@gmail.com>: ---------- nosy: -BreamoreBoy _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue14379> _______________________________________
Irit Katriel <iritkatriel@yahoo.com> added the comment: Closing this issue is out of date. Most if not all of the points mentioned have been resolved by now, and there is also a section on traceback objects [1] which is linked from the exc_info doc [2]. [1] https://docs.python.org/3/reference/datamodel.html#traceback-objects [2] https://docs.python.org/3/library/sys.html#sys.exc_info ---------- nosy: +iritkatriel resolution: -> out of date stage: -> resolved status: open -> closed _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue14379> _______________________________________
participants (4)
-
anatoly techtonik -
Irit Katriel
-
Mark Lawrence
-
R. David Murray