FazBrowse GitHub Viewer | Trending |
URL:
| Home
Tools: [Download Repo ZIP]   [Original HTTPS Page]

gh-130160: use `.. program::` directive for documenting `ensurepip` CLI by Mr-Sunglasses · Pull Request #130253 · python/cpython · GitHub

/ cpython Public

gh-130160: use .. program:: directive for documenting ensurepip CLI - #130253

Merged
pfmoore merged 2 commits into
python:mainfrom
Mr-Sunglasses:fix/130160
Feb 18, 2025
ConversationCommits (2)ChecksFiles changed
Merged

gh-130160: use .. program:: directive for documenting ensurepip CLI#130253
pfmoore merged 2 commits into
python:mainfrom
Mr-Sunglasses:fix/130160

Conversation

Mr-Sunglasses commented Feb 18, 2025 •
edited by github-actions Bot
Loading

Copy link
Copy Markdown
Contributor

ghost commented Feb 18, 2025 •
edited by ghost
Loading

Copy link
Copy Markdown

All commit authors signed the Contributor License Agreement.

bedevere-app Bot added docs Documentation in the Doc dir skip news awaiting review labels Feb 18, 2025
bedevere-app Bot mentioned this pull request Feb 18, 2025
Closed
6 tasks

Mr-Sunglasses commented Feb 18, 2025

Copy link
Copy Markdown
Contributor Author

@sobolevn , @picnixz ptal

sobolevn reviewed Feb 18, 2025
View reviewed changes

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

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

LGTM!

I would recommend changing pipX to pipN, because there's now a tool called pipx.

Thanks for the PR and congrats! 🎉

sobolevn reviewed Feb 18, 2025
View reviewed changes
Comment thread Doc/library/ensurepip.rst Outdated

By default, the scripts ``pipX`` and ``pipX.Y`` will be installed (where
X.Y stands for the version of Python used to invoke ``ensurepip``). The
By default, the scripts ``pipN`` and ``pipN.Y`` will be installed (where

sobolevn Feb 18, 2025

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.

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

Maybe pipN.M?

pfmoore Feb 18, 2025

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.

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

Why change this at all? pipX.Y is the normal convention here, used in the pip documentation.

sobolevn Feb 18, 2025

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.

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

Ok, this change is unrelated anyway and no users complained about it. I agree with @pfmoore

pfmoore requested changes Feb 18, 2025
View reviewed changes

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

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

Please leave the pipX.Y naming convention unchanged.

bedevere-app Bot commented Feb 18, 2025

Copy link
Copy Markdown

A Python core developer has requested some changes be made to your pull request before we can consider merging it. If you could please address their requests along with any other requests in other reviews from core developers that would be appreciated.

Once you have made the requested changes, please leave a comment on this pull request containing the phrase I have made the requested changes; please review again. I will then notify any core developers who have left a review that you're ready for them to take another look at this pull request.

pfmoore commented Feb 18, 2025

Copy link
Copy Markdown
Member

Sorry I hadn’t seen the comment by @sobolevn regarding the pipx application. Nevertheless, I disagree - the pipX.Y convention is well established, and consistency with existing terminology is important.

Mr-Sunglasses commented Feb 18, 2025

Copy link
Copy Markdown
Contributor Author

I have made the requested changes; please review again.

bedevere-app Bot commented Feb 18, 2025

Copy link
Copy Markdown

Thanks for making the requested changes!

@pfmoore: please review the changes made to this pull request.

bedevere-app Bot requested a review from pfmoore February 18, 2025 11:51

pfmoore commented Feb 18, 2025

Copy link
Copy Markdown
Member

Thanks! LGTM.

pfmoore merged commit 8cd7f8b into python:main Feb 18, 2025

sobolevn commented Feb 18, 2025

Copy link
Copy Markdown
Member

We usually backport doc changes, should we in this case?

sobolevn added needs backport to 3.12 only security fixes needs backport to 3.13 bugs and security fixes labels Feb 18, 2025

miss-islington-app Bot commented Feb 18, 2025

Copy link
Copy Markdown

Thanks @Mr-Sunglasses for the PR, and @pfmoore for merging it 🌮🎉.. I'm working now to backport this PR to: 3.13.
🐍🍒⛏🤖 I'm not a witch! I'm not a witch!

miss-islington-app Bot commented Feb 18, 2025

Copy link
Copy Markdown

Thanks @Mr-Sunglasses for the PR, and @pfmoore for merging it 🌮🎉.. I'm working now to backport this PR to: 3.12.
🐍🍒⛏🤖

miss-islington pushed a commit to miss-islington/cpython that referenced this pull request Feb 18, 2025
pythongh-130160: use .. program:: directive for documenting `ensure…
45a3590 
…pip` CLI (pythongh-130253)

(cherry picked from commit 8cd7f8b)

Co-authored-by: Kanishk Pachauri <itskanishkp.py@gmail.com>

bedevere-app Bot commented Feb 18, 2025

Copy link
Copy Markdown

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

bedevere-app Bot removed the needs backport to 3.12 only security fixes label Feb 18, 2025
miss-islington pushed a commit to miss-islington/cpython that referenced this pull request Feb 18, 2025
pythongh-130160: use .. program:: directive for documenting `ensure…
d47bff3 
…pip` CLI (pythongh-130253)

(cherry picked from commit 8cd7f8b)

Co-authored-by: Kanishk Pachauri <itskanishkp.py@gmail.com>

bedevere-app Bot commented Feb 18, 2025

Copy link
Copy Markdown

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

bedevere-app Bot removed the needs backport to 3.13 bugs and security fixes label Feb 18, 2025

pfmoore commented Feb 18, 2025

Copy link
Copy Markdown
Member

We usually backport doc changes, should we in this case?

I don't know the policy for doc changes, but if that's the usual approach, I see no reason not to.

pfmoore pushed a commit that referenced this pull request Feb 18, 2025
[3.13] gh-130160: use .. program:: directive for documenting `ensur…
a273543 
…epip` CLI (gh-130253) (gh-130259)

gh-130160: use `.. program::` directive for documenting `ensurepip` CLI (gh-130253)
(cherry picked from commit 8cd7f8b)

Co-authored-by: Kanishk Pachauri <itskanishkp.py@gmail.com>
pfmoore pushed a commit that referenced this pull request Feb 18, 2025
[3.12] gh-130160: use .. program:: directive for documenting `ensur…
aeefac9 
…epip` CLI (gh-130253) (gh-130258)

gh-130160: use `.. program::` directive for documenting `ensurepip` CLI (gh-130253)
(cherry picked from commit 8cd7f8b)

Co-authored-by: Kanishk Pachauri <itskanishkp.py@gmail.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode characters
Show hidden characters
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

sobolevn sobolevn left review comments
pfmoore pfmoore approved these changes
pradyunsg Awaiting requested review from pradyunsg pradyunsg is a code owner

Assignees

No one assigned

Labels

docs Documentation in the Doc dir skip news

Projects

Docs PRs
Status: Done

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Use .. program:: and .. option:: directives for modules with a documented CLI

3 participants

Back | FazBrowse Home | New Git URL