Skip to content

Conversation

@Muawiya-contact
Copy link

@Muawiya-contact Muawiya-contact commented Jan 30, 2026

Description

This PR fixes the ambiguity in the site module documentation regarding ._pth files. As noted in issue gh-144329, the current text does not explicitly state that the underscore-prefixed .pth files are a feature exclusive to the Windows embeddable distribution.

Changes

  • Added a .. note:: block to Doc/library/site.rst explaining the Windows-only nature of ._pth files.
  • Added a reference to the finding_modules section for further technical context on isolated environments.

Verification

I have built the documentation locally using make html (on Windows via make.bat html) and confirmed the new note renders correctly and the cross-reference link is functional.


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

@python-cla-bot
Copy link

python-cla-bot bot commented Jan 30, 2026

All commit authors signed the Contributor License Agreement.

CLA signed

@htgoebel
Copy link

This is AI garbage: 6 commits for adding a simple "Windows only". And adding a complete note-paragraph, where a simple "Windows only" would suffice.

@zooba
Copy link
Member

zooba commented Jan 30, 2026

Yeah, this is blatantly incorrect. The code for handling ._pth is not OS-specific, so it'll work on all platforms.

Let's give the PR creator a chance to admit they're human and close this themselves. If it's a fire-and-forget AI driven PR, then we won't feel so bad about just blocking the user for good.

@Muawiya-contact
Copy link
Author

Acknowledged, leaving this PR as-is. Thank you for the feedback.

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.

4 participants