From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> Date: Fri, 20 Apr 2018 23:49:58 +0000 (-0700) Subject: Clarify that __path__ can't be just any value (GH-6554) X-Git-Tag: v3.6.6rc1~172 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=0eadb42596e5e542822a89e66fa2828c6013851f;p=python Clarify that __path__ can't be just any value (GH-6554) (cherry picked from commit 441d945eb33f8dc130b268ebfa11315b98a2433c) Co-authored-by: Brett Cannon --- diff --git a/Doc/reference/import.rst b/Doc/reference/import.rst index 7fbf8ed9d7..61f58539fe 100644 --- a/Doc/reference/import.rst +++ b/Doc/reference/import.rst @@ -617,8 +617,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.