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)