rio 0.3.7 → 0.3.8

data/README

@@ -1,4 +1,4 @@
-Copyright (c) 2005, Christopher Kleckner
+Copyright (c) 2005, 2006 Christopher Kleckner
 All rights reserved
 
 This file is part of the Rio library for ruby.
@@ -27,7 +27,7 @@ Rio is a convenience class wrapping much of the functionality of
 IO, File, Dir, Pathname, FileUtils, Tempfile, StringIO, OpenURI, Zlib, and CSV.
 
 To create the documentation for Rio run the command
-  ruby RUNME.1st.rb
+  ruby build_doc.rb
 from  the distribution directory.
 
 Then point your browser at the 'doc/rdoc' directory.

data/Rakefile

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005, Christopher Kleckner
+# Copyright (c) 2005, 2006 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.
@@ -21,7 +21,7 @@
 # =============================================================================== 
 #
 # To create the documentation for Rio run the command
-#   rake rdoc
+#   ruby build_doc.rb
 # from the distribution directory.
 #++
 
@@ -42,7 +42,7 @@ $:.push 'lib'
 require 'rio/version'
 require 'rio/doc'
 
-SVN_REPOSITORY_URL = 'file:///loc/svn/'
+SVN_REPOSITORY_URL = ''
  
 SRC_FILES = FileList['lib/**/*.rb']
 DOC_FILES = FileList['README','lib/rio.rb','lib/rio/doc/*.rb',
@@ -52,11 +52,11 @@ XMP_FILES = FileList['ex/*']
 module PKG
   NAME = "rio"
   TITLE = RIO::TITLE
-  VERSION = '0.3.7'
+  VERSION = RIO::VERSION
   FULLNAME = PKG::NAME + "-" + PKG::VERSION
   SUMMARY = RIO::SUMMARY
   DESCRIPTION = RIO::DESCRIPTION
-  FILES = FileList.new(['setup.rb', 'RUNME.1st.rb', 'COPYING', 'Rakefile', 'ChangeLog', 'VERSION', 
+  FILES = FileList.new(['setup.rb', 'build_doc.rb', 'COPYING', 'Rakefile', 'ChangeLog', 'VERSION', 
                         'test/**/*.rb','doc/**/*'] + SRC_FILES.to_a + DOC_FILES.to_a + XMP_FILES.to_a
                        ) do |fl|
     fl.exclude( /\bsvn\b/ )

data/VERSION

@@ -1 +1 @@
-0.3.7
+0.3.8

data/{RUNME.1st.rb → build_doc.rb}

@@ -1,7 +1,7 @@
 #!/usr/bin/env ruby
 #--
 # =============================================================================== 
-# Copyright (c) 2005, Christopher Kleckner
+# Copyright (c) 2005, 2006 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.
@@ -22,18 +22,10 @@
 # =============================================================================== 
 #
 # To create the documentation for Rio run the command
-#   rake rdoc
+#   ruby build_doc.rb
 # from the distribution directory.
 #++
 
-# It is not really necessary to run this first. 
-# It simply builds the Rio RDoc documentation, and is provided 
-# to support those who have not installed +rake+ and to demonstrate Rio. 
-# The preferred method of building the documentation is
-#   rake rdoc
-# 
-
-
 $:.unshift 'lib'
 require 'rio'
 
@@ -61,6 +53,8 @@ rdoc_files = [
 
 cmd = sprintf("rdoc %s %s",RDOC_OPTIONS.join(' '),rdoc_files.join(' '))
 
+rio(?-,cmd) > ?-
+
 docindex = (rdoc_dir/'index.html').abs.to_url
 msg = "Please point your browser at '#{docindex}'" 
 lin =  ">" + ">" * (msg.length+2) + ">"

data/doc/ANNOUNCE

@@ -1,33 +1,43 @@
-Piping Hot -- Rio 0.3.7
+Rio 0.3.8
 
 == Overview
 
 Rio is a Ruby I/O convenience class wrapping much of the functionality
 of IO, File and Dir. Rio also uses FileUtils, Tempfile, StringIO,
-OpenURI, Zlib, and CSV to provide similar functionality using a simple
-consistent interface. In addition to forwarding the interfaces
-provided by IO, File, and Dir to an appropriate object, Rio provides a
-"grande" interface that allows many common application-level I/O and
-file-system tasks to be expressed succinctly.
+OpenURI, Net::FTP, Zlib, and CSV to provide similar functionality
+using a simple consistent interface. In addition to forwarding the
+interfaces provided by IO, File, and Dir to an appropriate object, Rio
+provides a "grande" interface that allows many common application
+level I/O and file-system tasks to be expressed succinctly.
 
 == New
 
-Support for Pipe operator
- # Pipe multiple commands
- rio('afile') | rio(?-,'acmd') | 'another_cmd' | ?-
+Enhanced support for FTP file-systems. All of Rio's most powerful
+idioms are now supported seamlessly on FTP servers.
+
+ # copy a file from or to an FTP server
+ rio('ftp://ahost/adir/afile') > rio('localfile') # server -> local file
+ rio('ftp://ahost/adir/afile') < rio('localfile') # local file -> server
+
+ # copy an entire directory structure from or to an FTP server
+ rio('ftp://ahost/adir') > rio('localdir') # server -> local directory
+ rio('ftp://ahost/adir') < rio('localdir') # local directory -> server
+
+All of Rio's grande selection and filtering options are available for
+files and directories on FTP servers.
+
+ # create a gzipped copy of a web page on an ftp server
+ rio('ftp://ftphost/f.html.gz').gzip < rio('http://httphost/f.html')
+
+ # dump the first 10 lines of a gzipped log file on an FTP server to stdout
+ rio('ftp://ftphost/logfile.txt').lines(0...10) > ?-
 
- # run the same series of commands, with different input and/or output
- cmdpipe = rio(?-,'acmd') | rio(?-,'another_cmd')
- rio('infile1') | cmdpipe | rio('outfile1')
- rio('infile2') | cmdpipe | rio('outfile2')
+ # iterate through the entries of a directory on an FTP server
+ rio('ftp://ftphost/adir').entries { |entrio| ... }
 
- cmdpipe2 = rio(?|,'cmd1','cmd2','outfile')   # create a cmdpipe Rio
- rio('infile1') | cmdpipe2       # run with input coming from a file
- rio(?-) | cmdpipe2              # same commands with input from stdin
+ # get an array of all .rb files on an ftp server
+ rb_files = rio('ftp://ftphost/').all.files['*.rb']
 
-Improved support for MS Windows path specifications
- rio('D:/adir/afile')
- rio('//ahost/adir/afile')
 
 == SYNOPSIS
 
@@ -135,75 +145,18 @@ Create a tab separated file of accounts in a UNIX passwd file,
 listing only the username, uid, and realname fields
  rio('/etc/passwd').csv(':').columns(0,2,4) > rio('rpt').csv("\t")
 
-== New for version 0.3.4
-
-* New Grande Selection parameter.
-
-  A major weakness of Rio's selection methods (lines, files, etc.)
-  has always been that it only implemented a logical OR.
-
-   rio('afile').lines(0..10,/Rio/) {...}
-  iterates through lines that are in the range 0..10 OR 
-  contain 'Rio'.
-
-   rio('adir').files(:executable?,'*.rb') {...}
-  iterates through files that are executable OR match '*.rb'
-
-  Selecting files that matched both required using a proc.
-   rio('adir').files(proc{ |f| f.executable? and f.fnmatch?('*.rb')}) {...}
-
-  Rio's grande selection methods will now accept an array of conditions
-  which must all be matched, in order to be selected. A logical AND.
-
-   rio('adir').files([:executable?,'*.rb']) {...}
-  
-  The array, of course, need not be the only paramter. 
-
-   rio('adir').files('*.exe',[:executable?,'*.rb']) {...}
-
-  selects .exe files and .rb files that are executable.
-
-* Renamed some of grande rejection methods. 
-  (based on a suggestion by Gavin Sinclair)
-   nolines => skiplines
-   nofiles => skipfiles
-  etc.
-
-* New skip() grande method
-   rio('afile').skip.lines(/Rio/)       # same as skiplines(/Rio/)
-   rio('afile').lines(/Rio/).skip(0..9) # lines with 'Rio', exclude 
-                                        # the first ten lines
-
-* Alternative syntaxes for creating Rios that have no path.
-   rio(?-)          # create a Rio refering to stdio
-   rio(:stdio)      # same thing.
-   rio.stdio        # same thing
-   RIO.stdio        # ditto
-   RIO::Rio.stdio   # once again
-
-* From Pathname added
-  * root?
-  * mountpoint?
-  * realpath
-  * cleanpath
-
-* Removed Rio#slurp in favor of Rio#contents.
+Pipe multiple commands
+ rio('afile') | rio(?-,'acmd') | 'another_cmd' | ?-
 
-* Added aliases for the copy operators. (suggested by Dave Burt)
-   * copy_to >
-   * append_to >>
-   * copy_from <
-   * append_from <<
+== Contact
 
-* Bug fixes and corrections    
-  
 Project:: http://rubyforge.org/projects/rio/
 Documentation:: http://rio.rubyforge.org/
 Bugs:: http://rubyforge.org/tracker/?group_id=821
 Email:: rio4ruby@rubyforge.org
 
 == Copyright
-Copyright (c) 2005, Christopher Kleckner. All rights reserved
+Copyright (c) 2005, 2006 Christopher Kleckner. All rights reserved
 
 == License
 Rio is released under the GNU General Public License

data/doc/RELEASE_NOTES

@@ -9,7 +9,7 @@ Rio is a convenience class wrapping much of the functionality of
 IO, File, Dir, Pathname, FileUtils, Tempfile, StringIO, OpenURI, Zlib, and CSV.
 
 To create the documentation for Rio run the command
-  ruby RUNME.1st.rb
+  ruby build_doc.rb
 from the distribution directory.
 
 Then point your browser at the 'doc/rdoc' directory.
@@ -20,6 +20,36 @@ Suggested Reading
 * RIO::Doc::HOWTO
 * RIO::Rio
 
+== New for version 0.3.8
+* Enhanced support for FTP file-systems. All of Rio's most powerful
+  idioms are now supported seamlessly on FTP servers.
+
+   # copy a file from or to an FTP server
+   rio('ftp://ahost/adir/afile') > rio('localfile') # server -> local file
+   rio('ftp://ahost/adir/afile') < rio('localfile') # local file -> server
+
+   # copy an entire directory structure from or to an FTP server
+   rio('ftp://ahost/adir') > rio('localdir') # server -> local directory
+   rio('ftp://ahost/adir') < rio('localdir') # local directory -> server
+
+  All of Rio's grande selection and filtering options are available for
+  files and directories on FTP servers.
+
+   # create a gzipped copy of a web page on an ftp server
+   rio('ftp://ftphost/f.html.gz').gzip < rio('http://httphost/f.html')
+
+   # dump the first 10 lines of a gzipped log file on an FTP server to stdout
+   rio('ftp://ftphost/logfile.txt').lines(0...10) > ?-
+
+   # iterate through the entries of a directory on an FTP server
+   rio('ftp://ftphost/adir').entries { |entrio| ... }
+
+   # get an array of all .rb files on an ftp server
+   rb_files = rio('ftp://ftphost/').all.files['*.rb']
+
+* More tests
+* Bug fixes
+
 == Version 0.3.7
 * Maintenance release
 

data/doc/generators/template/html/rio.rb

@@ -20,8 +20,8 @@
 #
 
 # Modified by Christopher Kleckner
-# Copyright (c) 2005. Some rights reserved.
-# Licensed under the same terms as the original
+# Copyright (c) 2005,2006. Some rights reserved.
+# Licensed under the same terms as the original.
 
 
 module RDoc
@@ -483,7 +483,7 @@ CONTEXT_CONTENT = %{
 #####################################################################
 FOOTER = %{
 <div id="validator-badges">
-   <p><small>Copyright &copy; 2005 Christopher Kleckner.  <a href="http://www.gnu.org/licenses/gpl.html">All rights reserved</a>.</small></p>
+   <p><small>Copyright &copy; 2005, 2006 Christopher Kleckner.  <a href="http://www.gnu.org/licenses/gpl.html">All rights reserved</a>.</small></p>
 </div>
 
 </body>

data/lib/rio/abstract_method.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005, Christopher Kleckner
+# Copyright (c) 2005, 2006 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.
@@ -22,7 +22,7 @@
 #++
 #
 # To create the documentation for Rio run the command
-#  rake rdoc
+#  ruby build_doc.rb
 # from the distribution directory. Then point your browser at the 'doc/rdoc' directory.
 #
 # Suggested Reading

data/lib/rio/argv.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005, Christopher Kleckner
+# Copyright (c) 2005, 2006 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.
@@ -22,7 +22,7 @@
 #++
 #
 # To create the documentation for Rio run the command
-#  rake rdoc
+#  ruby build_doc.rb
 # from the distribution directory. Then point your browser at the 'doc/rdoc' directory.
 #
 # Suggested Reading

data/lib/rio/arycopy.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005, Christopher Kleckner
+# Copyright (c) 2005, 2006 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.
@@ -22,7 +22,7 @@
 #++
 #
 # To create the documentation for Rio run the command
-#  rake rdoc
+#  ruby build_doc.rb
 # from the distribution directory. Then point your browser at the 'doc/rdoc' directory.
 #
 # Suggested Reading

data/lib/rio/assert.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005, Christopher Kleckner
+# Copyright (c) 2005, 2006 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.
@@ -22,7 +22,7 @@
 #++
 #
 # To create the documentation for Rio run the command
-#  rake rdoc
+#  ruby build_doc.rb
 # from the distribution directory. Then point your browser at the 'doc/rdoc' directory.
 #
 # Suggested Reading

data/lib/rio/base.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005, Christopher Kleckner
+# Copyright (c) 2005, 2006 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.
@@ -22,7 +22,7 @@
 #++
 #
 # To create the documentation for Rio run the command
-#  rake rdoc
+#  ruby build_doc.rb
 # from the distribution directory. Then point your browser at the 'doc/rdoc' directory.
 #
 # Suggested Reading

data/lib/rio/callstr.rb

@@ -0,0 +1,47 @@
+#--
+# =============================================================================== 
+# Copyright (c) 2005, 2006 Christopher Kleckner
+# All rights reserved
+#
+# This file is part of the Rio library for ruby.
+#
+# Rio is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# Rio is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with Rio; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+# =============================================================================== 
+#++
+#
+# To create the documentation for Rio run the command
+#  ruby build_doc.rb
+# from the distribution directory. Then point your browser at the 'doc/rdoc' directory.
+#
+# Suggested Reading
+# * RIO::Doc::SYNOPSIS
+# * RIO::Doc::INTRO
+# * RIO::Doc::HOWTO
+# * RIO::Rio
+#
+# <b>Rio is pre-alpha software. 
+# The documented interface and behavior is subject to change without notice.</b>
+
+
+module RIO
+  module CallStr #:nodoc: all
+    def callstr(func,*args)
+      self.class.to_s+'['+self.to_url+']'+'.'+func.to_s+'('+args.join(',')+')'
+    end
+    def scallstr(func,*args)
+      self.class.to_s+'['+self.to_s+']'+'.'+func.to_s+'('+args.join(',')+')'
+    end
+  end
+end

data/lib/rio/const.rb

@@ -0,0 +1,52 @@
+#--
+# =============================================================================== 
+# Copyright (c) 2005, 2006 Christopher Kleckner
+# All rights reserved
+#
+# This file is part of the Rio library for ruby.
+#
+# Rio is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# Rio is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with Rio; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+# =============================================================================== 
+#++
+#
+# To create the documentation for Rio run the command
+#  ruby build_doc.rb
+# from the distribution directory. Then point your browser at the 'doc/rdoc' directory.
+#
+# Suggested Reading
+# * RIO::Doc::SYNOPSIS
+# * RIO::Doc::INTRO
+# * RIO::Doc::HOWTO
+# * RIO::Rio
+#
+# <b>Rio is pre-alpha software. 
+# The documented interface and behavior is subject to change without notice.</b>
+
+module RIO
+  SEEK_SET = IO::SEEK_SET
+  SEEK_END = IO::SEEK_END
+  SEEK_CUR = IO::SEEK_CUR
+end
+
+if $0 == __FILE__
+  eval DATA.read, nil, $0, __LINE__+4
+end
+
+__END__
+
+puts
+puts("Run the tests that came with the distribution")
+puts("From the distribution directory use 'test/runtests.rb'")
+puts

data/lib/rio/construct.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005, Christopher Kleckner
+# Copyright (c) 2005, 2006 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.
@@ -22,7 +22,7 @@
 #++
 #
 # To create the documentation for Rio run the command
-#  rake rdoc
+#  ruby build_doc.rb
 # from the distribution directory. Then point your browser at the 'doc/rdoc' directory.
 #
 # Suggested Reading
@@ -39,31 +39,13 @@ module RIO
   require 'rio/ops/construct'
   include Ops::Construct
 
-  module_function :strio
-  module_function :stdio
-  module_function :stderr
-  module_function :temp
-  module_function :tempfile
-  module_function :tempdir
-  module_function :tcp
-  module_function :cmdio
-  module_function :cmdpipe
-  module_function :sysio
-  module_function :fd
+  module_function(*RIO::CONSTRUCTOR_SYMS)
 end
 
 module RIO
   class Rio
-    def self.strio(*args,&block) rio(:strio,*args,&block) end
-    def self.stdio(*args,&block) rio(:stdio,*args,&block) end
-    def self.stderr(*args,&block) rio(:stderr,*args,&block) end
-    def self.temp(*args,&block)  rio(:temp,*args,&block)  end
-    def self.tempfile(*args,&block)  rio(:tempfile,*args,&block)  end
-    def self.tempdir(*args,&block)  rio(:tempdir,*args,&block)  end
-    def self.tcp(*args,&block)  rio(:tcp,*args,&block)  end
-    def self.cmdio(*args,&block)  rio(:cmdio,*args,&block)  end
-    def self.cmdpipe(*args,&block)  rio(:cmdpipe,*args,&block)  end
-    def self.sysio(*args,&block)  rio(:sysio,*args,&block)  end
-    def self.fd(*args,&block)  rio(:fd,*args,&block)  end
+    RIO::CONSTRUCTOR_SYMS.each { |sym|
+      class_eval "def self.#{sym}(*args,&block) self.rio(:#{sym},*args,&block) end"
+    }
   end
 end

data/lib/rio/constructor.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005, Christopher Kleckner
+# Copyright (c) 2005, 2006 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.
@@ -22,7 +22,7 @@
 #++
 #
 # To create the documentation for Rio run the command
-#  rake rdoc
+#  ruby build_doc.rb
 # from the distribution directory. Then point your browser at the 'doc/rdoc' directory.
 #
 # Suggested Reading
@@ -198,6 +198,16 @@ module RIO
   #
   # This is Rio's interface to IO#popen
   #
+  # ===== Creating a Rio that acts like /dev/null
+  #
+  # <tt>rio(nil)</tt>
+  #
+  # <tt>rio(:null)</tt>
+  #
+  # This rio behaves like the Unix file /dev/null, but does depend on it -
+  # and thus will work on non-Unix systems. Reading behaves as if reading from
+  # an empty file, and writing to it discards anything written.
+  #
   # ===== Creating a Rio Pipe
   #
   # A Rio Pipe is a sequence of Rios that are run with the output of each being

data/lib/rio/context/autoclose.rb

@@ -0,0 +1,73 @@
+#--
+# =============================================================================== 
+# Copyright (c) 2005, 2006 Christopher Kleckner
+# All rights reserved
+#
+# This file is part of the Rio library for ruby.
+#
+# Rio is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# Rio is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with Rio; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+# =============================================================================== 
+#++
+#
+# To create the documentation for Rio run the command
+#  ruby build_doc.rb
+# from the distribution directory. Then point your browser at the 'doc/rdoc' directory.
+#
+# Suggested Reading
+# * RIO::Doc::SYNOPSIS
+# * RIO::Doc::INTRO
+# * RIO::Doc::HOWTO
+# * RIO::Rio
+#
+# <b>Rio is pre-alpha software. 
+# The documented interface and behavior is subject to change without notice.</b>
+
+
+require 'rio/context/cxx.rb'
+
+module RIO  
+  module Cx
+    module Methods
+      def closeoneof(arg=true,&block) cxx('closeoneof',arg,&block) end
+      def nocloseoneof(arg=false,&block) nocxx('closeoneof',arg,&block) end
+      def closeoneof?() cxx?('closeoneof') end 
+      def closeoneof_(arg=true)  cxx_('closeoneof',arg) end
+      protected :closeoneof_
+    end
+  end
+
+  module Cx
+    module Methods
+      def closeoncopy(arg=true,&block) cxx('closeoncopy',arg,&block) end
+      def nocloseoncopy(arg=false,&block) nocxx('closeoncopy',arg,&block) end
+      def closeoncopy?() cxx?('closeoncopy') end 
+      def closeoncopy_(arg=true)  cxx_('closeoncopy',arg) end
+      protected :closeoncopy_
+    end
+  end
+
+  module Cx
+    module Methods
+      def noautoclose(arg=false,&block)
+        closeoncopy(arg).closeoneof(arg,&block)
+      end
+      def noautoclose_(arg=false)
+        closeoncopy_(arg).closeoneof_(arg)
+      end
+      protected :noautoclose_
+    end
+  end
+
+end

data/lib/rio/context/copying.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005, Christopher Kleckner
+# Copyright (c) 2005, 2006 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.
@@ -22,7 +22,7 @@
 #++
 #
 # To create the documentation for Rio run the command
-#  rake rdoc
+#  ruby build_doc.rb
 # from the distribution directory. Then point your browser at the 'doc/rdoc' directory.
 #
 # Suggested Reading