summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorIrit Katriel <1055913+iritkatriel@users.noreply.github.com>2023-05-15 09:12:52 +0100
committerGitHub <noreply@github.com>2023-05-15 09:12:52 +0100
commitb15a1a6ac6ea0d7792036e639e90f0e51400c2ee (patch)
tree7eab63c2a3540255cb21746ec6896a29ace3d57e
parent146106a0f1cc61815fa33f0d3f808a3e3e3275be (diff)
downloadcpython-git-b15a1a6ac6ea0d7792036e639e90f0e51400c2ee.tar.gz
gh-67056: document that registering/unregistering an atexit func from within an atexit func is undefined (#104473)
-rw-r--r--Doc/library/atexit.rst3
-rw-r--r--Misc/NEWS.d/next/Documentation/2023-05-14-12-11-28.gh-issue-67056.nVC2Rf.rst2
2 files changed, 5 insertions, 0 deletions
diff --git a/Doc/library/atexit.rst b/Doc/library/atexit.rst
index f7f038107d..a2bd85b31c 100644
--- a/Doc/library/atexit.rst
+++ b/Doc/library/atexit.rst
@@ -20,6 +20,9 @@ at interpreter termination time they will be run in the order ``C``, ``B``,
program is killed by a signal not handled by Python, when a Python fatal
internal error is detected, or when :func:`os._exit` is called.
+**Note:** The effect of registering or unregistering functions from within
+a cleanup function is undefined.
+
.. versionchanged:: 3.7
When used with C-API subinterpreters, registered functions
are local to the interpreter they were registered in.
diff --git a/Misc/NEWS.d/next/Documentation/2023-05-14-12-11-28.gh-issue-67056.nVC2Rf.rst b/Misc/NEWS.d/next/Documentation/2023-05-14-12-11-28.gh-issue-67056.nVC2Rf.rst
new file mode 100644
index 0000000000..2c6ef17810
--- /dev/null
+++ b/Misc/NEWS.d/next/Documentation/2023-05-14-12-11-28.gh-issue-67056.nVC2Rf.rst
@@ -0,0 +1,2 @@
+Document that the effect of registering or unregistering an :mod:`atexit`
+cleanup function from within a registered cleanup function is undefined.