Note the sole case in which the ban on "from ... import *" within a

function is enforced.

diff --git a/Doc/ref/ref6.tex b/Doc/ref/ref6.tex
index 7dae88a994b6eaf04cd04337f3a7946f7ea9ed09..c78328ce2231e35a90180426a646785790983f1c 100644 (file)
--- a/Doc/ref/ref6.tex
+++ b/Doc/ref/ref6.tex
@@ -680,7 +680,11 @@ defined, the set of public names includes all names found in the
 module's namespace which do not begin with an underscore character
 (\character{_}).
 
-The \keyword{from} form with \samp{*} may only occur in a module scope.
+The \keyword{from} form with \samp{*} may only occur in a module
+scope.  If the wild card form of import --- \samp{import *} --- is
+used in a function and the function contains or is a nested block with
+free variables, the compiler will raise a \exception{SyntaxError}.
+
 \kwindex{from}
 \stindex{from}