classification
Title: [doc] Inconsistent / confusing documentation regarding importing submodules
Type: enhancement Stage:
Components: Documentation Versions: Python 3.10
process
Status: open Resolution:
Dependencies: Superseder:
Assigned To: docs@python Nosy List: Dirk Herrmann, docs@python
Priority: normal Keywords:

Created on 2021-02-05 17:33 by Dirk Herrmann, last changed 2021-02-05 17:33 by Dirk Herrmann.

Messages (1)
msg386532 - (view) Author: Dirk Herrmann (Dirk Herrmann) Date: 2021-02-05 17:33
In the language reference, section "7.11 The import statement" is is explained in the example section:

   import foo.bar.baz         # foo.bar.baz imported, foo bound locally

When looking at "5.3. Searching", it is stated that regarding foo.bar.baz:

   In this case, Python first tries to import foo, then foo.bar, and finally foo.bar.baz.

I find this confusing.  Assuming that 5.3 is correct, the examples in 7.11 could be improved, like, for the sample line mentioned above:

   import foo.bar.baz         # foo, foo.bar and foo.bar.baz imported, foo bound locally
History
Date User Action Args
2021-02-05 17:33:30Dirk Herrmanncreate