This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: Duplicate text in docs/reference/import statement
Type: enhancement Stage: resolved
Components: Documentation Versions: Python 3.3, Python 3.4
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: ezio.melotti Nosy List: docs@python, ezio.melotti, python-dev, stefanchrobot
Priority: normal Keywords:

Created on 2013-05-08 21:27 by stefanchrobot, last changed 2022-04-11 14:57 by admin. This issue is now closed.

Messages (3)
msg188737 - (view) Author: Stefan Chrobot (stefanchrobot) Date: 2013-05-08 21:27
http://docs.python.org/3/reference/simple_stmts.html#the-import-statement

After the "Examples", there's a duplicated paragraph:

The public names defined by a module are determined by checking the module’s namespace for a variable named __all__; if defined, it must be a sequence of strings which are names defined or imported by that module. The names given in __all__ are all considered public and are required to exist. If __all__ is not defined, the set of public names includes all names found in the module’s namespace which do not begin with an underscore character ('_'). __all__ should contain the entire public API. It is intended to avoid accidentally exporting items that are not part of the API (such as library modules which were imported and used within the module).

The from form with * may only occur in a module scope. Attempting to use it in class or function definitions will raise a SyntaxError.

The public names defined by a module are determined by checking the module’s namespace for a variable named __all__; if defined, it must be a sequence of strings which are names defined or imported by that module. The names given in __all__ are all considered public and are required to exist. If __all__ is not defined, the set of public names includes all names found in the module’s namespace which do not begin with an underscore character ('_'). __all__ should contain the entire public API. It is intended to avoid accidentally exporting items that are not part of the API (such as library modules which were imported and used within the module).

The from form with * may only occur in a module scope. The wild card form of import — import * — is only allowed at the module level. Attempting to use it in class or function definitions will raise a SyntaxError.
msg188772 - (view) Author: Roundup Robot (python-dev) (Python triager) Date: 2013-05-09 12:34
New changeset 844c6442a39e by Ezio Melotti in branch '3.3':
#17938: remove duplicate paragraphs.
http://hg.python.org/cpython/rev/844c6442a39e

New changeset ebc296bf23d1 by Ezio Melotti in branch 'default':
#17938: merge with 3.3.
http://hg.python.org/cpython/rev/ebc296bf23d1
msg188773 - (view) Author: Ezio Melotti (ezio.melotti) * (Python committer) Date: 2013-05-09 12:34
Fixed, thanks for the report!
History
Date User Action Args
2022-04-11 14:57:45adminsetgithub: 62138
2013-05-09 12:34:55ezio.melottisetstatus: open -> closed
versions: + Python 3.4
messages: + msg188773

assignee: docs@python -> ezio.melotti
resolution: fixed
stage: resolved
2013-05-09 12:34:23python-devsetnosy: + python-dev
messages: + msg188772
2013-05-08 21:47:44ezio.melottisetnosy: + ezio.melotti
2013-05-08 21:27:10stefanchrobotcreate