classification
Title: Confused by subprocess API documentation
Type: Stage:
Components: Documentation Versions: Python 2.6
process
Status: closed Resolution: accepted
Dependencies: Superseder:
Assigned To: georg.brandl Nosy List: georg.brandl, pakal, tim.golden
Priority: normal Keywords: patch

Created on 2009-06-29 15:47 by pakal, last changed 2009-06-30 16:17 by georg.brandl. This issue is now closed.

Files
File name Uploaded Description Edit
doc-subprocess.patch tim.golden, 2009-06-29 16:07
Messages (3)
msg89854 - (view) Author: Pascal Chambon (pakal) * Date: 2009-06-29 15:47
I feel the description of the subprocess.popen semantics is a little
incomplete/confusing to me, on some points, eg. :
- what does the "shell" argument do on windows, exactly ? The beginning
of the description states that nothing changes (createProcess() is used
in any way), but later "COMSPEC" and "shell" are quoted, and their
effect is unclear on windows...  
-"If cwd is not None, the child’s current directory will be changed to
cwd before it is executed. Note that this directory is not considered
when searching the executable, so you can’t specify the program’s path
relative to cwd." -> maybe we should precise that only the "executable"
argument is concerned, not the 'executable' program name which might be
given as first item in "args" argument (and which is, on the contrary,
searched relatively to "cwd" argument)
-for the "bufsize" argument, it would be handy to precise which buffer
size is set (of which file descriptors exactly ? Of Pipes only ?)

Regards, 
P. Chambon
msg89856 - (view) Author: Tim Golden (tim.golden) * (Python committer) Date: 2009-06-29 16:07
Attached is a patch against r73685 of the documentation for subprocess
which adds some information about using shell=True on Windows. I plan
to do some more general-purpose docs for subprocess on Windows, but as 
I've failed to get round to them for a year or so, let's get this small
change in at least!
msg89934 - (view) Author: Georg Brandl (georg.brandl) * (Python committer) Date: 2009-06-30 16:17
Thanks, committed in r73705.
History
Date User Action Args
2009-06-30 16:17:37georg.brandlsetstatus: open -> closed
resolution: accepted
messages: + msg89934
2009-06-29 16:07:16tim.goldensetfiles: + doc-subprocess.patch

nosy: + tim.golden
messages: + msg89856

keywords: + patch
2009-06-29 15:47:36pakalcreate