From 441d945eb33f8dc130b268ebfa11315b98a2433c Mon Sep 17 00:00:00 2001 From: Brett Cannon Date: Fri, 20 Apr 2018 16:32:46 -0700 Subject: Clarify that __path__ can't be just any value (GH-6554) --- Doc/reference/import.rst | 3 +-- .../NEWS.d/next/Documentation/2018-04-20-14-09-36.bpo-33276.rA1z_3.rst | 1 + 2 files changed, 2 insertions(+), 2 deletions(-) create mode 100644 Misc/NEWS.d/next/Documentation/2018-04-20-14-09-36.bpo-33276.rA1z_3.rst diff --git a/Doc/reference/import.rst b/Doc/reference/import.rst index 45d4172..44b5b81 100644 --- a/Doc/reference/import.rst +++ b/Doc/reference/import.rst @@ -616,8 +616,7 @@ the module. module.__path__ --------------- -By definition, if a module has a ``__path__`` attribute, it is a package, -regardless of its value. +By definition, if a module has a ``__path__`` attribute, it is a package. A package's ``__path__`` attribute is used during imports of its subpackages. Within the import machinery, it functions much the same as :data:`sys.path`, diff --git a/Misc/NEWS.d/next/Documentation/2018-04-20-14-09-36.bpo-33276.rA1z_3.rst b/Misc/NEWS.d/next/Documentation/2018-04-20-14-09-36.bpo-33276.rA1z_3.rst new file mode 100644 index 0000000..0da58a0 --- /dev/null +++ b/Misc/NEWS.d/next/Documentation/2018-04-20-14-09-36.bpo-33276.rA1z_3.rst @@ -0,0 +1 @@ +Clarify that the ``__path__`` attribute on modules cannot be just any value. -- cgit v0.12