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

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".

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