[Python-checkins] bpo-36084: Add threading Native ID information to What's New documentation (GH-14845)

[Victor Stinner]

https://github.com/python/cpython/commit/84846b0187919551b1b08dca447658bbbbb710b1
commit: 84846b0187919551b1b08dca447658bbbbb710b1
branch: master
author: Jake Tesler <jake.tesler at gmail.com>
committer: Victor Stinner <vstinner at redhat.com>
date: 2019-07-30T23:41:46+02:00
summary:

bpo-36084: Add threading Native ID information to What's New documentation (GH-14845)

files:
M Doc/library/threading.rst
M Doc/whatsnew/3.8.rst

diff --git a/Doc/library/threading.rst b/Doc/library/threading.rst
index f80eb22e18fc..7de12fbf9dcd 100644
--- a/Doc/library/threading.rst
+++ b/Doc/library/threading.rst
@@ -371,7 +371,7 @@ since it is impossible to detect the termination of alien threads.
          system-wide) from the time the thread is created until the thread
          has been terminated.
 
-      .. availability:: Require :func:`get_native_id` function.
+      .. availability:: Requires :func:`get_native_id` function.
 
       .. versionadded:: 3.8
 
diff --git a/Doc/whatsnew/3.8.rst b/Doc/whatsnew/3.8.rst
index 3f84e092827b..8442e4ef2e3c 100644
--- a/Doc/whatsnew/3.8.rst
+++ b/Doc/whatsnew/3.8.rst
@@ -768,10 +768,18 @@ in a standardized and extensible format, and offers several other benefits.
 threading
 ---------
 
-Add a new :func:`threading.excepthook` function which handles uncaught
-:meth:`threading.Thread.run` exception. It can be overridden to control how
-uncaught :meth:`threading.Thread.run` exceptions are handled.
-(Contributed by Victor Stinner in :issue:`1230540`.)
+* Add a new :func:`threading.excepthook` function which handles uncaught
+  :meth:`threading.Thread.run` exception. It can be overridden to control how
+  uncaught :meth:`threading.Thread.run` exceptions are handled.
+  (Contributed by Victor Stinner in :issue:`1230540`.)
+
+* Add a new
+  :func:`threading.get_native_id` function and a :data:`~threading.Thread.native_id`
+  attribute to the :class:`threading.Thread` class. These return the native
+  integral Thread ID of the current thread assigned by the kernel.
+  This feature is only available on certain platforms, see
+  :func:`get_native_id <threading.get_native_id>` for more information.
+  (Contributed by Jake Tesler in :issue:`36084`.)
 
 
 tokenize