When running a module using the interpreter's :option:`-m` switch,
``sys.argv`` will now be set to the string ``'-m'`` while the
-module is being located, while executing the :file:`__init__.py` files
-for any parent packages of the module to be executed.
-(Suggested by Michael Foord; implemented by Nick Coghlan;
+module is being located. This change is visible to user code while
+executing the :file:`__init__.py` files for any parent packages of
+the module to be executed. (Suggested by Michael Foord; implemented
+by Nick Coghlan; :issue:`8202`.)
``sys.path`` and the module :mod:`__main__` will be imported. It's
expected that the directory or zip contains a :file:`__main__.py`;
if it doesn't, some other :file:`__main__.py` might be imported from
- a location later in ``sys.path``. This makes
some of the machinery
+ a location later in ``sys.path``. This makes e of the machinery
of :mod:`runpy` available to scripts that want to mimic the way
:option:`-m` processes an explicit path name.
+ Python's processes an explicit path name.
(Added by Nick Coghlan; :issue:`6816`.)
* New function: in the :mod:`shutil` module, :func:`~shutil.make_archive`