From: R. David Murray <rdmurray@bitdance.com>
Date: Wed, 15 Apr 2009 22:34:30 +0000 (+0000)
Subject: Merged revisions 71631 via svnmerge from
X-Git-Tag: v2.6.3rc1~422
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=0ec635138fc97e496407413878845fa5a7e37de4;p=thirdparty%2FPython%2Fcpython.git

Merged revisions 71631 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/trunk

........
  r71631 | r.david.murray | 2009-04-15 18:33:07 -0400 (Wed, 15 Apr 2009) | 4 lines

  Fix for issue3440: add warning to subprocess discussion of
  env parameter that on Windows SystemRoot is required in order
  to run side-by-side assemblies.
........
---

diff --git a/Doc/library/subprocess.rst b/Doc/library/subprocess.rst
index 250a9267b9bd..bdce3187c9fb 100644
--- a/Doc/library/subprocess.rst
+++ b/Doc/library/subprocess.rst
@@ -102,6 +102,13 @@ This module defines one class called :class:`Popen`:
    variables for the new process; these are used instead of inheriting the current
    process' environment, which is the default behavior.
 
+   .. warning::
+
+      When replacing the environment you must provide any variables
+      required for the program to execute.  On Windows, in order to run
+      a side-by-side assembly the specified *env* must include a valid
+      :envvar:`SystemRoot`.
+
    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
    end-of-line convention, ``'\r'``, the old Macintosh convention or ``'\r\n'``, the