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).

@ned-deily
Copy link
Member

Thanks for the PR but the section that it adds the clarification to refers to the steps in cross-building Python targeted for iOS and iOS simulators, not for Pythons running on macOS. The --enable-framework option is needed for execution on non-MacOS Apple platforms and has nothing to do with gui libraries etc which would only apply to builds targeted for macOS.

@ned-deily ned-deily closed this Sep 17, 2025
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.

4 participants