[3.11] gh-49174: document that the effect of calling gc.collect() during a collection...

gh-49174: document that the effect of calling gc.collect() during a collection is undefined (GH-104699)
(cherry picked from commit 30488fa22a8f63753192ae7f1d01665857764e45)

Co-authored-by: Irit Katriel <1055913+iritkatriel@users.noreply.github.com>

diff --git a/Doc/library/gc.rst b/Doc/library/gc.rst
index 42bb6dc3503f7576d8f833bbdc12fdc8a9b2eab9..5c2d0bbe0035a145b7920685cb8e0aefa82793e1 100644 (file)
--- a/Doc/library/gc.rst
+++ b/Doc/library/gc.rst
@@ -50,6 +50,9 @@ The :mod:`gc` module provides the following functions:
    is run.  Not all items in some free lists may be freed due to the
    particular implementation, in particular :class:`float`.
 
+   The effect of calling ``gc.collect()`` while the interpreter is already
+   performing a collection is undefined.
+
 
 .. function:: set_debug(flags)