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

Éric Araujo added the comment: > It is customary *but not required* to place all import statements at the > beginning of a module...". The third seems to state that regardless of > whether or not you followed the custom, module names are always placed in > the global symbol table Yes. Not follow

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

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 imported sym

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

Jeff Knupp added the comment: I think Piotr's point is the wording of the last sentence is ambiguous. The second statement reads "It is customary *but not required* to place all import statements at the beginning of a module...". The third seems to state that regardless of whether or not you f

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

Éric Araujo added the comment: Text sounds correct to me. It says that imports should happen at the beginning of a module, and that the names of imported modules are placed in the module namespace. There is an implicit logical link between the two sentences, and the wording of “symbol table”

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

Changes by Ashwini Chaudhary : -- nosy: +montysinngh ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: http://mai

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

Ezio Melotti added the comment: It should probably say that they are placed in the namespace where they get imported, but I'm not sure if the concept of namespace has been covered yet at that point of the tutorial. The sentence probably assume that the modules are getting imported at the begi

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

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 import stateme