# HG changeset patch
# User Paul Moore
# Date 1424435497 0
# Fri Feb 20 12:31:37 2015 +0000
# Node ID 90a44e4134dd8a034eada121bde4b08291e69515
# Parent da4eeba6ba2088b898a6f2b1cad28d989d733db3
Implement PEP 441 - Improving Python Zip Application Support
diff -r da4eeba6ba20 -r 90a44e4134dd Doc/library/zipapp.rst
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/Doc/library/zipapp.rst Fri Feb 20 12:31:37 2015 +0000
@@ -0,0 +1,153 @@
+:mod:`zipapp` --- Manage executable python zip archives
+=======================================================
+
+.. module:: zipapp
+ :synopsis: Manage executable python zip archives
+
+
+.. index::
+ single: Executable Zip Files
+
+.. versionadded:: 3.5
+
+**Source code:** :source:`Lib/zipapp.py`
+
+--------------
+
+This module provides tools to manage the creation of zip files containing
+Python code, which can be executed directly by the Python interpreter (see
+:ref:`using-on-interface-options`). The module provides both a
+:ref:`zipapp-command-line-interface` and a :ref:`zipapp-python-api`.
+
+
+Basic Example
+-------------
+
+The following example shows how the :ref:`command-line-interface`
+can be used to create an executable archive from a directory containing
+Python code. When run, the archive will execute the "main" function from
+the module "myapp" in the archive.
+
+.. code-block:: sh
+
+ $ python -m zipapp myapp -m "myapp:main"
+ $ python myapp.pyz
+