[New-bugs-announce] [issue22242] Doc fix in the Import section in language reference.

[Jon Poler]

New submission from Jon Poler:

It looks like there might be a contradiction in the documentation of import in the language reference. In the loading subsection https://docs.python.org/dev/reference/import.html#loading, first bulleted list of the section, it specifies that if a loader fails, it must remove only the failing module from sys.modules, while other side-effect imports by loader will stay in sys.modules.

In the next subsection https://docs.python.org/dev/reference/import.html#loaders, second bulleted list (last bullet), the phrasing is confusing, and possibly contradictory. I believe that it meant to reiterate what was said above (see my previous paragraph).

Attached is a potential patch, but if anyone finds that I am interpreting this wrong, I'll make adjustments accordingly.

----------
assignee: docs at python
components: Documentation
files: import_doc_fix.patch
keywords: patch
messages: 225610
nosy: docs at python, jon.poler
priority: normal
severity: normal
status: open
title: Doc fix in the Import section in language reference.
type: enhancement
versions: Python 3.5
Added file: http://bugs.python.org/file36427/import_doc_fix.patch

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue22242>
_______________________________________