[Python-checkins] r81655 - in python/branches/release31-maint: Doc/library/subprocess.rst

antoine.pitrou python-checkins at python.org
Wed Jun 2 19:11:32 CEST 2010


Author: antoine.pitrou
Date: Wed Jun  2 19:11:32 2010
New Revision: 81655

Log:
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.
  ........
................


Modified:
   python/branches/release31-maint/   (props changed)
   python/branches/release31-maint/Doc/library/subprocess.rst

Modified: python/branches/release31-maint/Doc/library/subprocess.rst
==============================================================================
--- python/branches/release31-maint/Doc/library/subprocess.rst	(original)
+++ python/branches/release31-maint/Doc/library/subprocess.rst	Wed Jun  2 19:11:32 2010
@@ -88,6 +88,12 @@
    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,


More information about the Python-checkins mailing list