[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