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

[Miss Islington (bot)]

https://github.com/python/cpython/commit/7026737d77836657c3b713000c3154cfdb7451db
commit: 7026737d77836657c3b713000c3154cfdb7451db
branch: 3.8
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: GitHub <noreply at github.com>
date: 2019-07-30T14:49:23-07:00
summary:

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

(cherry picked from commit 84846b0187919551b1b08dca447658bbbbb710b1)

Co-authored-by: Jake Tesler <jake.tesler at gmail.com>

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 9ffd5cd58179..eb9da2b91197 100644
--- a/Doc/library/threading.rst
+++ b/Doc/library/threading.rst
@@ -363,7 +363,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 f8cc3304b207..8cfe88085de8 100644
--- a/Doc/whatsnew/3.8.rst
+++ b/Doc/whatsnew/3.8.rst
@@ -765,10 +765,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