[docs] [issue33909] PyObject_CallFinalizerFromDealloc is not referenced in any documentation

[Eric Wieser]

New submission from Eric Wieser <wieser.eric+pybug at gmail.com>:

PEP 442 states that:

> Two new C API functions are provided to ease calling of tp_finalize, especially from custom deallocators.

But it does not give the names of these functions, nor do any python docs I can discover.

>From grepping for tp_finalize, it seems the functions in question are:

- PyObject_CallFinalizerFromDealloc 
- PyObject_CallFinalizer

It would be great if these could be documented, and perhaps even an example given of when it's appropriate to call each one.

----------
assignee: docs at python
components: Documentation
messages: 320036
nosy: Eric.Wieser, docs at python
priority: normal
severity: normal
status: open
title: PyObject_CallFinalizerFromDealloc is not referenced in any documentation
versions: Python 3.4, Python 3.5, Python 3.6, Python 3.7, Python 3.8

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