From 454de1d5eb178ae71397702702fbda4996196f65 Mon Sep 17 00:00:00 2001 From: akr Date: Wed, 3 Aug 2011 12:18:50 +0000 Subject: update doc. git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@32827 b2dd03c8-39d4-4d8f-98ff-823fe69b080e --- lib/open3.rb | 9 +++++++++ 1 file changed, 9 insertions(+) (limited to 'lib/open3.rb') diff --git a/lib/open3.rb b/lib/open3.rb index 03a7937c09..7f68d706e9 100644 --- a/lib/open3.rb +++ b/lib/open3.rb @@ -70,6 +70,15 @@ module Open3 # # Closing stdin, stdout and stderr does not wait the process. # + # You should be careful to avoid deadlocks. + # Since pipes are fixed length buffer, + # Open3.popen3("prog") {|i, o, e, t| o.read } deadlocks if + # the program generates many output on stderr. + # You should be read stdout and stderr simultaneously (using thread or IO.select). + # However if you don't need stderr output, Open3.popen2 can be used. + # If merged stdout and stderr output is not a problem, you can use Open3.popen2e. + # If you really needs stdout and stderr output as separate strings, you can consider Open3.capture3. + # def popen3(*cmd, &block) if Hash === cmd.last opts = cmd.pop.dup -- cgit v1.2.3