RubyGems - rio - Versions diffs - 0.3.2 → 0.3.3 - Mend

rio 0.3.2 → 0.3.3

Files changed (248) hide show

data/ChangeLog +49 -0
data/VERSION +1 -1
data/doc/ANNOUNCE +19 -2
data/doc/RELEASE_NOTES +17 -0
data/ex/colx.rb +3 -1
data/ex/passwd_report.rb +12 -0
data/lib/rio.rb +8 -9
data/lib/rio/argv.rb +0 -4
data/lib/rio/base.rb +3 -1
data/lib/rio/doc/INTRO.rb +74 -1
data/lib/rio/ext/csv.rb +34 -5
data/lib/rio/factory.rb +2 -2
data/lib/rio/if.rb +3 -0
data/lib/rio/if/csv.rb +76 -0
data/lib/rio/if/dir.rb +14 -6
data/lib/rio/if/fileordir.rb +6 -0
data/lib/rio/if/grande.rb +28 -0
data/lib/rio/if/internal.rb +75 -2
data/lib/rio/if/methods.rb +4 -3
data/lib/rio/if/string.rb +46 -0
data/lib/rio/if/temp.rb +46 -0
data/lib/rio/matchcolumns.rb +266 -0
data/lib/rio/rangemath.rb +44 -0
data/lib/rio/scheme/temp.rb +4 -1
data/lib/rio/version.rb +1 -1
data/test/tc/all.rb +4 -1
data/test/tc/copy-from.rb +1 -1
data/test/tc/csv2.rb +135 -0
data/test/tc/csv_columns.rb +37 -0
data/test/tc/csvutil.rb +56 -0
data/test/tc/ext.rb +1 -1
data/test/tc/methods.rb +1 -1
data/test/tc/tempfile.rb +17 -0
metadata +11 -228
data/doc/rdoc/classes/Kernel.html +0 -181
data/doc/rdoc/classes/Kernel.src/M000182.html +0 -18
data/doc/rdoc/classes/RIO.html +0 -543
data/doc/rdoc/classes/RIO.src/M000001.html +0 -18
data/doc/rdoc/classes/RIO.src/M000002.html +0 -18
data/doc/rdoc/classes/RIO.src/M000003.html +0 -18
data/doc/rdoc/classes/RIO/Doc.html +0 -138
data/doc/rdoc/classes/RIO/Doc/HOWTO.html +0 -1035
data/doc/rdoc/classes/RIO/Doc/INTRO.html +0 -1335
data/doc/rdoc/classes/RIO/Doc/MISC.html +0 -443
data/doc/rdoc/classes/RIO/Doc/SYNOPSIS.html +0 -355
data/doc/rdoc/classes/RIO/Rio.html +0 -6358
data/doc/rdoc/classes/RIO/Rio.src/M000004.html +0 -18
data/doc/rdoc/classes/RIO/Rio.src/M000005.html +0 -20
data/doc/rdoc/classes/RIO/Rio.src/M000006.html +0 -27
data/doc/rdoc/classes/RIO/Rio.src/M000007.html +0 -27
data/doc/rdoc/classes/RIO/Rio.src/M000008.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000009.html +0 -18
data/doc/rdoc/classes/RIO/Rio.src/M000010.html +0 -20
data/doc/rdoc/classes/RIO/Rio.src/M000011.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000012.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000013.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000014.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000015.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000016.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000017.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000018.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000019.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000020.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000021.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000022.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000023.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000024.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000025.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000026.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000027.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000028.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000029.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000030.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000031.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000032.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000033.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000034.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000035.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000036.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000037.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000038.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000039.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000040.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000041.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000042.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000043.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000044.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000045.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000046.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000047.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000048.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000049.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000050.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000051.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000052.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000053.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000054.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000055.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000056.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000057.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000058.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000059.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000060.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000061.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000062.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000063.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000064.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000065.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000066.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000067.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000068.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000069.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000070.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000071.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000072.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000073.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000074.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000075.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000076.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000077.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000078.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000079.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000080.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000081.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000082.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000083.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000084.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000085.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000086.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000087.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000088.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000089.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000090.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000091.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000092.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000093.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000094.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000095.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000096.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000097.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000098.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000099.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000100.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000101.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000102.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000103.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000104.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000105.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000106.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000107.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000108.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000109.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000110.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000111.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000112.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000113.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000114.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000115.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000116.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000117.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000118.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000119.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000120.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000121.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000122.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000123.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000124.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000125.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000126.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000127.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000128.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000129.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000130.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000131.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000132.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000133.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000134.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000135.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000136.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000137.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000138.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000139.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000140.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000141.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000142.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000143.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000144.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000145.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000146.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000147.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000148.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000149.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000150.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000151.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000152.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000153.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000154.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000155.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000156.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000157.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000158.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000159.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000160.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000161.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000162.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000163.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000164.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000165.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000166.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000167.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000168.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000169.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000170.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000171.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000172.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000173.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000174.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000175.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000176.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000177.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000178.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000179.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000180.html +0 -16
data/doc/rdoc/classes/RIO/Rio.src/M000181.html +0 -16
data/doc/rdoc/created.rid +0 -1
data/doc/rdoc/files/README.html +0 -215
data/doc/rdoc/files/lib/rio/constructor_rb.html +0 -142
data/doc/rdoc/files/lib/rio/doc/HOWTO_rb.html +0 -135
data/doc/rdoc/files/lib/rio/doc/INTRO_rb.html +0 -135
data/doc/rdoc/files/lib/rio/doc/MISC_rb.html +0 -135
data/doc/rdoc/files/lib/rio/doc/SYNOPSIS_rb.html +0 -135
data/doc/rdoc/files/lib/rio/if/basic_rb.html +0 -135
data/doc/rdoc/files/lib/rio/if/dir_rb.html +0 -135
data/doc/rdoc/files/lib/rio/if/file_rb.html +0 -135
data/doc/rdoc/files/lib/rio/if/fileordir_rb.html +0 -135
data/doc/rdoc/files/lib/rio/if/grande_rb.html +0 -135
data/doc/rdoc/files/lib/rio/if/internal_rb.html +0 -135
data/doc/rdoc/files/lib/rio/if/methods_rb.html +0 -135
data/doc/rdoc/files/lib/rio/if/path_rb.html +0 -135
data/doc/rdoc/files/lib/rio/if/stream_rb.html +0 -135
data/doc/rdoc/files/lib/rio/if/test_rb.html +0 -135
data/doc/rdoc/files/lib/rio/kernel_rb.html +0 -142
data/doc/rdoc/files/lib/rio_rb.html +0 -153
data/doc/rdoc/fr_class_index.html +0 -34
data/doc/rdoc/fr_file_index.html +0 -44
data/doc/rdoc/fr_method_index.html +0 -209
data/doc/rdoc/index.html +0 -24
data/doc/rdoc/rdoc-style.css +0 -384

data/doc/rdoc/classes/RIO/Doc/INTRO.html DELETED Viewed

@@ -1,1335 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!DOCTYPE html
-     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-<head>
-  <title>Module: RIO::Doc::INTRO</title>
-  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-  <meta http-equiv="Content-Script-Type" content="text/javascript" />
-  <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
-  <script type="text/javascript">
-  // <![CDATA[
-  function popupCode( url ) {
-    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
-  }
-  function toggleCode( id ) {
-    if ( document.getElementById )
-      elem = document.getElementById( id );
-    else if ( document.all )
-      elem = eval( "document.all." + id );
-    else
-      return false;
-    elemStyle = elem.style;
-    if ( elemStyle.display != "block" ) {
-      elemStyle.display = "block"
-    } else {
-      elemStyle.display = "none"
-    }
-    return true;
-  }
-  // Make codeblocks hidden by default
-  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
-  // ]]>
-  </script>
-</head>
-<body>
-    <div id="classHeader">
-        <table class="header-table">
-        <tr class="top-aligned-row">
-          <td class="class-mod"><strong>Module</strong></td>
-          <td class="class-name-in-header">RIO::Doc::INTRO</td>
-            <td rowspan="2" class="class-header-space-col"></td>
-            <td rowspan="2">
-                <a class="in-url" href="../../../files/lib/rio/doc/INTRO_rb.html">
-                lib/rio/doc/INTRO.rb
-                </a>
-        &nbsp;&nbsp;
-            </td>
-        </tr>
-        </table>
-    </div>
-  <!-- banner header -->
-  <div id="bodyContent">
-  <div id="contextContent">
-    <div id="description">
-      <h1><a href="../Rio.html">Rio</a> - Ruby I/O Comfort Class</h1>
-<p>
-<a href="../Rio.html">Rio</a> is a convenience class wrapping much of the
-functionality of IO, File, Dir, Pathname, FileUtils, Tempfile, StringIO,
-and OpenURI and uses Zlib, and CSV to extend that functionality using a
-simple consistent interface. Most of the instance methods of IO, File and
-Dir are simply forwarded to the appropriate handle to provide identical
-functionality. <a href="../Rio.html">Rio</a> also provides a
-&quot;grande&quot; interface that allows many application level IO tasks to
-be accomplished in line or two of code.
-</p>
-<p>
-<a href="../Rio.html">Rio</a> functionality can be broadly broken into
-three categories
-</p>
-<ul>
-<li>path manipulation
-</li>
-<li>file system access
-</li>
-<li>stream manipulation
-</li>
-</ul>
-<p>
-Which methods are available to a given <a href="../Rio.html">Rio</a>,
-depends on the underlying object.
-</p>
-<p>
-A <a href="../Rio.html">Rio</a> generally does not need to be opened or
-have its mode specified. Most of <a href="../Rio.html">Rio</a>&#8217;s
-methods simply configure it. When an actual IO operation is specified, <a
-href="../Rio.html">Rio</a> determines how to open it based on the object it
-is opening, the operation it is performing, and the options specified.
-</p>
-<p>
-<a href="../Rio.html">Rio</a> configuration methods return the <a
-href="../Rio.html">Rio</a> for easy chaining and regard the presence of a
-block as an implied <tt>each</tt>.
-</p>
-<h2>Using a <a href="../Rio.html">Rio</a></h2>
-<p>
-Using a <a href="../Rio.html">Rio</a> can be described as having 3 steps:
-</p>
-<ul>
-<li>Creating a <a href="../Rio.html">Rio</a> (using the constructor or as the
-result of one of the path manipulation methods)
-</li>
-<li>Configuring a <a href="../Rio.html">Rio</a>
-</li>
-<li><a href="../Rio.html">Rio</a> I/O
-</li>
-</ul>
-<h3>Creating a <a href="../Rio.html">Rio</a></h3>
-<p>
-<a href="../Rio.html">Rio</a> extends <a
-href="../../Kernel.html">Kernel</a> with one function <tt>rio</tt>, its
-constructor. This function is overloaded to create any type of <a
-href="../Rio.html">Rio</a>. <tt>rio</tt> looks at the class and sometimes
-the value of its first argument to create an internal representation of the
-resource specified, additional arguments are used as needed by the resource
-type. The rio constructor does not initiate any io, it does not check for a
-resources existance or type. It neither knows nor cares what can be done
-with this <a href="../Rio.html">Rio</a>. Using methods like +respond_to?+
-are meaningless at best and usually misleading.
-</p>
-<p>
-For purposes of discussion, we divide Rios into two catagories, those that
-have a path and those that don&#8217;t.
-</p>
-<h4>Creating a <a href="../Rio.html">Rio</a> that has a path</h4>
-<p>
-To create a <a href="../Rio.html">Rio</a> that has a path the arguments to
-<tt>rio</tt> may be:
-</p>
-<ul>
-<li>a string representing the entire path. The separator used for Rios is as
-specified in RFC1738 (&#8217;/&#8217;).
-<pre>
- rio('adir/afile')
-</pre>
-</li>
-<li>a string representing a fully qualified <tt>file</tt> URI as per RFC1738
-<pre>
- rio('file:///atopleveldir/adir/afile')
-</pre>
-</li>
-<li>a <tt>URI</tt> object representing a <tt>file</tt> or generic <tt>URI</tt>
-<pre>
- rio(URI('adir/afile'))
-</pre>
-</li>
-<li>the components of a path as separate arguments
-<pre>
- rio('adir','afile')
-</pre>
-</li>
-<li>the components of a path as an array
-<pre>
- rio(%w/adir afile/)
-</pre>
-</li>
-<li>another <a href="../Rio.html">Rio</a>
-<pre>
- another_rio = rio('adir/afile')
- rio(another_rio)
-</pre>
-</li>
-<li>any object whose <tt>to_s</tt> method returns one of the above
-<pre>
- rio(Pathname.new('apath'))
-</pre>
-</li>
-<li>any combination of the above either as separate arguments or as elements of
-an array,
-<pre>
- another_rio = rio('dir1/dir2')
- auri = URI('dir4/dir5)
- rio(another_rio,'dir3',auri,'dir6/dir7')
-</pre>
-</li>
-</ul>
-<h5>Creating a <a href="../Rio.html">Rio</a> that refers to a web page</h5>
-<p>
-To create a <a href="../Rio.html">Rio</a> that refers to a web page the
-arguments to <tt>rio</tt> may be:
-</p>
-<ul>
-<li>a string representing a fully qualified <tt>http</tt> URI
-<pre>
- rio('http://ruby-doc.org/index.html')
-</pre>
-</li>
-<li>a <tt>URI</tt> object representing a <tt>http</tt> <tt>URI</tt>
-<pre>
- rio(URI('http://ruby-doc.org/index.html'))
-</pre>
-</li>
-<li>either of the above with additional path elements
-<pre>
- rio('http://www.ruby-doc.org/','core','classes/Object.html')
-</pre>
-</li>
-</ul>
-<h5>Creating a <a href="../Rio.html">Rio</a> that refers to a file or directory on a FTP server</h5>
-<p>
-To create a <a href="../Rio.html">Rio</a> that refers to a file on a FTP
-server the arguments to <tt>rio</tt> may be:
-</p>
-<ul>
-<li>a string representing a fully qualified <tt>ftp</tt> URI
-<pre>
- rio('ftp://user:password@ftp.example.com/afile.tar.gz')
-</pre>
-</li>
-<li>a <tt>URI</tt> object representing a <tt>ftp</tt> <tt>URI</tt>
-<pre>
- rio(URI('ftp://ftp.example.com/afile.tar.gz'))
-</pre>
-</li>
-<li>either of the above with additional path elements
-<pre>
- rio('ftp://ftp.gnu.org/pub/gnu','emacs','windows','README')
-</pre>
-</li>
-</ul>
-<h4>Creating Rios that do not have a path</h4>
-<p>
-To create a <a href="../Rio.html">Rio</a> without a path, the first
-argument to <tt>rio</tt> is usually a single character.
-</p>
-<h5>Creating a <a href="../Rio.html">Rio</a> that refers to a clone of your programs stdin or stdout.</h5>
-<p>
-<tt>rio(?-)</tt> (mnemonic: &#8217;-&#8217; is used by some Unix programs
-to specify stdin or stdout in place of a file)
-</p>
-<p>
-Just as a <a href="../Rio.html">Rio</a> that refers to a file, does not
-know whether that file will be opened for reading or writing until an io
-operation is specified, a <tt>stdio:</tt> <a href="../Rio.html">Rio</a>
-does not know whether it will connect to stdin or stdout until an I/O
-operation is specified.
-</p>
-<h5>Creating a <a href="../Rio.html">Rio</a> that refers to a clone of your programs stderr.</h5>
-<p>
-<tt>rio(?=)</tt> (mnemonic: &#8217;-&#8217; refers to fileno 1, so
-&#8217;=&#8217; refers to fileno 2)
-</p>
-<h5>Creating a <a href="../Rio.html">Rio</a> that refers to an arbitrary IO object.</h5>
-<pre>
- an_io = ::File.new('afile')
- rio(an_io)
-</pre>
-<h5>Creating a <a href="../Rio.html">Rio</a> that refers to a file descriptor</h5>
-<p>
-<tt>rio(?#,fd)</tt> (mnemonic: a file descriptor is a number
-&#8217;#&#8217; )
-</p>
-<pre>
- an_io = ::File.new('afile')
- rio(an_io)
-</pre>
-<h5>Creating a <a href="../Rio.html">Rio</a> that refers to a StringIO object</h5>
-<p>
-<tt>rio(?&quot;)</tt> (mnemonic: &#8217;&quot;&#8217; surrounds strings)
-</p>
-<ul>
-<li>create a <a href="../Rio.html">Rio</a> that refers to its own string
-</li>
-</ul>
-<pre>
- rio(?&quot;)
-</pre>
-<ul>
-<li>create a <a href="../Rio.html">Rio</a> that refers to a string of your
-choosing
-</li>
-</ul>
-<pre>
- astring = &quot;&quot;
- rio(?&quot;,&quot;&quot;)
-</pre>
-<h5>Creating a <a href="../Rio.html">Rio</a> that refers to a Temporary object</h5>
-<p>
-<tt>rio(??)</tt> (mnemonic: &#8217;?&#8217; you don&#8217;t know its name)
-</p>
-<p>
-To create a temporary object that will become a file or a directory,
-depending on how you use it:
-</p>
-<pre>
- rio(??)
- rio(??,basename='rio',tmpdir=Dir::tmpdir)
-</pre>
-<p>
-To force it to become a file
-</p>
-<pre>
- rio(??).file
-</pre>
-<p>
-or just write to it.
-</p>
-<p>
-To force it to become a directory:
-</p>
-<pre>
- rio(??).dir
-</pre>
-<p>
-or
-</p>
-<pre>
- rio(??).mkdir
-</pre>
-<p>
-or
-</p>
-<pre>
- rio(??).chdir
-</pre>
-<h5>Creating a <a href="../Rio.html">Rio</a> that refers to an arbitrary TCPSocket</h5>
-<pre>
- rio('tcp:',hostname,port)
-</pre>
-<p>
-or
-</p>
-<pre>
- rio('tcp://hostname:port')
-</pre>
-<h5>Creating a <a href="../Rio.html">Rio</a> that runs an external program and connects to its stdin and stdout</h5>
-<p>
-<tt>rio(?-,cmd)</tt> (mnemonic: &#8217;-&#8217; is used by some Unix
-programs to specify stdin or stdout in place of a file)
-</p>
-<p>
-or
-</p>
-<p>
-<tt>rio(?`,cmd)</tt> (mnemonic: &#8217;`&#8217; (backtick) runs an external
-program in ruby)
-</p>
-<p>
-This is <a href="../Rio.html">Rio</a>&#8217;s interface to IO#popen
-</p>
-<h3>Path Manipulation</h3>
-<p>
-<a href="../Rio.html">Rio</a>&#8217;s path manipulation methods are for the
-most part simply forwarded to the File or URI classes with the return
-values converted to a <a href="../Rio.html">Rio</a>.
-</p>
-<h4>Creating a <a href="../Rio.html">Rio</a> from a <a href="../Rio.html">Rio</a>&#8217;s component parts.</h4>
-<p>
-The <a href="../Rio.html">Rio</a> methods for creating a <a
-href="../Rio.html">Rio</a> from a <a href="../Rio.html">Rio</a>&#8217;s
-component parts are <a href="../Rio.html#M000093">Rio#dirname</a>, <a
-href="../Rio.html#M000095">Rio#filename</a>, <a
-href="../Rio.html#M000092">Rio#basename</a>, and <a
-href="../Rio.html#M000094">Rio#extname</a>. The behavior of <a
-href="../Rio.html#M000092">Rio#basename</a> depends on the setting of the
-<tt>ext</tt> configuration variable and is different from its counterpart
-in the File class. The default value of the <tt>ext</tt> configuration
-variable is the string returned File#extname. The <tt>ext</tt>
-configuration variable can be changed using <a
-href="../Rio.html#M000089">Rio#ext</a> and <a
-href="../Rio.html#M000090">Rio#noext</a> and can be queried using <a
-href="../Rio.html#M000089">Rio#ext</a>?. This value is used by calls to <a
-href="../Rio.html#M000092">Rio#basename</a>.
-</p>
-<p>
-<a href="../Rio.html#M000095">Rio#filename</a> returns the last component
-of a path, and is basically the same as <tt>basename</tt> without
-consideration of an extension. So
-</p>
-<pre>
-   rio('afile.txt').basename       #=&gt; rio('afile')
-   rio('afile.txt').filename       #=&gt; rio('afile.txt')
-   ario = rio('afile.tar.gz')
-   ario.basename                   #=&gt; rio('afile.tar')
-   ario.ext?                       #=&gt; &quot;.gz&quot;
-   ario.ext('.tar.gz').basename    #=&gt; rio('afile')
-   ario.ext?                       #=&gt; &quot;.tar.gz&quot;
-</pre>
-<h4>Changing a path&#8217;s component parts.</h4>
-<p>
-<a href="../Rio.html">Rio</a> also provides methods for changing the
-component parts of its path. They are <a
-href="../Rio.html#M000093">Rio#dirname</a>=, <a
-href="../Rio.html#M000095">Rio#filename</a>=, <a
-href="../Rio.html#M000092">Rio#basename</a>=, and <a
-href="../Rio.html#M000094">Rio#extname</a>=. These methods replace the part
-extracted as described above with their argument.
-</p>
-<pre>
-   ario = rio('dirA/dirB/afile.rb')
-   ario.dirname = 'dirC'          # rio('dirC/afile.rb')
-   ario.basename = 'bfile'        # rio('dirC/bfile.rb')
-   ario.extname = '.txt'          # rio('dirC/bfile.txt')
-   ario.filename = 'cfile.rb'     # rio('dirC/cfile.rb')
-</pre>
-<p>
-<a href="../Rio.html">Rio</a> also has a <tt>rename</tt> mode which causes
-each of these to rename the actual file system object as well as changing
-the <a href="../Rio.html">Rio</a>. This is discussed in the section on
-Renaming and Moving.
-</p>
-<h4>Splitting a <a href="../Rio.html">Rio</a></h4>
-<p>
-<a href="../Rio.html#M000101">Rio#split</a> returns an array of Rios, one
-for each path element. (Note that this behavior differs from File#split.)
-</p>
-<pre>
-   rio('a/b/c').split   #=&gt; [rio('a'),rio('b'),rio('c')]
-</pre>
-<p>
-The array returned is extended with a <tt>to_rio</tt> method, which will
-put the parts back together again.
-</p>
-<pre>
-   ary = rio('a/b/c').split   #=&gt; [rio('a'),rio('b'),rio('c')]
-   ary.to_rio           #=&gt; rio('a/b/c')
-</pre>
-<h4>Creating a <a href="../Rio.html">Rio</a> by specifying the individual parts of its path</h4>
-<p>
-The first way to create a <a href="../Rio.html">Rio</a> by specifying its
-parts is to use the <a href="../Rio.html">Rio</a> constructor <a
-href="../Rio.html#M000006">Rio#rio</a>. Since a <a
-href="../Rio.html">Rio</a> is among the arguments the constructor will
-take, the constructor can be used.
-</p>
-<pre>
-   ario = rio('adir')
-   rio(ario,'b')    #=&gt; rio('adir/b')
-</pre>
-<p>
-<a href="../Rio.html#M000100">Rio#join</a> and <a
-href="../Rio.html">Rio</a>#/ do the same thing, but the operator version
-<tt>/</tt> can take only one argument.
-</p>
-<pre>
-   a = rio('a')
-   b = rio('b')
-   c = a.join(b)    #=&gt; rio('a/b')
-   c = a/b          #=&gt; rio('a/b')
-</pre>
-<p>
-The arguments to <tt>join</tt> and <tt>/</tt> do not need to be Rios, of
-course
-</p>
-<pre>
-   ario = rio('adir')
-   ario/'afile.rb'           #=&gt; rio('ario/afile.rb')
-   ario.join('b','c','d')    #=&gt; rio('ario/b/c/d')
-   ario/'b'/'c'/'d'          #=&gt; rio('ario/b/c/d')
-   ario /= 'e'               #=&gt; rio('ario/b/c/d/e')
-</pre>
-<h4>Manipulating a <a href="../Rio.html">Rio</a> path by treating it as a string.</h4>
-<p>
-The <a href="../Rio.html">Rio</a> methods which treat a <a
-href="../Rio.html">Rio</a> as a string are <a
-href="../Rio.html#M000104">Rio#sub</a>, <a
-href="../Rio.html#M000105">Rio#gsub</a> and <a
-href="../Rio.html">Rio</a>#+. These methods create a new <a
-href="../Rio.html">Rio</a> using the string created by forwarding the
-method to the String returned by <a
-href="../Rio.html#M000008">Rio#to_s</a>.
-</p>
-<pre>
-   ario = rio('dirA/dirB/afile') + '-1.1.1'   # rio('dirA/dirB/afile-1.1.1')
-   brio = ario.sub(/^dirA/, 'dirC')           # rio('dirC/dirB/afile-1.1.1')
-</pre>
-<h4>Creating a <a href="../Rio.html">Rio</a> based on its relationship to another</h4>
-<p>
-<a href="../Rio.html#M000086">Rio#abs</a> creates a new rio whose path is
-the absolute path of a <a href="../Rio.html">Rio</a>. If provided with an
-argument, it uses that as the base path, otherwise it uses an internal base
-path (usually the current working directory when it was created).
-</p>
-<pre>
-   rio('/tmp').chdir do
-     rio('a').abs            #=&gt; rio('/tmp/a')
-     rio('a').abs('/usr')    #=&gt; rio('/usr/a')
-   end
-</pre>
-<p>
-<a href="../Rio.html#M000087">Rio#rel</a> creates a new rio with a path
-relative to a <a href="../Rio.html">Rio</a>.
-</p>
-<pre>
-   rio('/tmp').chdir do
-     rio('/tmp/a').rel       #=&gt; rio('a')
-   end
-   rio('/tmp/b').rel('/tmp') #=&gt; rio('b')
-</pre>
-<p>
-<a href="../Rio.html#M000113">Rio#route_to</a> and <a
-href="../Rio.html#M000112">Rio#route_from</a> creates a new rio with a path
-representing the route to get to/from a <a href="../Rio.html">Rio</a>. They
-are based on the methods of the same names in the URI class
-</p>
-<h3>Configuring a <a href="../Rio.html">Rio</a></h3>
-<p>
-The second step in using a rio is configuring it. Note that many times no
-configuration is necessary and that this is not a comprehensive list of all
-of <a href="../Rio.html">Rio</a>&#8217;s configuration methods.
-</p>
-<p>
-<a href="../Rio.html">Rio</a>&#8217;s configuration mehods fall into three
-categories.
-</p>
-<dl>
-<dt>IO manipulators</dt><dd>An IO manipulator alters the behavior of a <a
-href="../Rio.html">Rio</a>&#8217;s underlying IO object. These affect the
-behaviour of I/O methods which are forwarded directly to the underlying
-object as well as the grande I/O methods.
-</dd>
-<dt>Grande configuration methods</dt><dd>The grande configuration methods affect the behaviour of <a
-href="../Rio.html">Rio</a>&#8217;s grande I/O methods
-</dd>
-<dt>Grande selection methods</dt><dd>The grande selection methods select what data is returned by <a
-href="../Rio.html">Rio</a>&#8217;s grande I/O methods
-</dd>
-</dl>
-<p>
-All of <a href="../Rio.html">Rio</a>&#8217;s configuration and selection
-methods can be passed a block, which will cause the <a
-href="../Rio.html">Rio</a> to behave as if <tt>each</tt> had been called
-with the block after the method.
-</p>
-<h4>IO manipulators</h4>
-<ul>
-<li><tt>gzip</tt> a file on output, and ungzip it on input
-<pre>
- rio('afile.gz').gzip
-</pre>
-<p>
-This causes the rio to read through a Zlib::GzipReader and to write
-Zlib::GzipWriter.
-</p>
-</li>
-<li><tt>chomp</tt> lines as they are read
-<pre>
- rio('afile').chomp
-</pre>
-<p>
-This causes a <a href="../Rio.html">Rio</a> to call String#chomp on the the
-String returned by all line oriented read operations.
-</p>
-</li>
-</ul>
-<h4>Grande configuration methods</h4>
-<ul>
-<li><tt>all</tt>, <tt>recurse</tt>, <tt>norecurse</tt>
-<pre>
- rio('adir').all
- rio('adir').norecurse('CVS')
-</pre>
-<p>
-These methods instruct the <a href="../Rio.html">Rio</a> to also include
-entries in subdirectories when iterating through directories and control
-which subdirectories are included or excluded.
-</p>
-</li>
-<li><tt>bytes</tt>
-<pre>
- rio('afile').bytes(1024)
-</pre>
-<p>
-This causes a <a href="../Rio.html">Rio</a> to read the specified number of
-bytes at a time as a file is iterated through.
-</p>
-</li>
-</ul>
-<h4>Grande selection methods</h4>
-<ul>
-<li><tt>lines</tt>, <tt>nolines</tt>
-<pre>
- rio('afile').lines(0..9)
- rio('afile').nolines(/^\s*#/)
-</pre>
-<p>
-Strictly speaking these are both configuration and selection methods. They
-configure the <a href="../Rio.html">Rio</a> to iterate through an input
-stream as lines. The arguments select which lines are actually returned.
-Lines are included (<tt>lines</tt>) or excluded (<tt>nolines</tt>) if they
-match <b>any</b> of the arguments as follows.
-</p>
-<p>
-If the argument is a:
-</p>
-<table>
-<tr><td valign="top"><tt>RegExp</tt>:</td><td>the line is matched against it
-</td></tr>
-<tr><td valign="top"><tt>Range</tt>:</td><td>the lineno is matched against it
-</td></tr>
-<tr><td valign="top"><tt>Integer</tt>:</td><td>the lineno is matched against it as if it were a one element range
-</td></tr>
-<tr><td valign="top"><tt>Symbol</tt>:</td><td>the symbol is <tt>sent</tt> to the string; the line is included unless it
-returns false
-</td></tr>
-<tr><td valign="top"><tt>Proc</tt>:</td><td>the proc is called with the line as an argument; the line is included
-unless it returns false
-</td></tr>
-</table>
-</li>
-<li><tt>entries</tt>, <tt>files</tt>, <tt>dirs</tt>, <tt>noentries</tt>,
-<tt>nofiles</tt>, <tt>nodirs</tt>
-<pre>
- rio('adir').files('*.txt')
- rio('adir').nofiles(/^\./)
-</pre>
-<p>
-These methods select which entries will be returned when iterating throug
-directories. Entries are included
-(<tt>entries</tt>,<tt>files</tt>,<tt>dirs</tt>) or
-excluded(<tt>noentries</tt>,<tt>nofiles</tt>,<tt>nodirs</tt>) if they match
-<b>any</b> of the arguments as follows.
-</p>
-<p>
-If the argument is a:
-</p>
-<table>
-<tr><td valign="top"><tt>String</tt>:</td><td>the arg is treated as a glob; the filname is matched against it
-</td></tr>
-<tr><td valign="top"><tt>RegExp</tt>:</td><td>the filname is matched against it
-</td></tr>
-<tr><td valign="top"><tt>Symbol</tt>:</td><td>the symbol is <tt>sent</tt> to the entry (a <a href="../Rio.html">Rio</a>);
-the entry is included unless it returns false
-</td></tr>
-<tr><td valign="top"><tt>Proc</tt>:</td><td>the proc is called with the entry (a <a href="../Rio.html">Rio</a>) as an
-argument; the entry is included unless it returns false
-</td></tr>
-</table>
-</li>
-<li><tt>records</tt>, <tt>rows</tt>, <tt>norecords</tt>, <tt>norows</tt>
-<pre>
- rio('afile').bytes(1024).records(0...10)
-</pre>
-<p>
-These select items from an input stream just as <tt>lines</tt>, but without
-specifying lines as the input record type. They can be used to select
-different record types in extension modules. The only such module at this
-writing is the CSV extension. In that case <tt>records</tt> causes each
-line of a CSV file to be parsed into an array while <tt>lines</tt> causes
-each line of the file to be returned normally.
-</p>
-</li>
-</ul>
-<h3><a href="../Rio.html">Rio</a> I/O</h3>
-<p>
-As stated above the the three steps to using a <a
-href="../Rio.html">Rio</a> are:
-</p>
-<ul>
-<li>Creating a <a href="../Rio.html">Rio</a>
-</li>
-<li>Configuring a <a href="../Rio.html">Rio</a>
-</li>
-<li>Doing I/O
-</li>
-</ul>
-<p>
-This section describes that final step.
-</p>
-<p>
-After creating and configuring a <a href="../Rio.html">Rio</a>, the
-file-system has not been accessed, no socket has been opened, not so much
-as a test for a files existance has been done. When an I/O method is called
-on a <a href="../Rio.html">Rio</a>, the sequence of events required to
-complete that operation on the underlying object takes place. <a
-href="../Rio.html">Rio</a> takes care of creating the apropriate object (eg
-IO,Dir), opening the object with the apropriate mode, performing the
-operation, closing the object if required, and returning the results of the
-operation.
-</p>
-<p>
-<a href="../Rio.html">Rio</a>&#8217;s I/O operations can be divide into two
-catagories:
-</p>
-<ul>
-<li>Proxy operations
-</li>
-<li>Grande operations
-</li>
-</ul>
-<h4>Proxy operations</h4>
-<p>
-These are calls which are forwarded to the underlying object (eg
-IO,Dir,Net::FTP), after apropriately creating and configuring that object.
-The result produced by the method is returned, and the object is closed.
-</p>
-<p>
-In some cases the result is modified before being returned, as when a <a
-href="../Rio.html">Rio</a> is configured with <tt>chomp</tt>.
-</p>
-<p>
-In all cases, if the result returned by the underlying object, could itself
-be used for further I/O operations it is returned as a <a
-href="../Rio.html">Rio</a>. For example: where File#dirname returns a
-string, <a href="../Rio.html#M000093">Rio#dirname</a> returns a <a
-href="../Rio.html">Rio</a>; where Dir#read returns a string representing a
-directory entry, <a href="../Rio.html#M000038">Rio#read</a> returns a <a
-href="../Rio.html">Rio</a>.
-</p>
-<p>
-With some noteable exceptions, most of the operations available if one were
-using the underlying Ruby I/O class are available to the <a
-href="../Rio.html">Rio</a> and will behave identically.
-</p>
-<p>
-For things that exist on a file system:
-</p>
-<ul>
-<li>All the methods in FileTest are available as <a href="../Rio.html">Rio</a>
-instance methods. For example
-<pre>
- FileTest.file?('afile')
-</pre>
-<p>
-becomes
-</p>
-<pre>
- rio('afile').file?
-</pre>
-</li>
-<li>All the instance methods of <tt>File</tt> except <tt>path</tt> are
-available to a rio without change
-</li>
-<li>Most of the class methods of <tt>File</tt> are available.
-<ul>
-<li>For those that take a filename as their only argument the calls are mapped
-to <a href="../Rio.html">Rio</a> instance methods as described above for
-FileTest.
-</li>
-<li><tt>dirname</tt>, and <tt>readlink</tt> return Rios instead of strings
-</li>
-<li><a href="../Rio.html">Rio</a> has its own <a
-href="../Rio.html#M000092">Rio#basename</a>, <a
-href="../Rio.html#M000100">Rio#join</a> and <a
-href="../Rio.html#M000035">Rio#symlink</a>, which provide similar
-functionality.
-</li>
-<li>The class methods which take multiple filenames
-(<tt>chmod</tt>,<tt>chown</tt>,<tt>lchmod</tt>,<tt>lchown</tt>) are
-available as <a href="../Rio.html">Rio</a> instance methods. For example
-<pre>
- File.chmod(0666,'afile')
-</pre>
-<p>
-becomes
-</p>
-<pre>
- rio('afile').chmod(06660)
-</pre>
-</li>
-</ul>
-</li>
-</ul>
-<p>
-For I/O Streams
-</p>
-<p>
-Most of the instance methods of IO are available, and most do the same
-thing, with some interface changes. <b>The big exception to this is the
-&#8217;&lt;&lt;&#8217; operator.</b> This is one of <a
-href="../Rio.html">Rio</a>&#8217;s grande operators. While the symantics
-one would use to write to an IO object would actually accomplish the same
-thing with a <a href="../Rio.html">Rio</a>, It is a very different
-operator. Read the section on grande operators. The other differences
-between IO instance methods and the <a href="../Rio.html">Rio</a>
-equivelence can be summarized as follows.
-</p>
-<ul>
-<li>The simple instance methods (eg <tt>fcntl</tt>, <tt>eof?</tt>,
-<tt>tty?</tt> etc.) are forwarded and the result returned as is
-</li>
-<li>Anywhere IO returns an IO, <a href="../Rio.html">Rio</a> returns a <a
-href="../Rio.html">Rio</a>
-</li>
-<li><tt>close</tt> and its cousins return the <a href="../Rio.html">Rio</a>.
-</li>
-<li><tt>each_byte</tt> and <tt>each_line</tt> are forwarded as is.
-</li>
-<li>All methods which read (read*,get*,each*) will cause the file to closed
-when the end of file is reached. This behavior is configurable, but the
-default is to close on eof
-</li>
-<li>The methods which write (put*,print*) are forwarded as is; put* and print*
-return the <a href="../Rio.html">Rio</a>; write returns the value returned
-by IO#write; as mentioned above &#8217;&lt;&lt;&#8217; is a grande operator
-in <a href="../Rio.html">Rio</a>.
-</li>
-</ul>
-<p>
-For directories:
-</p>
-<ul>
-<li>all the instance methods of Dir are available except <tt>each</tt> which is
-a grande method.
-</li>
-<li>the class methods <tt>mkdir</tt>, <tt>delete</tt>, <tt>rmdir</tt> are
-provided as instance methods.
-</li>
-<li><tt>chdir</tt> is provided as an instance method. <a
-href="../Rio.html#M000017">Rio#chdir</a> returns a <a
-href="../Rio.html">Rio</a> and passes a <a href="../Rio.html">Rio</a> to a
-block if one is provided.
-</li>
-<li><tt>glob</tt> is provided as an instance method, but returns an array of
-Rios
-</li>
-<li><tt>foreach</tt> is not supported
-</li>
-<li><tt>each</tt> and <tt>[]</tt> have similar functionality provided by <a
-href="../Rio.html">Rio</a>
-</li>
-</ul>
-<p>
-For other Rios, instance methods are generally forwarded where appropriate.
-For example
-</p>
-<ul>
-<li>Rios that refer to StringIO objects forward &#8216;string&#8217; and
-&#8216;string=&#8217;
-</li>
-<li>Rios that refer to http URIs support all the Meta methods provided by
-open-uri
-</li>
-</ul>
-<h4>Grande operators</h4>
-<p>
-The primary grande operator is <a href="../Rio.html#M000045">Rio#each</a>.
-<tt>each</tt> is used to iterate through Rios. When applied to a file it
-iterates through records in the file. When applied to a directory it
-iterates through the entries in the directory. Its behavior is modified by
-configuring the <a href="../Rio.html">Rio</a> prior to calling it using the
-configuration methods discussed above. Since iterating through things is
-ubiquitous in ruby, it is implied by the presence of a block after any of
-the grande configuration methods and many times does not need to be call
-explicitly. For example:
-</p>
-<pre>
- rio('afile.rb').chomp.lines(/^\s*#/) { |line| ... } # iterate through chomped ruby comment lines
- rio('adir').all.files('*.rb') { |f| ... } # iterate through all .rb files in 'adir' and its subdirectories
-</pre>
-<p>
-Because a <a href="../Rio.html">Rio</a> is an Enumerable, it supports
-<tt>to_a</tt>, which is the basis for the grande subscript operator. <a
-href="../Rio.html">Rio</a>#[] with no arguments simply calls to_a. With
-arguments it behaves as if those arguments had been passed to the most
-recently called of the grande selection methods listed above, and then
-calls to_a. For example to get the first ten lines of a file into an array
-with lines chomped
-</p>
-<pre>
- rio('afile').chomp.lines(0...10).to_a
-</pre>
-<p>
-can be written as
-</p>
-<pre>
- rio('afile.gz').chomp.lines[0...10]
-</pre>
-<p>
-or, to create an array of all the .c files in a directory, one could write
-</p>
-<pre>
- rio('adir').files['*.c']
-</pre>
-<p>
-The other grande operators are its copy operators. They are:
-</p>
-<ul>
-<li><tt>&lt;</tt> (copy-from)
-</li>
-<li><tt>&lt;&lt;</tt> (append-from)
-</li>
-<li><tt>&gt;</tt> (copy-to)
-</li>
-<li><tt>&gt;&gt;</tt> (append-to)
-</li>
-</ul>
-<p>
-The only difference between the &#8216;copy&#8217; and &#8216;append&#8217;
-versions is how they deal with an unopened resource. In the former the open
-it with mode &#8216;w&#8217; and in the latter, mode &#8216;a&#8217;.
-Beyond that, their behavior can be summarized as:
-</p>
-<pre>
-   source.each do |entry|
-     destination &lt;&lt; entry
-   end
-</pre>
-<p>
-Since they are based on the <tt>each</tt> operator, all of the selection
-and configuration options are available. And the right-hand-side argument
-of the operators are not restricted to Rios &#8212; Strings and Arrays are
-also supported.
-</p>
-<p>
-For example:
-</p>
-<pre>
- rio('afile') &gt; astring # copy a file into a string
- rio('afile').chomp &gt; anarray # copy the chomped lines of afile into an array
- rio('afile.gz').gzip.lines(0...100) &gt; rio('bfile') # copy 100 lines from a gzipped file into another file
- rio(?-) &lt; rio('http://rubydoc.org/') # copy a web page to stdout
- rio('bdir') &lt; rio('adir') # copy an entire directory structure
- rio('adir').dirs.files('README') &gt; rio('bdir') # same thing, but only README files
- rio(?-,'ps -a').nolines(0,/ps$/) &gt; anarray # copy the output of th ps command into an array, skippying
-                                            # the header line and the ps command entry
-</pre>
-<h3>Renaming and Moving</h3>
-<p>
-<a href="../Rio.html">Rio</a> provides two methods for directly renaming
-objects on the filesystem: <a href="../Rio.html#M000037">Rio#rename</a> and
-<a href="../Rio.html#M000037">Rio#rename</a>!. Both of these use
-File#rename. The difference between them is the returned <a
-href="../Rio.html">Rio</a>. <a href="../Rio.html#M000037">Rio#rename</a>
-leaves the path of the <a href="../Rio.html">Rio</a> unchanged, while <a
-href="../Rio.html#M000037">Rio#rename</a>! changes the path of the <a
-href="../Rio.html">Rio</a> to refer to the renamed path.
-</p>
-<pre>
-   ario = rio('a')
-   ario.rename('b')  # file 'a' has been renamed to 'b' but 'ario' =&gt; rio('a')
-   ario.rename!('b')  # file 'a' has been renamed to 'b' and 'ario' =&gt; rio('b')
-</pre>
-<p>
-<a href="../Rio.html">Rio</a> also has a <tt>rename</tt> mode, which causes
-the path manipulation methods <a
-href="../Rio.html#M000093">Rio#dirname</a>=, <a
-href="../Rio.html#M000095">Rio#filename</a>=, <a
-href="../Rio.html#M000092">Rio#basename</a>= and <a
-href="../Rio.html#M000094">Rio#extname</a>= to rename an object on the
-filesystem when they are used to change a <a
-href="../Rio.html">Rio</a>&#8217;s path. A <a href="../Rio.html">Rio</a> is
-put in <tt>rename</tt> mode by calling <a
-href="../Rio.html#M000037">Rio#rename</a> with no arguments.
-</p>
-<pre>
-   rio('adir/afile.txt').rename.filename = 'bfile.rb' # adir/afile.txt =&gt; adir/bfile.rb
-   rio('adir/afile.txt').rename.basename = 'bfile'    # adir/afile.txt =&gt; adir/bfile.txt
-   rio('adir/afile.txt').rename.extname  = '.rb'      # adir/afile.txt =&gt; adir/afile.rb
-   rio('adir/afile.txt').rename.dirname =  'b/c'      # adir/afile.txt =&gt; b/c/afile.txt
-</pre>
-<p>
-When <tt>rename</tt> mode is set for a directory <a
-href="../Rio.html">Rio</a>, it is automatically set in the Rios created
-when iterating through that directory.
-</p>
-<pre>
-   rio('adir').rename.files('*.htm') do |frio|
-      frio.extname = '.html'  #=&gt; changes the rio and renames the file
-   end
-</pre>
-<h3>Deleting</h3>
-<p>
-The <a href="../Rio.html">Rio</a> methods for deleting filesystem objects
-are <a href="../Rio.html#M000033">Rio#rm</a>, <a
-href="../Rio.html#M000029">Rio#rmdir</a>, <a
-href="../Rio.html#M000030">Rio#rmtree</a>, <a
-href="../Rio.html#M000046">Rio#delete</a>, and <a
-href="../Rio.html#M000046">Rio#delete</a>!. <tt>rm</tt>, <tt>rmdir</tt> and
-<tt>rmtree</tt> are passed the like named methods in the FileUtils module.
-<a href="../Rio.html#M000046">Rio#delete</a> calls <tt>rmdir</tt> for
-directories and <tt>rm</tt> for anything else, while <a
-href="../Rio.html#M000046">Rio#delete</a>! calls <a
-href="../Rio.html#M000030">Rio#rmtree</a> for directories.
-</p>
-<ul>
-<li>To delete something only if it is not a directory use <a
-href="../Rio.html#M000033">Rio#rm</a>
-</li>
-<li>To delete an empty directory use <a
-href="../Rio.html#M000029">Rio#rmdir</a>
-</li>
-<li>To delete an entire directory tree use <a
-href="../Rio.html#M000030">Rio#rmtree</a>
-</li>
-<li>To delete anything except a populated directory use <a
-href="../Rio.html#M000046">Rio#delete</a>
-</li>
-<li>To delete anything use <a href="../Rio.html#M000046">Rio#delete</a>!
-</li>
-</ul>
-<p>
-It is not an error to call any of the deleting methods on something that
-does not exist. <a href="../Rio.html">Rio</a> provides Rio#exist? and <a
-href="../Rio.html#M000035">Rio#symlink</a>? to check if something exists
-(<tt>exist?</tt> returns false for symlinks to non-existant object even
-though the symlink itself exists). The deleting methods&#8217; purpose is
-to make things not exist, so calling one of them on something that already
-does not exist is considered a success.
-</p>
-<p>
-To create a clean copy of a directory whether or not anything with that
-name exists one might do this
-</p>
-<pre>
- rio('adir').delete!.mkpath.chdir do
-   # do something in adir
- end
-</pre>
-<hr size="1"></hr><h2>Miscellany</h2>
-<h4>Using Symbolic Links</h4>
-<p>
-To create a symbolic link (symlink) to the file-system entry refered to by
-a <a href="../Rio.html">Rio</a>, use <a
-href="../Rio.html#M000035">Rio#symlink</a>. <a
-href="../Rio.html#M000035">Rio#symlink</a> differs from File#symlink in
-that it calculates the path from the symlink location to the <a
-href="../Rio.html">Rio</a>&#8217;s position. So:
-</p>
-<pre>
- File#symlink('adir/afile','adir/alink')
-</pre>
-<p>
-creates a symlink in the directory &#8216;adir&#8217; named
-&#8216;alink&#8217; which references &#8216;adir/afile&#8217;. From the
-perspective of &#8216;alink&#8217;, &#8216;adir/afile&#8217; does not
-exist. While:
-</p>
-<pre>
- rio('adir/afile').symlink('adir/alink')
-</pre>
-<p>
-creates a symlink in the directory &#8216;adir&#8217; named
-&#8216;alink&#8217; which references &#8216;afile&#8217;. This is the route
-to &#8216;adir/afile&#8217; from the perspective of
-&#8216;adir/alink&#8217;.
-</p>
-<p>
-Note that the return value from <tt>symlink</tt> is the calling <a
-href="../Rio.html">Rio</a> and not a <a href="../Rio.html">Rio</a> refering
-to the symlink. This is done for consistency with the rest of <a
-href="../Rio.html">Rio</a>.
-</p>
-<p>
-<a href="../Rio.html#M000035">Rio#symlink</a>? can be used to test if a
-file-system object is a symlink. A <a href="../Rio.html">Rio</a> is
-extended with <a href="../Rio.html#M000036">Rio#readlink</a>, and <a
-href="../Rio.html#M000161">Rio#lstat</a> only if <a
-href="../Rio.html#M000035">Rio#symlink</a>? returns true. So for
-non-symlinks, these will raise a NoMethodError. These are both passed to
-their counterparts in File. <a href="../Rio.html#M000036">Rio#readlink</a>
-returns a <a href="../Rio.html">Rio</a> refering to the result of
-File#readlink.
-</p>
-<h4>Using A <a href="../Rio.html">Rio</a> as an IO (or File or Dir)</h4>
-<p>
-<a href="../Rio.html">Rio</a> supports so much of IO&#8217;s interface that
-one might be tempted to pass it to a method that expects an IO. While <a
-href="../Rio.html">Rio</a> is not and is not intended to be a stand in for
-IO, this can work. It requires knowledge of every IO method that will be
-called, under any circumstances.
-</p>
-<p>
-Even in cases where <a href="../Rio.html">Rio</a> supports the required IO
-interface, A <a href="../Rio.html">Rio</a> feature that seems to cause the
-most incompatibility, is its automatic closing of files. To turn off all of
-<a href="../Rio.html">Rio</a>&#8217;s automatic closing use
-Rio#noautoclose.
-</p>
-<p>
-For example:
-</p>
-<pre>
- require 'yaml'
- yrio = rio('ran.yaml').delete!.noautoclose
- YAML.dump( ['badger', 'elephant', 'tiger'], yrio )
- obj = YAML::load( yrio ) #=&gt; [&quot;badger&quot;, &quot;tiger&quot;, &quot;elephant&quot;]
-</pre>
-<h4>Automatic Closing of Files</h4>
-<p>
-<a href="../Rio.html">Rio</a> closes files automatically in three
-instances.
-</p>
-<p>
-When reading from an IO it is closed when the end of file is reached. While
-this is a reasonable thing to do in many cases, sometimes this is not
-desired. To turn <a href="../Rio.html">Rio</a>&#8217;s automatic closing on
-end of file use <a href="../Rio.html#M000069">Rio#nocloseoneof</a> (it can
-be turned back on via <a href="../Rio.html#M000068">Rio#closeoneof</a>)
-</p>
-<pre>
- ario = rio('afile').nocloseoneof
- lines = ario[]
- ario.closed?   #=&gt; false
-</pre>
-<p>
-Closing on end-of-file is necessary for many of <a
-href="../Rio.html">Rio</a>&#8217;s &quot;one-liners&quot;, but has an
-implication that may be surprising at first. A <a
-href="../Rio.html">Rio</a> starts life as a path, not much more than a
-string. When one of its read methods is called it becomes an input stream.
-When the stream is closed, it becomes a path again. This means that when
-reading from a <a href="../Rio.html">Rio</a>, the end-of-file condition is
-seen only once before it becomes a path again, and will be reopened if
-another read operation is attempted.
-</p>
-<p>
-Another time a <a href="../Rio.html">Rio</a> will be closed atomatically is
-when writing to it with one of the copy operators (<tt>&lt;, &lt;&lt;,
-&gt;, &gt;&gt;</tt>). This behavior can be turned off with <a
-href="../Rio.html#M000072">Rio#nocloseoncopy</a>.
-</p>
-<p>
-To turn off both of thes types of automatic closing use Rio#noautoclose.
-</p>
-<p>
-The third instance when <a href="../Rio.html">Rio</a> will close a file
-automatically is when a file opened for one type of access receives a
-method which that access mode does not support. So, the code
-</p>
-<pre>
- rio('afile').puts(&quot;Hello World&quot;).gets
-</pre>
-<p>
-will open the file for write access when the <tt>puts</tt> method is
-received. When <tt>gets</tt> is called the file is closed and reopened with
-read access.
-</p>
-<h4>Explicit Closing of Files</h4>
-<p>
-<a href="../Rio.html">Rio</a> can not determine when the client is finished
-writing to it, as it does using <tt>eof</tt> on read. It is the
-author&#8217;s understanding that Ruby does not support a mechanism to have
-code run when there are no more references to it &#8212; that finalizers
-are not necessarily run immediatly upon an object&#8217;s reference count
-reaching 0. If this understanding is incorrect, some of <a
-href="../Rio.html">Rio</a>&#8217;s extranious ways of closing a file may be
-rethought.
-</p>
-<p>
-That being said, <a href="../Rio.html">Rio</a> support several ways to
-explicitly close a file. <a href="../Rio.html#M000141">Rio#close</a> will
-close any open <a href="../Rio.html">Rio</a>. The output methods <a
-href="../Rio.html#M000132">Rio#puts</a>!, <a
-href="../Rio.html#M000131">Rio#putc</a>!, <a
-href="../Rio.html#M000129">Rio#printf</a>!, <a
-href="../Rio.html#M000126">Rio#print</a>!, and <a
-href="../Rio.html#M000135">Rio#write</a>! behave as if their counterparts
-without the exclamation point had been called and then call <a
-href="../Rio.html#M000141">Rio#close</a> or Rio#close_write if the
-underlying IO object is opened for duplex access.
-</p>
-<h4>Open mode selection</h4>
-<p>
-A <a href="../Rio.html">Rio</a> is typically not explicitly opened. It
-opens a file automatically when an input or output methed is called. For
-output methods <a href="../Rio.html">Rio</a> opens a file with mode
-&#8216;w&#8217;, and otherwise opens a file with mode &#8216;r&#8217;. This
-behavior can be modified using the tersely named methods <a
-href="../Rio.html#M000062">Rio#a</a>, <a
-href="../Rio.html#M000062">Rio#a</a>!, <a
-href="../Rio.html#M000064">Rio#r</a>, <a
-href="../Rio.html#M000064">Rio#r</a>!, <a
-href="../Rio.html#M000066">Rio#w</a>, and <a
-href="../Rio.html#M000066">Rio#w</a>!, which cause the <a
-href="../Rio.html">Rio</a> to use modes
-&#8216;a&#8217;,&#8217;a+&#8217;,&#8217;r&#8217;,&#8217;r+&#8217;,&#8217;w&#8217;,and
-&#8216;w+&#8217; respectively.
-</p>
-<p>
-One way to append a string to a file and close it in one line is
-</p>
-<pre>
- rio('afile').a.puts!(&quot;Hello World&quot;)
-</pre>
-<p>
-Run a cmd that must be opened for read and write
-</p>
-<pre>
- ans = rio(?-,'cat').w!.puts!(&quot;Hello Kitty&quot;).readlines
-</pre>
-<p>
-The automatic selection of mode can be bypassed entirely using <a
-href="../Rio.html#M000139">Rio#mode</a> and <a
-href="../Rio.html#M000007">Rio#open</a>.
-</p>
-<p>
-If a mode is specified using <tt>mode</tt>, the file will still be opened
-automatically, but the mode specified in the <tt>mode</tt> method will be
-used regardless of whether it makes sense.
-</p>
-<p>
-A <a href="../Rio.html">Rio</a> can also be opened explicitly using <a
-href="../Rio.html#M000007">Rio#open</a>. <tt>open</tt> takes one parameter,
-a mode. This also will override all of <a
-href="../Rio.html">Rio</a>&#8217;s automatic mode selection.
-</p>
-<hr size="1"></hr><p>
-See also:
-</p>
-<ul>
-<li><a href="SYNOPSIS.html">RIO::Doc::SYNOPSIS</a>
-</li>
-<li><a href="HOWTO.html">RIO::Doc::HOWTO</a>
-</li>
-<li><a href="../Rio.html">RIO::Rio</a>
-</li>
-</ul>
-    </div>
-   </div>
-  </div>
-    <!-- if includes -->
-    <div id="section">
-    <!-- if method_list -->
-  </div>
-<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>
-</div>
-</body>
-</html>