From 0de6533738361eeaf1ba109f84131a8dc0e6182c Mon Sep 17 00:00:00 2001 From: Ned Batchelder Date: Thu, 27 Aug 2026 06:30:35 -0400 Subject: [PATCH] [3.15] Docs: remove __path__ discussion from tutorial (GH-156426) * 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. * add removed id to removed-ids.txt (cherry picked from commit 79f41dd9f312ab960e492c34b85f02e84cf1f556) Co-authored-by: Ned Batchelder --- Doc/tools/removed-ids.txt | 2 ++ Doc/tutorial/modules.rst | 14 -------------- 2 files changed, 2 insertions(+), 14 deletions(-) diff --git a/Doc/tools/removed-ids.txt b/Doc/tools/removed-ids.txt index ffffda3506c066..d0c805bfa6e9ff 100644 --- a/Doc/tools/removed-ids.txt +++ b/Doc/tools/removed-ids.txt @@ -6,6 +6,8 @@ c-api/file.html: deprecated-api library/asyncio-task.html: terminating-a-task-group +tutorial/modules.html: packages-in-multiple-directories + # Removed APIs c-api/import.html: c.PyImport_LazyImportsMode.PyImport_LAZY_NONE diff --git a/Doc/tutorial/modules.rst b/Doc/tutorial/modules.rst index f8105cd5441fec..46a226be606aeb 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