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

(cherry picked from commit 441d945eb33f8dc130b268ebfa11315b98a2433c)

Co-authored-by: Brett Cannon <brettcannon@users.noreply.github.com>

diff --git a/Doc/reference/import.rst b/Doc/reference/import.rst
index 7fbf8ed9d789a4487956915ac95f17035cb18992..61f58539fe82886aaccb8bd31dfe3725f9f9c8a7 100644 (file)
--- 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 (file)
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.