Skip to content

Conversation

minikids
Copy link

@minikids minikids commented Aug 29, 2025

This PR updates the macOS build instructions to explain what the --enable-framework option does.
The note clarifies that this flag builds Python as a macOS framework, which is required for GUI modules like tkinter to function correctly.


📚 Documentation preview 📚: https://cpython-devguide--1646.org.readthedocs.build/

@python-cla-bot
Copy link

python-cla-bot bot commented Aug 29, 2025

All commit authors signed the Contributor License Agreement.

CLA signed

Comment on lines +714 to +716
Without ``--enable-framework``, you still get a working command-line
``python3``, but certain macOS-specific integrations (GUI event loops,
app embedding, etc.) will not work.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
Without ``--enable-framework``, you still get a working command-line
``python3``, but certain macOS-specific integrations (GUI event loops,
app embedding, etc.) will not work.
Without ``--enable-framework``, you still get a working command-line
``python3``, but certain macOS-specific integrations (such as GUI event
loops and app embedding) will not work.

@hugovk
Copy link
Member

hugovk commented Aug 29, 2025

cc @ned-deily

Copy link
Member

@ezio-melotti ezio-melotti left a comment

Choose a reason for hiding this comment

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

LGTM (with Hugo's suggestion).

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.

3 participants