[issue15088] PyGen_NeedsFinalizing is public, but undocumented

[STINNER Victor]

STINNER Victor <vstinner at python.org> added the comment:

The function is not documented nor tested.

I searched for usage of PyGen_NeedsFinalizing() in C code in GitHub:
https://github.com/search?l=C&p=1&q=PyGen_NeedsFinalizing&type=Code

I only found copies of the CPython code source: PyGen_NeedsFinalizing() definition in genobject.h.

IHMO we can safely remove the function right now. If someone complains, we can reintroduce it later. We just have to document clearly its removal at:
https://docs.python.org/dev/whatsnew/3.9.html#build-and-c-api-changes

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue15088>
_______________________________________