rio 0.4.1 → 0.4.2

data/lib/rio/ext/yaml.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005,2006,2007 Christopher Kleckner
+# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.

data/lib/rio/ext/yaml/doc.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005,2006,2007 Christopher Kleckner
+# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.

data/lib/rio/ext/yaml/tie.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005,2006,2007 Christopher Kleckner
+# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.

data/lib/rio/ext/zipfile.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005,2006,2007 Christopher Kleckner
+# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.

data/lib/rio/ext/zipfile/fs.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005,2006,2007 Christopher Kleckner
+# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.

data/lib/rio/ext/zipfile/rl.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005,2006,2007 Christopher Kleckner
+# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.

data/lib/rio/ext/zipfile/rootdir.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005,2006,2007 Christopher Kleckner
+# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.

data/lib/rio/ext/zipfile/state.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005,2006,2007 Christopher Kleckner
+# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.

data/lib/rio/ext/zipfile/wrap.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005,2006,2007 Christopher Kleckner
+# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.

data/lib/rio/factory.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005,2006,2007 Christopher Kleckner
+# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.

data/lib/rio/file.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005,2006,2007 Christopher Kleckner
+# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.

data/lib/rio/filter.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005,2006,2007 Christopher Kleckner
+# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.

data/lib/rio/filter/closeoneof.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005,2006,2007 Christopher Kleckner
+# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.

data/lib/rio/filter/gzip.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005,2006,2007 Christopher Kleckner
+# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.

data/lib/rio/fs/base.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005,2006,2007 Christopher Kleckner
+# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.

data/lib/rio/fs/impl.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005,2006,2007 Christopher Kleckner
+# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.

data/lib/rio/fs/native.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005,2006,2007 Christopher Kleckner
+# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.

data/lib/rio/fs/stream.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005,2006,2007 Christopher Kleckner
+# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.

data/lib/rio/fs/url.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005,2006,2007 Christopher Kleckner
+# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.

data/lib/rio/ftp/conncache.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005,2006,2007 Christopher Kleckner
+# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.

data/lib/rio/ftp/dir.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005,2006,2007 Christopher Kleckner
+# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.

data/lib/rio/ftp/fs.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005,2006,2007 Christopher Kleckner
+# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.

data/lib/rio/grande.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005,2006,2007 Christopher Kleckner
+# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.

data/lib/rio/handle.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005,2006,2007 Christopher Kleckner
+# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.

data/lib/rio/if.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005,2006,2007 Christopher Kleckner
+# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.

data/lib/rio/if/basic.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005,2006,2007 Christopher Kleckner
+# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.

data/lib/rio/if/csv.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005,2006,2007 Christopher Kleckner
+# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.

data/lib/rio/if/dir.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005,2006,2007 Christopher Kleckner
+# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.

data/lib/rio/if/file.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005,2006,2007 Christopher Kleckner
+# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.

data/lib/rio/if/fileordir.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005,2006,2007 Christopher Kleckner
+# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.

data/lib/rio/if/grande.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005,2006,2007 Christopher Kleckner
+# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.
@@ -128,11 +128,11 @@ module RIO
       # * Files and directories are returned as Rios
       # * The types of entries is also affected by IF::GrandeEntry#files and IF::GrandeEntry#dirs.
       #    rio('adir').files['*.txt'] # array of all .txt files
-      #    rio('adir').dirs(/^\./) # array of all dot directories
+      #    rio('adir').dirs[/^\./] # array of all dot directories
       # * Recursion is enabled using IF::GrandeEntry#all
       #    rio('adir').all.files['*.[ch]'] # array of c source files in adir and its subdirecories
       #    rio('adir').all.dirs[/^\.svn/]  # array of subversion directories in adir and subdirectories
-      # * IF::GrandeEntry#files and IF::GrandeEntry#dirs act independetly of each other. 
+      # * IF::GrandeEntry#files and IF::GrandeEntry#dirs act independently of each other. 
       #   Specifying both will cause both to be returned. 
       #   The argument list to IF::Grande#[] will be applied to the closest.
       #    rio('adir').files('*.rb').dirs['ruby*'] # array of .rb files and 
@@ -329,9 +329,12 @@ module RIO
       #
       def delete() target.delete(); self end
 
+      # See IF::Grande#delete
+      def unlink() target.unlink(); self end
+
       # For a file IF::Grande#delete! calls FileUtils#rm. 
-      # For a directory IF::Grande#delete! calls FileUtils#rmtree
-      # Returns the Rio. If the rio does not exist, simply return itself.
+      # For a directory IF::Grande#delete! calls FileUtils#rmtree.
+      # Returns the Rio. If the rio does not exist, simply returns itself.
       #
       #  rio('afile,txt').delete! # delete f.txt
       #  rio('adir').delete! # delete adir
@@ -346,7 +349,7 @@ module RIO
       # * To delete anything except a populated directory use IF::Grande#delete
       # * To delete anything use IF::Grande#delete!
       #
-      # In all cases, deleting something that does not exist is considered successful
+      # In all cases, deleting something that does not exist is considered successful.
       #
       def delete!() target.delete!(); self end
 
@@ -426,8 +429,9 @@ module RIO
 
       # Grande Pipe Operator
       # 
-      # The Rio pipe operator is actually an alternative syntax for calling the copy-to operator, designed to 
-      # allow several copy operation to be performed in one line of code, with behaviour that mimics
+      # The Rio pipe operator is actually an alternative syntax for calling the IF::Grande#> (copy-to) 
+      # operator, designed to 
+      # allow several copy operation to be performed in one line of code, with behavior that mimics
       # the pipe operator commonly available in shells.
       #
       # If +destination+ is a +cmdio+, a <tt>cmdpipe</tt> Rio is returned, and none of the commands are run.
@@ -528,7 +532,7 @@ module RIO
       # For example the code:
       #
       #  destination < source
-      #  # is like
+      # is like
       #  source.each { |element| destination << element }
       #
       # for any of the following definitions of src and dst
@@ -630,6 +634,9 @@ module RIO
       # 
       # +skip+ can be used in two ways.
       #
+      #
+      # ==== skip with no arguments
+      #
       # If called with no arguments it reverses the polarity of the
       # next non-skip grande selection method that is called. That is,
       # it turns +lines+, +records+, +rows+, +files+, +dirs+ and +entries+
@@ -643,6 +650,8 @@ module RIO
       # used more than once. If no grande selection method is seen, +skip+ is
       # ignored.
       #
+      # ==== skip with arguments
+      #
       # When called with arguments it acts like IF::GrandeEntry#skipentries for directory 
       # Rios and like IF::GrandeStream#skiprecords for stream Rios.
       #
@@ -674,7 +683,7 @@ module RIO
       # IF::Grande#split has two distinct behaviors depending on 
       # whether or not it is called with an argument.
       #
-      # ==== split-with-no-aruments:
+      # ==== split with no aruments:
       #
       # Returns an array of Rios, one for each path element. 
       # (Note that this behavior differs from File#split.)
@@ -693,7 +702,7 @@ module RIO
       #
       # See also IF::Path#join, IF::Path#/, IF::Path#splitpath
       #
-      # ==== split-with-an-argument:
+      # ==== split with an argument:
       #
       # This causes String#split(arg) to be called on every line
       # before it is returned. An array of the split lines is

data/lib/rio/if/grande_entry.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005,2006,2007 Christopher Kleckner
+# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.
@@ -40,7 +40,7 @@ module RIO
       # Grande Directory Selection Method 
       #
       # Sets the rio to return directories. _args_ can be used to select which directories are returned.
-      #  ario.files(*args) do |f|
+      #  ario.dirs(*args) do |f|
       #    f.directory?      #=> true
       #  end
       #

data/lib/rio/if/grande_stream.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005,2006,2007 Christopher Kleckner
+# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.

data/lib/rio/if/internal.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005,2006,2007 Christopher Kleckner
+# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.

data/lib/rio/if/path.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005,2006,2007 Christopher Kleckner
+# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.

data/lib/rio/if/rubyio.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005,2006,2007 Christopher Kleckner
+# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.
@@ -118,9 +118,9 @@ module RIO
       #
       #  anarray = rio('afile').lines[0..1] # anarray == ["L0\n", "L1\n"]
       #
-      # +recno+ counts the number of times IF::Grande#getrec or IF::Grande#each is used to get a record. 
+      # +recno+ counts the number of times IF::GrandeStream#getrec or IF::Grande#each is used to get a record. 
       # so +recno+ will only concern parts of the file read with grande methods 
-      # IF::Grande#each, IF::Grande#[], IF::Grande#getrec 
+      # IF::Grande#each, IF::Grande#[], IF::GrandeStream#getrec 
       # 
       # See also IF::RubyIO#lineno
       def recno() target.recno() end

data/lib/rio/if/string.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005,2006,2007 Christopher Kleckner
+# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.

data/lib/rio/if/temp.rb

@@ -1,6 +1,6 @@
 #--
 # =============================================================================== 
-# Copyright (c) 2005,2006,2007 Christopher Kleckner
+# Copyright (c) 2005,2006,2007,2008 Christopher Kleckner
 # All rights reserved
 #
 # This file is part of the Rio library for ruby.