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

diff --git a/Doc/library/threading.rst b/Doc/library/threading.rst
index f80eb22e18fca47a2c28f738777a72c58788f18b..7de12fbf9dcd396f3dddd13ba2f51993f375379c 100644 (file)
--- 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 3f84e092827bd8e77fdd41903998265b3f267cd0..8442e4ef2e3c7fe25d19a2969fe7168c0b2d7cd9 100644 (file)
--- 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