Skip to content

gh-148488: Clarify that both / and \ slashes are accepted in py -V:company/tag#148856

Open
Jah-yee wants to merge 1 commit intopython:mainfrom
Jah-yee:fix/py-v-doc-clarity-v2
Open

gh-148488: Clarify that both / and \ slashes are accepted in py -V:company/tag#148856
Jah-yee wants to merge 1 commit intopython:mainfrom
Jah-yee:fix/py-v-doc-clarity-v2

Conversation

@Jah-yee
Copy link
Copy Markdown

@Jah-yee Jah-yee commented Apr 21, 2026

Good day

This PR addresses issue #148488, which reported that the documentation for py -V was confusing regarding which slash characters are accepted as separators between company and tag.

Changes

In Doc/using/windows.rst, the sentence:

This should be separated from the tag by a slash, and may be a prefix.

was updated to:

This should be separated from the tag by a slash (either ``/`` or ``\\``, both are accepted on Windows), and may be a prefix.

This makes it clear that both forward slash / and backslash \\ are accepted as separators on Windows (as the underlying implementation handles both), resolving the confusion noted in the issue where the example used \\ but the text only mentioned "slash".

Verification

  • Documentation builds cleanly with Sphinx (no warnings related to this change)
  • The change is minimal and targeted, affecting only one sentence
  • Both example entries (Distributor\\1.0 and distrib/) already exist in the file, confirming both slash types are intended to be demonstrated

Thank you for your attention. If there are any issues or suggestions, please leave a comment and I will address them promptly.

Warmly,
Jah-yee


📚 Documentation preview 📚: https://cpython-previews--148856.org.readthedocs.build/

@python-cla-bot
Copy link
Copy Markdown

The following commit authors need to sign the Contributor License Agreement:

CLA not signed

@bedevere-app bedevere-app Bot added docs Documentation in the Doc dir skip news labels Apr 21, 2026
@github-project-automation github-project-automation Bot moved this to Todo in Docs PRs Apr 21, 2026
@StanFromIreland StanFromIreland changed the title Clarify that both / and \ slashes are accepted in py -V:company/tag gh-148488: Clarify that both / and \ slashes are accepted in py -V:company/tag Apr 21, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

awaiting review docs Documentation in the Doc dir skip news

Projects

Status: Todo

Development

Successfully merging this pull request may close these issues.

1 participant