From: Victor Stinner <vstinner@redhat.com>
Date: Tue, 13 Nov 2018 12:06:11 +0000 (+0100)
Subject: bpo-35229: Deprecate _PyObject_GC_TRACK() (GH-10511)
X-Git-Tag: v3.7.2rc1~146
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=55b4771d5d18d5ff7c095aa1ab750fe0c8bb5e67;p=thirdparty%2FPython%2Fcpython.git

bpo-35229: Deprecate _PyObject_GC_TRACK() (GH-10511)

Deprecate _PyObject_GC_TRACK() and _PyObject_GC_UNTRACK() in the
documentation. These macros are removed from Python 3.8 by the commit
1a6be91e6fd65ce9cb88cbbbb193db7e92ec6076.
---

diff --git a/Doc/c-api/gcsupport.rst b/Doc/c-api/gcsupport.rst
index 7f54b6a9cff8..472cd93ec3f7 100644
--- a/Doc/c-api/gcsupport.rst
+++ b/Doc/c-api/gcsupport.rst
@@ -66,6 +66,9 @@ Constructors for container types must conform to two rules:
    A macro version of :c:func:`PyObject_GC_Track`.  It should not be used for
    extension modules.
 
+   .. deprecated:: 3.6
+      This macro is removed from Python 3.8.
+
 Similarly, the deallocator for the object must conform to a similar pair of
 rules:
 
@@ -95,6 +98,9 @@ rules:
    A macro version of :c:func:`PyObject_GC_UnTrack`.  It should not be used for
    extension modules.
 
+   .. deprecated:: 3.6
+      This macro is removed from Python 3.8.
+
 The :c:member:`~PyTypeObject.tp_traverse` handler accepts a function parameter of this type: