[Python-checkins] Clarify that __path__ can't be just any value (GH-6554)

[Brett Cannon]

https://github.com/python/cpython/commit/441d945eb33f8dc130b268ebfa11315b98a2433c
commit: 441d945eb33f8dc130b268ebfa11315b98a2433c
branch: master
author: Brett Cannon <brettcannon at users.noreply.github.com>
committer: GitHub <noreply at github.com>
date: 2018-04-20T16:32:46-07:00
summary:

Clarify that __path__ can't be just any value (GH-6554)

files:
A Misc/NEWS.d/next/Documentation/2018-04-20-14-09-36.bpo-33276.rA1z_3.rst
M Doc/reference/import.rst

diff --git a/Doc/reference/import.rst b/Doc/reference/import.rst
index 45d417295d06..44b5b818aa82 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 000000000000..0da58a0ce4c8
--- /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.