traverseda
/
cpython
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

bpo-23915: update and elucidate documentation of with_traceback (GH-23680)

This commit is contained in:
Irit Katriel 2020-12-16 16:03:32 +00:00 committed by GitHub
parent fc3dca3e16
commit c590c2338e
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 7 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
Doc/library/exceptions.rst
View File

@ -90,8 +90,13 @@ The following exceptions are used mostly as base classes for other exceptions.
.. method:: with_traceback(tb) .. method:: with_traceback(tb)
This method sets *tb* as the new traceback for the exception and returns This method sets *tb* as the new traceback for the exception and returns
the exception object. It is usually used in exception handling code like the exception object. It was more commonly used before the exception
this:: chaining features of :pep:`3134` became available. The following example
shows how we can convert an instance of ``SomeException`` into an
instance of ``OtherException`` while preserving the traceback. Once
raised, the current frame is pushed onto the traceback of the
``OtherException``, as would have happened to the traceback of the
original ``SomeException`` had we allowed it to propagate to the caller.
try: try:
... ...