[docs] [issue36157] Document PyInterpreterState_Main().

[Eric Snow]

Eric Snow <ericsnowcurrently at gmail.com> added the comment:

As I noted on the PR, this might be a good chance to make sure the C-API docs are clear about what the "main" interpreter is.

----------

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