[doc] Inconsistent / confusing documentation regarding importing submodules

[DirkHerrmann]

BPO	43138

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = None
created_at = <Date 2021-02-05.17:33:30.976>
labels = ['type-feature', '3.10', 'docs']
title = '[doc] Inconsistent / confusing documentation regarding importing submodules'
updated_at = <Date 2021-02-05.17:33:30.976>
user = 'https://bugs.python.org/DirkHerrmann'

bugs.python.org fields:

activity = <Date 2021-02-05.17:33:30.976>
actor = 'Dirk Herrmann'
assignee = 'docs@python'
closed = False
closed_date = None
closer = None
components = ['Documentation']
creation = <Date 2021-02-05.17:33:30.976>
creator = 'Dirk Herrmann'
dependencies = []
files = []
hgrepos = []
issue_num = 43138
keywords = []
message_count = 1.0
messages = ['386532']
nosy_count = 2.0
nosy_names = ['docs@python', 'Dirk Herrmann']
pr_nums = []
priority = 'normal'
resolution = None
stage = None
status = 'open'
superseder = None
type = 'enhancement'
url = 'https://bugs.python.org/issue43138'
versions = ['Python 3.10']

[DirkHerrmann]

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

[hauntsaninja]

Thanks, seems like this can be closed now