[New-bugs-announce] [issue34206] Move and clarify Py_Main documentation

[Nick Coghlan]

New submission from Nick Coghlan <ncoghlan at gmail.com>:

In resolving issue 34008, we determined that we *do* support calling Py_Main after Py_Initialize, but it's not clear from that current documentation that this implies a Py_Finalize() call, so you don't need to call that again yourself (and it's actually an error to do so).

So this issue covers updating the draft PR I wrote at https://github.com/python/cpython/pull/8023 to move the Py_Main documentation into the initialization and finalization section, and clarify how it relates to the other initialization and finalization functions.

----------
assignee: ncoghlan
components: Documentation
messages: 322301
nosy: ncoghlan, vstinner
priority: normal
severity: normal
stage: patch review
status: open
title: Move and clarify Py_Main documentation
type: enhancement
versions: Python 3.7, Python 3.8

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