summaryrefslogtreecommitdiffstats
path: root/Doc/library/sys.monitoring.rst
diff options
context:
space:
mode:
authorMiss Islington (bot) <31488909+miss-islington@users.noreply.github.com>2023-11-21 23:06:13 (GMT)
committerGitHub <noreply@github.com>2023-11-21 23:06:13 (GMT)
commit298e57ab569d584bf567c19db68eac3dd87e3693 (patch)
tree86004052e04f9328d01917df520e610ccb72b0e6 /Doc/library/sys.monitoring.rst
parentfab9824658dbeaa9136583af722cdc471fb172ed (diff)
downloadcpython-298e57ab569d584bf567c19db68eac3dd87e3693.zip
cpython-298e57ab569d584bf567c19db68eac3dd87e3693.tar.gz
cpython-298e57ab569d584bf567c19db68eac3dd87e3693.tar.bz2
[3.12] GH-111963: Clarify sys.monitoring.free_tool_id's limitations (GH-112304)
(cherry picked from commit 46500c42f09a8342efde48ad74327d5225158ff3) Co-authored-by: Tian Gao <gaogaotiantian@hotmail.com>
Diffstat (limited to 'Doc/library/sys.monitoring.rst')
-rw-r--r--Doc/library/sys.monitoring.rst7
1 files changed, 7 insertions, 0 deletions
diff --git a/Doc/library/sys.monitoring.rst b/Doc/library/sys.monitoring.rst
index f2fe3d7..762581b 100644
--- a/Doc/library/sys.monitoring.rst
+++ b/Doc/library/sys.monitoring.rst
@@ -54,6 +54,13 @@ Registering and using tools
Should be called once a tool no longer requires *tool_id*.
+.. note::
+
+ :func:`free_tool_id` will not disable global or local events associated
+ with *tool_id*, nor will it unregister any callback functions. This
+ function is only intended to be used to notify the VM that the
+ particular *tool_id* is no longer in use.
+
.. function:: get_tool(tool_id: int, /) -> str | None
Returns the name of the tool if *tool_id* is in use,