rio 0.3.1 → 0.3.2

data/doc/rdoc/classes/RIO/Rio.html

@@ -134,183 +134,182 @@ href="Doc/HOWTO.html">RIO::Doc::HOWTO</a>.
       <div class="name-list">
       <a href="#M000103">+</a>&nbsp;&nbsp;
       <a href="#M000102">/</a>&nbsp;&nbsp;
-      <a href="#M000052">&lt;</a>&nbsp;&nbsp;
-      <a href="#M000051">&lt;&lt;</a>&nbsp;&nbsp;
-      <a href="#M000013">==</a>&nbsp;&nbsp;
-      <a href="#M000014">===</a>&nbsp;&nbsp;
-      <a href="#M000017">=~</a>&nbsp;&nbsp;
-      <a href="#M000049">&gt;</a>&nbsp;&nbsp;
-      <a href="#M000050">&gt;&gt;</a>&nbsp;&nbsp;
-      <a href="#M000045">[]</a>&nbsp;&nbsp;
-      <a href="#M000063">a</a>&nbsp;&nbsp;
-      <a href="#M000064">a!</a>&nbsp;&nbsp;
-      <a href="#M000087">abs</a>&nbsp;&nbsp;
-      <a href="#M000181">abs?</a>&nbsp;&nbsp;
-      <a href="#M000182">absolute?</a>&nbsp;&nbsp;
-      <a href="#M000025">all</a>&nbsp;&nbsp;
-      <a href="#M000024">all?</a>&nbsp;&nbsp;
-      <a href="#M000164">atime</a>&nbsp;&nbsp;
-      <a href="#M000108">base</a>&nbsp;&nbsp;
+      <a href="#M000051">&lt;</a>&nbsp;&nbsp;
+      <a href="#M000050">&lt;&lt;</a>&nbsp;&nbsp;
+      <a href="#M000012">==</a>&nbsp;&nbsp;
+      <a href="#M000013">===</a>&nbsp;&nbsp;
+      <a href="#M000016">=~</a>&nbsp;&nbsp;
+      <a href="#M000048">&gt;</a>&nbsp;&nbsp;
+      <a href="#M000049">&gt;&gt;</a>&nbsp;&nbsp;
+      <a href="#M000044">[]</a>&nbsp;&nbsp;
+      <a href="#M000062">a</a>&nbsp;&nbsp;
+      <a href="#M000063">a!</a>&nbsp;&nbsp;
+      <a href="#M000086">abs</a>&nbsp;&nbsp;
+      <a href="#M000180">abs?</a>&nbsp;&nbsp;
+      <a href="#M000181">absolute?</a>&nbsp;&nbsp;
+      <a href="#M000024">all</a>&nbsp;&nbsp;
+      <a href="#M000023">all?</a>&nbsp;&nbsp;
+      <a href="#M000163">atime</a>&nbsp;&nbsp;
+      <a href="#M000088">base</a>&nbsp;&nbsp;
       <a href="#M000092">basename</a>&nbsp;&nbsp;
       <a href="#M000097">basename=</a>&nbsp;&nbsp;
-      <a href="#M000121">binmode</a>&nbsp;&nbsp;
-      <a href="#M000149">blockdev?</a>&nbsp;&nbsp;
-      <a href="#M000057">bytes</a>&nbsp;&nbsp;
-      <a href="#M000150">chardev?</a>&nbsp;&nbsp;
-      <a href="#M000018">chdir</a>&nbsp;&nbsp;
-      <a href="#M000076">chomp</a>&nbsp;&nbsp;
-      <a href="#M000075">chomp?</a>&nbsp;&nbsp;
-      <a href="#M000142">close</a>&nbsp;&nbsp;
-      <a href="#M000158">closed?</a>&nbsp;&nbsp;
-      <a href="#M000072">closeoncopy</a>&nbsp;&nbsp;
-      <a href="#M000074">closeoncopy?</a>&nbsp;&nbsp;
-      <a href="#M000069">closeoneof</a>&nbsp;&nbsp;
-      <a href="#M000071">closeoneof?</a>&nbsp;&nbsp;
-      <a href="#M000117">contents</a>&nbsp;&nbsp;
-      <a href="#M000165">ctime</a>&nbsp;&nbsp;
-      <a href="#M000047">delete</a>&nbsp;&nbsp;
-      <a href="#M000048">delete!</a>&nbsp;&nbsp;
-      <a href="#M000152">dir?</a>&nbsp;&nbsp;
-      <a href="#M000151">directory?</a>&nbsp;&nbsp;
+      <a href="#M000120">binmode</a>&nbsp;&nbsp;
+      <a href="#M000148">blockdev?</a>&nbsp;&nbsp;
+      <a href="#M000056">bytes</a>&nbsp;&nbsp;
+      <a href="#M000149">chardev?</a>&nbsp;&nbsp;
+      <a href="#M000017">chdir</a>&nbsp;&nbsp;
+      <a href="#M000075">chomp</a>&nbsp;&nbsp;
+      <a href="#M000074">chomp?</a>&nbsp;&nbsp;
+      <a href="#M000141">close</a>&nbsp;&nbsp;
+      <a href="#M000157">closed?</a>&nbsp;&nbsp;
+      <a href="#M000071">closeoncopy</a>&nbsp;&nbsp;
+      <a href="#M000073">closeoncopy?</a>&nbsp;&nbsp;
+      <a href="#M000068">closeoneof</a>&nbsp;&nbsp;
+      <a href="#M000070">closeoneof?</a>&nbsp;&nbsp;
+      <a href="#M000116">contents</a>&nbsp;&nbsp;
+      <a href="#M000164">ctime</a>&nbsp;&nbsp;
+      <a href="#M000046">delete</a>&nbsp;&nbsp;
+      <a href="#M000047">delete!</a>&nbsp;&nbsp;
+      <a href="#M000151">dir?</a>&nbsp;&nbsp;
+      <a href="#M000150">directory?</a>&nbsp;&nbsp;
       <a href="#M000093">dirname</a>&nbsp;&nbsp;
       <a href="#M000098">dirname=</a>&nbsp;&nbsp;
-      <a href="#M000019">dirs</a>&nbsp;&nbsp;
+      <a href="#M000018">dirs</a>&nbsp;&nbsp;
       <a href="#M000009">dup</a>&nbsp;&nbsp;
-      <a href="#M000046">each</a>&nbsp;&nbsp;
-      <a href="#M000123">each_byte</a>&nbsp;&nbsp;
-      <a href="#M000124">each_line</a>&nbsp;&nbsp;
-      <a href="#M000021">entries</a>&nbsp;&nbsp;
-      <a href="#M000137">eof?</a>&nbsp;&nbsp;
-      <a href="#M000016">eql?</a>&nbsp;&nbsp;
-      <a href="#M000167">executable?</a>&nbsp;&nbsp;
-      <a href="#M000168">executable_real?</a>&nbsp;&nbsp;
-      <a href="#M000153">exist?</a>&nbsp;&nbsp;
-      <a href="#M000086">expand_path</a>&nbsp;&nbsp;
+      <a href="#M000045">each</a>&nbsp;&nbsp;
+      <a href="#M000122">each_byte</a>&nbsp;&nbsp;
+      <a href="#M000123">each_line</a>&nbsp;&nbsp;
+      <a href="#M000020">entries</a>&nbsp;&nbsp;
+      <a href="#M000136">eof?</a>&nbsp;&nbsp;
+      <a href="#M000015">eql?</a>&nbsp;&nbsp;
+      <a href="#M000166">executable?</a>&nbsp;&nbsp;
+      <a href="#M000167">executable_real?</a>&nbsp;&nbsp;
+      <a href="#M000152">exist?</a>&nbsp;&nbsp;
+      <a href="#M000085">expand_path</a>&nbsp;&nbsp;
       <a href="#M000089">ext</a>&nbsp;&nbsp;
       <a href="#M000091">ext?</a>&nbsp;&nbsp;
       <a href="#M000094">extname</a>&nbsp;&nbsp;
       <a href="#M000096">extname=</a>&nbsp;&nbsp;
-      <a href="#M000143">fcntl</a>&nbsp;&nbsp;
-      <a href="#M000154">file?</a>&nbsp;&nbsp;
+      <a href="#M000142">fcntl</a>&nbsp;&nbsp;
+      <a href="#M000153">file?</a>&nbsp;&nbsp;
       <a href="#M000095">filename</a>&nbsp;&nbsp;
       <a href="#M000099">filename=</a>&nbsp;&nbsp;
-      <a href="#M000145">fileno</a>&nbsp;&nbsp;
-      <a href="#M000022">files</a>&nbsp;&nbsp;
-      <a href="#M000028">find</a>&nbsp;&nbsp;
-      <a href="#M000122">flush</a>&nbsp;&nbsp;
-      <a href="#M000159">fnmatch?</a>&nbsp;&nbsp;
-      <a href="#M000085">fspath</a>&nbsp;&nbsp;
-      <a href="#M000146">fsync</a>&nbsp;&nbsp;
-      <a href="#M000160">ftype</a>&nbsp;&nbsp;
-      <a href="#M000053">getrec</a>&nbsp;&nbsp;
-      <a href="#M000115">gets</a>&nbsp;&nbsp;
-      <a href="#M000029">glob</a>&nbsp;&nbsp;
-      <a href="#M000175">grpowned?</a>&nbsp;&nbsp;
+      <a href="#M000144">fileno</a>&nbsp;&nbsp;
+      <a href="#M000021">files</a>&nbsp;&nbsp;
+      <a href="#M000027">find</a>&nbsp;&nbsp;
+      <a href="#M000121">flush</a>&nbsp;&nbsp;
+      <a href="#M000158">fnmatch?</a>&nbsp;&nbsp;
+      <a href="#M000084">fspath</a>&nbsp;&nbsp;
+      <a href="#M000145">fsync</a>&nbsp;&nbsp;
+      <a href="#M000159">ftype</a>&nbsp;&nbsp;
+      <a href="#M000052">getrec</a>&nbsp;&nbsp;
+      <a href="#M000114">gets</a>&nbsp;&nbsp;
+      <a href="#M000028">glob</a>&nbsp;&nbsp;
+      <a href="#M000174">grpowned?</a>&nbsp;&nbsp;
       <a href="#M000105">gsub</a>&nbsp;&nbsp;
-      <a href="#M000077">gzip</a>&nbsp;&nbsp;
-      <a href="#M000078">gzip?</a>&nbsp;&nbsp;
-      <a href="#M000015">hash</a>&nbsp;&nbsp;
-      <a href="#M000110">host</a>&nbsp;&nbsp;
+      <a href="#M000076">gzip</a>&nbsp;&nbsp;
+      <a href="#M000077">gzip?</a>&nbsp;&nbsp;
+      <a href="#M000014">hash</a>&nbsp;&nbsp;
+      <a href="#M000109">host</a>&nbsp;&nbsp;
       <a href="#M000005">initialize_copy</a>&nbsp;&nbsp;
       <a href="#M000010">inspect</a>&nbsp;&nbsp;
-      <a href="#M000144">ioctl</a>&nbsp;&nbsp;
-      <a href="#M000138">ioh</a>&nbsp;&nbsp;
-      <a href="#M000139">ios</a>&nbsp;&nbsp;
+      <a href="#M000143">ioctl</a>&nbsp;&nbsp;
+      <a href="#M000137">ioh</a>&nbsp;&nbsp;
+      <a href="#M000138">ios</a>&nbsp;&nbsp;
       <a href="#M000100">join</a>&nbsp;&nbsp;
       <a href="#M000106">join!</a>&nbsp;&nbsp;
-      <a href="#M000012">length</a>&nbsp;&nbsp;
-      <a href="#M000118">lineno</a>&nbsp;&nbsp;
-      <a href="#M000119">lineno=</a>&nbsp;&nbsp;
-      <a href="#M000056">lines</a>&nbsp;&nbsp;
-      <a href="#M000162">lstat</a>&nbsp;&nbsp;
-      <a href="#M000112">merge</a>&nbsp;&nbsp;
-      <a href="#M000033">mkdir</a>&nbsp;&nbsp;
-      <a href="#M000032">mkpath</a>&nbsp;&nbsp;
-      <a href="#M000140">mode</a>&nbsp;&nbsp;
-      <a href="#M000141">mode?</a>&nbsp;&nbsp;
-      <a href="#M000166">mtime</a>&nbsp;&nbsp;
+      <a href="#M000011">length</a>&nbsp;&nbsp;
+      <a href="#M000117">lineno</a>&nbsp;&nbsp;
+      <a href="#M000118">lineno=</a>&nbsp;&nbsp;
+      <a href="#M000055">lines</a>&nbsp;&nbsp;
+      <a href="#M000161">lstat</a>&nbsp;&nbsp;
+      <a href="#M000111">merge</a>&nbsp;&nbsp;
+      <a href="#M000032">mkdir</a>&nbsp;&nbsp;
+      <a href="#M000031">mkpath</a>&nbsp;&nbsp;
+      <a href="#M000139">mode</a>&nbsp;&nbsp;
+      <a href="#M000140">mode?</a>&nbsp;&nbsp;
+      <a href="#M000165">mtime</a>&nbsp;&nbsp;
       <a href="#M000004">new</a>&nbsp;&nbsp;
-      <a href="#M000073">nocloseoncopy</a>&nbsp;&nbsp;
-      <a href="#M000070">nocloseoneof</a>&nbsp;&nbsp;
-      <a href="#M000020">nodirs</a>&nbsp;&nbsp;
+      <a href="#M000072">nocloseoncopy</a>&nbsp;&nbsp;
+      <a href="#M000069">nocloseoneof</a>&nbsp;&nbsp;
+      <a href="#M000019">nodirs</a>&nbsp;&nbsp;
       <a href="#M000090">noext</a>&nbsp;&nbsp;
-      <a href="#M000023">nofiles</a>&nbsp;&nbsp;
-      <a href="#M000060">nolines</a>&nbsp;&nbsp;
-      <a href="#M000059">norecords</a>&nbsp;&nbsp;
-      <a href="#M000027">norecurse</a>&nbsp;&nbsp;
-      <a href="#M000062">norows</a>&nbsp;&nbsp;
-      <a href="#M000080">nosync</a>&nbsp;&nbsp;
-      <a href="#M000111">opaque</a>&nbsp;&nbsp;
+      <a href="#M000022">nofiles</a>&nbsp;&nbsp;
+      <a href="#M000059">nolines</a>&nbsp;&nbsp;
+      <a href="#M000058">norecords</a>&nbsp;&nbsp;
+      <a href="#M000026">norecurse</a>&nbsp;&nbsp;
+      <a href="#M000061">norows</a>&nbsp;&nbsp;
+      <a href="#M000079">nosync</a>&nbsp;&nbsp;
+      <a href="#M000110">opaque</a>&nbsp;&nbsp;
       <a href="#M000007">open</a>&nbsp;&nbsp;
-      <a href="#M000157">open?</a>&nbsp;&nbsp;
-      <a href="#M000174">owned?</a>&nbsp;&nbsp;
-      <a href="#M000082">path</a>&nbsp;&nbsp;
-      <a href="#M000163">pipe?</a>&nbsp;&nbsp;
-      <a href="#M000042">pos</a>&nbsp;&nbsp;
-      <a href="#M000044">pos=</a>&nbsp;&nbsp;
-      <a href="#M000127">print</a>&nbsp;&nbsp;
-      <a href="#M000128">print!</a>&nbsp;&nbsp;
-      <a href="#M000130">printf</a>&nbsp;&nbsp;
-      <a href="#M000129">printf!</a>&nbsp;&nbsp;
-      <a href="#M000132">putc</a>&nbsp;&nbsp;
-      <a href="#M000131">putc!</a>&nbsp;&nbsp;
-      <a href="#M000133">puts</a>&nbsp;&nbsp;
-      <a href="#M000134">puts!</a>&nbsp;&nbsp;
-      <a href="#M000065">r</a>&nbsp;&nbsp;
-      <a href="#M000066">r!</a>&nbsp;&nbsp;
-      <a href="#M000039">read</a>&nbsp;&nbsp;
-      <a href="#M000169">readable?</a>&nbsp;&nbsp;
-      <a href="#M000170">readable_real?</a>&nbsp;&nbsp;
-      <a href="#M000126">readline</a>&nbsp;&nbsp;
-      <a href="#M000125">readlines</a>&nbsp;&nbsp;
-      <a href="#M000037">readlink</a>&nbsp;&nbsp;
-      <a href="#M000120">recno</a>&nbsp;&nbsp;
-      <a href="#M000058">records</a>&nbsp;&nbsp;
-      <a href="#M000026">recurse</a>&nbsp;&nbsp;
-      <a href="#M000088">rel</a>&nbsp;&nbsp;
-      <a href="#M000038">rename</a>&nbsp;&nbsp;
-      <a href="#M000054">reset</a>&nbsp;&nbsp;
-      <a href="#M000040">rewind</a>&nbsp;&nbsp;
+      <a href="#M000156">open?</a>&nbsp;&nbsp;
+      <a href="#M000173">owned?</a>&nbsp;&nbsp;
+      <a href="#M000081">path</a>&nbsp;&nbsp;
+      <a href="#M000162">pipe?</a>&nbsp;&nbsp;
+      <a href="#M000041">pos</a>&nbsp;&nbsp;
+      <a href="#M000043">pos=</a>&nbsp;&nbsp;
+      <a href="#M000126">print</a>&nbsp;&nbsp;
+      <a href="#M000127">print!</a>&nbsp;&nbsp;
+      <a href="#M000129">printf</a>&nbsp;&nbsp;
+      <a href="#M000128">printf!</a>&nbsp;&nbsp;
+      <a href="#M000131">putc</a>&nbsp;&nbsp;
+      <a href="#M000130">putc!</a>&nbsp;&nbsp;
+      <a href="#M000132">puts</a>&nbsp;&nbsp;
+      <a href="#M000133">puts!</a>&nbsp;&nbsp;
+      <a href="#M000064">r</a>&nbsp;&nbsp;
+      <a href="#M000065">r!</a>&nbsp;&nbsp;
+      <a href="#M000038">read</a>&nbsp;&nbsp;
+      <a href="#M000168">readable?</a>&nbsp;&nbsp;
+      <a href="#M000169">readable_real?</a>&nbsp;&nbsp;
+      <a href="#M000125">readline</a>&nbsp;&nbsp;
+      <a href="#M000124">readlines</a>&nbsp;&nbsp;
+      <a href="#M000036">readlink</a>&nbsp;&nbsp;
+      <a href="#M000119">recno</a>&nbsp;&nbsp;
+      <a href="#M000057">records</a>&nbsp;&nbsp;
+      <a href="#M000025">recurse</a>&nbsp;&nbsp;
+      <a href="#M000087">rel</a>&nbsp;&nbsp;
+      <a href="#M000037">rename</a>&nbsp;&nbsp;
+      <a href="#M000053">reset</a>&nbsp;&nbsp;
+      <a href="#M000039">rewind</a>&nbsp;&nbsp;
       <a href="#M000006">rio</a>&nbsp;&nbsp;
-      <a href="#M000055">rl</a>&nbsp;&nbsp;
-      <a href="#M000034">rm</a>&nbsp;&nbsp;
-      <a href="#M000030">rmdir</a>&nbsp;&nbsp;
-      <a href="#M000031">rmtree</a>&nbsp;&nbsp;
+      <a href="#M000054">rl</a>&nbsp;&nbsp;
+      <a href="#M000033">rm</a>&nbsp;&nbsp;
+      <a href="#M000029">rmdir</a>&nbsp;&nbsp;
+      <a href="#M000030">rmtree</a>&nbsp;&nbsp;
       <a href="#M000107">rootpath</a>&nbsp;&nbsp;
-      <a href="#M000113">route_from</a>&nbsp;&nbsp;
-      <a href="#M000114">route_to</a>&nbsp;&nbsp;
-      <a href="#M000061">rows</a>&nbsp;&nbsp;
-      <a href="#M000109">scheme</a>&nbsp;&nbsp;
-      <a href="#M000041">seek</a>&nbsp;&nbsp;
-      <a href="#M000176">setgid?</a>&nbsp;&nbsp;
-      <a href="#M000177">setuid?</a>&nbsp;&nbsp;
-      <a href="#M000178">size</a>&nbsp;&nbsp;
-      <a href="#M000179">size?</a>&nbsp;&nbsp;
-      <a href="#M000116">slurp</a>&nbsp;&nbsp;
-      <a href="#M000155">socket?</a>&nbsp;&nbsp;
+      <a href="#M000112">route_from</a>&nbsp;&nbsp;
+      <a href="#M000113">route_to</a>&nbsp;&nbsp;
+      <a href="#M000060">rows</a>&nbsp;&nbsp;
+      <a href="#M000108">scheme</a>&nbsp;&nbsp;
+      <a href="#M000040">seek</a>&nbsp;&nbsp;
+      <a href="#M000175">setgid?</a>&nbsp;&nbsp;
+      <a href="#M000176">setuid?</a>&nbsp;&nbsp;
+      <a href="#M000177">size</a>&nbsp;&nbsp;
+      <a href="#M000178">size?</a>&nbsp;&nbsp;
+      <a href="#M000115">slurp</a>&nbsp;&nbsp;
+      <a href="#M000154">socket?</a>&nbsp;&nbsp;
       <a href="#M000101">split</a>&nbsp;&nbsp;
-      <a href="#M000161">stat</a>&nbsp;&nbsp;
-      <a href="#M000173">sticky?</a>&nbsp;&nbsp;
+      <a href="#M000160">stat</a>&nbsp;&nbsp;
+      <a href="#M000172">sticky?</a>&nbsp;&nbsp;
       <a href="#M000104">sub</a>&nbsp;&nbsp;
-      <a href="#M000036">symlink</a>&nbsp;&nbsp;
-      <a href="#M000156">symlink?</a>&nbsp;&nbsp;
-      <a href="#M000079">sync</a>&nbsp;&nbsp;
-      <a href="#M000081">sync?</a>&nbsp;&nbsp;
-      <a href="#M000043">tell</a>&nbsp;&nbsp;
-      <a href="#M000011">to_rl</a>&nbsp;&nbsp;
+      <a href="#M000035">symlink</a>&nbsp;&nbsp;
+      <a href="#M000155">symlink?</a>&nbsp;&nbsp;
+      <a href="#M000078">sync</a>&nbsp;&nbsp;
+      <a href="#M000080">sync?</a>&nbsp;&nbsp;
+      <a href="#M000042">tell</a>&nbsp;&nbsp;
       <a href="#M000008">to_s</a>&nbsp;&nbsp;
-      <a href="#M000084">to_uri</a>&nbsp;&nbsp;
-      <a href="#M000083">to_url</a>&nbsp;&nbsp;
-      <a href="#M000035">touch</a>&nbsp;&nbsp;
-      <a href="#M000147">tty?</a>&nbsp;&nbsp;
-      <a href="#M000148">ungetc</a>&nbsp;&nbsp;
-      <a href="#M000067">w</a>&nbsp;&nbsp;
-      <a href="#M000068">w!</a>&nbsp;&nbsp;
-      <a href="#M000171">writable?</a>&nbsp;&nbsp;
-      <a href="#M000172">writable_real?</a>&nbsp;&nbsp;
-      <a href="#M000136">write</a>&nbsp;&nbsp;
-      <a href="#M000135">write!</a>&nbsp;&nbsp;
-      <a href="#M000180">zero?</a>&nbsp;&nbsp;
+      <a href="#M000083">to_uri</a>&nbsp;&nbsp;
+      <a href="#M000082">to_url</a>&nbsp;&nbsp;
+      <a href="#M000034">touch</a>&nbsp;&nbsp;
+      <a href="#M000146">tty?</a>&nbsp;&nbsp;
+      <a href="#M000147">ungetc</a>&nbsp;&nbsp;
+      <a href="#M000066">w</a>&nbsp;&nbsp;
+      <a href="#M000067">w!</a>&nbsp;&nbsp;
+      <a href="#M000170">writable?</a>&nbsp;&nbsp;
+      <a href="#M000171">writable_real?</a>&nbsp;&nbsp;
+      <a href="#M000135">write</a>&nbsp;&nbsp;
+      <a href="#M000134">write!</a>&nbsp;&nbsp;
+      <a href="#M000179">zero?</a>&nbsp;&nbsp;
       </div>
     </div>
 
@@ -404,6 +403,9 @@ See <a href="../RIO.html#M000001">RIO.rio</a>
 Create a <a href="Rio.html">Rio</a> referencing <a
 href="Rio.html#M000008">Rio#to_s</a> + arg.to_s
 </p>
+<pre>
+ rio('afile') + '-0.1'   #=&gt; rio('afile-0.1')
+</pre>
         </div>
       </div>
 
@@ -439,12 +441,12 @@ Effectively the same as <a href="Rio.html#M000100">Rio#join</a>(arg)
         </div>
       </div>
 
-      <div id="method-M000052" class="method-detail">
-        <a name="M000052"></a>
+      <div id="method-M000051" class="method-detail">
+        <a name="M000051"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000052.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000052.html');return false;">
+          <a href="Rio.src/M000051.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000051.html');return false;">
           <span class="method-name">&lt;</span><span class="method-args">(source)</span>
           </a>
         </div>
@@ -583,17 +585,17 @@ to copy files.
 </pre>
 <p>
 See also <a href="Rio.html">Rio</a>#&gt; (copy-to), <a
-href="Rio.html#M000046">Rio#each</a>, <a href="Rio.html">Rio</a>#[]
+href="Rio.html#M000045">Rio#each</a>, <a href="Rio.html">Rio</a>#[]
 </p>
         </div>
       </div>
 
-      <div id="method-M000051" class="method-detail">
-        <a name="M000051"></a>
+      <div id="method-M000050" class="method-detail">
+        <a name="M000050"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000051.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000051.html');return false;">
+          <a href="Rio.src/M000050.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000050.html');return false;">
           <span class="method-name">&lt;&lt;</span><span class="method-args">(source)</span>
           </a>
         </div>
@@ -621,7 +623,7 @@ href="Rio.html">Rio</a>.
 
 </td></tr>
 <tr><td valign="top">String:</td><td>The string is appended to the <a href="Rio.html">Rio</a> using <a
-href="Rio.html#M000127">Rio#print</a>
+href="Rio.html#M000126">Rio#print</a>
 
 </td></tr>
 <tr><td valign="top"><a href="Rio.html">Rio</a>:</td><td>The source <a href="Rio.html">Rio</a> is appended using its <a
@@ -635,12 +637,12 @@ See <a href="Rio.html">Rio</a>#&lt; (copy-from)
         </div>
       </div>
 
-      <div id="method-M000013" class="method-detail">
-        <a name="M000013"></a>
+      <div id="method-M000012" class="method-detail">
+        <a name="M000012"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000013.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000013.html');return false;">
+          <a href="Rio.src/M000012.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000012.html');return false;">
           <span class="method-name">==</span><span class="method-args">(other)</span>
           </a>
         </div>
@@ -654,12 +656,12 @@ href="Rio.html#M000008">Rio#to_s</a>
         </div>
       </div>
 
-      <div id="method-M000014" class="method-detail">
-        <a name="M000014"></a>
+      <div id="method-M000013" class="method-detail">
+        <a name="M000013"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000014.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000014.html');return false;">
+          <a href="Rio.src/M000013.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000013.html');return false;">
           <span class="method-name">===</span><span class="method-args">(other)</span>
           </a>
         </div>
@@ -671,12 +673,12 @@ Equality (for case statements) same as <a href="Rio.html">Rio</a>#==
         </div>
       </div>
 
-      <div id="method-M000017" class="method-detail">
-        <a name="M000017"></a>
+      <div id="method-M000016" class="method-detail">
+        <a name="M000016"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000017.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000017.html');return false;">
+          <a href="Rio.src/M000016.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000016.html');return false;">
           <span class="method-name">=~</span><span class="method-args">(other)</span>
           </a>
         </div>
@@ -689,12 +691,12 @@ href="Rio.html#M000008">Rio#to_s</a>
         </div>
       </div>
 
-      <div id="method-M000049" class="method-detail">
-        <a name="M000049"></a>
+      <div id="method-M000048" class="method-detail">
+        <a name="M000048"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000049.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000049.html');return false;">
+          <a href="Rio.src/M000048.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000048.html');return false;">
           <span class="method-name">&gt;</span><span class="method-args">(destination)</span>
           </a>
         </div>
@@ -812,12 +814,12 @@ semi-colons as separators
         </div>
       </div>
 
-      <div id="method-M000050" class="method-detail">
-        <a name="M000050"></a>
+      <div id="method-M000049" class="method-detail">
+        <a name="M000049"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000050.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000050.html');return false;">
+          <a href="Rio.src/M000049.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000049.html');return false;">
           <span class="method-name">&gt;&gt;</span><span class="method-args">(destination)</span>
           </a>
         </div>
@@ -864,12 +866,12 @@ See <a href="Rio.html">Rio</a>#&gt; (copy-to)
         </div>
       </div>
 
-      <div id="method-M000045" class="method-detail">
-        <a name="M000045"></a>
+      <div id="method-M000044" class="method-detail">
+        <a name="M000044"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000045.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000045.html');return false;">
+          <a href="Rio.src/M000044.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000044.html');return false;">
           <span class="method-name">[]</span><span class="method-args">(*selectors)</span>
           </a>
         </div>
@@ -887,7 +889,7 @@ For directories this returns all or some of the entries in a directory
 <h3>Files</h3>
 <p>
 This combines the record selection offered by <a
-href="Rio.html#M000058">Rio#records</a> with the conversion to an array
+href="Rio.html#M000057">Rio#records</a> with the conversion to an array
 provided by Rio#to_a. The following two are equivelant:
 </p>
 <ul>
@@ -900,9 +902,9 @@ provided by Rio#to_a. The following two are equivelant:
 </ul>
 <p>
 What constitutes an array element is determined by <a
-href="Rio.html#M000056">Rio#lines</a>, <a
-href="Rio.html#M000057">Rio#bytes</a>, or by an extension such as Rio#csv.
-<a href="Rio.html#M000056">Rio#lines</a> is the default.
+href="Rio.html#M000055">Rio#lines</a>, <a
+href="Rio.html#M000056">Rio#bytes</a>, or by an extension such as Rio#csv.
+<a href="Rio.html#M000055">Rio#lines</a> is the default.
 </p>
 <p>
 Arguments may consist of zero or more integers, ranges, regular
@@ -936,7 +938,7 @@ array. (acts like an <em>or</em>)
 </p>
 <p>
 Because this is implemented in terms of the <a
-href="Rio.html#M000046">Rio#each</a>, When only record ranges are used to
+href="Rio.html#M000045">Rio#each</a>, When only record ranges are used to
 select records, iteration will stop when the recno exceeds the maximum of
 any range. That is to say
 </p>
@@ -955,7 +957,7 @@ While this reads <b>all</b> records from a file and returns the first one
 <h3>Directories</h3>
 <p>
 This combines the entry selection offered by <a
-href="Rio.html#M000021">Rio#entries</a> with the conversion to an array
+href="Rio.html#M000020">Rio#entries</a> with the conversion to an array
 provided by Rio#to_a. The following two are equivelant:
 </p>
 <ul>
@@ -971,7 +973,7 @@ Arguments may consist of strings (treated as globs) or regular expressions.
 An empty argument list selects all entries See ::Dir#glob and
 ::File::fnmatch? for more in information on <em>globs</em>. Be warned that
 using the &#8217;**&#8217; glob recurses into directories independently of
-<a href="Rio.html#M000025">Rio#all</a> and using both is unsupported.
+<a href="Rio.html#M000024">Rio#all</a> and using both is unsupported.
 </p>
 <pre>
  ario = rio('adir')
@@ -980,30 +982,30 @@ using the &#8217;**&#8217; glob recurses into directories independently of
  ario['zippy*'] # same thing
 </pre>
 <p>
-As with <a href="Rio.html#M000046">Rio#each</a>:
+As with <a href="Rio.html#M000045">Rio#each</a>:
 </p>
 <ul>
 <li>Files and directories are returned as Rios
 
 </li>
 <li>The types of entries is also affected by <a
-href="Rio.html#M000022">Rio#files</a> and <a
-href="Rio.html#M000019">Rio#dirs</a>.
+href="Rio.html#M000021">Rio#files</a> and <a
+href="Rio.html#M000018">Rio#dirs</a>.
 
 <pre>
  rio('adir').files['*.txt'] # array of all _.txt_ files
  rio('adir').dirs(/^\./) # array of all dot directories
 </pre>
 </li>
-<li>Recursion is enabled using <a href="Rio.html#M000025">Rio#all</a>
+<li>Recursion is enabled using <a href="Rio.html#M000024">Rio#all</a>
 
 <pre>
  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
 </pre>
 </li>
-<li><a href="Rio.html#M000022">Rio#files</a> and <a
-href="Rio.html#M000019">Rio#dirs</a> act independetly of each other.
+<li><a href="Rio.html#M000021">Rio#files</a> and <a
+href="Rio.html#M000018">Rio#dirs</a> act independetly of each other.
 Specifying both will cause both to be returned. The argument list to <a
 href="Rio.html">Rio</a>#[] will be applied to the closest.
 
@@ -1016,15 +1018,15 @@ href="Rio.html">Rio</a>#[] will be applied to the closest.
 </ul>
 <h3>Lines</h3>
 <p>
-This section applies similarly to <a href="Rio.html#M000056">Rio#lines</a>,
-<a href="Rio.html#M000057">Rio#bytes</a>, <a
-href="Rio.html#M000058">Rio#records</a>, and <a
-href="Rio.html#M000061">Rio#rows</a>
+This section applies similarly to <a href="Rio.html#M000055">Rio#lines</a>,
+<a href="Rio.html#M000056">Rio#bytes</a>, <a
+href="Rio.html#M000057">Rio#records</a>, and <a
+href="Rio.html#M000060">Rio#rows</a>
 </p>
 <p>
-Using <a href="Rio.html#M000056">Rio#lines</a> and related methods with a
+Using <a href="Rio.html#M000055">Rio#lines</a> and related methods with a
 <a href="Rio.html">Rio</a> referencing a directory imples <a
-href="Rio.html#M000022">Rio#files</a> and will cause an array of the lines
+href="Rio.html#M000021">Rio#files</a> and will cause an array of the lines
 or bytes in the files to be returned. As above, the arguments to the
 subscript operator will be applied to the closest.
 </p>
@@ -1092,12 +1094,12 @@ Examples:
         </div>
       </div>
 
-      <div id="method-M000063" class="method-detail">
-        <a name="M000063"></a>
+      <div id="method-M000062" class="method-detail">
+        <a name="M000062"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000063.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000063.html');return false;">
+          <a href="Rio.src/M000062.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000062.html');return false;">
           <span class="method-name">a</span><span class="method-args">()</span>
           </a>
         </div>
@@ -1117,19 +1119,19 @@ file system object and on the action specified. For instance when a <a
 href="Rio.html">Rio</a> encounters a <tt>read</tt> on a file it opens the
 file for reading using File#open and calls IO#read; when it encounters a
 <tt>read</tt> on a directory it knows to use Dir#open and call Dir#read.
-When it encounters a <a href="Rio.html#M000133">Rio#puts</a>, it knows to
+When it encounters a <a href="Rio.html#M000132">Rio#puts</a>, it knows to
 perform a File#open, and call IO#puts on the returned handle. By default
 when a method requires a file be opened for writing the file is opened with
-a mode of &#8216;w&#8217;. <a href="Rio.html#M000063">Rio#a</a> changes
+a mode of &#8216;w&#8217;. <a href="Rio.html#M000062">Rio#a</a> changes
 this implicit output mode to &#8216;a&#8217;.
 </p>
 <p>
 Note that this is not the same as setting the output mode
 <b>explicitly</b>, as in rio(&#8216;afile&#8217;).mode(&#8216;a&#8217;).
 When the mode is set explicitly using <a
-href="Rio.html#M000140">Rio#mode</a>, the mode specified will be used
+href="Rio.html#M000139">Rio#mode</a>, the mode specified will be used
 regardless of the operation being performed. The <a
-href="Rio.html#M000063">Rio#a</a> method only affects how <a
+href="Rio.html#M000062">Rio#a</a> method only affects how <a
 href="Rio.html">Rio</a> opens a file when it sees an operator that requires
 writing, and must determine for itself how to open it.
 </p>
@@ -1138,15 +1140,15 @@ writing, and must determine for itself how to open it.
  rio('afile').a.puts!('Hello World') # call IO#puts on a file handle opened in 'a' mode
 </pre>
 <p>
-See also <a href="Rio.html#M000063">Rio#a</a>!, <a
-href="Rio.html#M000067">Rio#w</a>! for setting the implicit output mode
+See also <a href="Rio.html#M000062">Rio#a</a>!, <a
+href="Rio.html#M000066">Rio#w</a>! for setting the implicit output mode
 &#8216;a+&#8217; and &#8216;w+&#8217; respectively
 </p>
 <p>
-The methods <a href="Rio.html#M000063">Rio#a</a>, <a
-href="Rio.html#M000063">Rio#a</a>!, <a href="Rio.html#M000067">Rio#w</a>,
-<a href="Rio.html#M000067">Rio#w</a>!, <a
-href="Rio.html#M000065">Rio#r</a>, <a href="Rio.html#M000065">Rio#r</a>!
+The methods <a href="Rio.html#M000062">Rio#a</a>, <a
+href="Rio.html#M000062">Rio#a</a>!, <a href="Rio.html#M000066">Rio#w</a>,
+<a href="Rio.html#M000066">Rio#w</a>!, <a
+href="Rio.html#M000064">Rio#r</a>, <a href="Rio.html#M000064">Rio#r</a>!
 set the <tt>implicit</tt> open mode to
 &#8216;a&#8217;,&#8217;a+&#8217;,&#8217;w&#8217;,&#8217;w+&#8217;,&#8217;r&#8217;
 and &#8216;r+&#8217; respectively.
@@ -1154,12 +1156,12 @@ and &#8216;r+&#8217; respectively.
         </div>
       </div>
 
-      <div id="method-M000064" class="method-detail">
-        <a name="M000064"></a>
+      <div id="method-M000063" class="method-detail">
+        <a name="M000063"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000064.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000064.html');return false;">
+          <a href="Rio.src/M000063.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000063.html');return false;">
           <span class="method-name">a!</span><span class="method-args">()</span>
           </a>
         </div>
@@ -1176,17 +1178,17 @@ for output when no mode is specified.
 Returns the <a href="Rio.html">Rio</a>
 </p>
 <p>
-See the discussion for <a href="Rio.html#M000063">Rio#a</a>.
+See the discussion for <a href="Rio.html#M000062">Rio#a</a>.
 </p>
         </div>
       </div>
 
-      <div id="method-M000087" class="method-detail">
-        <a name="M000087"></a>
+      <div id="method-M000086" class="method-detail">
+        <a name="M000086"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000087.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000087.html');return false;">
+          <a href="Rio.src/M000086.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000086.html');return false;">
           <span class="method-name">abs</span><span class="method-args">(*args)</span>
           </a>
         </div>
@@ -1202,12 +1204,12 @@ Returns a new rio with a path equal to the absolute path of this rio
         </div>
       </div>
 
-      <div id="method-M000181" class="method-detail">
-        <a name="M000181"></a>
+      <div id="method-M000180" class="method-detail">
+        <a name="M000180"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000181.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000181.html');return false;">
+          <a href="Rio.src/M000180.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000180.html');return false;">
           <span class="method-name">abs?</span><span class="method-args">()</span>
           </a>
         </div>
@@ -1226,12 +1228,12 @@ Rio#absolute?
         </div>
       </div>
 
-      <div id="method-M000182" class="method-detail">
-        <a name="M000182"></a>
+      <div id="method-M000181" class="method-detail">
+        <a name="M000181"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000182.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000182.html');return false;">
+          <a href="Rio.src/M000181.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000181.html');return false;">
           <span class="method-name">absolute?</span><span class="method-args">()</span>
           </a>
         </div>
@@ -1250,12 +1252,12 @@ or URI. Calls URI#absolute?
         </div>
       </div>
 
-      <div id="method-M000025" class="method-detail">
-        <a name="M000025"></a>
+      <div id="method-M000024" class="method-detail">
+        <a name="M000024"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000025.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000025.html');return false;">
+          <a href="Rio.src/M000024.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000024.html');return false;">
           <span class="method-name">all</span><span class="method-args">(arg=true,&amp;block)</span>
           </a>
         </div>
@@ -1285,12 +1287,12 @@ be applied recursively to subdirectories
         </div>
       </div>
 
-      <div id="method-M000024" class="method-detail">
-        <a name="M000024"></a>
+      <div id="method-M000023" class="method-detail">
+        <a name="M000023"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000024.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000024.html');return false;">
+          <a href="Rio.src/M000023.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000023.html');return false;">
           <span class="method-name">all?</span><span class="method-args">()</span>
           </a>
         </div>
@@ -1298,7 +1300,7 @@ be applied recursively to subdirectories
         <div class="method-description">
           <p>
 Returns <tt>true</tt> if the rio is in <tt>all</tt> (recursive) mode. See
-<a href="Rio.html#M000025">Rio#all</a>
+<a href="Rio.html#M000024">Rio#all</a>
 </p>
 <pre>
  adir = rio('adir').all.dirs
@@ -1312,12 +1314,12 @@ Returns <tt>true</tt> if the rio is in <tt>all</tt> (recursive) mode. See
         </div>
       </div>
 
-      <div id="method-M000164" class="method-detail">
-        <a name="M000164"></a>
+      <div id="method-M000163" class="method-detail">
+        <a name="M000163"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000164.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000164.html');return false;">
+          <a href="Rio.src/M000163.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000163.html');return false;">
           <span class="method-name">atime</span><span class="method-args">(*args)</span>
           </a>
         </div>
@@ -1333,19 +1335,28 @@ referenced
         </div>
       </div>
 
-      <div id="method-M000108" class="method-detail">
-        <a name="M000108"></a>
+      <div id="method-M000088" class="method-detail">
+        <a name="M000088"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000108.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000108.html');return false;">
+          <a href="Rio.src/M000088.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000088.html');return false;">
           <span class="method-name">base</span><span class="method-args">()</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-<a href="Rio.html#M000108">Rio#base</a>
+Returns a new <a href="Rio.html">Rio</a> whose path is the base path that
+is used by <a href="Rio.html#M000086">Rio#abs</a> to create an absolute <a
+href="Rio.html">Rio</a> from a relative one.
+</p>
+<pre>
+ rio('/tmp').chdir
+ rio('afile').base # =&gt; rio('/tmp/')
+</pre>
+<p>
+See <a href="Rio.html#M000086">Rio#abs</a>.
 </p>
         </div>
       </div>
@@ -1417,17 +1428,17 @@ Returns the new value of <tt>basename</tt>
 </pre>
 <p>
 See <a href="Rio.html#M000092">Rio#basename</a>, <a
-href="Rio.html#M000038">Rio#rename</a>
+href="Rio.html#M000037">Rio#rename</a>
 </p>
         </div>
       </div>
 
-      <div id="method-M000121" class="method-detail">
-        <a name="M000121"></a>
+      <div id="method-M000120" class="method-detail">
+        <a name="M000120"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000121.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000121.html');return false;">
+          <a href="Rio.src/M000120.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000120.html');return false;">
           <span class="method-name">binmode</span><span class="method-args">()</span>
           </a>
         </div>
@@ -1450,12 +1461,12 @@ Returns the <a href="Rio.html">Rio</a>.
         </div>
       </div>
 
-      <div id="method-M000149" class="method-detail">
-        <a name="M000149"></a>
+      <div id="method-M000148" class="method-detail">
+        <a name="M000148"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000149.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000149.html');return false;">
+          <a href="Rio.src/M000148.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000148.html');return false;">
           <span class="method-name">blockdev?</span><span class="method-args">()</span>
           </a>
         </div>
@@ -1473,12 +1484,12 @@ Returns <tt>true</tt> if the named file is a block device.
         </div>
       </div>
 
-      <div id="method-M000057" class="method-detail">
-        <a name="M000057"></a>
+      <div id="method-M000056" class="method-detail">
+        <a name="M000056"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000057.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000057.html');return false;">
+          <a href="Rio.src/M000056.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000056.html');return false;">
           <span class="method-name">bytes</span><span class="method-args">(n=1,*args,&amp;block)</span>
           </a>
         </div>
@@ -1489,12 +1500,12 @@ Sets the rio to read bytes and returns the rio
 </p>
 <p>
 <em>n</em> specifies the number of bytes to be returned on each iteration
-of <a href="Rio.html#M000046">Rio#each</a> or by <a
-href="Rio.html#M000053">Rio#getrec</a>. If <em>args</em> are provided, they
+of <a href="Rio.html#M000045">Rio#each</a> or by <a
+href="Rio.html#M000052">Rio#getrec</a>. If <em>args</em> are provided, they
 are treated as record selectors as if <tt>ario.bytes(n).records(*args)</tt>
-had been called. See also <a href="Rio.html#M000058">Rio#records</a>, <a
-href="Rio.html#M000056">Rio#lines</a>, <a
-href="Rio.html#M000046">Rio#each</a>, <a href="Rio.html">Rio</a>#[]
+had been called. See also <a href="Rio.html#M000057">Rio#records</a>, <a
+href="Rio.html#M000055">Rio#lines</a>, <a
+href="Rio.html#M000045">Rio#each</a>, <a href="Rio.html">Rio</a>#[]
 </p>
 <p>
 If called with a block behaves as if
@@ -1519,12 +1530,12 @@ If called with a block behaves as if
         </div>
       </div>
 
-      <div id="method-M000150" class="method-detail">
-        <a name="M000150"></a>
+      <div id="method-M000149" class="method-detail">
+        <a name="M000149"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000150.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000150.html');return false;">
+          <a href="Rio.src/M000149.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000149.html');return false;">
           <span class="method-name">chardev?</span><span class="method-args">()</span>
           </a>
         </div>
@@ -1542,12 +1553,12 @@ Returns <tt>true</tt> if the named file is a character device.
         </div>
       </div>
 
-      <div id="method-M000018" class="method-detail">
-        <a name="M000018"></a>
+      <div id="method-M000017" class="method-detail">
+        <a name="M000017"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000018.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000018.html');return false;">
+          <a href="Rio.src/M000017.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000017.html');return false;">
           <span class="method-name">chdir</span><span class="method-args">(&amp;block)</span>
           </a>
         </div>
@@ -1580,12 +1591,12 @@ Returns the <a href="Rio.html">Rio</a>
         </div>
       </div>
 
-      <div id="method-M000076" class="method-detail">
-        <a name="M000076"></a>
+      <div id="method-M000075" class="method-detail">
+        <a name="M000075"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000076.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000076.html');return false;">
+          <a href="Rio.src/M000075.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000075.html');return false;">
           <span class="method-name">chomp</span><span class="method-args">(arg=true,&amp;block)</span>
           </a>
         </div>
@@ -1601,7 +1612,7 @@ called
 </p>
 <p>
 chomp causes lines returned by each, to_a, readlines, readline, gets, <a
-href="Rio.html#M000124">each_line</a> etc. to be chomped before iterated
+href="Rio.html#M000123">each_line</a> etc. to be chomped before iterated
 over or assigned
 </p>
 <pre>
@@ -1633,12 +1644,12 @@ over or assigned
         </div>
       </div>
 
-      <div id="method-M000075" class="method-detail">
-        <a name="M000075"></a>
+      <div id="method-M000074" class="method-detail">
+        <a name="M000074"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000075.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000075.html');return false;">
+          <a href="Rio.src/M000074.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000074.html');return false;">
           <span class="method-name">chomp?</span><span class="method-args">()</span>
           </a>
         </div>
@@ -1646,17 +1657,17 @@ over or assigned
         <div class="method-description">
           <p>
 Queries the <a href="Rio.html">Rio</a>&#8217;s chomp-mode. See <a
-href="Rio.html#M000076">Rio#chomp</a>.
+href="Rio.html#M000075">Rio#chomp</a>.
 </p>
         </div>
       </div>
 
-      <div id="method-M000142" class="method-detail">
-        <a name="M000142"></a>
+      <div id="method-M000141" class="method-detail">
+        <a name="M000141"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000142.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000142.html');return false;">
+          <a href="Rio.src/M000141.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000141.html');return false;">
           <span class="method-name">close</span><span class="method-args">()</span>
           </a>
         </div>
@@ -1677,12 +1688,12 @@ automatically closed when they are claimed by the garbage collector.
         </div>
       </div>
 
-      <div id="method-M000158" class="method-detail">
-        <a name="M000158"></a>
+      <div id="method-M000157" class="method-detail">
+        <a name="M000157"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000158.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000158.html');return false;">
+          <a href="Rio.src/M000157.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000157.html');return false;">
           <span class="method-name">closed?</span><span class="method-args">()</span>
           </a>
         </div>
@@ -1701,12 +1712,12 @@ streams, both reader and writer), <tt>false</tt> otherwise.
         </div>
       </div>
 
-      <div id="method-M000072" class="method-detail">
-        <a name="M000072"></a>
+      <div id="method-M000071" class="method-detail">
+        <a name="M000071"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000072.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000072.html');return false;">
+          <a href="Rio.src/M000071.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000071.html');return false;">
           <span class="method-name">closeoncopy</span><span class="method-args">(arg=true,&amp;block)</span>
           </a>
         </div>
@@ -1719,12 +1730,12 @@ Set a <a href="Rio.html">Rio</a>&#8217;s closeoncopy mode
  ario.closeoncopy(&amp;block) =&gt; ario
 </pre>
 <p>
-<a href="Rio.html#M000072">Rio#closeoncopy</a> causes the <a
+<a href="Rio.html#M000071">Rio#closeoncopy</a> causes the <a
 href="Rio.html">Rio</a> being written to to be closed when using a grande
-copy operator. While <a href="Rio.html#M000069">Rio#closeoneof</a> causes
+copy operator. While <a href="Rio.html#M000068">Rio#closeoneof</a> causes
 all <a href="Rio.html">Rio</a>&#8217;s to be closed when reading to the end
 of file, it does not affect Rios being written to. <a
-href="Rio.html#M000072">Rio#closeoncopy</a> only affects the <a
+href="Rio.html#M000071">Rio#closeoncopy</a> only affects the <a
 href="Rio.html">Rio</a> being written to and only when a grande copy
 operator is used. <tt>closeoncopy</tt> is on by default, with one
 exception.
@@ -1815,12 +1826,12 @@ contact the author.
         </div>
       </div>
 
-      <div id="method-M000074" class="method-detail">
-        <a name="M000074"></a>
+      <div id="method-M000073" class="method-detail">
+        <a name="M000073"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000074.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000074.html');return false;">
+          <a href="Rio.src/M000073.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000073.html');return false;">
           <span class="method-name">closeoncopy?</span><span class="method-args">()</span>
           </a>
         </div>
@@ -1833,17 +1844,17 @@ Query a <a href="Rio.html">Rio</a>&#8217;s closeoncopy mode
     ario.closeoncopy? =&gt; true or false
 </pre>
 <p>
-See <a href="Rio.html#M000072">Rio#closeoncopy</a>
+See <a href="Rio.html#M000071">Rio#closeoncopy</a>
 </p>
         </div>
       </div>
 
-      <div id="method-M000069" class="method-detail">
-        <a name="M000069"></a>
+      <div id="method-M000068" class="method-detail">
+        <a name="M000068"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000069.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000069.html');return false;">
+          <a href="Rio.src/M000068.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000068.html');return false;">
           <span class="method-name">closeoneof</span><span class="method-args">(arg=true,&amp;block)</span>
           </a>
         </div>
@@ -1859,12 +1870,12 @@ Set the <a href="Rio.html">Rio</a>&#8217;s closeoneof mode.
 <tt>closeoneof</tt> causes a <a href="Rio.html">Rio</a> to be closed
 automatically whenever the end of file is reached. This is handled at the
 IO level, and thus affects all methods that read from a rio (<a
-href="Rio.html#M000125">Rio#readlines</a>, Rio#to_a, <a
-href="Rio.html#M000046">Rio#each</a> <a
-href="Rio.html#M000115">Rio#gets</a> etc.) Because <tt>closeoneof</tt> must
+href="Rio.html#M000124">Rio#readlines</a>, Rio#to_a, <a
+href="Rio.html#M000045">Rio#each</a> <a
+href="Rio.html#M000114">Rio#gets</a> etc.) Because <tt>closeoneof</tt> must
 be on for many of <a href="Rio.html">Rio</a>&#8217;s most useful idioms, it
 is on by default. <tt>closeoneof</tt> can be turned off using <a
-href="Rio.html#M000070">Rio#nocloseoneof</a>.
+href="Rio.html#M000069">Rio#nocloseoneof</a>.
 </p>
 <p>
 If a block is given behaves like <tt>ario.closeoneof.each(&amp;block)</tt>
@@ -1910,12 +1921,12 @@ directory&#8217;s setting
         </div>
       </div>
 
-      <div id="method-M000071" class="method-detail">
-        <a name="M000071"></a>
+      <div id="method-M000070" class="method-detail">
+        <a name="M000070"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000071.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000071.html');return false;">
+          <a href="Rio.src/M000070.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000070.html');return false;">
           <span class="method-name">closeoneof?</span><span class="method-args">()</span>
           </a>
         </div>
@@ -1928,8 +1939,8 @@ Query a <a href="Rio.html">Rio</a>&#8217;s closeoneof mode
  ario.closeoneof?    =&gt; true or false
 </pre>
 <p>
-See <a href="Rio.html#M000069">Rio#closeoneof</a> and <a
-href="Rio.html#M000070">Rio#nocloseoneof</a>
+See <a href="Rio.html#M000068">Rio#closeoneof</a> and <a
+href="Rio.html#M000069">Rio#nocloseoneof</a>
 </p>
 <pre>
  ario = rio('afile')
@@ -1946,12 +1957,12 @@ href="Rio.html#M000070">Rio#nocloseoneof</a>
         </div>
       </div>
 
-      <div id="method-M000117" class="method-detail">
-        <a name="M000117"></a>
+      <div id="method-M000116" class="method-detail">
+        <a name="M000116"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000117.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000117.html');return false;">
+          <a href="Rio.src/M000116.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000116.html');return false;">
           <span class="method-name">contents</span><span class="method-args">()</span>
           </a>
         </div>
@@ -1959,15 +1970,15 @@ href="Rio.html#M000070">Rio#nocloseoneof</a>
         <div class="method-description">
           <p>
 Returns the contents of the rio as a string. See also <a
-href="Rio.html#M000116">Rio#slurp</a>
+href="Rio.html#M000115">Rio#slurp</a>
 </p>
 <pre>
  astring = rio('afile.txt').contents # copies the entire contents of afile.txt into astring
 </pre>
 <p>
 Alpha Note: Considering removing <a
-href="Rio.html#M000117">Rio#contents</a> and <a
-href="Rio.html#M000116">Rio#slurp</a> in favor of <tt>to_string</tt>. Is
+href="Rio.html#M000116">Rio#contents</a> and <a
+href="Rio.html#M000115">Rio#slurp</a> in favor of <tt>to_string</tt>. Is
 this the Ruby way? Is it too confusing with a <tt><a
 href="Rio.html#M000008">to_s</a></tt> and <tt>to_str</tt> already? Is it a
 good idea?
@@ -1975,12 +1986,12 @@ good idea?
         </div>
       </div>
 
-      <div id="method-M000165" class="method-detail">
-        <a name="M000165"></a>
+      <div id="method-M000164" class="method-detail">
+        <a name="M000164"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000165.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000165.html');return false;">
+          <a href="Rio.src/M000164.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000164.html');return false;">
           <span class="method-name">ctime</span><span class="method-args">(*args)</span>
           </a>
         </div>
@@ -1997,12 +2008,12 @@ itself).
         </div>
       </div>
 
-      <div id="method-M000047" class="method-detail">
-        <a name="M000047"></a>
+      <div id="method-M000046" class="method-detail">
+        <a name="M000046"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000047.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000047.html');return false;">
+          <a href="Rio.src/M000046.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000046.html');return false;">
           <span class="method-name">delete</span><span class="method-args">()</span>
           </a>
         </div>
@@ -2023,20 +2034,20 @@ href="Rio.html">Rio</a>.
         </div>
       </div>
 
-      <div id="method-M000048" class="method-detail">
-        <a name="M000048"></a>
+      <div id="method-M000047" class="method-detail">
+        <a name="M000047"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000048.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000048.html');return false;">
+          <a href="Rio.src/M000047.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000047.html');return false;">
           <span class="method-name">delete!</span><span class="method-args">()</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-For a file <a href="Rio.html#M000047">Rio#delete</a>! calls FileUtils#rm.
-For a directory <a href="Rio.html#M000047">Rio#delete</a>! calls
+For a file <a href="Rio.html#M000046">Rio#delete</a>! calls FileUtils#rm.
+For a directory <a href="Rio.html#M000046">Rio#delete</a>! calls
 FileUtils#rmtree Returns the <a href="Rio.html">Rio</a>. If the rio does
 not exist, simply return itself.
 </p>
@@ -2050,21 +2061,21 @@ not exist, simply return itself.
 <h4>Deleting Summary</h4>
 <ul>
 <li>To delete something only if it is not a directory use <a
-href="Rio.html#M000034">Rio#rm</a>
+href="Rio.html#M000033">Rio#rm</a>
 
 </li>
-<li>To delete an empty directory use <a href="Rio.html#M000030">Rio#rmdir</a>
+<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#M000031">Rio#rmtree</a>
+href="Rio.html#M000030">Rio#rmtree</a>
 
 </li>
 <li>To delete anything except a populated directory use <a
-href="Rio.html#M000047">Rio#delete</a>
+href="Rio.html#M000046">Rio#delete</a>
 
 </li>
-<li>To delete anything use <a href="Rio.html#M000047">Rio#delete</a>!
+<li>To delete anything use <a href="Rio.html#M000046">Rio#delete</a>!
 
 </li>
 </ul>
@@ -2075,12 +2086,12 @@ successful
         </div>
       </div>
 
-      <div id="method-M000152" class="method-detail">
-        <a name="M000152"></a>
+      <div id="method-M000151" class="method-detail">
+        <a name="M000151"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000152.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000152.html');return false;">
+          <a href="Rio.src/M000151.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000151.html');return false;">
           <span class="method-name">dir?</span><span class="method-args">()</span>
           </a>
         </div>
@@ -2089,12 +2100,12 @@ successful
         </div>
       </div>
 
-      <div id="method-M000151" class="method-detail">
-        <a name="M000151"></a>
+      <div id="method-M000150" class="method-detail">
+        <a name="M000150"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000151.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000151.html');return false;">
+          <a href="Rio.src/M000150.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000150.html');return false;">
           <span class="method-name">directory?</span><span class="method-args">()</span>
           </a>
         </div>
@@ -2170,17 +2181,17 @@ Returns the new value of <tt>dirname</tt>
 </pre>
 <p>
 See <a href="Rio.html#M000093">Rio#dirname</a>, <a
-href="Rio.html#M000038">Rio#rename</a>
+href="Rio.html#M000037">Rio#rename</a>
 </p>
         </div>
       </div>
 
-      <div id="method-M000019" class="method-detail">
-        <a name="M000019"></a>
+      <div id="method-M000018" class="method-detail">
+        <a name="M000018"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000019.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000019.html');return false;">
+          <a href="Rio.src/M000018.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000018.html');return false;">
           <span class="method-name">dirs</span><span class="method-args">(*args,&amp;block)</span>
           </a>
         </div>
@@ -2222,9 +2233,9 @@ If a block is given, behaves like
 <tt>ario.dirs(*args).each(&amp;block)</tt>
 </p>
 <p>
-See also <a href="Rio.html#M000022">Rio#files</a>, <a
-href="Rio.html#M000021">Rio#entries</a>, <a
-href="Rio.html#M000020">Rio#nodirs</a>
+See also <a href="Rio.html#M000021">Rio#files</a>, <a
+href="Rio.html#M000020">Rio#entries</a>, <a
+href="Rio.html#M000019">Rio#nodirs</a>
 </p>
 <pre>
  rio('adir').dirs { |frio| ... } # process all directories in 'adir'
@@ -2250,12 +2261,12 @@ href="Rio.html#M000020">Rio#nodirs</a>
         </div>
       </div>
 
-      <div id="method-M000046" class="method-detail">
-        <a name="M000046"></a>
+      <div id="method-M000045" class="method-detail">
+        <a name="M000045"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000046.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000046.html');return false;">
+          <a href="Rio.src/M000045.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000045.html');return false;">
           <span class="method-name">each</span><span class="method-args">(*args,&amp;block)</span>
           </a>
         </div>
@@ -2263,29 +2274,29 @@ href="Rio.html#M000020">Rio#nodirs</a>
         <div class="method-description">
           <p>
 Iterate through a rio. Executes the block for each item selected for the <a
-href="Rio.html">Rio</a>. See <a href="Rio.html#M000056">Rio#lines</a>, <a
-href="Rio.html#M000058">Rio#records</a>, <a
-href="Rio.html#M000057">Rio#bytes</a>, <a
-href="Rio.html#M000022">Rio#files</a>, <a
-href="Rio.html#M000019">Rio#dirs</a>, <a href="Rio.html">Rio</a>#[] and
+href="Rio.html">Rio</a>. See <a href="Rio.html#M000055">Rio#lines</a>, <a
+href="Rio.html#M000057">Rio#records</a>, <a
+href="Rio.html#M000056">Rio#bytes</a>, <a
+href="Rio.html#M000021">Rio#files</a>, <a
+href="Rio.html#M000018">Rio#dirs</a>, <a href="Rio.html">Rio</a>#[] and
 Rio#to_a for more information on how records are selected and what kind of
 record is passed to the block.
 </p>
 <p>
-<a href="Rio.html#M000046">Rio#each</a> is the fundemental method for all
+<a href="Rio.html#M000045">Rio#each</a> is the fundemental method for all
 the <a href="Rio.html">Rio</a> grande operators. Rio#to_a and the <a
 href="Rio.html">Rio</a> copy operators <a href="Rio.html">Rio</a>#&lt; <a
 href="Rio.html">Rio</a>#&lt;&lt; <a href="Rio.html">Rio</a>#&gt;&gt; <a
 href="Rio.html">Rio</a>#&gt; are all implemented in terms of <a
-href="Rio.html#M000046">Rio#each</a>.
+href="Rio.html#M000045">Rio#each</a>.
 </p>
 <p>
-While <a href="Rio.html#M000046">Rio#each</a> is fundamental to a <a
+While <a href="Rio.html#M000045">Rio#each</a> is fundamental to a <a
 href="Rio.html">Rio</a>, it rarely needs actually be called because all the
 grande configuration methods will also take a block and call <a
-href="Rio.html#M000046">Rio#each</a> if one is given. So the existance of a
+href="Rio.html#M000045">Rio#each</a> if one is given. So the existance of a
 block after many methods is taken as an implied <a
-href="Rio.html#M000046">Rio#each</a>
+href="Rio.html#M000045">Rio#each</a>
 </p>
 <p>
 For Rios that refer to directories, the item passed to the block is a <a
@@ -2308,7 +2319,7 @@ certain attributes from the directory <a href="Rio.html">Rio</a>.
  end
 </pre>
 <p>
-<a href="Rio.html#M000046">Rio#each</a> returns the <a
+<a href="Rio.html#M000045">Rio#each</a> returns the <a
 href="Rio.html">Rio</a> which called it.
 </p>
 <p>
@@ -2380,12 +2391,12 @@ href="Doc/INTRO.html">RIO::Doc::INTRO</a> for further explanation.
         </div>
       </div>
 
-      <div id="method-M000123" class="method-detail">
-        <a name="M000123"></a>
+      <div id="method-M000122" class="method-detail">
+        <a name="M000122"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000123.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000123.html');return false;">
+          <a href="Rio.src/M000122.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000122.html');return false;">
           <span class="method-name">each_byte</span><span class="method-args">(*args,&amp;block)</span>
           </a>
         </div>
@@ -2404,12 +2415,12 @@ the byte as an argument.
         </div>
       </div>
 
-      <div id="method-M000124" class="method-detail">
-        <a name="M000124"></a>
+      <div id="method-M000123" class="method-detail">
+        <a name="M000123"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000124.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000124.html');return false;">
+          <a href="Rio.src/M000123.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000123.html');return false;">
           <span class="method-name">each_line</span><span class="method-args">(*args,&amp;block)</span>
           </a>
         </div>
@@ -2428,12 +2439,12 @@ separated by <em>sep_string</em>.
         </div>
       </div>
 
-      <div id="method-M000021" class="method-detail">
-        <a name="M000021"></a>
+      <div id="method-M000020" class="method-detail">
+        <a name="M000020"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000021.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000021.html');return false;">
+          <a href="Rio.src/M000020.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000020.html');return false;">
           <span class="method-name">entries</span><span class="method-args">(*args,&amp;block)</span>
           </a>
         </div>
@@ -2467,8 +2478,8 @@ If a block is given, behaves like
 <tt>ario.etries(*args).each(&amp;block)</tt>
 </p>
 <p>
-See also <a href="Rio.html#M000022">Rio#files</a>, <a
-href="Rio.html#M000019">Rio#dirs</a>, Rio#noentries
+See also <a href="Rio.html#M000021">Rio#files</a>, <a
+href="Rio.html#M000018">Rio#dirs</a>, Rio#noentries
 </p>
 <pre>
  rio('adir').entries { |frio| ... } # process all entries in 'adir'
@@ -2480,12 +2491,12 @@ href="Rio.html#M000019">Rio#dirs</a>, Rio#noentries
         </div>
       </div>
 
-      <div id="method-M000137" class="method-detail">
-        <a name="M000137"></a>
+      <div id="method-M000136" class="method-detail">
+        <a name="M000136"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000137.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000137.html');return false;">
+          <a href="Rio.src/M000136.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000136.html');return false;">
           <span class="method-name">eof?</span><span class="method-args">()</span>
           </a>
         </div>
@@ -2504,12 +2515,12 @@ for reading or an <tt>IOError</tt> will be raised.
         </div>
       </div>
 
-      <div id="method-M000016" class="method-detail">
-        <a name="M000016"></a>
+      <div id="method-M000015" class="method-detail">
+        <a name="M000015"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000016.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000016.html');return false;">
+          <a href="Rio.src/M000015.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000015.html');return false;">
           <span class="method-name">eql?</span><span class="method-args">(other)</span>
           </a>
         </div>
@@ -2521,12 +2532,12 @@ Returns true if their String representations are eql?
         </div>
       </div>
 
-      <div id="method-M000167" class="method-detail">
-        <a name="M000167"></a>
+      <div id="method-M000166" class="method-detail">
+        <a name="M000166"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000167.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000167.html');return false;">
+          <a href="Rio.src/M000166.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000166.html');return false;">
           <span class="method-name">executable?</span><span class="method-args">(*args)</span>
           </a>
         </div>
@@ -2542,12 +2553,12 @@ process.
         </div>
       </div>
 
-      <div id="method-M000168" class="method-detail">
-        <a name="M000168"></a>
+      <div id="method-M000167" class="method-detail">
+        <a name="M000167"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000168.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000168.html');return false;">
+          <a href="Rio.src/M000167.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000167.html');return false;">
           <span class="method-name">executable_real?</span><span class="method-args">(*args)</span>
           </a>
         </div>
@@ -2562,12 +2573,12 @@ Returns true if the file is executable by the real user id of this process.
         </div>
       </div>
 
-      <div id="method-M000153" class="method-detail">
-        <a name="M000153"></a>
+      <div id="method-M000152" class="method-detail">
+        <a name="M000152"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000153.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000153.html');return false;">
+          <a href="Rio.src/M000152.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000152.html');return false;">
           <span class="method-name">exist?</span><span class="method-args">()</span>
           </a>
         </div>
@@ -2585,12 +2596,12 @@ Returns <tt>true</tt> if the named file exists.
         </div>
       </div>
 
-      <div id="method-M000086" class="method-detail">
-        <a name="M000086"></a>
+      <div id="method-M000085" class="method-detail">
+        <a name="M000085"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000086.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000086.html');return false;">
+          <a href="Rio.src/M000085.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000085.html');return false;">
           <span class="method-name">expand_path</span><span class="method-args">(*args)</span>
           </a>
         </div>
@@ -2735,17 +2746,17 @@ Returns the extension
 </pre>
 <p>
 See <a href="Rio.html#M000094">Rio#extname</a>, <a
-href="Rio.html#M000038">Rio#rename</a>
+href="Rio.html#M000037">Rio#rename</a>
 </p>
         </div>
       </div>
 
-      <div id="method-M000143" class="method-detail">
-        <a name="M000143"></a>
+      <div id="method-M000142" class="method-detail">
+        <a name="M000142"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000143.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000143.html');return false;">
+          <a href="Rio.src/M000142.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000142.html');return false;">
           <span class="method-name">fcntl</span><span class="method-args">(integer_cmd,arg)</span>
           </a>
         </div>
@@ -2768,12 +2779,12 @@ details. Not implemented on all platforms.
         </div>
       </div>
 
-      <div id="method-M000154" class="method-detail">
-        <a name="M000154"></a>
+      <div id="method-M000153" class="method-detail">
+        <a name="M000153"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000154.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000154.html');return false;">
+          <a href="Rio.src/M000153.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000153.html');return false;">
           <span class="method-name">file?</span><span class="method-args">()</span>
           </a>
         </div>
@@ -2846,17 +2857,17 @@ Returns the new value of <tt>filename</tt>
 </pre>
 <p>
 See <a href="Rio.html#M000095">Rio#filename</a>, <a
-href="Rio.html#M000038">Rio#rename</a>
+href="Rio.html#M000037">Rio#rename</a>
 </p>
         </div>
       </div>
 
-      <div id="method-M000145" class="method-detail">
-        <a name="M000145"></a>
+      <div id="method-M000144" class="method-detail">
+        <a name="M000144"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000145.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000145.html');return false;">
+          <a href="Rio.src/M000144.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000144.html');return false;">
           <span class="method-name">fileno</span><span class="method-args">()</span>
           </a>
         </div>
@@ -2876,12 +2887,12 @@ Returns an integer representing the numeric file descriptor for
         </div>
       </div>
 
-      <div id="method-M000022" class="method-detail">
-        <a name="M000022"></a>
+      <div id="method-M000021" class="method-detail">
+        <a name="M000021"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000022.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000022.html');return false;">
+          <a href="Rio.src/M000021.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000021.html');return false;">
           <span class="method-name">files</span><span class="method-args">(*args,&amp;block)</span>
           </a>
         </div>
@@ -2923,9 +2934,9 @@ If <tt>args</tt> are:
 If a block is given, behaves like <tt>ario.files(*args).each</tt>
 </p>
 <p>
-See also <a href="Rio.html#M000019">Rio#dirs</a>, <a
-href="Rio.html#M000021">Rio#entries</a>, <a
-href="Rio.html#M000023">Rio#nofiles</a>
+See also <a href="Rio.html#M000018">Rio#dirs</a>, <a
+href="Rio.html#M000020">Rio#entries</a>, <a
+href="Rio.html#M000022">Rio#nofiles</a>
 </p>
 <pre>
  rio('adir').files { |frio| ... } # process all files in 'adir'
@@ -3002,12 +3013,12 @@ Return an array rather than iterating thru them
         </div>
       </div>
 
-      <div id="method-M000028" class="method-detail">
-        <a name="M000028"></a>
+      <div id="method-M000027" class="method-detail">
+        <a name="M000027"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000028.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000028.html');return false;">
+          <a href="Rio.src/M000027.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000027.html');return false;">
           <span class="method-name">find</span><span class="method-args">(*args,&amp;block)</span>
           </a>
         </div>
@@ -3020,8 +3031,8 @@ Calls Find#find
 Uses Find#find to find all entries recursively for a <a
 href="Rio.html">Rio</a> that specifies a directory. Note that there are
 other ways to recurse through a directory structure using a <a
-href="Rio.html">Rio</a>. See <a href="Rio.html#M000046">Rio#each</a> and <a
-href="Rio.html#M000025">Rio#all</a>.
+href="Rio.html">Rio</a>. See <a href="Rio.html#M000045">Rio#each</a> and <a
+href="Rio.html#M000024">Rio#all</a>.
 </p>
 <p>
 Calls the block passing a <a href="Rio.html">Rio</a> for each entry found.
@@ -3042,12 +3053,12 @@ Returns itself
         </div>
       </div>
 
-      <div id="method-M000122" class="method-detail">
-        <a name="M000122"></a>
+      <div id="method-M000121" class="method-detail">
+        <a name="M000121"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000122.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000122.html');return false;">
+          <a href="Rio.src/M000121.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000121.html');return false;">
           <span class="method-name">flush</span><span class="method-args">()</span>
           </a>
         </div>
@@ -3067,12 +3078,12 @@ the data as well).
         </div>
       </div>
 
-      <div id="method-M000159" class="method-detail">
-        <a name="M000159"></a>
+      <div id="method-M000158" class="method-detail">
+        <a name="M000158"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000159.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000159.html');return false;">
+          <a href="Rio.src/M000158.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000158.html');return false;">
           <span class="method-name">fnmatch?</span><span class="method-args">(*args)</span>
           </a>
         </div>
@@ -3087,12 +3098,12 @@ Returns true if path matches against pattern
         </div>
       </div>
 
-      <div id="method-M000085" class="method-detail">
-        <a name="M000085"></a>
+      <div id="method-M000084" class="method-detail">
+        <a name="M000084"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000085.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000085.html');return false;">
+          <a href="Rio.src/M000084.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000084.html');return false;">
           <span class="method-name">fspath</span><span class="method-args">(*args)</span>
           </a>
         </div>
@@ -3106,12 +3117,12 @@ filesystem (i.e. stdin: or http: Rios)
         </div>
       </div>
 
-      <div id="method-M000146" class="method-detail">
-        <a name="M000146"></a>
+      <div id="method-M000145" class="method-detail">
+        <a name="M000145"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000146.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000146.html');return false;">
+          <a href="Rio.src/M000145.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000145.html');return false;">
           <span class="method-name">fsync</span><span class="method-args">()</span>
           </a>
         </div>
@@ -3127,19 +3138,19 @@ Calls IO#fsync
 Immediately writes all buffered data in <em>ario</em> to disk and return
 <em>ario</em>. Does nothing if the underlying operating system does not
 support _fsync(2)_. Note that <tt>fsync</tt> differs from using <a
-href="Rio.html#M000079">Rio#sync</a>. The latter ensures that data is
+href="Rio.html#M000078">Rio#sync</a>. The latter ensures that data is
 flushed from Ruby&#8217;s buffers, but doesn&#8217;t not guarantee that the
 underlying operating system actually writes it to disk.
 </p>
         </div>
       </div>
 
-      <div id="method-M000160" class="method-detail">
-        <a name="M000160"></a>
+      <div id="method-M000159" class="method-detail">
+        <a name="M000159"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000160.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000160.html');return false;">
+          <a href="Rio.src/M000159.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000159.html');return false;">
           <span class="method-name">ftype</span><span class="method-args">(*args)</span>
           </a>
         </div>
@@ -3157,12 +3168,12 @@ Identifies the type of the named file; the return string is one of
         </div>
       </div>
 
-      <div id="method-M000053" class="method-detail">
-        <a name="M000053"></a>
+      <div id="method-M000052" class="method-detail">
+        <a name="M000052"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000053.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000053.html');return false;">
+          <a href="Rio.src/M000052.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000052.html');return false;">
           <span class="method-name">getrec</span><span class="method-args">()</span>
           </a>
         </div>
@@ -3176,9 +3187,9 @@ honoring the grande selection methods.
 Returns nil on end of file.
 </p>
 <p>
-See also <a href="Rio.html#M000058">Rio#records</a>, <a
-href="Rio.html#M000056">Rio#lines</a>, <a
-href="Rio.html#M000046">Rio#each</a>, <a href="Rio.html">Rio</a>#[]
+See also <a href="Rio.html#M000057">Rio#records</a>, <a
+href="Rio.html#M000055">Rio#lines</a>, <a
+href="Rio.html#M000045">Rio#each</a>, <a href="Rio.html">Rio</a>#[]
 </p>
 <pre>
  ario = rio('afile').lines(10..12)
@@ -3190,12 +3201,12 @@ href="Rio.html#M000046">Rio#each</a>, <a href="Rio.html">Rio</a>#[]
         </div>
       </div>
 
-      <div id="method-M000115" class="method-detail">
-        <a name="M000115"></a>
+      <div id="method-M000114" class="method-detail">
+        <a name="M000114"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000115.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000115.html');return false;">
+          <a href="Rio.src/M000114.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000114.html');return false;">
           <span class="method-name">gets</span><span class="method-args">(sep_string=$/)</span>
           </a>
         </div>
@@ -3219,12 +3230,12 @@ Returns nil if called at end of file.
         </div>
       </div>
 
-      <div id="method-M000029" class="method-detail">
-        <a name="M000029"></a>
+      <div id="method-M000028" class="method-detail">
+        <a name="M000028"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000029.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000029.html');return false;">
+          <a href="Rio.src/M000028.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000028.html');return false;">
           <span class="method-name">glob</span><span class="method-args">(string,*args,&amp;block)</span>
           </a>
         </div>
@@ -3243,12 +3254,12 @@ for details of file name matching and the meaning of the flags parameter.
         </div>
       </div>
 
-      <div id="method-M000175" class="method-detail">
-        <a name="M000175"></a>
+      <div id="method-M000174" class="method-detail">
+        <a name="M000174"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000175.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000175.html');return false;">
+          <a href="Rio.src/M000174.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000174.html');return false;">
           <span class="method-name">grpowned?</span><span class="method-args">(*args)</span>
           </a>
         </div>
@@ -3282,17 +3293,26 @@ Windows.
           <p>
 Create a new <a href="Rio.html">Rio</a> referencing the result of applying
 String#gsub to the value returned by <a
-href="Rio.html#M000008">Rio#to_s</a>
+href="Rio.html#M000008">Rio#to_s</a>. So:
+</p>
+<pre>
+ ario.gsub(re,string)
+</pre>
+<p>
+is equivelent to
 </p>
+<pre>
+ rio(ario.to_s.gsub(re,string))
+</pre>
         </div>
       </div>
 
-      <div id="method-M000077" class="method-detail">
-        <a name="M000077"></a>
+      <div id="method-M000076" class="method-detail">
+        <a name="M000076"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000077.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000077.html');return false;">
+          <a href="Rio.src/M000076.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000076.html');return false;">
           <span class="method-name">gzip</span><span class="method-args">(&amp;block)</span>
           </a>
         </div>
@@ -3329,12 +3349,12 @@ If a block is given, acts like <tt>ario.gzip.each(&amp;block)</tt>
         </div>
       </div>
 
-      <div id="method-M000078" class="method-detail">
-        <a name="M000078"></a>
+      <div id="method-M000077" class="method-detail">
+        <a name="M000077"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000078.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000078.html');return false;">
+          <a href="Rio.src/M000077.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000077.html');return false;">
           <span class="method-name">gzip?</span><span class="method-args">()</span>
           </a>
         </div>
@@ -3347,17 +3367,17 @@ Queries the <a href="Rio.html">Rio</a>&#8217;s gzip-mode
  ario.gzip?     #=&gt; true or false
 </pre>
 <p>
-See <a href="Rio.html#M000077">Rio#gzip</a>
+See <a href="Rio.html#M000076">Rio#gzip</a>
 </p>
         </div>
       </div>
 
-      <div id="method-M000015" class="method-detail">
-        <a name="M000015"></a>
+      <div id="method-M000014" class="method-detail">
+        <a name="M000014"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000015.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000015.html');return false;">
+          <a href="Rio.src/M000014.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000014.html');return false;">
           <span class="method-name">hash</span><span class="method-args">()</span>
           </a>
         </div>
@@ -3369,22 +3389,22 @@ Rios are hashed based on their String representation
         </div>
       </div>
 
-      <div id="method-M000110" class="method-detail">
-        <a name="M000110"></a>
+      <div id="method-M000109" class="method-detail">
+        <a name="M000109"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000110.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000110.html');return false;">
+          <a href="Rio.src/M000109.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000109.html');return false;">
           <span class="method-name">host</span><span class="method-args">(*args)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-Proxy for URI#host
+Calls URI#host for Rios which have a URI. Otherwise raises NoMethodError.
 </p>
 <pre>
- rio('http://ruby-doc.org/') #=&gt; 'ruby-doc'
+ rio('http://ruby-doc.org/').host #=&gt; 'ruby-doc'
 </pre>
         </div>
       </div>
@@ -3417,12 +3437,12 @@ Proxy for URI#host
         </div>
       </div>
 
-      <div id="method-M000144" class="method-detail">
-        <a name="M000144"></a>
+      <div id="method-M000143" class="method-detail">
+        <a name="M000143"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000144.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000144.html');return false;">
+          <a href="Rio.src/M000143.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000143.html');return false;">
           <span class="method-name">ioctl</span><span class="method-args">(integer_cmd,arg)</span>
           </a>
         </div>
@@ -3444,12 +3464,12 @@ details. Not implemented on all platforms.
         </div>
       </div>
 
-      <div id="method-M000138" class="method-detail">
-        <a name="M000138"></a>
+      <div id="method-M000137" class="method-detail">
+        <a name="M000137"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000138.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000138.html');return false;">
+          <a href="Rio.src/M000137.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000137.html');return false;">
           <span class="method-name">ioh</span><span class="method-args">(*args)</span>
           </a>
         </div>
@@ -3458,22 +3478,22 @@ details. Not implemented on all platforms.
           <p>
 Provides direct access to the IO handle (as would be returned by ::IO#new)
 <b>with</b> filtering. Reading from and writing to this handle will be
-affected by such things as <a href="Rio.html#M000077">Rio#gzip</a> and <a
-href="Rio.html#M000076">Rio#chomp</a> if they were specified for the <a
+affected by such things as <a href="Rio.html#M000076">Rio#gzip</a> and <a
+href="Rio.html#M000075">Rio#chomp</a> if they were specified for the <a
 href="Rio.html">Rio</a>.
 </p>
 <p>
-Compare this with <a href="Rio.html#M000139">Rio#ios</a>
+Compare this with <a href="Rio.html#M000138">Rio#ios</a>
 </p>
         </div>
       </div>
 
-      <div id="method-M000139" class="method-detail">
-        <a name="M000139"></a>
+      <div id="method-M000138" class="method-detail">
+        <a name="M000138"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000139.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000139.html');return false;">
+          <a href="Rio.src/M000138.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000138.html');return false;">
           <span class="method-name">ios</span><span class="method-args">(*args)</span>
           </a>
         </div>
@@ -3482,11 +3502,11 @@ Compare this with <a href="Rio.html#M000139">Rio#ios</a>
           <p>
 Provides direct access to the IO handle (as would be returned by ::IO#new)
 Reading from and writing to this handle is <b>not</b> affected by such
-things as <a href="Rio.html#M000077">Rio#gzip</a> and <a
-href="Rio.html#M000076">Rio#chomp</a>.
+things as <a href="Rio.html#M000076">Rio#gzip</a> and <a
+href="Rio.html#M000075">Rio#chomp</a>.
 </p>
 <p>
-Compare this with <a href="Rio.html#M000138">Rio#ioh</a>
+Compare this with <a href="Rio.html#M000137">Rio#ioh</a>
 </p>
         </div>
       </div>
@@ -3538,12 +3558,12 @@ directory components like <a href="Rio.html#M000100">Rio#join</a>,
         </div>
       </div>
 
-      <div id="method-M000012" class="method-detail">
-        <a name="M000012"></a>
+      <div id="method-M000011" class="method-detail">
+        <a name="M000011"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000012.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000012.html');return false;">
+          <a href="Rio.src/M000011.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000011.html');return false;">
           <span class="method-name">length</span><span class="method-args">()</span>
           </a>
         </div>
@@ -3555,17 +3575,17 @@ representation
 </p>
 <p>
 To get the size of the underlying file system object use <a
-href="Rio.html#M000178">Rio#size</a>
+href="Rio.html#M000177">Rio#size</a>
 </p>
         </div>
       </div>
 
-      <div id="method-M000118" class="method-detail">
-        <a name="M000118"></a>
+      <div id="method-M000117" class="method-detail">
+        <a name="M000117"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000118.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000118.html');return false;">
+          <a href="Rio.src/M000117.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000117.html');return false;">
           <span class="method-name">lineno</span><span class="method-args">()</span>
           </a>
         </div>
@@ -3582,12 +3602,12 @@ The <a href="Rio.html">Rio</a> will be opened for reading if not already.
 lineno counts the number of times gets is called, rather than the number of
 newlines encountered &#8212; so lineno will only be accurate if the file is
 read exclusively with line-oriented methods (<a
-href="Rio.html#M000126">Rio#readline</a>, <a
-href="Rio.html#M000124">Rio#each_line</a>, <a
-href="Rio.html#M000115">Rio#gets</a> etc.)
+href="Rio.html#M000125">Rio#readline</a>, <a
+href="Rio.html#M000123">Rio#each_line</a>, <a
+href="Rio.html#M000114">Rio#gets</a> etc.)
 </p>
 <p>
-See also the $. variable and <a href="Rio.html#M000120">Rio#recno</a>
+See also the $. variable and <a href="Rio.html#M000119">Rio#recno</a>
 </p>
 <pre>
  f = rio(&quot;testfile&quot;)
@@ -3600,12 +3620,12 @@ See also the $. variable and <a href="Rio.html#M000120">Rio#recno</a>
         </div>
       </div>
 
-      <div id="method-M000119" class="method-detail">
-        <a name="M000119"></a>
+      <div id="method-M000118" class="method-detail">
+        <a name="M000118"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000119.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000119.html');return false;">
+          <a href="Rio.src/M000118.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000118.html');return false;">
           <span class="method-name">lineno=</span><span class="method-args">(integer)</span>
           </a>
         </div>
@@ -3630,12 +3650,12 @@ read #=&gt; 1001
         </div>
       </div>
 
-      <div id="method-M000056" class="method-detail">
-        <a name="M000056"></a>
+      <div id="method-M000055" class="method-detail">
+        <a name="M000055"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000056.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000056.html');return false;">
+          <a href="Rio.src/M000055.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000055.html');return false;">
           <span class="method-name">lines</span><span class="method-args">(*args,&amp;block)</span>
           </a>
         </div>
@@ -3682,12 +3702,12 @@ unless nil or false is returned
         </div>
       </div>
 
-      <div id="method-M000162" class="method-detail">
-        <a name="M000162"></a>
+      <div id="method-M000161" class="method-detail">
+        <a name="M000161"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000162.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000162.html');return false;">
+          <a href="Rio.src/M000161.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000161.html');return false;">
           <span class="method-name">lstat</span><span class="method-args">(*args)</span>
           </a>
         </div>
@@ -3699,34 +3719,34 @@ Calls File#lstat
         </div>
       </div>
 
-      <div id="method-M000112" class="method-detail">
-        <a name="M000112"></a>
+      <div id="method-M000111" class="method-detail">
+        <a name="M000111"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000112.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000112.html');return false;">
+          <a href="Rio.src/M000111.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000111.html');return false;">
           <span class="method-name">merge</span><span class="method-args">(other)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-Proxy for URI#merge
+Calls URI#merge
 </p>
 <p>
-Merges to Rios. URI#merge does not document exactly what merging to URIs
+Merges two Rios. URI#merge does not document exactly what merging to URIs
 means. This appears to join the the paths with like <tt>other + path</tt>.
 See URI#merge for less information.
 </p>
         </div>
       </div>
 
-      <div id="method-M000033" class="method-detail">
-        <a name="M000033"></a>
+      <div id="method-M000032" class="method-detail">
+        <a name="M000032"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000033.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000033.html');return false;">
+          <a href="Rio.src/M000032.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000032.html');return false;">
           <span class="method-name">mkdir</span><span class="method-args">(*args,&amp;block)</span>
           </a>
         </div>
@@ -3750,12 +3770,12 @@ just returns the <a href="Rio.html">Rio</a>.
         </div>
       </div>
 
-      <div id="method-M000032" class="method-detail">
-        <a name="M000032"></a>
+      <div id="method-M000031" class="method-detail">
+        <a name="M000031"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000032.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000032.html');return false;">
+          <a href="Rio.src/M000031.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000031.html');return false;">
           <span class="method-name">mkpath</span><span class="method-args">(&amp;block)</span>
           </a>
         </div>
@@ -3778,12 +3798,12 @@ just returns the <a href="Rio.html">Rio</a>.
         </div>
       </div>
 
-      <div id="method-M000140" class="method-detail">
-        <a name="M000140"></a>
+      <div id="method-M000139" class="method-detail">
+        <a name="M000139"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000140.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000140.html');return false;">
+          <a href="Rio.src/M000139.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000139.html');return false;">
           <span class="method-name">mode</span><span class="method-args">(m,*args)</span>
           </a>
         </div>
@@ -3800,19 +3820,19 @@ opened.
 Normally one needs never open a <a href="Rio.html">Rio</a> or specify its
 mode &#8212; the mode is determined by the operation the <a
 href="Rio.html">Rio</a> is asked to perform. (i.e. <a
-href="Rio.html#M000127">Rio#print</a> requires write access, <a
-href="Rio.html#M000125">Rio#readlines</a> requires read access). However
+href="Rio.html#M000126">Rio#print</a> requires write access, <a
+href="Rio.html#M000124">Rio#readlines</a> requires read access). However
 there are times when one wishes to be specific about the mode with which a
 <a href="Rio.html">Rio</a> will be opened. Note that explicitly setting the
 mode overrides all of <a href="Rio.html">Rio</a>&#8217;s internal mode
-logic. If a mode is specified via <a href="Rio.html#M000140">Rio#mode</a>
+logic. If a mode is specified via <a href="Rio.html#M000139">Rio#mode</a>
 or <a href="Rio.html#M000007">Rio#open</a> that mode will be used. Period.
 </p>
 <p>
 Returns the <a href="Rio.html">Rio</a>.
 </p>
 <p>
-See also <a href="Rio.html#M000140">Rio#mode</a>?
+See also <a href="Rio.html#M000139">Rio#mode</a>?
 </p>
 <p>
 If the mode is given as a String, it must be one of the values listed in
@@ -3858,12 +3878,12 @@ TODO:
         </div>
       </div>
 
-      <div id="method-M000141" class="method-detail">
-        <a name="M000141"></a>
+      <div id="method-M000140" class="method-detail">
+        <a name="M000140"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000141.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000141.html');return false;">
+          <a href="Rio.src/M000140.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000140.html');return false;">
           <span class="method-name">mode?</span><span class="method-args">()</span>
           </a>
         </div>
@@ -3876,7 +3896,7 @@ Query a <a href="Rio.html">Rio</a>&#8217;s mode
    ario.mode?      #=&gt; a mode string
 </pre>
 <p>
-See <a href="Rio.html#M000140">Rio#mode</a>
+See <a href="Rio.html#M000139">Rio#mode</a>
 </p>
 <pre>
  ario = rio('afile')
@@ -3894,12 +3914,12 @@ See <a href="Rio.html#M000140">Rio#mode</a>
         </div>
       </div>
 
-      <div id="method-M000166" class="method-detail">
-        <a name="M000166"></a>
+      <div id="method-M000165" class="method-detail">
+        <a name="M000165"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000166.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000166.html');return false;">
+          <a href="Rio.src/M000165.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000165.html');return false;">
           <span class="method-name">mtime</span><span class="method-args">(*args)</span>
           </a>
         </div>
@@ -3915,12 +3935,12 @@ file system objects
         </div>
       </div>
 
-      <div id="method-M000073" class="method-detail">
-        <a name="M000073"></a>
+      <div id="method-M000072" class="method-detail">
+        <a name="M000072"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000073.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000073.html');return false;">
+          <a href="Rio.src/M000072.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000072.html');return false;">
           <span class="method-name">nocloseoncopy</span><span class="method-args">(arg=false,&amp;block)</span>
           </a>
         </div>
@@ -3933,17 +3953,17 @@ Set a <a href="Rio.html">Rio</a>&#8217;s closeoncopy mode to false
     ario.nocloseoncopy(&amp;block) =&gt; ario
 </pre>
 <p>
-See <a href="Rio.html#M000072">Rio#closeoncopy</a>
+See <a href="Rio.html#M000071">Rio#closeoncopy</a>
 </p>
         </div>
       </div>
 
-      <div id="method-M000070" class="method-detail">
-        <a name="M000070"></a>
+      <div id="method-M000069" class="method-detail">
+        <a name="M000069"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000070.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000070.html');return false;">
+          <a href="Rio.src/M000069.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000069.html');return false;">
           <span class="method-name">nocloseoneof</span><span class="method-args">(arg=false,&amp;block)</span>
           </a>
         </div>
@@ -3956,7 +3976,7 @@ Set the <a href="Rio.html">Rio</a>&#8217;s closeoneof mode to false
  ario.nocloseoneof(&amp;block) =&gt; ario
 </pre>
 <p>
-See <a href="Rio.html#M000069">Rio#closeoneof</a>
+See <a href="Rio.html#M000068">Rio#closeoneof</a>
 </p>
 <p>
 If a block is given behaves like
@@ -3980,12 +4000,12 @@ Returns the <a href="Rio.html">Rio</a>
         </div>
       </div>
 
-      <div id="method-M000020" class="method-detail">
-        <a name="M000020"></a>
+      <div id="method-M000019" class="method-detail">
+        <a name="M000019"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000020.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000020.html');return false;">
+          <a href="Rio.src/M000019.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000019.html');return false;">
           <span class="method-name">nodirs</span><span class="method-args">(*args,&amp;block)</span>
           </a>
         </div>
@@ -4004,7 +4024,7 @@ If no args are provided selects anything but directories.
 </pre>
 <p>
 If args are provided, sets the rio to select directories as with <a
-href="Rio.html#M000019">Rio#dirs</a>, but the arguments are used to
+href="Rio.html#M000018">Rio#dirs</a>, but the arguments are used to
 determine which directories will <b>not</b> be processed
 </p>
 <p>
@@ -4014,7 +4034,7 @@ If a block is given behaves like
  ario.nodirs(*args).each(&amp;block)
 </pre>
 <p>
-See <a href="Rio.html#M000019">Rio#dirs</a>
+See <a href="Rio.html#M000018">Rio#dirs</a>
 </p>
 <pre>
  rio('adir').nodirs { |ent| ... } # iterate through everything except directories
@@ -4045,12 +4065,12 @@ href="Rio.html#M000089">Rio#ext</a>
         </div>
       </div>
 
-      <div id="method-M000023" class="method-detail">
-        <a name="M000023"></a>
+      <div id="method-M000022" class="method-detail">
+        <a name="M000022"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000023.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000023.html');return false;">
+          <a href="Rio.src/M000022.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000022.html');return false;">
           <span class="method-name">nofiles</span><span class="method-args">(*args,&amp;block)</span>
           </a>
         </div>
@@ -4069,7 +4089,7 @@ If no args are provided selects anything but files.
 </pre>
 <p>
 If args are provided, sets the rio to select files as with <a
-href="Rio.html#M000022">Rio#files</a>, but the arguments are used to
+href="Rio.html#M000021">Rio#files</a>, but the arguments are used to
 determine which files will <b>not</b> be processed
 </p>
 <p>
@@ -4077,7 +4097,7 @@ If a block is given behaves like
 <tt>ario.nofiles(*args).each(&amp;block)</tt>
 </p>
 <p>
-See <a href="Rio.html#M000022">Rio#files</a>
+See <a href="Rio.html#M000021">Rio#files</a>
 </p>
 <pre>
  rio('adir').nofiles { |ent| ... } # iterate through everything except files
@@ -4086,12 +4106,12 @@ See <a href="Rio.html#M000022">Rio#files</a>
         </div>
       </div>
 
-      <div id="method-M000060" class="method-detail">
-        <a name="M000060"></a>
+      <div id="method-M000059" class="method-detail">
+        <a name="M000059"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000060.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000060.html');return false;">
+          <a href="Rio.src/M000059.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000059.html');return false;">
           <span class="method-name">nolines</span><span class="method-args">(*args,&amp;block)</span>
           </a>
         </div>
@@ -4100,8 +4120,8 @@ See <a href="Rio.html#M000022">Rio#files</a>
           <p>
 Sets the <a href="Rio.html">Rio</a> to read lines and specifies lines which
 should <b>not</b> be iterated through by <a
-href="Rio.html#M000046">Rio#each</a> or returned by <a
-href="Rio.html#M000053">Rio#getrec</a>
+href="Rio.html#M000045">Rio#each</a> or returned by <a
+href="Rio.html#M000052">Rio#getrec</a>
 </p>
 <p>
 If called with a block behaves as if
@@ -4111,8 +4131,8 @@ If called with a block behaves as if
 Returns the <a href="Rio.html">Rio</a>
 </p>
 <p>
-See also <a href="Rio.html#M000056">Rio#lines</a>, <a
-href="Rio.html#M000058">Rio#records</a>
+See also <a href="Rio.html#M000055">Rio#lines</a>, <a
+href="Rio.html#M000057">Rio#records</a>
 </p>
 <p>
 If no args are provided, no lines are rejected.
@@ -4148,12 +4168,12 @@ nil or false is returned
         </div>
       </div>
 
-      <div id="method-M000059" class="method-detail">
-        <a name="M000059"></a>
+      <div id="method-M000058" class="method-detail">
+        <a name="M000058"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000059.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000059.html');return false;">
+          <a href="Rio.src/M000058.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000058.html');return false;">
           <span class="method-name">norecords</span><span class="method-args">(*args,&amp;block)</span>
           </a>
         </div>
@@ -4161,8 +4181,8 @@ nil or false is returned
         <div class="method-description">
           <p>
 Specifies records which should <b>not</b> be iterated through by <a
-href="Rio.html#M000046">Rio#each</a> or returned by <a
-href="Rio.html#M000053">Rio#getrec</a>
+href="Rio.html#M000045">Rio#each</a> or returned by <a
+href="Rio.html#M000052">Rio#getrec</a>
 </p>
 <p>
 If called with a block behaves as if norecords(*args).each(&amp;block) had
@@ -4172,14 +4192,14 @@ been called
 Returns the <a href="Rio.html">Rio</a>
 </p>
 <p>
-See also <a href="Rio.html#M000058">Rio#records</a>, <a
-href="Rio.html#M000060">Rio#nolines</a>, <a
-href="Rio.html#M000056">Rio#lines</a>
+See also <a href="Rio.html#M000057">Rio#records</a>, <a
+href="Rio.html#M000059">Rio#nolines</a>, <a
+href="Rio.html#M000055">Rio#lines</a>
 </p>
 <p>
 If no args are provided, no records are rejected. What constitutes a record
-is affected by <a href="Rio.html#M000056">Rio#lines</a>,<a
-href="Rio.html#M000057">Rio#bytes</a>, and extensions such as Rio#csv.
+is affected by <a href="Rio.html#M000055">Rio#lines</a>,<a
+href="Rio.html#M000056">Rio#bytes</a>, and extensions such as Rio#csv.
 </p>
 <p>
 If args are provided they may be one or more of the following:
@@ -4217,12 +4237,12 @@ record type <tt>ario.norecords(*args)</tt> is effectively the same as
         </div>
       </div>
 
-      <div id="method-M000027" class="method-detail">
-        <a name="M000027"></a>
+      <div id="method-M000026" class="method-detail">
+        <a name="M000026"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000027.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000027.html');return false;">
+          <a href="Rio.src/M000026.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000026.html');return false;">
           <span class="method-name">norecurse</span><span class="method-args">(*args,&amp;block)</span>
           </a>
         </div>
@@ -4233,9 +4253,9 @@ Grande Directory Recursion Exclude Method
 </p>
 <p>
 Sets the <a href="Rio.html">Rio</a> to recurse into directories like <a
-href="Rio.html#M000025">Rio#all</a>. If no args are provided, no
+href="Rio.html#M000024">Rio#all</a>. If no args are provided, no
 directories will be recursed into. If args are provided, behaves like <a
-href="Rio.html#M000026">Rio#recurse</a>, except that mathcing will
+href="Rio.html#M000025">Rio#recurse</a>, except that mathcing will
 <b>not</b> be recursed into
 </p>
 <pre>
@@ -4244,12 +4264,12 @@ href="Rio.html#M000026">Rio#recurse</a>, except that mathcing will
         </div>
       </div>
 
-      <div id="method-M000062" class="method-detail">
-        <a name="M000062"></a>
+      <div id="method-M000061" class="method-detail">
+        <a name="M000061"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000062.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000062.html');return false;">
+          <a href="Rio.src/M000061.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000061.html');return false;">
           <span class="method-name">norows</span><span class="method-args">(*args,&amp;block)</span>
           </a>
         </div>
@@ -4258,21 +4278,21 @@ href="Rio.html#M000026">Rio#recurse</a>, except that mathcing will
           <p>
 Sets the <a href="Rio.html">Rio</a> to read rows and specifies lines which
 should <b>not</b> be iterated through by <a
-href="Rio.html#M000046">Rio#each</a> or returned by <a
-href="Rio.html#M000053">Rio#getrec</a> <a
-href="Rio.html#M000062">Rio#norows</a> is intended for use by extensions,
+href="Rio.html#M000045">Rio#each</a> or returned by <a
+href="Rio.html#M000052">Rio#getrec</a> <a
+href="Rio.html#M000061">Rio#norows</a> is intended for use by extensions,
 where the concept of a row is reasonable. In the absensence of an extension
-behaves like <a href="Rio.html#M000059">Rio#norecords</a>
+behaves like <a href="Rio.html#M000058">Rio#norecords</a>
 </p>
         </div>
       </div>
 
-      <div id="method-M000080" class="method-detail">
-        <a name="M000080"></a>
+      <div id="method-M000079" class="method-detail">
+        <a name="M000079"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000080.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000080.html');return false;">
+          <a href="Rio.src/M000079.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000079.html');return false;">
           <span class="method-name">nosync</span><span class="method-args">(arg=false,&amp;block)</span>
           </a>
         </div>
@@ -4289,9 +4309,9 @@ Sets the <a href="Rio.html">Rio</a> so that its &#8216;sync mode&#8217;
 will be set to <tt>false</tt> when opened, or set it immediatly if already
 open. When sync mode is true, all output is immediately flushed to the
 underlying operating system and is not buffered internally. Returns the
-rio. See also <a href="Rio.html#M000146">Rio#fsync</a>, <a
-href="Rio.html#M000079">Rio#sync</a>, <a
-href="Rio.html#M000079">Rio#sync</a>?.
+rio. See also <a href="Rio.html#M000145">Rio#fsync</a>, <a
+href="Rio.html#M000078">Rio#sync</a>, <a
+href="Rio.html#M000078">Rio#sync</a>?.
 </p>
 <p>
 If a block is given behaves like <tt>ario.nosync.each(&amp;block)</tt>
@@ -4305,19 +4325,28 @@ If a block is given behaves like <tt>ario.nosync.each(&amp;block)</tt>
         </div>
       </div>
 
-      <div id="method-M000111" class="method-detail">
-        <a name="M000111"></a>
+      <div id="method-M000110" class="method-detail">
+        <a name="M000110"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000111.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000111.html');return false;">
+          <a href="Rio.src/M000110.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000110.html');return false;">
           <span class="method-name">opaque</span><span class="method-args">(*args)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-Proxy for URI#opaque
+Calls URI#opaque for Rios which have URI representations. The opaque
+portion of a URI is the portion after the colon and before the
+question-mark beginning the query.
+</p>
+<pre>
+ rio('http://example.org/do.cgi?n=1').opaque  #=&gt; '//example.org/do.cgi'
+</pre>
+<p>
+For Rios that do not have URL representations, returns the same part of <a
+href="Rio.html">Rio</a>&#8217;s internal psuedo-URL
 </p>
         </div>
       </div>
@@ -4336,12 +4365,12 @@ Proxy for URI#opaque
         </div>
       </div>
 
-      <div id="method-M000157" class="method-detail">
-        <a name="M000157"></a>
+      <div id="method-M000156" class="method-detail">
+        <a name="M000156"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000157.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000157.html');return false;">
+          <a href="Rio.src/M000156.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000156.html');return false;">
           <span class="method-name">open?</span><span class="method-args">()</span>
           </a>
         </div>
@@ -4353,12 +4382,12 @@ Returns <tt>true</tt> if a <a href="Rio.html">Rio</a> is not closed?
         </div>
       </div>
 
-      <div id="method-M000174" class="method-detail">
-        <a name="M000174"></a>
+      <div id="method-M000173" class="method-detail">
+        <a name="M000173"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000174.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000174.html');return false;">
+          <a href="Rio.src/M000173.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000173.html');return false;">
           <span class="method-name">owned?</span><span class="method-args">(*args)</span>
           </a>
         </div>
@@ -4377,12 +4406,12 @@ the calling process is the owner of the file.
         </div>
       </div>
 
-      <div id="method-M000082" class="method-detail">
-        <a name="M000082"></a>
+      <div id="method-M000081" class="method-detail">
+        <a name="M000081"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000082.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000082.html');return false;">
+          <a href="Rio.src/M000081.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000081.html');return false;">
           <span class="method-name">path</span><span class="method-args">(*args)</span>
           </a>
         </div>
@@ -4393,44 +4422,27 @@ Returns the path for the <a href="Rio.html">Rio</a>, which is defined
 differently for different types of Rios.
 </p>
 <p>
-For Rios representing paths on the underlying file system this proxies
+For Rios representing paths on the underlying file system this returns
 URI::FILE#path or URI::Generic#path depending on whether the <a
-href="Rio.html">Rio</a> is absolute or not. Note that this is <b>not</b>
-the same as <a href="Rio.html#M000085">Rio#fspath</a>, but rather a URL
-path as defined in RFC 1738.
-</p>
-<p>
-For HTTP Rios this proxies this proxies URI::HTTP#path
+href="Rio.html">Rio</a> is absolute or not. Note that this is not
+necessarily the same as <a href="Rio.html#M000084">Rio#fspath</a>, but
+rather a URL path as defined in RFC1738.
 </p>
 <p>
-For special Rios such as stdin: and stderr: this returns the special symbol
-used to create the <a href="Rio.html">Rio</a>
+For Rios that have a URI representation this returns URI#path
 </p>
 <p>
-Specifically:
-</p>
-<pre>
- '-' =&gt; stdio:
- '=' =&gt; stderr:
- '?' =&gt; tempfile:
- '$' =&gt; stringio:
- '_' =&gt; sysio:
-</pre>
-<p>
-This list of possible paths may not be comprehensive as new types of Rios
-are added, however, A <a href="Rio.html">Rio</a> should always return a
-path when the underlying object has a concept of a path and something else
-that is reasonable for Rios that have no such concept
+Otherwise this returns nil.
 </p>
         </div>
       </div>
 
-      <div id="method-M000163" class="method-detail">
-        <a name="M000163"></a>
+      <div id="method-M000162" class="method-detail">
+        <a name="M000162"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000163.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000163.html');return false;">
+          <a href="Rio.src/M000162.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000162.html');return false;">
           <span class="method-name">pipe?</span><span class="method-args">()</span>
           </a>
         </div>
@@ -4448,12 +4460,12 @@ Returns <tt>true</tt> if the named file is a pipe.
         </div>
       </div>
 
-      <div id="method-M000042" class="method-detail">
-        <a name="M000042"></a>
+      <div id="method-M000041" class="method-detail">
+        <a name="M000041"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000042.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000042.html');return false;">
+          <a href="Rio.src/M000041.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000041.html');return false;">
           <span class="method-name">pos</span><span class="method-args">()</span>
           </a>
         </div>
@@ -4487,7 +4499,7 @@ Proxy for Dir#pos
 </pre>
 <p>
 Returns the current position in <em>dir</em>. See also +<a
-href="Rio.html#M000041">Rio#seek</a>+.
+href="Rio.html#M000040">Rio#seek</a>+.
 </p>
 <pre>
        d = rio(&quot;testdir&quot;)
@@ -4498,12 +4510,12 @@ href="Rio.html#M000041">Rio#seek</a>+.
         </div>
       </div>
 
-      <div id="method-M000044" class="method-detail">
-        <a name="M000044"></a>
+      <div id="method-M000043" class="method-detail">
+        <a name="M000043"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000044.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000044.html');return false;">
+          <a href="Rio.src/M000043.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000043.html');return false;">
           <span class="method-name">pos=</span><span class="method-args">(integer)</span>
           </a>
         </div>
@@ -4535,12 +4547,12 @@ Proxy for Dir#pos=
         </div>
       </div>
 
-      <div id="method-M000127" class="method-detail">
-        <a name="M000127"></a>
+      <div id="method-M000126" class="method-detail">
+        <a name="M000126"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000127.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000127.html');return false;">
+          <a href="Rio.src/M000126.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000126.html');return false;">
           <span class="method-name">print</span><span class="method-args">(*args,&amp;block)</span>
           </a>
         </div>
@@ -4563,12 +4575,12 @@ Returns the <a href="Rio.html">Rio</a>.
         </div>
       </div>
 
-      <div id="method-M000128" class="method-detail">
-        <a name="M000128"></a>
+      <div id="method-M000127" class="method-detail">
+        <a name="M000127"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000128.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000128.html');return false;">
+          <a href="Rio.src/M000127.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000127.html');return false;">
           <span class="method-name">print!</span><span class="method-args">(*args,&amp;block)</span>
           </a>
         </div>
@@ -4576,7 +4588,7 @@ Returns the <a href="Rio.html">Rio</a>.
         <div class="method-description">
           <p>
 Writes the given objects to the rio as with <a
-href="Rio.html#M000127">Rio#print</a> and then closes the <a
+href="Rio.html#M000126">Rio#print</a> and then closes the <a
 href="Rio.html">Rio</a>. Returns the <a href="Rio.html">Rio</a>.
 </p>
 <p>
@@ -4588,12 +4600,12 @@ Equivalent to rio.print(*args).close
         </div>
       </div>
 
-      <div id="method-M000130" class="method-detail">
-        <a name="M000130"></a>
+      <div id="method-M000129" class="method-detail">
+        <a name="M000129"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000130.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000130.html');return false;">
+          <a href="Rio.src/M000129.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000129.html');return false;">
           <span class="method-name">printf</span><span class="method-args">(*argv)</span>
           </a>
         </div>
@@ -4612,12 +4624,12 @@ the format string. See +Kernel#sprintf+ for details.
         </div>
       </div>
 
-      <div id="method-M000129" class="method-detail">
-        <a name="M000129"></a>
+      <div id="method-M000128" class="method-detail">
+        <a name="M000128"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000129.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000129.html');return false;">
+          <a href="Rio.src/M000128.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000128.html');return false;">
           <span class="method-name">printf!</span><span class="method-args">(*argv)</span>
           </a>
         </div>
@@ -4625,7 +4637,7 @@ the format string. See +Kernel#sprintf+ for details.
         <div class="method-description">
           <p>
 Writes the given objects to the rio as with <a
-href="Rio.html#M000130">Rio#printf</a> and then closes the rio. Returns the
+href="Rio.html#M000129">Rio#printf</a> and then closes the rio. Returns the
 rio.
 </p>
 <p>
@@ -4634,12 +4646,12 @@ Equivalent to rio.printf(*args).close
         </div>
       </div>
 
-      <div id="method-M000132" class="method-detail">
-        <a name="M000132"></a>
+      <div id="method-M000131" class="method-detail">
+        <a name="M000131"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000132.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000132.html');return false;">
+          <a href="Rio.src/M000131.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000131.html');return false;">
           <span class="method-name">putc</span><span class="method-args">(*argv)</span>
           </a>
         </div>
@@ -4670,12 +4682,12 @@ _produces:_
         </div>
       </div>
 
-      <div id="method-M000131" class="method-detail">
-        <a name="M000131"></a>
+      <div id="method-M000130" class="method-detail">
+        <a name="M000130"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000131.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000131.html');return false;">
+          <a href="Rio.src/M000130.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000130.html');return false;">
           <span class="method-name">putc!</span><span class="method-args">(*argv)</span>
           </a>
         </div>
@@ -4683,7 +4695,7 @@ _produces:_
         <div class="method-description">
           <p>
 Writes the given objects to the rio as with <a
-href="Rio.html#M000132">Rio#putc</a> and then closes the rio. Returns the
+href="Rio.html#M000131">Rio#putc</a> and then closes the rio. Returns the
 rio.
 </p>
 <p>
@@ -4692,12 +4704,12 @@ Equivalent to rio.putc(*args).close
         </div>
       </div>
 
-      <div id="method-M000133" class="method-detail">
-        <a name="M000133"></a>
+      <div id="method-M000132" class="method-detail">
+        <a name="M000132"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000133.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000133.html');return false;">
+          <a href="Rio.src/M000132.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000132.html');return false;">
           <span class="method-name">puts</span><span class="method-args">(*args)</span>
           </a>
         </div>
@@ -4708,7 +4720,7 @@ Calls IO#puts
 </p>
 <p>
 Writes the given objects to the rio as with <a
-href="Rio.html#M000127">Rio#print</a> . Writes a record separator
+href="Rio.html#M000126">Rio#print</a> . Writes a record separator
 (typically a newline) after any that do not already end with a newline
 sequence. If called with an array argument, writes each element on a new
 line. If called without arguments, outputs a single record separator.
@@ -4717,12 +4729,12 @@ Returns the rio.
         </div>
       </div>
 
-      <div id="method-M000134" class="method-detail">
-        <a name="M000134"></a>
+      <div id="method-M000133" class="method-detail">
+        <a name="M000133"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000134.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000134.html');return false;">
+          <a href="Rio.src/M000133.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000133.html');return false;">
           <span class="method-name">puts!</span><span class="method-args">(*args)</span>
           </a>
         </div>
@@ -4730,7 +4742,7 @@ Returns the rio.
         <div class="method-description">
           <p>
 Writes the given objects to the rio as with <a
-href="Rio.html#M000133">Rio#puts</a> and then closes the rio. Returns the
+href="Rio.html#M000132">Rio#puts</a> and then closes the rio. Returns the
 rio.
 </p>
 <p>
@@ -4742,12 +4754,12 @@ Equivalent to rio.puts(*args).close
         </div>
       </div>
 
-      <div id="method-M000065" class="method-detail">
-        <a name="M000065"></a>
+      <div id="method-M000064" class="method-detail">
+        <a name="M000064"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000065.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000065.html');return false;">
+          <a href="Rio.src/M000064.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000064.html');return false;">
           <span class="method-name">r</span><span class="method-args">()</span>
           </a>
         </div>
@@ -4764,7 +4776,7 @@ input when no mode is specified.
 Returns the <a href="Rio.html">Rio</a>
 </p>
 <p>
-See the discussion for <a href="Rio.html#M000063">Rio#a</a>.
+See the discussion for <a href="Rio.html#M000062">Rio#a</a>.
 </p>
 <p>
 Since &#8216;r&#8217; is the implicit input mode used by default, this
@@ -4773,12 +4785,12 @@ method is probably uneeded.
         </div>
       </div>
 
-      <div id="method-M000066" class="method-detail">
-        <a name="M000066"></a>
+      <div id="method-M000065" class="method-detail">
+        <a name="M000065"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000066.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000066.html');return false;">
+          <a href="Rio.src/M000065.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000065.html');return false;">
           <span class="method-name">r!</span><span class="method-args">()</span>
           </a>
         </div>
@@ -4795,17 +4807,17 @@ input when no mode is specified.
 Returns the <a href="Rio.html">Rio</a>
 </p>
 <p>
-See the discussion for <a href="Rio.html#M000063">Rio#a</a>.
+See the discussion for <a href="Rio.html#M000062">Rio#a</a>.
 </p>
         </div>
       </div>
 
-      <div id="method-M000039" class="method-detail">
-        <a name="M000039"></a>
+      <div id="method-M000038" class="method-detail">
+        <a name="M000038"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000039.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000039.html');return false;">
+          <a href="Rio.src/M000038.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000038.html');return false;">
           <span class="method-name">read</span><span class="method-args">(*args)</span>
           </a>
         </div>
@@ -4841,12 +4853,12 @@ Proxy for Dir#read
         </div>
       </div>
 
-      <div id="method-M000169" class="method-detail">
-        <a name="M000169"></a>
+      <div id="method-M000168" class="method-detail">
+        <a name="M000168"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000169.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000169.html');return false;">
+          <a href="Rio.src/M000168.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000168.html');return false;">
           <span class="method-name">readable?</span><span class="method-args">(*args)</span>
           </a>
         </div>
@@ -4867,12 +4879,12 @@ Returns <tt>true</tt> if the named file is readable by the effective user
         </div>
       </div>
 
-      <div id="method-M000170" class="method-detail">
-        <a name="M000170"></a>
+      <div id="method-M000169" class="method-detail">
+        <a name="M000169"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000170.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000170.html');return false;">
+          <a href="Rio.src/M000169.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000169.html');return false;">
           <span class="method-name">readable_real?</span><span class="method-args">(*args)</span>
           </a>
         </div>
@@ -4891,12 +4903,12 @@ this process.
         </div>
       </div>
 
-      <div id="method-M000126" class="method-detail">
-        <a name="M000126"></a>
+      <div id="method-M000125" class="method-detail">
+        <a name="M000125"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000126.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000126.html');return false;">
+          <a href="Rio.src/M000125.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000125.html');return false;">
           <span class="method-name">readline</span><span class="method-args">(*args)</span>
           </a>
         </div>
@@ -4915,12 +4927,12 @@ file.
         </div>
       </div>
 
-      <div id="method-M000125" class="method-detail">
-        <a name="M000125"></a>
+      <div id="method-M000124" class="method-detail">
+        <a name="M000124"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000125.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000125.html');return false;">
+          <a href="Rio.src/M000124.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000124.html');return false;">
           <span class="method-name">readlines</span><span class="method-args">(*args,&amp;block)</span>
           </a>
         </div>
@@ -4941,12 +4953,12 @@ opened for reading or an IOerror will be raised.
         </div>
       </div>
 
-      <div id="method-M000037" class="method-detail">
-        <a name="M000037"></a>
+      <div id="method-M000036" class="method-detail">
+        <a name="M000036"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000037.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000037.html');return false;">
+          <a href="Rio.src/M000036.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000036.html');return false;">
           <span class="method-name">readlink</span><span class="method-args">(*args)</span>
           </a>
         </div>
@@ -4962,12 +4974,12 @@ given link. Not available on all platforms.
         </div>
       </div>
 
-      <div id="method-M000120" class="method-detail">
-        <a name="M000120"></a>
+      <div id="method-M000119" class="method-detail">
+        <a name="M000119"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000120.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000120.html');return false;">
+          <a href="Rio.src/M000119.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000119.html');return false;">
           <span class="method-name">recno</span><span class="method-args">()</span>
           </a>
         </div>
@@ -4980,9 +4992,9 @@ represents the zero-based index of the last record read. Returns nil until
 a record has been read.
 </p>
 <p>
-see <a href="Rio.html#M000056">Rio#lines</a> <a
-href="Rio.html#M000057">Rio#bytes</a> and <a
-href="Rio.html#M000058">Rio#records</a>
+see <a href="Rio.html#M000055">Rio#lines</a> <a
+href="Rio.html#M000056">Rio#bytes</a> and <a
+href="Rio.html#M000057">Rio#records</a>
 </p>
 <p>
 To illustrate: Given a file containing three lines
@@ -5001,14 +5013,14 @@ of the following would fill ay with [&quot;L0\n&quot;, &quot;L1\n&quot;]
 </pre>
 <p>
 <tt>recno</tt> counts the number of times <a
-href="Rio.html#M000053">Rio#getrec</a> or <a
-href="Rio.html#M000046">Rio#each</a> is used to get a record. so
+href="Rio.html#M000052">Rio#getrec</a> or <a
+href="Rio.html#M000045">Rio#each</a> is used to get a record. so
 <tt>recno</tt> will only concern parts of the file read with grande methods
-<a href="Rio.html#M000046">Rio#each</a>, <a href="Rio.html">Rio</a>#[], <a
-href="Rio.html#M000053">Rio#getrec</a>
+<a href="Rio.html#M000045">Rio#each</a>, <a href="Rio.html">Rio</a>#[], <a
+href="Rio.html#M000052">Rio#getrec</a>
 </p>
 <p>
-See also <a href="Rio.html#M000118">Rio#lineno</a>
+See also <a href="Rio.html#M000117">Rio#lineno</a>
 </p>
 <pre>
  f = rio(&quot;afile&quot;)
@@ -5027,12 +5039,12 @@ See also <a href="Rio.html#M000118">Rio#lineno</a>
         </div>
       </div>
 
-      <div id="method-M000058" class="method-detail">
-        <a name="M000058"></a>
+      <div id="method-M000057" class="method-detail">
+        <a name="M000057"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000058.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000058.html');return false;">
+          <a href="Rio.src/M000057.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000057.html');return false;">
           <span class="method-name">records</span><span class="method-args">(*args,&amp;block)</span>
           </a>
         </div>
@@ -5040,8 +5052,8 @@ See also <a href="Rio.html#M000118">Rio#lineno</a>
         <div class="method-description">
           <p>
 Specifies which records will be iterated through by <a
-href="Rio.html#M000046">Rio#each</a> or returned by <a
-href="Rio.html#M000053">Rio#getrec</a>
+href="Rio.html#M000045">Rio#each</a> or returned by <a
+href="Rio.html#M000052">Rio#getrec</a>
 </p>
 <p>
 If called with a block behaves as if
@@ -5052,21 +5064,21 @@ Returns the <a href="Rio.html">Rio</a>
 </p>
 <p>
 If no args are provided, all records are selected. What constitutes a
-record is affected by <a href="Rio.html#M000056">Rio#lines</a>,<a
-href="Rio.html#M000057">Rio#bytes</a>, and extensions such as Rio#csv.
+record is affected by <a href="Rio.html#M000055">Rio#lines</a>,<a
+href="Rio.html#M000056">Rio#bytes</a>, and extensions such as Rio#csv.
 </p>
 <p>
 If args are provided they may be one or more of the following:
 </p>
 <dl>
 <dt>Regexp</dt><dd>any matching record will be iterated over by <a
-href="Rio.html#M000046">Rio#each</a> or returned by <a
-href="Rio.html#M000053">Rio#getrec</a>
+href="Rio.html#M000045">Rio#each</a> or returned by <a
+href="Rio.html#M000052">Rio#getrec</a>
 
 </dd>
 <dt>Integer</dt><dd>specifies a record-number (zero-based) to be iterated over by <a
-href="Rio.html#M000046">Rio#each</a> or returned by <a
-href="Rio.html#M000053">Rio#getrec</a>
+href="Rio.html#M000045">Rio#each</a> or returned by <a
+href="Rio.html#M000052">Rio#getrec</a>
 
 </dd>
 <dt>Range</dt><dd>specifies a range of records (zero-based) to included in the iteration
@@ -5100,12 +5112,12 @@ Note in the following examples that since <tt>lines</tt> is the default
         </div>
       </div>
 
-      <div id="method-M000026" class="method-detail">
-        <a name="M000026"></a>
+      <div id="method-M000025" class="method-detail">
+        <a name="M000025"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000026.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000026.html');return false;">
+          <a href="Rio.src/M000025.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000025.html');return false;">
           <span class="method-name">recurse</span><span class="method-args">(*args,&amp;block)</span>
           </a>
         </div>
@@ -5116,12 +5128,12 @@ Grande Directory Recursion Selection Method
 </p>
 <p>
 Sets the <a href="Rio.html">Rio</a> to recurse into directories like <a
-href="Rio.html#M000025">Rio#all</a>. If no args are provided behaves like
-<a href="Rio.html#M000025">Rio#all</a>. If args are provided, they are
-processed like <a href="Rio.html#M000019">Rio#dirs</a>, to select which
+href="Rio.html#M000024">Rio#all</a>. If no args are provided behaves like
+<a href="Rio.html#M000024">Rio#all</a>. If args are provided, they are
+processed like <a href="Rio.html#M000018">Rio#dirs</a>, to select which
 subdirectories should be recursed into. <a
-href="Rio.html#M000026">Rio#recurse</a> always implies <a
-href="Rio.html#M000025">Rio#all</a>.
+href="Rio.html#M000025">Rio#recurse</a> always implies <a
+href="Rio.html#M000024">Rio#all</a>.
 </p>
 <p>
 <tt>args</tt> may be one or more of:
@@ -5147,9 +5159,9 @@ If a block is given, behaves like
 <tt>ario.recurse(*args).each(&amp;block)</tt>
 </p>
 <p>
-See also <a href="Rio.html#M000027">Rio#norecurse</a>, <a
-href="Rio.html#M000025">Rio#all</a>, <a
-href="Rio.html#M000019">Rio#dirs</a>
+See also <a href="Rio.html#M000026">Rio#norecurse</a>, <a
+href="Rio.html#M000024">Rio#all</a>, <a
+href="Rio.html#M000018">Rio#dirs</a>
 </p>
 <pre>
  rio('adir').all.recurse('test*') { |drio| ... } # process all entries and all entries in subdirectories
@@ -5158,12 +5170,12 @@ href="Rio.html#M000019">Rio#dirs</a>
         </div>
       </div>
 
-      <div id="method-M000088" class="method-detail">
-        <a name="M000088"></a>
+      <div id="method-M000087" class="method-detail">
+        <a name="M000087"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000088.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000088.html');return false;">
+          <a href="Rio.src/M000087.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000087.html');return false;">
           <span class="method-name">rel</span><span class="method-args">(other)</span>
           </a>
         </div>
@@ -5180,12 +5192,12 @@ Returns a new rio with a path equal to the relative path from
         </div>
       </div>
 
-      <div id="method-M000038" class="method-detail">
-        <a name="M000038"></a>
+      <div id="method-M000037" class="method-detail">
+        <a name="M000037"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000038.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000038.html');return false;">
+          <a href="Rio.src/M000037.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000037.html');return false;">
           <span class="method-name">rename</span><span class="method-args">(*args,&amp;block)</span>
           </a>
         </div>
@@ -5235,12 +5247,12 @@ href="Rio.html#M000094">Rio#extname</a>=
         </div>
       </div>
 
-      <div id="method-M000054" class="method-detail">
-        <a name="M000054"></a>
+      <div id="method-M000053" class="method-detail">
+        <a name="M000053"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000054.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000054.html');return false;">
+          <a href="Rio.src/M000053.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000053.html');return false;">
           <span class="method-name">reset</span><span class="method-args">()</span>
           </a>
         </div>
@@ -5254,12 +5266,12 @@ code. It closes a <a href="Rio.html">Rio</a> and returns it to its
         </div>
       </div>
 
-      <div id="method-M000040" class="method-detail">
-        <a name="M000040"></a>
+      <div id="method-M000039" class="method-detail">
+        <a name="M000039"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000040.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000040.html');return false;">
+          <a href="Rio.src/M000039.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000039.html');return false;">
           <span class="method-name">rewind</span><span class="method-args">(&amp;block)</span>
           </a>
         </div>
@@ -5299,12 +5311,12 @@ Proxy for Dir#rewind
         </div>
       </div>
 
-      <div id="method-M000055" class="method-detail">
-        <a name="M000055"></a>
+      <div id="method-M000054" class="method-detail">
+        <a name="M000054"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000055.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000055.html');return false;">
+          <a href="Rio.src/M000054.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000054.html');return false;">
           <span class="method-name">rl</span><span class="method-args">()</span>
           </a>
         </div>
@@ -5318,12 +5330,12 @@ object.
         </div>
       </div>
 
-      <div id="method-M000034" class="method-detail">
-        <a name="M000034"></a>
+      <div id="method-M000033" class="method-detail">
+        <a name="M000033"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000034.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000034.html');return false;">
+          <a href="Rio.src/M000033.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000033.html');return false;">
           <span class="method-name">rm</span><span class="method-args">()</span>
           </a>
         </div>
@@ -5337,19 +5349,19 @@ Deletes the referenced file, returning the <a href="Rio.html">Rio</a>.
 Raises an exception on any error.
 </p>
 <p>
-See also <a href="Rio.html#M000047">Rio#delete</a>, <a
-href="Rio.html#M000047">Rio#delete</a>!, <a
-href="Rio.html#M000030">Rio#rmdir</a>.
+See also <a href="Rio.html#M000046">Rio#delete</a>, <a
+href="Rio.html#M000046">Rio#delete</a>!, <a
+href="Rio.html#M000029">Rio#rmdir</a>.
 </p>
         </div>
       </div>
 
-      <div id="method-M000030" class="method-detail">
-        <a name="M000030"></a>
+      <div id="method-M000029" class="method-detail">
+        <a name="M000029"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000030.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000030.html');return false;">
+          <a href="Rio.src/M000029.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000029.html');return false;">
           <span class="method-name">rmdir</span><span class="method-args">()</span>
           </a>
         </div>
@@ -5365,9 +5377,9 @@ href="Rio.html">Rio</a>. If the directory does not exist, just returns the
 <a href="Rio.html">Rio</a>.
 </p>
 <p>
-See also <a href="Rio.html#M000031">Rio#rmtree</a>, <a
-href="Rio.html#M000047">Rio#delete</a>, <a
-href="Rio.html#M000047">Rio#delete</a>!
+See also <a href="Rio.html#M000030">Rio#rmtree</a>, <a
+href="Rio.html#M000046">Rio#delete</a>, <a
+href="Rio.html#M000046">Rio#delete</a>!
 </p>
 <pre>
    rio('adir').rmdir # remove the empty directory 'adir'
@@ -5375,12 +5387,12 @@ href="Rio.html#M000047">Rio#delete</a>!
         </div>
       </div>
 
-      <div id="method-M000031" class="method-detail">
-        <a name="M000031"></a>
+      <div id="method-M000030" class="method-detail">
+        <a name="M000030"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000031.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000031.html');return false;">
+          <a href="Rio.src/M000030.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000030.html');return false;">
           <span class="method-name">rmtree</span><span class="method-args">()</span>
           </a>
         </div>
@@ -5399,7 +5411,7 @@ If called with a block, behaves as if rmtree.each(&amp;block) had been
 called
 </p>
 <p>
-See also <a href="Rio.html#M000047">Rio#delete</a>!
+See also <a href="Rio.html#M000046">Rio#delete</a>!
 </p>
 <pre>
  rio('adir').rmtree # removes the directory 'adir' recursively
@@ -5429,58 +5441,58 @@ See also <a href="Rio.html#M000047">Rio#delete</a>!
         </div>
       </div>
 
-      <div id="method-M000113" class="method-detail">
-        <a name="M000113"></a>
+      <div id="method-M000112" class="method-detail">
+        <a name="M000112"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000113.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000113.html');return false;">
+          <a href="Rio.src/M000112.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000112.html');return false;">
           <span class="method-name">route_from</span><span class="method-args">(other)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-Proxy for URI#route_from
+Calls URI#route_from
 </p>
 <p>
 Returns a new rio representing the path to this <a href="Rio.html">Rio</a>
 from the perspective of <em>other</em>. URI#route_from requires that
-absolute URIs be used. <a href="Rio.html#M000113">Rio#route_from</a> does
+absolute URIs be used. <a href="Rio.html#M000112">Rio#route_from</a> does
 not.
 </p>
         </div>
       </div>
 
-      <div id="method-M000114" class="method-detail">
-        <a name="M000114"></a>
+      <div id="method-M000113" class="method-detail">
+        <a name="M000113"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000114.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000114.html');return false;">
+          <a href="Rio.src/M000113.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000113.html');return false;">
           <span class="method-name">route_to</span><span class="method-args">(other)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-Proxy for URI#route_to
+Calls URI#route_to
 </p>
 <p>
 Returns a new rio representing the path to <em>other</em> from the
 perspective of this <a href="Rio.html">Rio</a>. URI#route_to requires that
-absolute URIs be used. <a href="Rio.html#M000114">Rio#route_to</a> does
+absolute URIs be used. <a href="Rio.html#M000113">Rio#route_to</a> does
 not.
 </p>
         </div>
       </div>
 
-      <div id="method-M000061" class="method-detail">
-        <a name="M000061"></a>
+      <div id="method-M000060" class="method-detail">
+        <a name="M000060"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000061.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000061.html');return false;">
+          <a href="Rio.src/M000060.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000060.html');return false;">
           <span class="method-name">rows</span><span class="method-args">(*args,&amp;block)</span>
           </a>
         </div>
@@ -5488,44 +5500,44 @@ not.
         <div class="method-description">
           <p>
 Sets the <a href="Rio.html">Rio</a> to read rows and specifies rows which
-should be iterated through by <a href="Rio.html#M000046">Rio#each</a> or
-returned by <a href="Rio.html#M000053">Rio#getrec</a> <a
-href="Rio.html#M000061">Rio#rows</a> is intended for use by extensions,
+should be iterated through by <a href="Rio.html#M000045">Rio#each</a> or
+returned by <a href="Rio.html#M000052">Rio#getrec</a> <a
+href="Rio.html#M000060">Rio#rows</a> is intended for use by extensions,
 where the concept of a row is reasonable. In the absensence of an extension
-behaves like <a href="Rio.html#M000058">Rio#records</a>
+behaves like <a href="Rio.html#M000057">Rio#records</a>
 </p>
         </div>
       </div>
 
-      <div id="method-M000109" class="method-detail">
-        <a name="M000109"></a>
+      <div id="method-M000108" class="method-detail">
+        <a name="M000108"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000109.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000109.html');return false;">
+          <a href="Rio.src/M000108.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000108.html');return false;">
           <span class="method-name">scheme</span><span class="method-args">(*args)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-Returns the scheme for <a href="Rio.html">Rio</a>&#8217;s URI like
+Returns the scheme for the <a href="Rio.html">Rio</a>&#8217;s URI like
 URI#scheme where the <a href="Rio.html">Rio</a> is represented by a
 standard URI. For Rios that are not represented by standard URIs one of <a
-href="Rio.html">Rio</a>&#8217;s non-standard schemes&#8217;s is returned.
+href="Rio.html">Rio</a>&#8217;s non-standard schemes is returned.
 </p>
 <pre>
- rio('http://ruby-doc.org/') #=&gt; 'http'
+ rio('http://ruby-doc.org/').scheme #=&gt; 'http'
 </pre>
         </div>
       </div>
 
-      <div id="method-M000041" class="method-detail">
-        <a name="M000041"></a>
+      <div id="method-M000040" class="method-detail">
+        <a name="M000040"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000041.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000041.html');return false;">
+          <a href="Rio.src/M000040.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000040.html');return false;">
           <span class="method-name">seek</span><span class="method-args">(*args)</span>
           </a>
         </div>
@@ -5567,7 +5579,7 @@ Proxy for Dir#seek
 </pre>
 <p>
 Seeks to a particular location in <em>ario</em>. <em>integer</em> must be a
-value returned by +Dir#tell+ or <a href="Rio.html#M000043">Rio#tell</a>.
+value returned by +Dir#tell+ or <a href="Rio.html#M000042">Rio#tell</a>.
 </p>
 <pre>
        d = rio(&quot;testdir&quot;)       #=&gt; #&lt;RIO::Rio:0x401b3c40&gt;
@@ -5580,12 +5592,12 @@ value returned by +Dir#tell+ or <a href="Rio.html#M000043">Rio#tell</a>.
         </div>
       </div>
 
-      <div id="method-M000176" class="method-detail">
-        <a name="M000176"></a>
+      <div id="method-M000175" class="method-detail">
+        <a name="M000175"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000176.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000176.html');return false;">
+          <a href="Rio.src/M000175.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000175.html');return false;">
           <span class="method-name">setgid?</span><span class="method-args">(*args)</span>
           </a>
         </div>
@@ -5603,12 +5615,12 @@ Returns <tt>true</tt> if the named file is a has the setgid bit set.
         </div>
       </div>
 
-      <div id="method-M000177" class="method-detail">
-        <a name="M000177"></a>
+      <div id="method-M000176" class="method-detail">
+        <a name="M000176"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000177.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000177.html');return false;">
+          <a href="Rio.src/M000176.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000176.html');return false;">
           <span class="method-name">setuid?</span><span class="method-args">(*args)</span>
           </a>
         </div>
@@ -5626,12 +5638,12 @@ Returns <tt>true</tt> if the named file is a has the setuid bit set.
         </div>
       </div>
 
-      <div id="method-M000178" class="method-detail">
-        <a name="M000178"></a>
+      <div id="method-M000177" class="method-detail">
+        <a name="M000177"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000178.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000178.html');return false;">
+          <a href="Rio.src/M000177.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000177.html');return false;">
           <span class="method-name">size</span><span class="method-args">(*args)</span>
           </a>
         </div>
@@ -5646,17 +5658,17 @@ Calls FileTest#size
 <p>
 Returns the size of <em>afile</em>. To get the length of the <a
 href="Rio.html">Rio</a>&#8217;s string representation use <a
-href="Rio.html#M000012">Rio#length</a>
+href="Rio.html#M000011">Rio#length</a>
 </p>
         </div>
       </div>
 
-      <div id="method-M000179" class="method-detail">
-        <a name="M000179"></a>
+      <div id="method-M000178" class="method-detail">
+        <a name="M000178"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000179.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000179.html');return false;">
+          <a href="Rio.src/M000178.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000178.html');return false;">
           <span class="method-name">size?</span><span class="method-args">(*args)</span>
           </a>
         </div>
@@ -5675,12 +5687,12 @@ size, the size of the file otherwise.
         </div>
       </div>
 
-      <div id="method-M000116" class="method-detail">
-        <a name="M000116"></a>
+      <div id="method-M000115" class="method-detail">
+        <a name="M000115"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000116.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000116.html');return false;">
+          <a href="Rio.src/M000115.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000115.html');return false;">
           <span class="method-name">slurp</span><span class="method-args">()</span>
           </a>
         </div>
@@ -5688,15 +5700,15 @@ size, the size of the file otherwise.
         <div class="method-description">
           <p>
 Slurps the contents of the rio into a string. See also <a
-href="Rio.html#M000117">Rio#contents</a>
+href="Rio.html#M000116">Rio#contents</a>
 </p>
 <pre>
  astring = rio('afile.txt').slurp # slurp the entire contents of afile.txt into astring
 </pre>
 <p>
 Alpha Note: Considering removing <a
-href="Rio.html#M000117">Rio#contents</a> and <a
-href="Rio.html#M000116">Rio#slurp</a> in favor of <tt>to_string</tt>. Is
+href="Rio.html#M000116">Rio#contents</a> and <a
+href="Rio.html#M000115">Rio#slurp</a> in favor of <tt>to_string</tt>. Is
 this the Ruby way? Is it too confusing with a <tt><a
 href="Rio.html#M000008">to_s</a></tt> and <tt>to_str</tt> already? Is it a
 good idea?
@@ -5704,12 +5716,12 @@ good idea?
         </div>
       </div>
 
-      <div id="method-M000155" class="method-detail">
-        <a name="M000155"></a>
+      <div id="method-M000154" class="method-detail">
+        <a name="M000154"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000155.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000155.html');return false;">
+          <a href="Rio.src/M000154.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000154.html');return false;">
           <span class="method-name">socket?</span><span class="method-args">()</span>
           </a>
         </div>
@@ -5764,12 +5776,12 @@ href="Rio.html">Rio</a>#/
         </div>
       </div>
 
-      <div id="method-M000161" class="method-detail">
-        <a name="M000161"></a>
+      <div id="method-M000160" class="method-detail">
+        <a name="M000160"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000161.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000161.html');return false;">
+          <a href="Rio.src/M000160.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000160.html');return false;">
           <span class="method-name">stat</span><span class="method-args">(*args)</span>
           </a>
         </div>
@@ -5781,12 +5793,12 @@ Calls File#stat
         </div>
       </div>
 
-      <div id="method-M000173" class="method-detail">
-        <a name="M000173"></a>
+      <div id="method-M000172" class="method-detail">
+        <a name="M000172"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000173.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000173.html');return false;">
+          <a href="Rio.src/M000172.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000172.html');return false;">
           <span class="method-name">sticky?</span><span class="method-args">(*args)</span>
           </a>
         </div>
@@ -5817,17 +5829,27 @@ Returns <tt>true</tt> if the named file is a has the sticky bit set.
         <div class="method-description">
           <p>
 Create a new <a href="Rio.html">Rio</a> referencing the result of applying
-String#sub to the value returned by <a href="Rio.html#M000008">Rio#to_s</a>
+String#sub to the value returned by <a
+href="Rio.html#M000008">Rio#to_s</a>. So:
 </p>
+<pre>
+ ario.sub(re,string)
+</pre>
+<p>
+is equivelent to
+</p>
+<pre>
+ rio(ario.to_s.sub(re,string))
+</pre>
         </div>
       </div>
 
-      <div id="method-M000036" class="method-detail">
-        <a name="M000036"></a>
+      <div id="method-M000035" class="method-detail">
+        <a name="M000035"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000036.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000036.html');return false;">
+          <a href="Rio.src/M000035.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000035.html');return false;">
           <span class="method-name">symlink</span><span class="method-args">(dest)</span>
           </a>
         </div>
@@ -5835,7 +5857,7 @@ String#sub to the value returned by <a href="Rio.html#M000008">Rio#to_s</a>
         <div class="method-description">
           <p>
 Creates a symbolic link <em>dest</em> which points to the <a
-href="Rio.html">Rio</a>&#8217;s <a href="Rio.html#M000085">Rio#fspath</a>.
+href="Rio.html">Rio</a>&#8217;s <a href="Rio.html#M000084">Rio#fspath</a>.
 Raises a NotImplementedError exception on platforms that do not support
 symbolic links. <em>dest</em> may be a <a href="Rio.html">Rio</a>, a
 String, or anything that will create an appropriate <a
@@ -5850,9 +5872,9 @@ Errno::EEXIST.
 Returns the <a href="Rio.html">Rio</a> (not the symlink)
 </p>
 <p>
-<a href="Rio.html#M000036">Rio#symlink</a> differs from File#symlink when
+<a href="Rio.html#M000035">Rio#symlink</a> differs from File#symlink when
 the <a href="Rio.html">Rio</a> or the <em>dest</em> path has directory
-information. In this case <a href="Rio.html#M000036">Rio#symlink</a>
+information. In this case <a href="Rio.html#M000035">Rio#symlink</a>
 creates a symlink that actually refers to the <a
 href="Rio.html">Rio</a>&#8217;s location from the perspective of the
 link&#8217;s location.
@@ -5889,12 +5911,12 @@ Examples
         </div>
       </div>
 
-      <div id="method-M000156" class="method-detail">
-        <a name="M000156"></a>
+      <div id="method-M000155" class="method-detail">
+        <a name="M000155"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000156.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000156.html');return false;">
+          <a href="Rio.src/M000155.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000155.html');return false;">
           <span class="method-name">symlink?</span><span class="method-args">()</span>
           </a>
         </div>
@@ -5912,12 +5934,12 @@ Returns <tt>true</tt> if the named file is a symbolic link.
         </div>
       </div>
 
-      <div id="method-M000079" class="method-detail">
-        <a name="M000079"></a>
+      <div id="method-M000078" class="method-detail">
+        <a name="M000078"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000079.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000079.html');return false;">
+          <a href="Rio.src/M000078.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000078.html');return false;">
           <span class="method-name">sync</span><span class="method-args">(arg=true,&amp;block)</span>
           </a>
         </div>
@@ -5935,9 +5957,9 @@ will be set to <tt>true</tt> or <tt>false</tt> when opened, or set it
 immediatly if already open. When sync mode is true, all output is
 immediately flushed to the underlying operating system and is not buffered
 internally. Returns the rio. See also <a
-href="Rio.html#M000146">Rio#fsync</a>, <a
-href="Rio.html#M000080">Rio#nosync</a>, <a
-href="Rio.html#M000079">Rio#sync</a>?.
+href="Rio.html#M000145">Rio#fsync</a>, <a
+href="Rio.html#M000079">Rio#nosync</a>, <a
+href="Rio.html#M000078">Rio#sync</a>?.
 </p>
 <p>
 If a block is given behaves like <tt>ario.sync(arg).each(&amp;block)</tt>
@@ -5949,12 +5971,12 @@ If a block is given behaves like <tt>ario.sync(arg).each(&amp;block)</tt>
         </div>
       </div>
 
-      <div id="method-M000081" class="method-detail">
-        <a name="M000081"></a>
+      <div id="method-M000080" class="method-detail">
+        <a name="M000080"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000081.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000081.html');return false;">
+          <a href="Rio.src/M000080.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000080.html');return false;">
           <span class="method-name">sync?</span><span class="method-args">()</span>
           </a>
         </div>
@@ -5970,9 +5992,9 @@ Query the current &#8216;sync mode&#8217; with IO#sync
 Returns the current ``sync mode&#8217;&#8217; of <em>ario</em>. When sync
 mode is true, all output is immediately flushed to the underlying operating
 system and is not buffered by Ruby internally. See also +<a
-href="Rio.html#M000146">Rio#fsync</a>+, <a
-href="Rio.html#M000079">Rio#sync</a>, <a
-href="Rio.html#M000080">Rio#nosync</a>
+href="Rio.html#M000145">Rio#fsync</a>+, <a
+href="Rio.html#M000078">Rio#sync</a>, <a
+href="Rio.html#M000079">Rio#nosync</a>
 </p>
 <pre>
  f = rio(&quot;testfile&quot;)
@@ -5981,37 +6003,23 @@ href="Rio.html#M000080">Rio#nosync</a>
         </div>
       </div>
 
-      <div id="method-M000043" class="method-detail">
-        <a name="M000043"></a>
+      <div id="method-M000042" class="method-detail">
+        <a name="M000042"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000043.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000043.html');return false;">
+          <a href="Rio.src/M000042.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000042.html');return false;">
           <span class="method-name">tell</span><span class="method-args">()</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-See <a href="Rio.html#M000042">Rio#pos</a>
+See <a href="Rio.html#M000041">Rio#pos</a>
 </p>
         </div>
       </div>
 
-      <div id="method-M000011" class="method-detail">
-        <a name="M000011"></a>
-
-        <div class="method-heading">
-          <a href="Rio.src/M000011.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000011.html');return false;">
-          <span class="method-name">to_rl</span><span class="method-args">()</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-        </div>
-      </div>
-
       <div id="method-M000008" class="method-detail">
         <a name="M000008"></a>
 
@@ -6024,46 +6032,63 @@ See <a href="Rio.html#M000042">Rio#pos</a>
       
         <div class="method-description">
           <p>
-returns the <a href="Rio.html#M000085">Rio#fspath</a>, which is the path
+returns the <a href="Rio.html#M000084">Rio#fspath</a>, which is the path
 for the <a href="Rio.html">Rio</a> on the underlying filesystem
 </p>
         </div>
       </div>
 
-      <div id="method-M000084" class="method-detail">
-        <a name="M000084"></a>
+      <div id="method-M000083" class="method-detail">
+        <a name="M000083"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000084.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000084.html');return false;">
+          <a href="Rio.src/M000083.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000083.html');return false;">
           <span class="method-name">to_uri</span><span class="method-args">()</span>
           </a>
         </div>
       
         <div class="method-description">
+          <p>
+For resources that have a URL (RFC1738) representation, this returns a URI
+object referencing it. Otherwise this raises NoMethodError.
+</p>
+<pre>
+ rio('http://rubyforge.org/').to_uri     #=&gt; &lt;URI::HTTP:0x818bd84 URL:http://rubyforge.org/&gt;
+ rio('adir/afile').to_uri                #=&gt; &lt;URI::Generic:0x817d288 URL:adir/afile&gt;
+</pre>
         </div>
       </div>
 
-      <div id="method-M000083" class="method-detail">
-        <a name="M000083"></a>
+      <div id="method-M000082" class="method-detail">
+        <a name="M000082"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000083.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000083.html');return false;">
+          <a href="Rio.src/M000082.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000082.html');return false;">
           <span class="method-name">to_url</span><span class="method-args">()</span>
           </a>
         </div>
       
         <div class="method-description">
+          <p>
+For resources that have a absolute URL (RFC1738) representation, this
+returns a string containing that representation. For objects that do not
+this returns a RIORL (a descriptive pseudo-URL).
+</p>
+<pre>
+ rio('/var/www/')                  #=&gt; &quot;file:///var/www/&quot;
+ rio('http://rio.rubyforge.org/')  #=&gt; &quot;http://rio.rubyforge.org&quot;
+</pre>
         </div>
       </div>
 
-      <div id="method-M000035" class="method-detail">
-        <a name="M000035"></a>
+      <div id="method-M000034" class="method-detail">
+        <a name="M000034"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000035.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000035.html');return false;">
+          <a href="Rio.src/M000034.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000034.html');return false;">
           <span class="method-name">touch</span><span class="method-args">()</span>
           </a>
         </div>
@@ -6079,12 +6104,12 @@ href="Rio.html">Rio</a>. A file is created if it doesn&#8217;t exist.
         </div>
       </div>
 
-      <div id="method-M000147" class="method-detail">
-        <a name="M000147"></a>
+      <div id="method-M000146" class="method-detail">
+        <a name="M000146"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000147.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000147.html');return false;">
+          <a href="Rio.src/M000146.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000146.html');return false;">
           <span class="method-name">tty?</span><span class="method-args">()</span>
           </a>
         </div>
@@ -6107,12 +6132,12 @@ Returns <tt>true</tt> if <em>ario</em> is associated with a terminal device
         </div>
       </div>
 
-      <div id="method-M000148" class="method-detail">
-        <a name="M000148"></a>
+      <div id="method-M000147" class="method-detail">
+        <a name="M000147"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000148.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000148.html');return false;">
+          <a href="Rio.src/M000147.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000147.html');return false;">
           <span class="method-name">ungetc</span><span class="method-args">(*args)</span>
           </a>
         </div>
@@ -6138,12 +6163,12 @@ to read only the last of several characters that have been pushed back).
         </div>
       </div>
 
-      <div id="method-M000067" class="method-detail">
-        <a name="M000067"></a>
+      <div id="method-M000066" class="method-detail">
+        <a name="M000066"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000067.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000067.html');return false;">
+          <a href="Rio.src/M000066.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000066.html');return false;">
           <span class="method-name">w</span><span class="method-args">()</span>
           </a>
         </div>
@@ -6160,7 +6185,7 @@ for output when no mode is specified.
 Returns the <a href="Rio.html">Rio</a>
 </p>
 <p>
-See the discussion for <a href="Rio.html#M000063">Rio#a</a>.
+See the discussion for <a href="Rio.html#M000062">Rio#a</a>.
 </p>
 <p>
 Since &#8216;w&#8217; is the implicit output mode used by default, this
@@ -6170,12 +6195,12 @@ time.
         </div>
       </div>
 
-      <div id="method-M000068" class="method-detail">
-        <a name="M000068"></a>
+      <div id="method-M000067" class="method-detail">
+        <a name="M000067"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000068.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000068.html');return false;">
+          <a href="Rio.src/M000067.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000067.html');return false;">
           <span class="method-name">w!</span><span class="method-args">()</span>
           </a>
         </div>
@@ -6192,17 +6217,17 @@ for output when no mode is specified.
 Returns the <a href="Rio.html">Rio</a>
 </p>
 <p>
-See the discussion for <a href="Rio.html#M000063">Rio#a</a>.
+See the discussion for <a href="Rio.html#M000062">Rio#a</a>.
 </p>
         </div>
       </div>
 
-      <div id="method-M000171" class="method-detail">
-        <a name="M000171"></a>
+      <div id="method-M000170" class="method-detail">
+        <a name="M000170"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000171.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000171.html');return false;">
+          <a href="Rio.src/M000170.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000170.html');return false;">
           <span class="method-name">writable?</span><span class="method-args">(*args)</span>
           </a>
         </div>
@@ -6221,12 +6246,12 @@ id of this process.
         </div>
       </div>
 
-      <div id="method-M000172" class="method-detail">
-        <a name="M000172"></a>
+      <div id="method-M000171" class="method-detail">
+        <a name="M000171"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000172.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000172.html');return false;">
+          <a href="Rio.src/M000171.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000171.html');return false;">
           <span class="method-name">writable_real?</span><span class="method-args">(*args)</span>
           </a>
         </div>
@@ -6245,12 +6270,12 @@ this process.
         </div>
       </div>
 
-      <div id="method-M000136" class="method-detail">
-        <a name="M000136"></a>
+      <div id="method-M000135" class="method-detail">
+        <a name="M000135"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000136.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000136.html');return false;">
+          <a href="Rio.src/M000135.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000135.html');return false;">
           <span class="method-name">write</span><span class="method-args">(*argv)</span>
           </a>
         </div>
@@ -6270,12 +6295,12 @@ href="Rio.html#M000008">to_s</a></tt>. Returns the number of bytes written.
         </div>
       </div>
 
-      <div id="method-M000135" class="method-detail">
-        <a name="M000135"></a>
+      <div id="method-M000134" class="method-detail">
+        <a name="M000134"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000135.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000135.html');return false;">
+          <a href="Rio.src/M000134.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000134.html');return false;">
           <span class="method-name">write!</span><span class="method-args">(*argv)</span>
           </a>
         </div>
@@ -6283,7 +6308,7 @@ href="Rio.html#M000008">to_s</a></tt>. Returns the number of bytes written.
         <div class="method-description">
           <p>
 Writes the given objects to the rio as with <a
-href="Rio.html#M000136">Rio#write</a> and then closes the rio.
+href="Rio.html#M000135">Rio#write</a> and then closes the rio.
 </p>
 <p>
 Equivalent to
@@ -6295,12 +6320,12 @@ Equivalent to
         </div>
       </div>
 
-      <div id="method-M000180" class="method-detail">
-        <a name="M000180"></a>
+      <div id="method-M000179" class="method-detail">
+        <a name="M000179"></a>
 
         <div class="method-heading">
-          <a href="Rio.src/M000180.html" target="Code" class="method-signature"
-            onclick="popupCode('Rio.src/M000180.html');return false;">
+          <a href="Rio.src/M000179.html" target="Code" class="method-signature"
+            onclick="popupCode('Rio.src/M000179.html');return false;">
           <span class="method-name">zero?</span><span class="method-args">(*args)</span>
           </a>
         </div>