[Python-checkins] r88018 - in python/branches/py3k: Doc/c-api/init.rst Misc/NEWS

Sat Jan 15 14:11:48 CET 2011

Author: antoine.pitrou
Date: Sat Jan 15 14:11:48 2011
New Revision: 88018
Log:
Issue #10913: Deprecate misleading functions PyEval_AcquireLock() and
PyEval_ReleaseLock(). The thread-state aware APIs should be used instead.
Modified:
 python/branches/py3k/Doc/c-api/init.rst
 python/branches/py3k/Misc/NEWS
Modified: python/branches/py3k/Doc/c-api/init.rst
==============================================================================

--- python/branches/py3k/Doc/c-api/init.rst	(original)
+++ python/branches/py3k/Doc/c-api/init.rst	Sat Jan 15 14:11:48 2011
@@ -759,6 +759,10 @@
 *tstate*, which should not be *NULL*. The lock must have been created earlier.
 If this thread already has the lock, deadlock ensues.
 
+ :c:func:`PyEval_RestoreThread` is a higher-level function which is always
+ available (even when thread support isn't enabled or when threads have
+ not been initialized).
+
 
 .. c:function:: void PyEval_ReleaseThread(PyThreadState *tstate)
 
@@ -768,17 +772,31 @@
 that it represents the current thread state --- if it isn't, a fatal error is
 reported.
 
+ :c:func:`PyEval_SaveThread` is a higher-level function which is always
+ available (even when thread support isn't enabled or when threads have
+ not been initialized).
+
 
 .. c:function:: void PyEval_AcquireLock()
 
 Acquire the global interpreter lock. The lock must have been created earlier.
 If this thread already has the lock, a deadlock ensues.
 
+ .. deprecated:: 3.2
+ This function does not change the current thread state. Please use
+ :c:func:`PyEval_RestoreThread` or :c:func:`PyEval_AcquireThread`
+ instead.
+
 
 .. c:function:: void PyEval_ReleaseLock()
 
 Release the global interpreter lock. The lock must have been created earlier.
 
+ .. deprecated:: 3.2
+ This function does not change the current thread state. Please use
+ :c:func:`PyEval_SaveThread` or :c:func:`PyEval_ReleaseThread`
+ instead.
+
 
 Sub-interpreter support
 =======================
Modified: python/branches/py3k/Misc/NEWS
==============================================================================
--- python/branches/py3k/Misc/NEWS	(original)
+++ python/branches/py3k/Misc/NEWS	Sat Jan 15 14:11:48 2011
@@ -200,6 +200,9 @@
 C-API
 -----
 
+- Issue #10913: Deprecate misleading functions PyEval_AcquireLock() and
+ PyEval_ReleaseLock(). The thread-state aware APIs should be used instead.
+
 - Issue #10333: Remove ancient GC API, which has been deprecated since
 Python 2.2.
 
