summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorGeorg Brandl <georg@python.org>2009-03-31 18:26:55 (GMT)
committerGeorg Brandl <georg@python.org>2009-03-31 18:26:55 (GMT)
commit22717dffba6827c430afc078c58cec05331de7ed (patch)
tree35ffbcbe0de588f895939cbfeb38cc5fa89c6fd3 /Doc
parent40a6164afa79f6b97e7e40e0f35f6081fde437c2 (diff)
downloadcpython-22717dffba6827c430afc078c58cec05331de7ed.zip
cpython-22717dffba6827c430afc078c58cec05331de7ed.tar.gz
cpython-22717dffba6827c430afc078c58cec05331de7ed.tar.bz2
#837577: note cryptic return value of spawn*e on invalid env dicts.
Diffstat (limited to 'Doc')
-rw-r--r--Doc/library/os.rst4
1 files changed, 3 insertions, 1 deletions
diff --git a/Doc/library/os.rst b/Doc/library/os.rst
index bbe3b5c..4ea6c7f 100644
--- a/Doc/library/os.rst
+++ b/Doc/library/os.rst
@@ -1753,7 +1753,9 @@ written in Python, such as a mail server's external command delivery program.
which is used to define the environment variables for the new process (they are
used instead of the current process' environment); the functions
:func:`spawnl`, :func:`spawnlp`, :func:`spawnv`, and :func:`spawnvp` all cause
- the new process to inherit the environment of the current process.
+ the new process to inherit the environment of the current process. Note that
+ keys and values in the *env* dictionary must be strings; invalid keys or
+ values will cause the function to fail, with a return value of ``127``.
As an example, the following calls to :func:`spawnlp` and :func:`spawnvpe` are
equivalent::