clarify advanced deployment options, reflow some text

python · rickeylev · Jun 27, 2025 · Jun 28, 2025 · Jun 28, 2025 · Jun 28, 2025
commit b81c50f001899297f6c8a9413062abe0bb64d3ea
@@ -32,15 +32,15 @@ Motivation
 There are two main motivations for allowing relative paths in ``pyvenv.cfg``
 and thus enabling host-relocatable virtual environments.
 
-First, it is currently proscribed that the ``home`` value in ``pyvenv.cfg`` be an
-absolute path. The behavior of relative paths is unspecified.
-While techniques exist to work around this for every other
-sub-part of a virtual environment, the one remaining part without a teneable
-solution is how the Python runtime itself finds ``PYTHONHOME``. This is because,
-currently, the startup process requires absolute paths be used for the ``home``
-key in ``pyvenv.cfg``. If a relative path is used, behavior is unspecified
-(currently, it is relative to the process's current working directory, making
-it untenable to use).
+First, it is currently proscribed that the ``home`` value in ``pyvenv.cfg`` be
+an absolute path. The behavior of relative paths is unspecified. While
+techniques exist to work around this for every other sub-part of a virtual
+environment, the one remaining part without a teneable solution is how the
+Python runtime itself finds ``PYTHONHOME``. This is because, currently, the
+startup process requires absolute paths be used for the ``home`` key in
+``pyvenv.cfg``. If a relative path is used, behavior is unspecified (currently,
+it is relative to the process's current working directory, making it untenable
+to use).
 
 This requirement is overly proscriptive and restrictive because, given a known
 anchor point, it's easy to tranform a relative path to an absolute path and
@@ -58,15 +58,14 @@ applications. This means ...
 * The simpler the process is to re-create the environment, the faster the process
   can be.
 
-By making it trivial to copy a virtual environment from one host to another,
-it avoids these categories of problems. Additionally, the development tools
-to create a virtual environment and install its dependencies aren't needed
-on the host that intends to run the program.
+By making it trivial to copy a virtual environment from one host to another, it
+avoids these categories of problems. Additionally, the development tools to
+create a virtual environment and install its dependencies aren't needed on the
+host that intends to run the program.
 
-Simple copying allows additional optimizations in more advanced deployments,
-such as remote mounting
-Because only simply copying is need, it allows more advanced d
-This simple copying enables more advanced deployments to employ
+Because the virtual environment doesn't require modifications to be usable, it
+also allows more advanced deployment mechansisms, e.g. remote mounting and
+caching of artifacts.
 
 Rationale
 =========