#10741: add documentation for PyGILState_GetThisThreadState()

diff --git a/Doc/c-api/init.rst b/Doc/c-api/init.rst
index 1806867e5e190acbd420ab73e92655d6ed821c8f..4b70ec29a4e971e3beb6a7a8092366799c7aec30 100644 (file)
--- a/Doc/c-api/init.rst
+++ b/Doc/c-api/init.rst
@@ -646,6 +646,14 @@ with sub-interpreters:
    :c:func:`PyGILState_Release` on the same thread.
 
 
+.. c:function:: PyThreadState PyGILState_GetThisThreadState()
+
+   Get the current thread state for this thread.  May return ``NULL`` if no
+   GILState API has been used on the current thread.  Note that the main thread
+   always has such a thread-state, even if no auto-thread-state call has been
+   made on the main thread.  This is mainly a helper/diagnostic function.
+
+
 The following macros are normally used without a trailing semicolon; look for
 example usage in the Python source distribution.
 

diff --git a/Include/pystate.h b/Include/pystate.h
index 5d2ee633fdf56dab9b277b2fb0191d5e9fc7eaab..b5fe1adddcf506fa868102f456e40cda6f1ad5fa 100644 (file)
--- a/Include/pystate.h
+++ b/Include/pystate.h
@@ -195,7 +195,7 @@ PyAPI_FUNC(void) PyGILState_Release(PyGILState_STATE);
 
 /* Helper/diagnostic function - get the current thread state for
    this thread.  May return NULL if no GILState API has been used
-   on the current thread.  Note the main thread always has such a
+   on the current thread.  Note that the main thread always has such a
    thread-state, even if no auto-thread-state call has been made
    on the main thread.
 */