In our current docs, we claim that:

The local trace function should return a reference to itself (or to another function for further tracing in that scope), or None to turn off tracing in that scope.

That is not the case, and for as far as we know.

Returning None in the local trace function has no effect and it's already the de facto. There are at least 3 issues about this (#104232, #78980 and #56201) and it should not be that difficult to fix this. Rather than changing the behavior which could potentially break someone's code, we can simply change our docs because we never achieved what we claimed anyway, and people are fine with it.

• Issue: Local trace function return value: bug or documentation issue #104232

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