gh-102304: Add a What's New Entry About _Py_RefTotal (gh-102845)

https://github.com/python/cpython/issues/102304

diff --git a/Doc/whatsnew/3.12.rst b/Doc/whatsnew/3.12.rst
index cdd26cd19e720bf7eb07e46884038ef4d69c1980..af52c7cb670c61b0029a3a9ea68de215e9a59d88 100644 (file)
--- a/Doc/whatsnew/3.12.rst
+++ b/Doc/whatsnew/3.12.rst
@@ -1036,6 +1036,11 @@ Porting to Python 3.12
   functions that set the error indicator now normalize the exception
   before storing it. (Contributed by Mark Shannon in :gh:`101578`.)
 
+* ``_Py_RefTotal`` is no longer authoritative and only kept around
+  for ABI compabitility.  Note that it is an internal global and only
+  available on debug builds.  If you happen to be using it then you'll
+  need to start using ``_Py_GetGlobalRefTotal()``.
+
 Deprecated
 ----------