https://github.com/python/cpython/commit/7b3f7ffb476001cabbb8f9e9ae4c9222aa4ae3c5
commit: 7b3f7ffb476001cabbb8f9e9ae4c9222aa4ae3c5
branch: 3.13
author: Peter Bierma <[email protected]>
committer: ZeroIntensity <[email protected]>
date: 2025-11-09T15:37:13Z
summary:
[3.13] gh-141004: Document deprecated aliases for memory allocation (GH-141146)
(GH-141289)
* gh-141004: Document deprecated aliases for memory allocation (GH-141146)
(cherry picked from commit 1d738dea6364de004f8cec7c6309d6bbd3b996c7)
files:
M Doc/c-api/allocation.rst
diff --git a/Doc/c-api/allocation.rst b/Doc/c-api/allocation.rst
index b44fe983d22d88..c85db44f24e864 100644
--- a/Doc/c-api/allocation.rst
+++ b/Doc/c-api/allocation.rst
@@ -58,15 +58,6 @@ Allocating Objects on the Heap
use :c:func:`PyObject_GC_NewVar` instead.
-.. c:function:: void PyObject_Del(void *op)
-
- Releases memory allocated to an object using :c:macro:`PyObject_New` or
- :c:macro:`PyObject_NewVar`. This is normally called from the
- :c:member:`~PyTypeObject.tp_dealloc` handler specified in the object's
type. The fields of
- the object should not be accessed after this call as the memory is no
- longer a valid Python object.
-
-
.. c:var:: PyObject _Py_NoneStruct
Object which is visible in Python as ``None``. This should only be accessed
@@ -79,3 +70,35 @@ Allocating Objects on the Heap
:ref:`moduleobjects`
To allocate and create extension modules.
+
+Deprecated aliases
+^^^^^^^^^^^^^^^^^^
+
+These are :term:`soft deprecated` aliases to existing functions and macros.
+They exist solely for backwards compatibility.
+
+
+.. list-table::
+ :widths: auto
+ :header-rows: 1
+
+ * * Deprecated alias
+ * Function
+ * * .. c:macro:: PyObject_NEW(type, typeobj)
+ * :c:macro:`PyObject_New`
+ * * .. c:macro:: PyObject_NEW_VAR(type, typeobj, n)
+ * :c:macro:`PyObject_NewVar`
+ * * .. c:macro:: PyObject_INIT(op, typeobj)
+ * :c:func:`PyObject_Init`
+ * * .. c:macro:: PyObject_INIT_VAR(op, typeobj, n)
+ * :c:func:`PyObject_InitVar`
+ * * .. c:macro:: PyObject_MALLOC(n)
+ * :c:func:`PyObject_Malloc`
+ * * .. c:macro:: PyObject_REALLOC(p, n)
+ * :c:func:`PyObject_Realloc`
+ * * .. c:macro:: PyObject_FREE(p)
+ * :c:func:`PyObject_Free`
+ * * .. c:macro:: PyObject_DEL(p)
+ * :c:func:`PyObject_Free`
+ * * .. c:macro:: PyObject_Del(p)
+ * :c:func:`PyObject_Free`
_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: [email protected]
