Process.wait hangs with too much output on Stdout

You mean you redirect stdout of the child process to a pipe, then don't read the pipe, and simply wait for the child to exit? If this is the case, what's happening is the child is filling up the kernel buffer for the pipe, and cannot write any more data. Since the parent isn't reading, you have deadlock.

If this is the case, then I don't think it warrants any changes, documentation or otherwise. I don't think Tango needs to encompass all aspects of programming. When redirecting output, one is expected to know that using pipes requires that you read what the other side is writing to avoid deadlock (this is basic producer/consumer 101). A good place for this may be a tutorial, but it's such a fundamental requirement, I don't think it belongs in the documentation.

If this is a different issue, let me know.

Yeah, that's probably it. I believe the pipe is read afterwards. I may remember wrong, but I think that is what the main example used to do in the past. Thanks for the clarification.