diff options
Diffstat (limited to 'Include/cobject.h')
| -rw-r--r-- | Include/cobject.h | 28 |
1 files changed, 26 insertions, 2 deletions
diff --git a/Include/cobject.h b/Include/cobject.h index e5e246b..ad3cd9c 100644 --- a/Include/cobject.h +++ b/Include/cobject.h @@ -1,3 +1,29 @@ +/* + CObjects are marked Pending Deprecation as of Python 2.7. + The full schedule for 2.x is as follows: + - CObjects are marked Pending Deprecation in Python 2.7. + - CObjects will be marked Deprecated in Python 2.8 + (if there is one). + - CObjects will be removed in Python 2.9 (if there is one). + + Additionally, for the Python 3.x series: + - CObjects were marked Deprecated in Python 3.1. + - CObjects will be removed in Python 3.2. + + You should switch all use of CObjects to capsules. Capsules + have a safer and more consistent API. For more information, + see Include/pycapsule.h, or read the "Capsules" topic in + the "Python/C API Reference Manual". + + Python 2.7 no longer uses CObjects itself; all objects which + were formerly CObjects are now capsules. Note that this change + does not by itself break binary compatibility with extensions + built for previous versions of Python--PyCObject_AsVoidPtr() + has been changed to also understand capsules. + +*/ + +/* original file header comment follows: */ /* C objects to be exported from one extension module to another. @@ -6,8 +32,6 @@ to other extension modules, so that extension modules can use the Python import mechanism to link to one another. - DEPRECATED - Use PyCapsule objects instead. - CObject will be removed in 2.8 (if there is one). */ #ifndef Py_COBJECT_H |