https://github.com/python/cpython/commit/a6dd2a87f13d147cb01a356d7bb845f1f1498d79
commit: a6dd2a87f13d147cb01a356d7bb845f1f1498d79
branch: 3.13
author: Miss Islington (bot) <[email protected]>
committer: vstinner <[email protected]>
date: 2026-07-18T18:16:41Z
summary:

[3.13] gh-150663: Document that PyErr_SetRaisedException accepts null 
(GH-153046) (#154023)

gh-150663: Document that PyErr_SetRaisedException accepts null (GH-153046)
(cherry picked from commit a0c8329218402396478be92b691043453fc28c32)

Co-authored-by: Andrii Hrimov <[email protected]>

files:
M Doc/c-api/exceptions.rst

diff --git a/Doc/c-api/exceptions.rst b/Doc/c-api/exceptions.rst
index 22df73bd6717a3..d66826d049820b 100644
--- a/Doc/c-api/exceptions.rst
+++ b/Doc/c-api/exceptions.rst
@@ -499,12 +499,12 @@ Querying the error indicator
 .. c:function:: void PyErr_SetRaisedException(PyObject *exc)
 
    Set *exc* as the exception currently being raised,
-   clearing the existing exception if one is set.
+   clearing the existing exception if one is set.  If *exc* is ``NULL``,
+   just clear the existing exception.
 
-   .. warning::
+   *exc* must be a valid exception or ``NULL``.
 
-      This call ":term:`steals <steal>`" a reference to *exc*,
-      which must be a valid exception.
+   This call ":term:`steals <steal>`" a reference to *exc*.
 
    .. versionadded:: 3.12
 

_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: [email protected]

Reply via email to