gh-115145: Update documentation about PyThreadState_DeleteCurrent

[corona10]

• Issue: PyThreadState_DeleteCurrent documentation incorrect #115145

---

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

[vstinner]

LGTM

[vstinner]

The GIL must be held, it's checked by:

void
_PyThreadState_DeleteCurrent(PyThreadState *tstate)
{
    _Py_EnsureTstateNotNULL(tstate);
    ...
}

[miss-islington-app]

Thanks @corona10 for the PR 🌮🎉.. I'm working now to backport this PR to: 3.12, 3.13.
🐍🍒⛏🤖 I'm not a witch! I'm not a witch!

[bedevere-app]

GH-124930 is a backport of this pull request to the 3.13 branch.

[bedevere-app]

GH-124931 is a backport of this pull request to the 3.12 branch.

[da-woods]

Can we have another look at this?

Like PyThreadState_Delete(), the global interpreter lock must be held.

To me this implies that the GIL must be held for PyThreadState_Delete, which contradicts the documentation for PyThreadState_Delete. I suspect you just want to remove the words "Like PyThreadState_Delete()" but I'm not sure I understand it well enough to be absolutely confident.

[vstinner]

I agree that "Like PyThreadState_Delete()" is wrong and should be removed.

@corona10: Do you want to propose a patch for this?

[corona10]

Yeah I will send the patch