summaryrefslogtreecommitdiffstats
path: root/Doc/c-api/exceptions.rst
diff options
context:
space:
mode:
authorNick Coghlan <ncoghlan@gmail.com>2014-01-26 14:53:38 (GMT)
committerNick Coghlan <ncoghlan@gmail.com>2014-01-26 14:53:38 (GMT)
commit77b286b2ccccc407d8ed17b0543b10f7c1ccc864 (patch)
tree2e95a1c03b79829ebf72698d61da997f501ef1a5 /Doc/c-api/exceptions.rst
parent23e37aa7b787fd41623c4f3f1eb7ca16ded2ef96 (diff)
downloadcpython-77b286b2ccccc407d8ed17b0543b10f7c1ccc864.zip
cpython-77b286b2ccccc407d8ed17b0543b10f7c1ccc864.tar.gz
cpython-77b286b2ccccc407d8ed17b0543b10f7c1ccc864.tar.bz2
Close #20105: set __traceback__ when chaining exceptions in C
Diffstat (limited to 'Doc/c-api/exceptions.rst')
-rw-r--r--Doc/c-api/exceptions.rst10
1 files changed, 10 insertions, 0 deletions
diff --git a/Doc/c-api/exceptions.rst b/Doc/c-api/exceptions.rst
index 8658a58..d4065e0 100644
--- a/Doc/c-api/exceptions.rst
+++ b/Doc/c-api/exceptions.rst
@@ -90,6 +90,16 @@ in various ways. There is a separate error indicator for each thread.
the class in that case. If the values are already normalized, nothing happens.
The delayed normalization is implemented to improve performance.
+ .. note::
+
+ This function *does not* implicitly set the ``__traceback__``
+ attribute on the exception value. If setting the traceback
+ appropriately is desired, the following additional snippet is needed::
+
+ if (tb != NULL) {
+ PyException_SetTraceback(val, tb);
+ }
+
.. c:function:: void PyErr_Clear()