(original) (raw)

changeset: 86891:2924a63aab73 branch: 3.3 parent: 86887:c574951deadd user: Tim Golden mail@timgolden.me.uk date: Sun Nov 03 18:24:50 2013 +0000 files: Doc/library/subprocess.rst description: Issue #10197: Indicate availability of subprocess.get[status]output on Windows and add a note about the effects of universal newlines diff -r c574951deadd -r 2924a63aab73 Doc/library/subprocess.rst --- a/Doc/library/subprocess.rst Sun Nov 03 12:23:23 2013 -0500 +++ b/Doc/library/subprocess.rst Sun Nov 03 18:24:50 2013 +0000 @@ -1050,10 +1050,12 @@ Return ``(status, output)`` of executing *cmd* in a shell. - Execute the string *cmd* in a shell with :func:`os.popen` and return a 2-tuple - ``(status, output)``. *cmd* is actually run as ``{ cmd ; } 2>&1``, so that the - returned output will contain output or error messages. A trailing newline is - stripped from the output. The exit status for the command can be interpreted + Execute the string *cmd* in a shell with :class:`Popen` and return a 2-tuple + ``(status, output)`` via :func:`Popen.communicate`. Universal newlines mode + is used; see the notes on :ref:`frequently-used-arguments` for more details. + + A trailing newline is stripped from the output. + The exit status for the command can be interpreted according to the rules for the C function :c:func:`wait`. Example:: >>> subprocess.getstatusoutput('ls /bin/ls') @@ -1063,7 +1065,8 @@ >>> subprocess.getstatusoutput('/bin/junk') (256, 'sh: /bin/junk: not found') - Availability: UNIX. + .. versionchanged:: 3.3 + Availability: Unix & Windows .. function:: getoutput(cmd) @@ -1076,7 +1079,8 @@ >>> subprocess.getoutput('ls /bin/ls') '/bin/ls' - Availability: UNIX. + .. versionchanged:: 3.3 + Availability: Unix & Windows Notes /mail@timgolden.me.uk