From 6092bb2affd9195dcfe21c44802f26c7a3faae61 Mon Sep 17 00:00:00 2001
From: nobu <nobu@b2dd03c8-39d4-4d8f-98ff-823fe69b080e>
Date: Sun, 20 Sep 2009 00:53:37 +0000
Subject: [PATCH] * lib/open3.rb (Open3#popen3): fixed and improved rdoc. 
 [ruby-core:25658]

git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/branches/ruby_1_8@25009 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
---
 ChangeLog    | 4 ++++
 lib/open3.rb | 8 +++++++-
 version.h    | 6 +++---
 3 files changed, 14 insertions(+), 4 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index a825c92957..fad548123a 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+Sun Sep 20 09:53:35 2009  Nobuyoshi Nakada  <nobu@ruby-lang.org>
+
+	* lib/open3.rb (Open3#popen3): fixed and improved rdoc.  [ruby-core:25658]
+
 Fri Sep 18 14:44:13 2009  NAKAMURA Usaku  <usa@ruby-lang.org>
 
 	* win32/win32.c (rb_w32_select): wait specified time on select.
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
diff --git a/version.h b/version.h
index a46f135f08..9b9de86819 100644
--- a/version.h
+++ b/version.h
@@ -1,7 +1,7 @@
 #define RUBY_VERSION "1.8.8"
-#define RUBY_RELEASE_DATE "2009-09-18"
+#define RUBY_RELEASE_DATE "2009-09-20"
 #define RUBY_VERSION_CODE 188
-#define RUBY_RELEASE_CODE 20090918
+#define RUBY_RELEASE_CODE 20090920
 #define RUBY_PATCHLEVEL -1
 
 #define RUBY_VERSION_MAJOR 1
@@ -9,7 +9,7 @@
 #define RUBY_VERSION_TEENY 8
 #define RUBY_RELEASE_YEAR 2009
 #define RUBY_RELEASE_MONTH 9
-#define RUBY_RELEASE_DAY 18
+#define RUBY_RELEASE_DAY 20
 
 #ifdef RUBY_EXTERN
 RUBY_EXTERN const char ruby_version[];