summaryrefslogtreecommitdiff
path: root/lib
diff options
context:
space:
mode:
Diffstat (limited to 'lib')
-rw-r--r--lib/open3.rb8
1 files changed, 7 insertions, 1 deletions
diff --git a/lib/open3.rb b/lib/open3.rb
index c4dacc9473..fca0257cdd 100644
--- a/lib/open3.rb
+++ b/lib/open3.rb
@@ -33,7 +33,7 @@ module Open3
#
# require 'open3'
#
- # [stdin, stdout, stderr] = Open3.popen3(cmd)
+ # stdin, stdout, stderr = Open3.popen3(cmd)
#
# Block form:
#
@@ -43,6 +43,12 @@ module Open3
#
# The parameter +cmd+ is passed directly to Kernel#exec.
#
+ # _popen3_ is like _system_ in that you can pass extra parameters, and the
+ # strings won't be mangled by shell expansion.
+ #
+ # stdin, stdout, stderr = Open3.popen3('identify', '/weird path/with spaces/and "strange" characters.jpg')
+ # result = stdout.read
+ #
def popen3(*cmd)
pw = IO::pipe # pipe[0] for read, pipe[1] for write
pr = IO::pipe