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

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
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 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
different thread only updates the Python Thread object.)
.. versionchanged:: 3.14
Set the operating system thread name.
.. method:: getName()
setName()

View File

@ -645,6 +645,13 @@ sys.monitoring
* Two new events are added: :monitoring-event:`BRANCH_LEFT` and
: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
-------