📖 split PyRun URL settings (release.pex task)

docs/customize.rst

@@ -56,20 +56,25 @@ pyrun.python        The version of *Python* to use (``2.6``, ``2.7``,
 pyrun.ucs           Unicode code points size (``ucs2`` or ``ucs4``)
 pyrun.platform      The platform ID (e.g. ``linux-x86_64``,
                     ``macosx-10.5-x86_64``)
-pyrun.url           Download location URL pattern
+pyrun.base_url      Download location base URL pattern
+pyrun.archive       Download location file name pattern
 =================== =========================================================
 
-The ``pyrun.url`` value can be a local ``http[s]`` URL
+The ``pyrun.base_url`` value can be a local ``http[s]`` URL
 of an `Artifactory`_ repository or some similar webserver, or else
-a ``file://`` URL of a file system cache. Note that the basename of
-the URL should be exactly as in the following example, i.e. unchanged
-from the original download name.
+a ``file://`` URL of a file system cache. Note that you should keep the
+unchanged name of the original download location, i.e. do not change
+``pyrun.archive``. The location patterns can contain the ``pyrun``
+settings as placeholders, e.g. ``{version}``.
+
+This sets a local download cache:
 
 .. code:: sh
 
-    export INVOKE_RITUALS_PYRUN_URL="file://"\
-    "$HOME/Downloads/egenix-pyrun-{version}-py{python}_{ucs}-{platform}.tgz"
+    export INVOKE_RITUALS_PYRUN_BASE_URL="file://$HOME/Downloads"
 
+You have to download the *PyRun* releases you plan to use to that directory,
+using your browser or ``curl``.
 
 .. _`Artifactory`: http://www.jfrog.com/open-source/#os-arti
 .. _`Bintray`: https://bintray.com/