https://github.com/python/cpython/commit/8dd272ffe03f9941e9784854e33827c066a8b226
commit: 8dd272ffe03f9941e9784854e33827c066a8b226
branch: 3.14
author: Ned Batchelder <[email protected]>
committer: nedbat <[email protected]>
date: 2026-08-27T07:06:31-04:00
summary:

[3.14] Docs: remove __path__ discussion from tutorial (GH-156426) (#156454)

* Docs: remove __path__ discussion from tutorial

This isn't the current best way to make namespace packages; almost no
one needs to make namespace packages; the deleted text even says "while
this feature is not often needed".  It doesn't belong in the tutorial.

(cherry picked from commit 79f41dd9f312ab960e492c34b85f02e84cf1f556)

files:
M Doc/tutorial/modules.rst

diff --git a/Doc/tutorial/modules.rst b/Doc/tutorial/modules.rst
index f8105cd5441fec2..46a226be606aeba 100644
--- a/Doc/tutorial/modules.rst
+++ b/Doc/tutorial/modules.rst
@@ -584,20 +584,6 @@ Since the main module does not have a package, modules 
intended for use
 as the main module of a Python application must always use absolute imports.
 
 
-Packages in Multiple Directories
---------------------------------
-
-Packages support one more special attribute, :attr:`~module.__path__`.  This is
-initialized to be a :term:`sequence` of strings containing the name of the
-directory holding the
-package's :file:`__init__.py` before the code in that file is executed.  This
-variable can be modified; doing so affects future searches for modules and
-subpackages contained in the package.
-
-While this feature is not often needed, it can be used to extend the set of
-modules found in a package.
-
-
 .. rubric:: Footnotes
 
 .. [#] In fact function definitions are also 'statements' that are 'executed'; 
the

_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: [email protected]

Reply via email to