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@python
components: Documentation
files: import_doc_fix.patch
keywords: patch
messages: 225610
nosy: docs@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 <rep...@bugs.python.org>
<http://bugs.python.org/issue22242>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to