From: Chris G <redmine@...>
Date: 2009-09-20T08:37:23+09:00
Subject: [ruby-core:25658] [Bug #2125] Open.popen3 documentation has a small bug

Bug #2125: Open.popen3 documentation has a small bug
http://redmine.ruby-lang.org/issues/show/2125

Author: Chris G
Status: Open, Priority: Low
Category: lib
ruby -v: ruby 1.8.7 (2008-08-11 patchlevel 72) [i486-linux]

This documentation has a small glitch:
  http://www.ruby-doc.org/stdlib/libdoc/open3/rdoc/classes/Open3.html

The example in the docs for the module itself is valid: 

  stdin, stdout, stderr = popen3('nroff -man')

But the example in the method docs is not:
  [stdin, stdout, stderr] = Open3.popen3(cmd)

Those []'s are mad mojo, man...

Also, it would probably be good to mention that popen3 is like system in that you can pass extra parameters, and the strings won't be mangled by shell expansion. eg:

  stdin, stdout, stderr = Open3.popen3('identify' '/weird path/with spaces/and "strange" characters.jpg')
  result = stdout.read


----------------------------------------
http://redmine.ruby-lang.org