classification
Title: subprocess.Popen description unclear.
Type: Stage:
Components: Documentation Versions: Python 3.0, Python 2.6, Python 2.5
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: georg.brandl Nosy List: benjamin.peterson, georg.brandl, lregebro
Priority: normal Keywords:

Created on 2008-07-27 14:39 by lregebro, last changed 2008-07-27 15:22 by benjamin.peterson. This issue is now closed.

Messages (2)
msg70321 - (view) Author: Lennart Regebro (lregebro) Date: 2008-07-27 14:39
In the documentation of subprocess.Popen the docs say:

"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
string, but can be explicitly set by using the executable argument. "

The statement that the program to exectute is the "first item in the
args sequence or string" indicates that the first item in a string like
"ls -l", i.e. the "ls" will be the program. The next paragraph however
makes it clear that this is not the case, but by then the damage is
done, and you think that passing in "ls -l" will work.

Rewording this, perhaps by saying "The program to execute is normally
the first item in the args sequence, or the string if a string a given",
would make this clear.
msg70323 - (view) Author: Benjamin Peterson (benjamin.peterson) * (Python committer) Date: 2008-07-27 15:22
Thanks for the report. Fixed in r65259.
History
Date User Action Args
2008-07-27 15:22:47benjamin.petersonsetstatus: open -> closed
resolution: fixed
2008-07-27 15:22:36benjamin.petersonsetnosy: + benjamin.peterson
messages: + msg70323
2008-07-27 14:39:38lregebrocreate