Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

gh-93103: Enhance PyConfig.parser_debug documentation #93186

Merged
merged 1 commit into from
May 24, 2022
Merged

gh-93103: Enhance PyConfig.parser_debug documentation #93186

merged 1 commit into from
May 24, 2022

Conversation

vstinner
Copy link
Member

Document that -d option and PYTHONDEBUG env var requires a debug
build of Python. Also mention them in the debug build documentation.

Document that -d option and PYTHONDEBUG env var requires a debug
build of Python. Also mention them in the debug build documentation.
@malemburg
Copy link
Member

@vstinner: You may not be aware, but the Py_DebugFlag is also being used by Python extensions to e.g. produce debug log output. While the docs are fine for CPython itself, they are not necessarily correct for other uses.

@malemburg
Copy link
Member

The same is true for Py_VerboseFlag and Py_OptimizeFlag as well.

@vstinner
Copy link
Member Author

My plan is to deprecate Py_DebugFlag to replace it with PyConfig.parser_debug. In Python 2.7, it was already documented as being related to debugging the Python parser. It's also documented at: https://devguide.python.org/parser/#verbose-mode

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs Documentation in the Doc dir skip news
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants