[Python-checkins] r76641 - in python/branches/py3k: Doc/library/subprocess.rst

[philip.jenvey]

Author: philip.jenvey
Date: Thu Dec  3 03:29:36 2009
New Revision: 76641

Log:
Merged revisions 76640 via svnmerge from 
svn+ssh://pythondev@svn.python.org/python/trunk

........
  r76640 | philip.jenvey | 2009-12-02 18:25:54 -0800 (Wed, 02 Dec 2009) | 2 lines
  
  #7177: clarify the potential PIPE deadlock warnings
........


Modified:
   python/branches/py3k/   (props changed)
   python/branches/py3k/Doc/library/subprocess.rst

Modified: python/branches/py3k/Doc/library/subprocess.rst
==============================================================================
--- python/branches/py3k/Doc/library/subprocess.rst	(original)
+++ python/branches/py3k/Doc/library/subprocess.rst	Thu Dec  3 03:29:36 2009
@@ -161,9 +161,10 @@
 
    .. warning::
 
-      Like :meth:`Popen.wait`, this will deadlock if the child process
-      generates enough output to a stdout or stderr pipe such that it blocks
-      waiting for the OS pipe buffer to accept more data.
+      Like :meth:`Popen.wait`, this will deadlock when using
+      ``stdout=PIPE`` and/or ``stderr=PIPE`` and the child process
+      generates enough output to a pipe such that it blocks waiting
+      for the OS pipe buffer to accept more data.
 
 
 .. function:: check_call(*popenargs, **kwargs)
@@ -286,9 +287,10 @@
 
    .. warning::
 
-      This will deadlock if the child process generates enough output to a
-      stdout or stderr pipe such that it blocks waiting for the OS pipe buffer
-      to accept more data.  Use :meth:`communicate` to avoid that.
+      This will deadlock when using ``stdout=PIPE`` and/or
+      ``stderr=PIPE`` and the child process generates enough output to
+      a pipe such that it blocks waiting for the OS pipe buffer to
+      accept more data.  Use :meth:`communicate` to avoid that.
 
 
 .. method:: Popen.communicate(input=None)