#2633: clarify meaning of env parameter.

diff --git a/Doc/library/subprocess.rst b/Doc/library/subprocess.rst
index d1471f1ff83da6e1bc9cd9f7cd4ad8966e47f41d..b93bd0395c873313bd464e8ab7d50a6a8b60d80a 100644 (file)
--- a/Doc/library/subprocess.rst
+++ b/Doc/library/subprocess.rst
@@ -93,8 +93,9 @@ This module defines one class called :class:`Popen`:
    searching the executable, so you can't specify the program's path relative to
    *cwd*.
 
-   If *env* is not ``None``, it defines the environment variables for the new
-   process.
+   If *env* is not ``None``, it must be a mapping that defines the environment
+   variables for the new process; these are used instead of inheriting the current
+   process' environment, which is the default behavior.
 
    If *universal_newlines* is :const:`True`, the file objects stdout and stderr are
    opened as text files, but lines may be terminated by any of ``'\n'``, the Unix