[3.12] GH-109190: Copyedit 3.12 What's New: Improve the C-API deprecations section (GH-109751)

[miss-islington]

(cherry picked from commit bccc1b7)

Co-authored-by: Adam Turner 9087854+AA-Turner@users.noreply.github.com
Co-authored-by: Serhiy Storchaka storchaka@gmail.com

• Issue: What's New in Python 3.12 (copyediting) #109190

---

📚 Documentation preview 📚: https://cpython-previews--109830.org.readthedocs.build/

[hugovk]

@AA-Turner We're getting a CI failure on this one:

Emitting doc warnings matching modified lines:
Warning: c:func reference target not found: PyWeakref_GetRef
/home/runner/work/cpython/cpython/Doc/whatsnew/3.12.rst:2176: WARNING: c:func reference target not found: PyWeakref_GetRef
Warning: c:func reference target not found: PyWeakref_GetRef
/home/runner/work/cpython/cpython/Doc/whatsnew/3.12.rst:2177: WARNING: c:func reference target not found: PyWeakref_GetRef

Error: must not contain warnings:

Doc/whatsnew/3.12.rst
  2176: c:func reference target not found: PyWeakref_GetRef
  2177: c:func reference target not found: PyWeakref_GetRef

[AA-Turner]

Oh, looks like one of the 3.13 deprecations slipped through. I'll push to this PR & open a new one.

Edit: What's actually happened is that I listed all the functions pending removal in Python 3.15 in an attempt to give C developers more notice, but several of these aren't deprecated in Python 3.12. I've removed the two offending lines here as the replacement function was only added in Python 3.13, so I don't think there's benefit to listing them in the 3.12 What's New given nothing can be done by programmers to port their usages.

A

[hugovk]

Thanks, let's also update Doc/whatsnew/3.12.rst in main to match.