diff --git a/Doc/reference/import.rst b/Doc/reference/import.rst index 45d417295d0..44b5b818aa8 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 00000000000..0da58a0ce4c --- /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.