summaryrefslogtreecommitdiffstats
path: root/Doc/library/subprocess.rst
diff options
context:
space:
mode:
authorAntoine Pitrou <solipsis@pitrou.net>2010-06-02 17:11:32 (GMT)
committerAntoine Pitrou <solipsis@pitrou.net>2010-06-02 17:11:32 (GMT)
commit5050bb2e50f4035040380489c2e1d16cd59d51fa (patch)
treec209f6f60e93b9f7fe4691746c81e815a713b46d /Doc/library/subprocess.rst
parentaa47f0ead8a88e66f774e56623d17dc55146197e (diff)
downloadcpython-5050bb2e50f4035040380489c2e1d16cd59d51fa.zip
cpython-5050bb2e50f4035040380489c2e1d16cd59d51fa.tar.gz
cpython-5050bb2e50f4035040380489c2e1d16cd59d51fa.tar.bz2
Merged revisions 81654 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k ................ r81654 | antoine.pitrou | 2010-06-02 19:10:49 +0200 (mer., 02 juin 2010) | 10 lines Merged revisions 81652 via svnmerge from svn+ssh://pythondev@svn.python.org/python/trunk ........ r81652 | antoine.pitrou | 2010-06-02 19:08:47 +0200 (mer., 02 juin 2010) | 4 lines Issue #8873: add a documentation note about possible performance issues with the default of unbuffered IO in subprocess.Popen. ........ ................
Diffstat (limited to 'Doc/library/subprocess.rst')
-rw-r--r--Doc/library/subprocess.rst6
1 files changed, 6 insertions, 0 deletions
diff --git a/Doc/library/subprocess.rst b/Doc/library/subprocess.rst
index 834ec58..2c39551 100644
--- a/Doc/library/subprocess.rst
+++ b/Doc/library/subprocess.rst
@@ -88,6 +88,12 @@ This module defines one class called :class:`Popen`:
size. A negative *bufsize* means to use the system default, which usually means
fully buffered. The default value for *bufsize* is :const:`0` (unbuffered).
+ .. note::
+
+ If you experience performance issues, it is recommended that you try to
+ enable buffering by setting *bufsize* to either -1 or a large enough
+ positive value (such as 4096).
+
The *executable* argument specifies the program to execute. It is very seldom
needed: Usually, the program to execute is defined by the *args* argument. If
``shell=True``, the *executable* argument specifies which shell to use. On Unix,