Skip to content

gh-160547: Fix outdated details in the macOS build READMEs - #160548

Merged
ned-deily merged 1 commit into
python:mainfrom
devdavidejesus:docs-mac-readmes
Oct 24, 2026
Merged

ned-deily merged 1 commit into
python:mainfrom
devdavidejesus:docs-mac-readmes

Conversation

@devdavidejesus

@devdavidejesus devdavidejesus commented Oct 23, 2026 •

Copy link
Copy Markdown
Contributor

Corrections, each checked against the build files:

Mac/README.rst

  • /Library/Framework/Python.framework → /Library/Frameworks/Python.framework, the default in configure.ac.
  • $HOME/Applications/Python-<VERSION> → Python <VERSION>: PYTHONAPPSDIR in Mac/Makefile.in uses a space, as the rest of the README does.
  • python3.x-32 is installed only when LIPO_32BIT_FLAGS is set in configure.ac, which happens for all, intel and 3-way. The text said "all flavors but 64-bit and intel-64", which also covered universal2, 32-bit and intel-32.
  • The architecture section said macOS supports only x86_64. macOS 11 added Apple Silicon (arm64), which the same file already reflects in the universal2 flavor and in "11.0 and later SDKs support universal2".
  • The "macOS 10.4 or later and Xcode 2.1" requirement for build-installer.py is outdated: the script's docstring says building installers for 10.4 is no longer supported as of 3.7.0. It now points to Mac/BuildScript/README.rst.

Mac/BuildScript/README.rst

  • The script is build-installer.py, not build-install.py.
  • The recommended universal2 build (macOS 11 or later) builds Tcl/Tk 9.0.x, not 8.6.x: useOldTk() selects 8.6.8 only on build machines older than macOS 10.15, and 9.0.4 otherwise.
  • Two typos ("macoS", "we not regularly").

Documentation only, so no NEWS entry. Both files are identical on 3.15. On 3.14, Mac/README.rst is identical, but Mac/BuildScript/README.rst still says OpenSSL 3.0.x (the script builds 3.5.9), so the Tcl/Tk hunk needs a manual backport there. On 3.13 the script still builds Tcl/Tk 8.6.18, so the Tcl/Tk change must not be backported to 3.13.

See #160547.

Correct the framework path, the per-user applications directory, the
flavors that install python3.x-32, the supported architectures and the
build-installer.py requirements in Mac/README.rst, and the script name,
Tcl/Tk version and two typos in Mac/BuildScript/README.rst.
@ned-deily ned-deily added needs backport to 3.14 bugs and security fixes needs backport to 3.15 bugs and security fixes labels Oct 23, 2026
@ned-deily
ned-deily merged commit dc28c3a into python:main Oct 24, 2026
44 checks passed
@miss-islington-app

Copy link
Copy Markdown

Thanks @devdavidejesus for the PR, and @ned-deily for merging it 🌮🎉.. I'm working now to backport this PR to: 3.14, 3.15.
🐍🍒⛏🤖

@github-project-automation github-project-automation Bot moved this from Todo to Done in Docs PRs Oct 24, 2026
@miss-islington-app

Copy link
Copy Markdown

Sorry, @devdavidejesus and @ned-deily, I could not cleanly backport this to 3.14 due to a conflict.

Please backport manually with cherry_picker, see the devguide for more information.

cherry_picker dc28c3a358221b1e0ae5f926b72e112cbd1d03f7 3.14

@bedevere-app

bedevere-app Bot commented Oct 24, 2026

Copy link
Copy Markdown

GH-160552 is a backport of this pull request to the 3.15 branch.

@bedevere-app bedevere-app Bot removed the needs backport to 3.15 bugs and security fixes label Oct 24, 2026
ned-deily pushed a commit that referenced this pull request Oct 24, 2026
@bedevere-app

bedevere-app Bot commented Oct 24, 2026

Copy link
Copy Markdown

GH-160553 is a backport of this pull request to the 3.14 branch.

@bedevere-app

bedevere-app Bot commented Oct 24, 2026

Copy link
Copy Markdown

GH-160554 is a backport of this pull request to the 3.14 branch.

@bedevere-app

bedevere-app Bot commented Oct 24, 2026

Copy link
Copy Markdown

GH-160555 is a backport of this pull request to the 3.13 branch.

ned-deily added a commit that referenced this pull request Oct 24, 2026
…60548) (#160553)

(cherry picked from commit dc28c3a)
Co-authored-by: Davi de Jesus <[email protected]>
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

Status: Done

Development

Successfully merging this pull request may close these issues.

2 participants