[issue17383] Error in documentation /2/tutorial/modules.html#more-on-modules

2013-03-07 Thread Piotr Kuchta
New submission from Piotr Kuchta: In the 2.7 tutorial, chapter on modules: http://docs.python.org/2/tutorial/modules.html#more-on-modules I think the last sentence in this paragraph is incorrect: "Modules can import other modules. It is customary but not required to place all i

[issue17383] Error in documentation /2/tutorial/modules.html#more-on-modules

2013-03-08 Thread Piotr Kuchta
Piotr Kuchta added the comment: Jeff, thank you: that was exactly what I wanted to point out. The three sentences read in order imply that it doesn't matter whether you import a module at the top level of a script/module or in a function, because the effect is the same, namely the imp

[issue17383] Possibly ambiguous phrasing in tutorial/modules#more-on-modules

2013-03-08 Thread Piotr Kuchta
Piotr Kuchta added the comment: Eric, when you say 'the tutorial distinguishes between “it’s customary to put imports near the top of the file” vs. “later in the file”' the last bit is just your interpretation. The tutorial doesn't say "later in the file". Anyway, &#x