summaryrefslogtreecommitdiffstats
path: root/Doc/library/subprocess.rst
diff options
context:
space:
mode:
authorR. David Murray <rdmurray@bitdance.com>2009-05-29 19:30:27 (GMT)
committerR. David Murray <rdmurray@bitdance.com>2009-05-29 19:30:27 (GMT)
commitfe6e784a9dc1e1c3281f2a62d2d5f48134cc4fd5 (patch)
treeb27a1978f69aff1d048e2102b3e6050d641294e6 /Doc/library/subprocess.rst
parent6b98544b32bdbf9d22fddf3973c56a815b53fc3c (diff)
downloadcpython-fe6e784a9dc1e1c3281f2a62d2d5f48134cc4fd5.zip
cpython-fe6e784a9dc1e1c3281f2a62d2d5f48134cc4fd5.tar.gz
cpython-fe6e784a9dc1e1c3281f2a62d2d5f48134cc4fd5.tar.bz2
Issue 6141: document that the first item of args is still the
command name even when executable is specified.
Diffstat (limited to 'Doc/library/subprocess.rst')
-rw-r--r--Doc/library/subprocess.rst9
1 files changed, 6 insertions, 3 deletions
diff --git a/Doc/library/subprocess.rst b/Doc/library/subprocess.rst
index 946a504..73c622e 100644
--- a/Doc/library/subprocess.rst
+++ b/Doc/library/subprocess.rst
@@ -39,9 +39,12 @@ This module defines one class called :class:`Popen`:
Arguments are:
*args* should be a string, or a sequence of program arguments. The program
- to execute is normally the first item in the args sequence or the string if a
- string is given, but can be explicitly set by using the *executable*
- argument.
+ to execute is normally the first item in the args sequence or the string if
+ a string is given, but can be explicitly set by using the *executable*
+ argument. When *executable* is given, the first item in the args sequence
+ is still treated by most programs as the command name, which can then be
+ different from the actual executable name. On Unix, it becomes the display
+ name for the executing program in utilities such as :program:`ps`.
On Unix, with *shell=False* (default): In this case, the Popen class uses
:meth:`os.execvp` to execute the child program. *args* should normally be a