From: Pablo Galindo Salgado <Pablogsal@gmail.com>
Date: Tue, 13 Sep 2022 12:12:15 +0000 (+0100)
Subject: gh-93503: Document the new tracing/profiling APIs in the What's new document (#96681)
X-Git-Tag: v3.12.0a1~423
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=830a20eb3273a84a77eb2fc160cc10d9f8904275;p=thirdparty%2FPython%2Fcpython.git

gh-93503: Document the new tracing/profiling APIs in the What's new document (#96681)

Co-authored-by: Victor Stinner <vstinner@python.org>
---

diff --git a/Doc/whatsnew/3.12.rst b/Doc/whatsnew/3.12.rst
index 11784ba0021e..8e178d994e67 100644
--- a/Doc/whatsnew/3.12.rst
+++ b/Doc/whatsnew/3.12.rst
@@ -139,6 +139,14 @@ sqlite3
 * Add a :ref:`command-line interface <sqlite3-cli>`.
   (Contributed by Erlend E. Aasland in :gh:`77617`.)
 
+threading
+---------
+
+* Add :func:`threading.settrace_all_threads` and
+  :func:`threading.setprofile_all_threads` that allow to set tracing and
+  profiling functions in all running threads in addition to the calling one.
+  (Contributed by Pablo Galindo in :gh:`93503`.)
+
 
 Optimizations
 =============
@@ -473,6 +481,12 @@ New Features
   ``__dict__`` and weakrefs with less bookkeeping,
   using less memory and with faster access.
 
+* Added two new public functions,
+  :c:func:`PyEval_SetProfileAllThreads` and
+  :c:func:`PyEval_SetTraceAllThreads`, that allow to set tracing and profiling
+  functions in all running threads in addition to the calling one. (Contributed
+  by Pablo Galindo in :gh:`93503`.)
+
 Porting to Python 3.12
 ----------------------
 
diff --git a/Misc/NEWS.d/next/C API/2022-06-06-16-04-14.gh-issue-93503.MHJTu8.rst b/Misc/NEWS.d/next/C API/2022-06-06-16-04-14.gh-issue-93503.MHJTu8.rst
index 6df9f95fc946..3dd292cd7780 100644
--- a/Misc/NEWS.d/next/C API/2022-06-06-16-04-14.gh-issue-93503.MHJTu8.rst	
+++ b/Misc/NEWS.d/next/C API/2022-06-06-16-04-14.gh-issue-93503.MHJTu8.rst	
@@ -1,7 +1,7 @@
 Add two new public functions to the public C-API,
-:c:func:`PyEval_SetProfileAllThreads` and
-:c:func:`PyEval_SetTraceAllThreads`, that allow to set tracking and
-profiling functions in all running threads in addition to the calling one.
-Also, add a new *running_threads* parameter to :func:`threading.setprofile`
-and :func:`threading.settrace` that allows to do the same from Python. Patch
-by Pablo Galindo
+:c:func:`PyEval_SetProfileAllThreads` and :c:func:`PyEval_SetTraceAllThreads`,
+that allow to set tracing and profiling functions in all running threads in
+addition to the calling one. Also, two analogous functions to the
+:mod:`threading` module (:func:`threading.setprofile_all_threads` and
+:func:`threading.settrace_all_threads`) that allow to do the same from Python.
+Patch by Pablo Galindo