[3.14] gh-150663: Document that PyErr_SetRaisedException accepts null (GH-153046...

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

Co-authored-by: Andrii Hrimov <andrew.hrimov@gmail.com>

diff --git a/Doc/c-api/exceptions.rst b/Doc/c-api/exceptions.rst
index 6e9b0733fb628c23048c19462cdd72648739b8e4..4ff7122fe3f93d6aaa8dfe66262b9918d8233aad 100644 (file)
--- 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