From: Georg Brandl Date: Tue, 31 Mar 2009 18:26:55 +0000 (+0000) Subject: #837577: note cryptic return value of spawn*e on invalid env dicts. X-Git-Tag: v2.7a1~1698 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=22717dffba6827c430afc078c58cec05331de7ed;p=python #837577: note cryptic return value of spawn*e on invalid env dicts. --- diff --git a/Doc/library/os.rst b/Doc/library/os.rst index bbe3b5c1b9..4ea6c7f5b3 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::