From: Brett Cannon Date: Fri, 20 Apr 2018 23:32:46 +0000 (-0700) Subject: Clarify that __path__ can't be just any value (GH-6554) X-Git-Tag: v3.8.0a1~1937 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=441d945eb33f8dc130b268ebfa11315b98a2433c;p=python Clarify that __path__ can't be just any value (GH-6554) --- diff --git a/Doc/reference/import.rst b/Doc/reference/import.rst index 45d417295d..44b5b818aa 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 0000000000..0da58a0ce4 --- /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.