mirrors
/
cpython
mirror of https://github.com/python/cpython.git
2
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

gh-59705: Document OS thread name change (#128800)

This commit is contained in:
Victor Stinner 2025-01-14 16:31:13 +01:00 committed by GitHub
parent 43ef9587ae
commit d786ac7f58
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 14 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
Doc/library/threading.rst
View File

@ -380,6 +380,13 @@ since it is impossible to detect the termination of alien threads.
This method will raise a :exc:`RuntimeError` if called more than once This method will raise a :exc:`RuntimeError` if called more than once
on the same thread object. on the same thread object.
If supported, set the operating system thread name to
:attr:`threading.Thread.name`. The name can be truncated depending on the
operating system thread name limits.
.. versionchanged:: 3.14
Set the operating system thread name.
.. method:: run() .. method:: run()
Method representing the thread's activity. Method representing the thread's activity.
@ -443,9 +450,6 @@ since it is impossible to detect the termination of alien threads.
running thread is renamed. (Setting the *name* attribute of a running thread is renamed. (Setting the *name* attribute of a
different thread only updates the Python Thread object.) different thread only updates the Python Thread object.)
.. versionchanged:: 3.14
Set the operating system thread name.
.. method:: getName() .. method:: getName()
setName() setName()

7
Doc/whatsnew/3.14.rst
View File

@ -645,6 +645,13 @@ sys.monitoring
* Two new events are added: :monitoring-event:`BRANCH_LEFT` and * Two new events are added: :monitoring-event:`BRANCH_LEFT` and
:monitoring-event:`BRANCH_RIGHT`. The ``BRANCH`` event is deprecated. :monitoring-event:`BRANCH_RIGHT`. The ``BRANCH`` event is deprecated.
threading
---------
* :meth:`threading.Thread.start` now sets the operating system thread name
to :attr:`threading.Thread.name`.
(Contributed by Victor Stinner in :gh:`59705`.)
tkinter tkinter
------- -------