summaryrefslogtreecommitdiffstats
path: root/Doc/library
diff options
context:
space:
mode:
authorAntoine Pitrou <solipsis@pitrou.net>2011-01-06 16:35:14 (GMT)
committerAntoine Pitrou <solipsis@pitrou.net>2011-01-06 16:35:14 (GMT)
commit9f41bb325b4f5db695d1ea25649d1fd1e809b2bf (patch)
tree766b705949641c4bebeabd6b9913f3f5fe27869d /Doc/library
parent5047225baca0e6351c674e00cda396d16c4a07f1 (diff)
downloadcpython-9f41bb325b4f5db695d1ea25649d1fd1e809b2bf.zip
cpython-9f41bb325b4f5db695d1ea25649d1fd1e809b2bf.tar.gz
cpython-9f41bb325b4f5db695d1ea25649d1fd1e809b2bf.tar.bz2
Merged revisions 87792 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k ........ r87792 | antoine.pitrou | 2011-01-06 17:31:28 +0100 (jeu., 06 janv. 2011) | 3 lines Elaborate about the GIL. ........
Diffstat (limited to 'Doc/library')
-rw-r--r--Doc/library/threading.rst11
1 files changed, 11 insertions, 0 deletions
diff --git a/Doc/library/threading.rst b/Doc/library/threading.rst
index 142f1ec..4a6041f 100644
--- a/Doc/library/threading.rst
+++ b/Doc/library/threading.rst
@@ -26,11 +26,22 @@ The :mod:`dummy_threading` module is provided for situations where
Starting with Python 2.5, several Thread methods raise :exc:`RuntimeError`
instead of :exc:`AssertionError` if called erroneously.
+.. impl-detail::
+
+ Due to the :term:`Global Interpreter Lock`, in CPython only one thread
+ can execute Python code at once (even though certain performance-oriented
+ libraries might overcome this limitation).
+ If you want your application to make better of use of the computational
+ resources of multi-core machines, you are advised to use
+ :mod:`multiprocessing`. However, threading is still an appropriate model
+ if you want to run multiple I/O-bound tasks simultaneously.
+
.. seealso::
Latest version of the `threading module Python source code
<http://svn.python.org/view/python/branches/release27-maint/Lib/threading.py?view=markup>`_
+
This module defines the following functions and objects:
.. function:: active_count()