Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Update "Using Python on a Mac" #115024

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

Merged
merged 11 commits into from
Feb 13, 2024
Merged

Update "Using Python on a Mac" #115024

merged 11 commits into from
Feb 13, 2024

Conversation

hugovk
Copy link
Member

@hugovk hugovk commented Feb 5, 2024

  • Spell out IDE on first use
  • Elide 'on the Mac' for subheadings
  • PPC is long gone, Intel is now legacy, universal2 is here
  • Just call it Python, not MacPython
  • Put macOS 10.8-12.3 info into note
  • Use program role
  • Update editor names and links
  • Link to Apple's Technical Q&A
  • Include PySide after PyQt
  • Update Python version number

For the last point:

* A :file:`Python 3.13` folder in your :file:`Applications` folder. In here

It would be better to use the |version| substitution:

* A :file:`Python |version|` folder in your :file:`Applications` folder. In here

Unfortunately, substitutions can't be used inside roles and it renders as Python |version|.

Another option is to drop the file formatting and use plain text:

* A "Python |version|" folder in your "Applications" folder. In here

If we keep the hardcoded version, then we let's add this file to the list the release manager manually edits for each new release cycle:


📚 Documentation preview 📚: https://cpython-previews--115024.org.readthedocs.build/en/115024/using/mac.html

@hugovk
Copy link
Member Author

hugovk commented Feb 6, 2024

Updated to use substitution in rst_prolog to use the version in code literal formatting. Thanks for the help, @CAM-Gerlach!

@hugovk hugovk merged commit 0a6e1a4 into python:main Feb 13, 2024
@hugovk hugovk deleted the docs-update-using-mac branch February 13, 2024 06:31
@miss-islington-app
Copy link

Thanks @hugovk for the PR 🌮🎉.. I'm working now to backport this PR to: 3.11, 3.12.
🐍🍒⛏🤖

miss-islington pushed a commit to miss-islington/cpython that referenced this pull request Feb 13, 2024
(cherry picked from commit 0a6e1a4)

Co-authored-by: Hugo van Kemenade <[email protected]>
@bedevere-app
Copy link

bedevere-app bot commented Feb 13, 2024

GH-115387 is a backport of this pull request to the 3.12 branch.

@bedevere-app bedevere-app bot removed the needs backport to 3.12 only security fixes label Feb 13, 2024
miss-islington pushed a commit to miss-islington/cpython that referenced this pull request Feb 13, 2024
(cherry picked from commit 0a6e1a4)

Co-authored-by: Hugo van Kemenade <[email protected]>
@bedevere-app
Copy link

bedevere-app bot commented Feb 13, 2024

GH-115388 is a backport of this pull request to the 3.11 branch.

@bedevere-app bedevere-app bot removed the needs backport to 3.11 only security fixes label Feb 13, 2024
hugovk added a commit that referenced this pull request Feb 13, 2024
Update "Using Python on a Mac" (GH-115024)
(cherry picked from commit 0a6e1a4)

Co-authored-by: Hugo van Kemenade <[email protected]>
hugovk added a commit that referenced this pull request Feb 13, 2024
Update "Using Python on a Mac" (GH-115024)
(cherry picked from commit 0a6e1a4)

Co-authored-by: Hugo van Kemenade <[email protected]>
@hugovk
Copy link
Member Author

hugovk commented Feb 13, 2024

PR #115416 uses the same rst_epilog technique to replace a couple of other manual version updates with substitutions.

fsc-eriker pushed a commit to fsc-eriker/cpython that referenced this pull request Feb 14, 2024
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 OS-mac skip issue skip news
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants