Skip to content

Document CPython code generation tools - #1943

Closed
badrisatyam1-ctrl wants to merge 2 commits into
python:mainfrom
badrisatyam1-ctrl:codex/document-code-generation
Closed

badrisatyam1-ctrl wants to merge 2 commits into
python:mainfrom
badrisatyam1-ctrl:codex/document-code-generation

Conversation

@badrisatyam1-ctrl

Copy link
Copy Markdown

Summary

  • Add a guide to selected CPython source-generation tools and their make targets.
  • Link the existing Argument Clinic and parser documentation.

Closes #805

Validation

  • git diff --check

@read-the-docs-community

Copy link
Copy Markdown

Documentation build overview

📚 CPython devguide | 🛠️ Build #35446482 | 📁 Comparing b3666ec against latest (dce8cdf)

  🔍 Preview build  

1 file changed
+ development-tools/code-generation/index.html

@StanFromIreland StanFromIreland left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We already document these at https://docs.python.org/3/using/configure.html#generated-files, although in less detail. I'm not sure we need this, it's an incomplete list, and I don't remember the last time I've had to run make regen-frozen manually (rather than just via make regen-all)...

@willingc

Copy link
Copy Markdown
Collaborator

Thanks for the PR to the devguide @badrisatyam1-ctrl. Based on the core team's comments here, I've closed the underlying issue.

If you need help finding another issue to work on, please let us know.

@willingc willingc closed this Oct 27, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document the various code generation tools used by CPython

3 participants