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

[ericsnowcurrently]

https://github.com/python/cpython/commit/28d369e070652e8f2274101d72131e3140dfadf7
commit: 28d369e070652e8f2274101d72131e3140dfadf7
branch: main
author: Eric Snow <ericsnowcurrently at gmail.com>
committer: ericsnowcurrently <ericsnowcurrently at gmail.com>
date: 2023-03-20T10:35:49-06:00
summary:

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

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

files:
M Doc/whatsnew/3.12.rst

diff --git a/Doc/whatsnew/3.12.rst b/Doc/whatsnew/3.12.rst
index cdd26cd19e72..af52c7cb670c 100644
--- 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
 ----------