Please include a hint in the documentation of popen3
that it can produce a dead lock.

Example:

The subprocess writes a lot of data to stderr and
blocks and your application reads from stdout. It
might result in a dead lock

An other explanation to this can be found here:
http://mail.python.org/pipermail/python-dev/2000-September/009460.html

Unfortunately popen3 is documented twice. Would be nice
if there is a
hint to deadlocks at both places. I am programming
quite long and I
lost hours debugging why this happens sometimes and
sometimes not. (It
only happens if you have a lot of output)

In the documentation of Perl there is a hint
to this problem, too.

thomas

(I already submitted this feature request to
python-docs@python.org. But received no response)

Logged In: YES 
user_id=3066

Added a section on flow control issues to the documentation
for the popen2 module, with a reference from the
corresponding functions in the os module.

Doc/lib/libos.tex:     1.90, 1.74.2.1.2.5, 1.53.4.9.
Doc/lib/libpopen2.tex: 1.16, 1.15.12.1, 1.13.6.2.

Logged In: YES 
user_id=22123

Thank you very much!