Skip to content

gh-148641: Flesh out PEP 829 for What's New#149347

Open
warsaw wants to merge 3 commits intopython:mainfrom
warsaw:warsaw/829-followup
Open

gh-148641: Flesh out PEP 829 for What's New#149347
warsaw wants to merge 3 commits intopython:mainfrom
warsaw:warsaw/829-followup

Conversation

@warsaw
Copy link
Copy Markdown
Member

@warsaw warsaw commented May 4, 2026

@warsaw warsaw self-assigned this May 4, 2026
@warsaw warsaw requested a review from AA-Turner as a code owner May 4, 2026 03:43
@bedevere-app bedevere-app Bot added the docs Documentation in the Doc dir label May 4, 2026
@github-project-automation github-project-automation Bot moved this to Todo in Docs PRs May 4, 2026
@warsaw warsaw requested review from hugovk and removed request for AA-Turner May 4, 2026 03:43
@read-the-docs-community
Copy link
Copy Markdown

Documentation build overview

📚 cpython-previews | 🛠️ Build #32520312 | 📁 Comparing 82a0cdf against main (3efd2f4)

  🔍 Preview build  

7 files changed · ± 7 modified

± Modified

Comment thread Doc/whatsnew/3.15.rst Outdated
Comment thread Doc/whatsnew/3.15.rst
Comment thread Doc/whatsnew/3.15.rst
Comment on lines +460 to +464
Loaded by the :mod:`site` module when ``-S`` is not given, :file:`.pth` files
can contain lines that both extend :data:`sys.path` and execute arbitrary code
when the line starts with ``import`` (followed by a space or tab). The latter
functionality can be problematic, since it is difficult to know exactly what
gets executed when Python starts up.
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.

Let's link something to the new _site-pth-files reference here, perhaps link ".pth files"? Would likely need the :file: markup removed.

https://github.com/python/cpython/pull/149109/changes#diff-fdaae06c309c89bb3352a8d0485bcdb8f7ffe316a5d988238f7c7cd15741bd69

Comment thread Doc/whatsnew/3.15.rst
Python 3.15 introduces :file:`.start` files which contain entry point
specifications of the form ``pkg.mod:callable`` where ``pkg.mod`` is the
import path to the given callable. When Python starts up, the callable is
located and called with no arguments.
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.

And link to _site-start-files somewhere here, perhaps ".start files".

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

awaiting core review docs Documentation in the Doc dir skip news

Projects

Status: Todo

Development

Successfully merging this pull request may close these issues.

2 participants