python
diff --git a/‎Doc/library/sys.monitoring.rst‎
Lines changed: 7 additions & 0 deletions b/‎Doc/library/sys.monitoring.rst‎
Lines changed: 7 additions & 0 deletions
@@ -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,