summaryrefslogtreecommitdiffstats
path: root/Doc/c-api
diff options
context:
space:
mode:
authorJeroen Ruigrok van der Werven <asmodai@in-nomine.org>2009-04-25 13:07:40 (GMT)
committerJeroen Ruigrok van der Werven <asmodai@in-nomine.org>2009-04-25 13:07:40 (GMT)
commit2dcf46ee2cddce17f18081ea7fa3535caad652dc (patch)
treea9072ed1cf62c7e49ed932573726e7a8cb5c35bc /Doc/c-api
parentbcddf6777ac46e9cee508749840263c4ea169a19 (diff)
downloadcpython-2dcf46ee2cddce17f18081ea7fa3535caad652dc.zip
cpython-2dcf46ee2cddce17f18081ea7fa3535caad652dc.tar.gz
cpython-2dcf46ee2cddce17f18081ea7fa3535caad652dc.tar.bz2
Rewrite a sentence to be more in line with the rest of the documentation with
regard to person and audience.
Diffstat (limited to 'Doc/c-api')
-rw-r--r--Doc/c-api/init.rst14
1 files changed, 7 insertions, 7 deletions
diff --git a/Doc/c-api/init.rst b/Doc/c-api/init.rst
index e62bab6..281432b 100644
--- a/Doc/c-api/init.rst
+++ b/Doc/c-api/init.rst
@@ -492,13 +492,13 @@ thread could immediately acquire the lock and store its own thread state in the
global variable). Conversely, when acquiring the lock and restoring the thread
state, the lock must be acquired before storing the thread state pointer.
-Why am I going on with so much detail about this? Because when threads are
-created from C, they don't have the global interpreter lock, nor is there a
-thread state data structure for them. Such threads must bootstrap themselves
-into existence, by first creating a thread state data structure, then acquiring
-the lock, and finally storing their thread state pointer, before they can start
-using the Python/C API. When they are done, they should reset the thread state
-pointer, release the lock, and finally free their thread state data structure.
+It is important to note that when threads are created from C, they don't have
+the global interpreter lock, nor is there a thread state data structure for
+them. Such threads must bootstrap themselves into existence, by first
+creating a thread state data structure, then acquiring the lock, and finally
+storing their thread state pointer, before they can start using the Python/C
+API. When they are done, they should reset the thread state pointer, release
+the lock, and finally free their thread state data structure.
Beginning with version 2.3, threads can now take advantage of the
:cfunc:`PyGILState_\*` functions to do all of the above automatically. The