@@ -82,12 +82,12 @@ New features
8282:pep: `799 `: A dedicated profiling package
8383-----------------------------------------
8484
85- A new :mod: `! profiling ` module has been added to organize Python's built-in
85+ A new :mod: `profiling ` module has been added to organize Python's built-in
8686profiling tools under a single, coherent namespace. This module contains:
8787
88- * :mod: `! profiling.tracing `: deterministic function-call tracing (relocated from
88+ * :mod: `profiling.tracing `: deterministic function-call tracing (relocated from
8989 :mod: `cProfile `).
90- * :mod: `! profiling.sampling `: a new statistical sampling profiler (named Tachyon).
90+ * :mod: `profiling.sampling `: a new statistical sampling profiler (named Tachyon).
9191
9292The :mod: `cProfile ` module remains as an alias for backwards compatibility.
9393The :mod: `profile ` module is deprecated and will be removed in Python 3.17.
@@ -103,10 +103,10 @@ Tachyon: High frequency statistical sampling profiler
103103-----------------------------------------------------
104104
105105A new statistical sampling profiler (Tachyon) has been added as
106- :mod: `! profiling.sampling `. This profiler enables low-overhead performance analysis of
106+ :mod: `profiling.sampling `. This profiler enables low-overhead performance analysis of
107107running Python processes without requiring code modification or process restart.
108108
109- Unlike deterministic profilers (:mod: ` cProfile ` and :mod: `profile `) that instrument
109+ Unlike deterministic profilers (such as :mod: `profiling.tracing `) that instrument
110110every function call, the sampling profiler periodically captures stack traces from
111111running processes. This approach provides virtually zero overhead while achieving
112112sampling rates of **up to 1,000,000 Hz **, making it the fastest sampling profiler
@@ -168,6 +168,9 @@ Key features include:
168168 (``--async-aware ``). See which coroutines are consuming time, with options to show only
169169 running tasks or all tasks including those waiting.
170170
171+ See :mod: `profiling.sampling ` for full documentation, including all available
172+ output formats, profiling modes, and configuration options.
173+
171174(Contributed by Pablo Galindo and László Kiss Kollár in :gh: `135953 ` and :gh: `138122 `.)
172175
173176
0 commit comments