facets 2.4.3 → 2.4.4

data/doc/rdoc/lore/classes/File.html

@@ -80,7 +80,7 @@ Object
 
   <div class="sectiontitle">Methods</div>
   <ul>
-  <li><a href="#M000057">yaml?</a></li>
+  <li><a href="#M000097">yaml?</a></li>
   </ul>
 
 
@@ -91,7 +91,7 @@ Object
 <div class="sectiontitle">Public Class methods</div>
 <div class="method">
   <div class="title">
-    <a name="M000057"></a><b>yaml?</b>(file)
+    <a name="M000097"></a><b>yaml?</b>(file)
   </div>
   <div class="description">
   <p>
@@ -105,8 +105,8 @@ fit that standard.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000057_source')" id="l_M000057_source">show source</a> ]</p>
-  <div id="M000057_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000097_source')" id="l_M000097_source">show source</a> ]</p>
+  <div id="M000097_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/lore/facets/yaml.rb, line 65</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">yaml?</span>(<span class="ruby-identifier">file</span>)

data/doc/rdoc/lore/classes/FileUtils.html

@@ -61,11 +61,6 @@
 <a href="../files/lib/lore/facets/fileutils/whereis_rb.html">lib/lore/facets/fileutils/whereis.rb</a>
 <a href="../files/lib/lore/facets/fileutils/wc_rb.html">lib/lore/facets/fileutils/wc.rb</a>
 <a href="../files/lib/lore/facets/fileutils/slice_rb.html">lib/lore/facets/fileutils/slice.rb</a>
-<a href="../files/lib/lore/facets/fileutils/safe_ln_rb.html">lib/lore/facets/fileutils/safe_ln.rb</a>
-<a href="../files/lib/lore/facets/fileutils/which_rb.html">lib/lore/facets/fileutils/which.rb</a>
-<a href="../files/lib/lore/facets/fileutils/whereis_rb.html">lib/lore/facets/fileutils/whereis.rb</a>
-<a href="../files/lib/lore/facets/fileutils/wc_rb.html">lib/lore/facets/fileutils/wc.rb</a>
-<a href="../files/lib/lore/facets/fileutils/slice_rb.html">lib/lore/facets/fileutils/slice.rb</a>
 <a href="../files/lib/lore/facets/fileutils/safe_ln_rb.html">lib/lore/facets/fileutils/safe_ln.rb</a>
         </td>
       </tr>
@@ -83,20 +78,13 @@
 
   <div class="sectiontitle">Methods</div>
   <ul>
-  <li><a href="#M000079">head</a></li>
-  <li><a href="#M000086">head</a></li>
-  <li><a href="#M000089">safe_ln</a></li>
-  <li><a href="#M000082">safe_ln</a></li>
-  <li><a href="#M000088">slice</a></li>
-  <li><a href="#M000081">slice</a></li>
-  <li><a href="#M000080">tail</a></li>
-  <li><a href="#M000087">tail</a></li>
-  <li><a href="#M000078">wc</a></li>
-  <li><a href="#M000085">wc</a></li>
-  <li><a href="#M000077">whereis</a></li>
-  <li><a href="#M000084">whereis</a></li>
-  <li><a href="#M000083">which</a></li>
-  <li><a href="#M000076">which</a></li>
+  <li><a href="#M000120">head</a></li>
+  <li><a href="#M000123">safe_ln</a></li>
+  <li><a href="#M000122">slice</a></li>
+  <li><a href="#M000121">tail</a></li>
+  <li><a href="#M000119">wc</a></li>
+  <li><a href="#M000118">whereis</a></li>
+  <li><a href="#M000117">which</a></li>
   </ul>
 
 
@@ -119,65 +107,13 @@
     <td>=</td>
     <td class="attr-value">[true]</td>
   </tr>
-  <tr valign='top'>
-    <td class="attr-name">Win32Exts</td>
-    <td>=</td>
-    <td class="attr-value">%w{.exe .com .bat .cmd}</td>
-  </tr>
-  <tr valign='top'>
-    <td class="attr-name">Win32Exts</td>
-    <td>=</td>
-    <td class="attr-value">%w{.exe .com .bat .cmd}</td>
-  </tr>
-  <tr valign='top'>
-    <td class="attr-name">LINKING_SUPPORTED</td>
-    <td>=</td>
-    <td class="attr-value">[true]</td>
-  </tr>
   </table>
 
 
 <div class="sectiontitle">Public Instance methods</div>
 <div class="method">
   <div class="title">
-    <a name="M000079"></a><b>head</b>(filename,lines=10) {|| ...}
-  </div>
-  <div class="description">
-  <p>
-In block form, yields the first number of ((<b>lines</b>)) of file
-((<b>filename</b>)). In non-block form, it returns an array of the first
-number of ((<b>lines</b>)).
-</p>
-<pre>
-  # Returns first 10 lines of 'myfile'
-  FileUtils.head(&quot;myfile&quot;)
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000079_source')" id="l_M000079_source">show source</a> ]</p>
-  <div id="M000079_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/lore/facets/fileutils/slice.rb, line 11</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">head</span>(<span class="ruby-identifier">filename</span>,<span class="ruby-identifier">lines</span>=<span class="ruby-value">10</span>) <span class="ruby-comment cmt">#:yield:</span>
-    <span class="ruby-identifier">a</span> = []
-    <span class="ruby-constant">IO</span>.<span class="ruby-identifier">foreach</span>(<span class="ruby-identifier">filename</span>){<span class="ruby-operator">|</span><span class="ruby-identifier">line</span><span class="ruby-operator">|</span>
-        <span class="ruby-keyword kw">break</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">lines</span> <span class="ruby-operator">&lt;=</span> <span class="ruby-value">0</span>
-        <span class="ruby-identifier">lines</span> <span class="ruby-operator">-=</span> <span class="ruby-value">1</span>
-        <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">block_given?</span>
-          <span class="ruby-keyword kw">yield</span> <span class="ruby-identifier">line</span>
-        <span class="ruby-keyword kw">else</span>
-          <span class="ruby-identifier">a</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">line</span>
-        <span class="ruby-keyword kw">end</span>
-    }
-    <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">a</span>.<span class="ruby-identifier">empty?</span> <span class="ruby-value">? </span><span class="ruby-keyword kw">nil</span> <span class="ruby-operator">:</span> <span class="ruby-identifier">a</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000086"></a><b>head</b>(filename,lines=10) {|| ...}
+    <a name="M000120"></a><b>head</b>(filename,lines=10) {|| ...}
   </div>
   <div class="description">
   <p>
@@ -191,8 +127,8 @@ number of ((<b>lines</b>)).
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000086_source')" id="l_M000086_source">show source</a> ]</p>
-  <div id="M000086_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000120_source')" id="l_M000120_source">show source</a> ]</p>
+  <div id="M000120_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/lore/facets/fileutils/slice.rb, line 11</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">head</span>(<span class="ruby-identifier">filename</span>,<span class="ruby-identifier">lines</span>=<span class="ruby-value">10</span>) <span class="ruby-comment cmt">#:yield:</span>
@@ -214,41 +150,7 @@ number of ((<b>lines</b>)).
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000089"></a><b>safe_ln</b>(*args)
-  </div>
-  <div class="description">
-  <p>
-Attempt to do a normal file link, but fall back to a copy if the link
-fails.
-</p>
-<p>
-CREDIT Jim Weirich
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000089_source')" id="l_M000089_source">show source</a> ]</p>
-  <div id="M000089_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/lore/facets/fileutils/safe_ln.rb, line 14</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">safe_ln</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
-    <span class="ruby-keyword kw">unless</span> <span class="ruby-constant">LINKING_SUPPORTED</span>[<span class="ruby-value">0</span>]
-      <span class="ruby-identifier">cp</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
-    <span class="ruby-keyword kw">else</span>
-      <span class="ruby-keyword kw">begin</span>
-        <span class="ruby-identifier">ln</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
-      <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">Errno</span><span class="ruby-operator">::</span><span class="ruby-constant">EOPNOTSUPP</span>
-        <span class="ruby-constant">LINKING_SUPPORTED</span>[<span class="ruby-value">0</span>] = <span class="ruby-keyword kw">false</span>
-        <span class="ruby-identifier">cp</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
-      <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">end</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000082"></a><b>safe_ln</b>(*args)
+    <a name="M000123"></a><b>safe_ln</b>(*args)
   </div>
   <div class="description">
   <p>
@@ -260,8 +162,8 @@ CREDIT Jim Weirich
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000082_source')" id="l_M000082_source">show source</a> ]</p>
-  <div id="M000082_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000123_source')" id="l_M000123_source">show source</a> ]</p>
+  <div id="M000123_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/lore/facets/fileutils/safe_ln.rb, line 14</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">safe_ln</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
@@ -282,7 +184,7 @@ CREDIT Jim Weirich
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000088"></a><b>slice</b>(filename,from,to) {|| ...}
+    <a name="M000122"></a><b>slice</b>(filename,from,to) {|| ...}
   </div>
   <div class="description">
   <p>
@@ -298,8 +200,8 @@ CREDIT Shashank <a href="Date.html">Date</a>, via Daniel Berger.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000088_source')" id="l_M000088_source">show source</a> ]</p>
-  <div id="M000088_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000122_source')" id="l_M000122_source">show source</a> ]</p>
+  <div id="M000122_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/lore/facets/fileutils/slice.rb, line 48</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">slice</span>(<span class="ruby-identifier">filename</span>,<span class="ruby-identifier">from</span>,<span class="ruby-identifier">to</span>) <span class="ruby-comment cmt">#:yield:</span>
@@ -311,69 +213,7 @@ CREDIT Shashank <a href="Date.html">Date</a>, via Daniel Berger.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000081"></a><b>slice</b>(filename,from,to) {|| ...}
-  </div>
-  <div class="description">
-  <p>
-In block form, yields lines ((<b>from</b>))-((<b>to</b>)). In non-block
-form, returns an array of lines ((<b>from</b>))-((<b>to</b>)).
-</p>
-<pre>
-  # Returns lines 8-12 of 'myfile'
-  FileUtils.body(&quot;myfile&quot;,8,12)
-</pre>
-<p>
-CREDIT Shashank <a href="Date.html">Date</a>, via Daniel Berger.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000081_source')" id="l_M000081_source">show source</a> ]</p>
-  <div id="M000081_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/lore/facets/fileutils/slice.rb, line 48</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">slice</span>(<span class="ruby-identifier">filename</span>,<span class="ruby-identifier">from</span>,<span class="ruby-identifier">to</span>) <span class="ruby-comment cmt">#:yield:</span>
-    <span class="ruby-constant">IO</span>.<span class="ruby-identifier">readlines</span>(<span class="ruby-identifier">filename</span>)[<span class="ruby-identifier">from</span><span class="ruby-operator">-</span><span class="ruby-value">1</span><span class="ruby-operator">..</span><span class="ruby-identifier">to</span><span class="ruby-operator">-</span><span class="ruby-value">1</span>]
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000080"></a><b>tail</b>(filename,lines=10)
-  </div>
-  <div class="description">
-  <p>
-In block form, yields the last number of ((<b>lines</b>)) of file
-((<b>filename</b>)). In non-block form, it returns the lines as an array.
-</p>
-<p>
-Note that this method slurps the entire file, so I don&#8216;t recommend it
-for very large files. If you want an advanced form of ((<b><a
-href="FileUtils.html#M000080">tail</a></b>)), I suggest using file-<a
-href="FileUtils.html#M000080">tail</a>, by Florian Frank (available on the
-RAA). And no <a href="FileUtils.html#M000080">tail</a> -f.
-</p>
-<pre>
-  # Returns last 3 lines of 'myfile'
-  FileUtils.tail(&quot;myfile&quot;,3)
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000080_source')" id="l_M000080_source">show source</a> ]</p>
-  <div id="M000080_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/lore/facets/fileutils/slice.rb, line 36</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">tail</span>(<span class="ruby-identifier">filename</span>,<span class="ruby-identifier">lines</span>=<span class="ruby-value">10</span>) <span class="ruby-comment cmt">#:yield</span>
-    <span class="ruby-constant">IO</span>.<span class="ruby-identifier">readlines</span>(<span class="ruby-identifier">filename</span>).<span class="ruby-identifier">reverse</span>[<span class="ruby-value">0</span><span class="ruby-operator">..</span><span class="ruby-identifier">lines</span><span class="ruby-operator">-</span><span class="ruby-value">1</span>].<span class="ruby-identifier">reverse</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000087"></a><b>tail</b>(filename,lines=10)
+    <a name="M000121"></a><b>tail</b>(filename,lines=10)
   </div>
   <div class="description">
   <p>
@@ -383,9 +223,9 @@ In block form, yields the last number of ((<b>lines</b>)) of file
 <p>
 Note that this method slurps the entire file, so I don&#8216;t recommend it
 for very large files. If you want an advanced form of ((<b><a
-href="FileUtils.html#M000080">tail</a></b>)), I suggest using file-<a
-href="FileUtils.html#M000080">tail</a>, by Florian Frank (available on the
-RAA). And no <a href="FileUtils.html#M000080">tail</a> -f.
+href="FileUtils.html#M000121">tail</a></b>)), I suggest using file-<a
+href="FileUtils.html#M000121">tail</a>, by Florian Frank (available on the
+RAA). And no <a href="FileUtils.html#M000121">tail</a> -f.
 </p>
 <pre>
   # Returns last 3 lines of 'myfile'
@@ -393,8 +233,8 @@ RAA). And no <a href="FileUtils.html#M000080">tail</a> -f.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000087_source')" id="l_M000087_source">show source</a> ]</p>
-  <div id="M000087_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000121_source')" id="l_M000121_source">show source</a> ]</p>
+  <div id="M000121_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/lore/facets/fileutils/slice.rb, line 36</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">tail</span>(<span class="ruby-identifier">filename</span>,<span class="ruby-identifier">lines</span>=<span class="ruby-value">10</span>) <span class="ruby-comment cmt">#:yield</span>
@@ -406,81 +246,7 @@ RAA). And no <a href="FileUtils.html#M000080">tail</a> -f.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000078"></a><b>wc</b>(filename,option='all')
-  </div>
-  <div class="description">
-  <p>
-With no arguments, returns a four element array consisting of the number of
-bytes, characters, words and lines in <em>filename</em>, respectively.
-</p>
-<p>
-Valid options are <tt>bytes</tt>, <tt>characters</tt> (or just
-&#8216;chars&#8217;), <tt>words</tt> and <tt>lines</tt>.
-</p>
-<pre>
-  # Return the number of words in 'myfile'
-  FileUtils.wc(&quot;myfile&quot;,'words')
-</pre>
-<p>
-CREDIT Daniel J. Berger
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000078_source')" id="l_M000078_source">show source</a> ]</p>
-  <div id="M000078_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/lore/facets/fileutils/wc.rb, line 16</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">wc</span>(<span class="ruby-identifier">filename</span>,<span class="ruby-identifier">option</span>=<span class="ruby-value str">'all'</span>)
-    <span class="ruby-identifier">option</span>.<span class="ruby-identifier">downcase!</span>
-    <span class="ruby-identifier">valid</span> = <span class="ruby-node">%w/all bytes characters chars lines words/</span>
-
-    <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">valid</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-identifier">option</span>)
-        <span class="ruby-identifier">raise</span> <span class="ruby-node">&quot;Invalid option: '#{option}'&quot;</span>
-    <span class="ruby-keyword kw">end</span>
-
-    <span class="ruby-identifier">n</span> = <span class="ruby-value">0</span>
-    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">option</span> <span class="ruby-operator">==</span> <span class="ruby-value str">'lines'</span>
-        <span class="ruby-constant">IO</span>.<span class="ruby-identifier">foreach</span>(<span class="ruby-identifier">filename</span>){ <span class="ruby-identifier">n</span> <span class="ruby-operator">+=</span> <span class="ruby-value">1</span> }
-        <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">n</span>
-    <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">option</span> <span class="ruby-operator">==</span> <span class="ruby-value str">'bytes'</span>
-        <span class="ruby-constant">File</span>.<span class="ruby-identifier">open</span>(<span class="ruby-identifier">filename</span>){ <span class="ruby-operator">|</span><span class="ruby-identifier">f</span><span class="ruby-operator">|</span>
-          <span class="ruby-identifier">f</span>.<span class="ruby-identifier">each_byte</span>{ <span class="ruby-identifier">n</span> <span class="ruby-operator">+=</span> <span class="ruby-value">1</span> }
-        }
-        <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">n</span>
-    <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">option</span> <span class="ruby-operator">==</span> <span class="ruby-value str">'characters'</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">option</span> <span class="ruby-operator">==</span> <span class="ruby-value str">'chars'</span>
-        <span class="ruby-constant">File</span>.<span class="ruby-identifier">open</span>(<span class="ruby-identifier">filename</span>){ <span class="ruby-operator">|</span><span class="ruby-identifier">f</span><span class="ruby-operator">|</span>
-          <span class="ruby-keyword kw">while</span> <span class="ruby-identifier">f</span>.<span class="ruby-identifier">getc</span>
-              <span class="ruby-identifier">n</span> <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
-          <span class="ruby-keyword kw">end</span>
-        }
-        <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">n</span>
-    <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">option</span> <span class="ruby-operator">==</span> <span class="ruby-value str">'words'</span>
-        <span class="ruby-constant">IO</span>.<span class="ruby-identifier">foreach</span>(<span class="ruby-identifier">filename</span>){ <span class="ruby-operator">|</span><span class="ruby-identifier">line</span><span class="ruby-operator">|</span>
-          <span class="ruby-identifier">n</span> <span class="ruby-operator">+=</span> <span class="ruby-identifier">line</span>.<span class="ruby-identifier">split</span>.<span class="ruby-identifier">length</span>
-        }
-        <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">n</span>
-    <span class="ruby-keyword kw">else</span>
-        <span class="ruby-identifier">bytes</span>,<span class="ruby-identifier">chars</span>,<span class="ruby-identifier">lines</span>,<span class="ruby-identifier">words</span> = <span class="ruby-value">0</span>,<span class="ruby-value">0</span>,<span class="ruby-value">0</span>,<span class="ruby-value">0</span>
-        <span class="ruby-constant">IO</span>.<span class="ruby-identifier">foreach</span>(<span class="ruby-identifier">filename</span>){ <span class="ruby-operator">|</span><span class="ruby-identifier">line</span><span class="ruby-operator">|</span>
-          <span class="ruby-identifier">lines</span> <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
-          <span class="ruby-identifier">words</span> <span class="ruby-operator">+=</span> <span class="ruby-identifier">line</span>.<span class="ruby-identifier">split</span>.<span class="ruby-identifier">length</span>
-          <span class="ruby-identifier">chars</span> <span class="ruby-operator">+=</span> <span class="ruby-identifier">line</span>.<span class="ruby-identifier">split</span>(<span class="ruby-value str">''</span>).<span class="ruby-identifier">length</span>
-        }
-        <span class="ruby-constant">File</span>.<span class="ruby-identifier">open</span>(<span class="ruby-identifier">filename</span>){ <span class="ruby-operator">|</span><span class="ruby-identifier">f</span><span class="ruby-operator">|</span>
-          <span class="ruby-keyword kw">while</span> <span class="ruby-identifier">f</span>.<span class="ruby-identifier">getc</span>
-              <span class="ruby-identifier">bytes</span> <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
-          <span class="ruby-keyword kw">end</span>
-        }
-        <span class="ruby-keyword kw">return</span> [<span class="ruby-identifier">bytes</span>,<span class="ruby-identifier">chars</span>,<span class="ruby-identifier">words</span>,<span class="ruby-identifier">lines</span>]
-    <span class="ruby-keyword kw">end</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000085"></a><b>wc</b>(filename,option='all')
+    <a name="M000119"></a><b>wc</b>(filename,option='all')
   </div>
   <div class="description">
   <p>
@@ -500,8 +266,8 @@ CREDIT Daniel J. Berger
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000085_source')" id="l_M000085_source">show source</a> ]</p>
-  <div id="M000085_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000119_source')" id="l_M000119_source">show source</a> ]</p>
+  <div id="M000119_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/lore/facets/fileutils/wc.rb, line 16</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">wc</span>(<span class="ruby-identifier">filename</span>,<span class="ruby-identifier">option</span>=<span class="ruby-value str">'all'</span>)
@@ -554,64 +320,11 @@ CREDIT Daniel J. Berger
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000077"></a><b>whereis</b>(prog, path=ENV['PATH']) {|| ...}
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000077_source')" id="l_M000077_source">show source</a> ]</p>
-  <div id="M000077_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/lore/facets/fileutils/whereis.rb, line 23</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">whereis</span>(<span class="ruby-identifier">prog</span>, <span class="ruby-identifier">path</span>=<span class="ruby-constant">ENV</span>[<span class="ruby-value str">'PATH'</span>]) <span class="ruby-comment cmt">#:yield:</span>
-    <span class="ruby-identifier">dirs</span> = []
-    <span class="ruby-identifier">path</span>.<span class="ruby-identifier">split</span>(<span class="ruby-constant">File</span><span class="ruby-operator">::</span><span class="ruby-constant">PATH_SEPARATOR</span>).<span class="ruby-identifier">each</span>{<span class="ruby-operator">|</span><span class="ruby-identifier">dir</span><span class="ruby-operator">|</span>
-        <span class="ruby-comment cmt"># Windows checks against specific extensions</span>
-        <span class="ruby-keyword kw">if</span> <span class="ruby-constant">File</span><span class="ruby-operator">::</span><span class="ruby-constant">ALT_SEPARATOR</span>
-          <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">prog</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-value str">'.'</span>)
-              <span class="ruby-identifier">f</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-identifier">dir</span>,<span class="ruby-identifier">prog</span>)
-              <span class="ruby-keyword kw">if</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">executable?</span>(<span class="ruby-identifier">f</span>) <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-operator">!</span><span class="ruby-constant">File</span>.<span class="ruby-identifier">directory?</span>(<span class="ruby-identifier">f</span>)
-                <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">block_given?</span>
-                    <span class="ruby-keyword kw">yield</span> <span class="ruby-identifier">f</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-regexp re">/\//</span>,<span class="ruby-value str">'\\'</span>)
-                <span class="ruby-keyword kw">else</span>
-                    <span class="ruby-identifier">dirs</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">f</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-regexp re">/\//</span>,<span class="ruby-value str">'\\'</span>)
-                <span class="ruby-keyword kw">end</span>
-              <span class="ruby-keyword kw">end</span>
-          <span class="ruby-keyword kw">else</span>
-              <span class="ruby-constant">Win32Exts</span>.<span class="ruby-identifier">find_all</span>{<span class="ruby-operator">|</span><span class="ruby-identifier">ext</span><span class="ruby-operator">|</span>
-                <span class="ruby-identifier">f</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-identifier">dir</span>,<span class="ruby-identifier">prog</span><span class="ruby-operator">+</span><span class="ruby-identifier">ext</span>)
-                <span class="ruby-keyword kw">if</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">executable?</span>(<span class="ruby-identifier">f</span>) <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-operator">!</span><span class="ruby-constant">File</span>.<span class="ruby-identifier">directory?</span>(<span class="ruby-identifier">f</span>)
-                    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">block_given?</span>
-                      <span class="ruby-keyword kw">yield</span> <span class="ruby-identifier">f</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-regexp re">/\//</span>,<span class="ruby-value str">'\\'</span>)
-                    <span class="ruby-keyword kw">else</span>
-                      <span class="ruby-identifier">dirs</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">f</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-regexp re">/\//</span>,<span class="ruby-value str">'\\'</span>)
-                    <span class="ruby-keyword kw">end</span>
-                <span class="ruby-keyword kw">end</span>
-              }
-          <span class="ruby-keyword kw">end</span>
-        <span class="ruby-keyword kw">else</span>
-          <span class="ruby-identifier">f</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-identifier">dir</span>,<span class="ruby-identifier">prog</span>)
-          <span class="ruby-comment cmt"># Avoid /usr/lib/ruby, for example</span>
-          <span class="ruby-keyword kw">if</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">executable?</span>(<span class="ruby-identifier">f</span>) <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-operator">!</span><span class="ruby-constant">File</span>.<span class="ruby-identifier">directory?</span>(<span class="ruby-identifier">f</span>)
-              <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">block_given?</span>
-                <span class="ruby-keyword kw">yield</span> <span class="ruby-identifier">f</span>
-              <span class="ruby-keyword kw">else</span>
-                <span class="ruby-identifier">dirs</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">f</span>
-              <span class="ruby-keyword kw">end</span>
-          <span class="ruby-keyword kw">end</span>
-        <span class="ruby-keyword kw">end</span>
-    }
-    <span class="ruby-identifier">dirs</span>.<span class="ruby-identifier">empty?</span> <span class="ruby-value">? </span><span class="ruby-keyword kw">nil</span> <span class="ruby-operator">:</span> <span class="ruby-identifier">dirs</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000084"></a><b>whereis</b>(prog, path=ENV['PATH']) {|| ...}
+    <a name="M000118"></a><b>whereis</b>(prog, path=ENV['PATH']) {|| ...}
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000084_source')" id="l_M000084_source">show source</a> ]</p>
-  <div id="M000084_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000118_source')" id="l_M000118_source">show source</a> ]</p>
+  <div id="M000118_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/lore/facets/fileutils/whereis.rb, line 23</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">whereis</span>(<span class="ruby-identifier">prog</span>, <span class="ruby-identifier">path</span>=<span class="ruby-constant">ENV</span>[<span class="ruby-value str">'PATH'</span>]) <span class="ruby-comment cmt">#:yield:</span>
@@ -660,64 +373,7 @@ CREDIT Daniel J. Berger
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000083"></a><b>which</b>(prog, path=ENV['PATH'])
-  </div>
-  <div class="description">
-  <p>
-Looks for the first occurrence of <em>program</em> within <em>path</em>.
-</p>
-<p>
-On the MS Windows platform, it looks for executables ending with .exe, .bat
-and .com, <a href="FileUtils.html#M000076">which</a> you may optionally
-include in the program name. Returns <tt>nil</tt> if not found.
-</p>
-<p>
-CREDIT Daniel J. Berger &amp; Michael Granger
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000083_source')" id="l_M000083_source">show source</a> ]</p>
-  <div id="M000083_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/lore/facets/fileutils/which.rb, line 24</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">which</span>(<span class="ruby-identifier">prog</span>, <span class="ruby-identifier">path</span>=<span class="ruby-constant">ENV</span>[<span class="ruby-value str">'PATH'</span>])
-    <span class="ruby-identifier">path</span>.<span class="ruby-identifier">split</span>(<span class="ruby-constant">File</span><span class="ruby-operator">::</span><span class="ruby-constant">PATH_SEPARATOR</span>).<span class="ruby-identifier">each</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">dir</span><span class="ruby-operator">|</span>
-      <span class="ruby-comment cmt"># Windows checks against specific extensions</span>
-      <span class="ruby-keyword kw">if</span> <span class="ruby-constant">File</span><span class="ruby-operator">::</span><span class="ruby-constant">ALT_SEPARATOR</span>
-        <span class="ruby-identifier">ext</span> = <span class="ruby-constant">Win32Exts</span>.<span class="ruby-identifier">find</span>{<span class="ruby-operator">|</span><span class="ruby-identifier">ext</span><span class="ruby-operator">|</span>
-          <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">prog</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-value str">'.'</span>) <span class="ruby-comment cmt"># Assume extension already included</span>
-            <span class="ruby-identifier">f</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-identifier">dir</span>,<span class="ruby-identifier">prog</span>)
-          <span class="ruby-keyword kw">else</span>
-            <span class="ruby-identifier">f</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-identifier">dir</span>,<span class="ruby-identifier">prog</span><span class="ruby-operator">+</span><span class="ruby-identifier">ext</span>)
-          <span class="ruby-keyword kw">end</span>
-          <span class="ruby-constant">File</span>.<span class="ruby-identifier">executable?</span>(<span class="ruby-identifier">f</span>) <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-operator">!</span><span class="ruby-constant">File</span>.<span class="ruby-identifier">directory?</span>(<span class="ruby-identifier">f</span>)
-        }
-        <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">ext</span>
-          <span class="ruby-comment cmt"># Use backslashes, not forward slashes</span>
-          <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">prog</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-value str">'.'</span>) <span class="ruby-comment cmt"># Assume extension already included</span>
-            <span class="ruby-identifier">f</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>( <span class="ruby-identifier">dir</span>, <span class="ruby-identifier">prog</span> ).<span class="ruby-identifier">gsub</span>(<span class="ruby-regexp re">/\//</span>,<span class="ruby-value str">'\\'</span>)
-          <span class="ruby-keyword kw">else</span>
-            <span class="ruby-identifier">f</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>( <span class="ruby-identifier">dir</span>, <span class="ruby-identifier">prog</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">ext</span> ).<span class="ruby-identifier">gsub</span>(<span class="ruby-regexp re">/\//</span>,<span class="ruby-value str">'\\'</span>)
-          <span class="ruby-keyword kw">end</span>
-          <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">f</span>
-        <span class="ruby-keyword kw">end</span>
-      <span class="ruby-keyword kw">else</span>
-        <span class="ruby-identifier">f</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-identifier">dir</span>,<span class="ruby-identifier">prog</span>)
-        <span class="ruby-comment cmt"># Avoid /usr/lib/ruby, for example</span>
-        <span class="ruby-keyword kw">if</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">executable?</span>(<span class="ruby-identifier">f</span>) <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-operator">!</span><span class="ruby-constant">File</span>.<span class="ruby-identifier">directory?</span>(<span class="ruby-identifier">f</span>)
-          <span class="ruby-keyword kw">return</span> <span class="ruby-constant">File</span><span class="ruby-operator">::</span><span class="ruby-identifier">join</span>( <span class="ruby-identifier">dir</span>, <span class="ruby-identifier">prog</span> )
-        <span class="ruby-keyword kw">end</span>
-      <span class="ruby-keyword kw">end</span>
-    }
-    <span class="ruby-keyword kw">nil</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000076"></a><b>which</b>(prog, path=ENV['PATH'])
+    <a name="M000117"></a><b>which</b>(prog, path=ENV['PATH'])
   </div>
   <div class="description">
   <p>
@@ -725,7 +381,7 @@ Looks for the first occurrence of <em>program</em> within <em>path</em>.
 </p>
 <p>
 On the MS Windows platform, it looks for executables ending with .exe, .bat
-and .com, <a href="FileUtils.html#M000076">which</a> you may optionally
+and .com, <a href="FileUtils.html#M000117">which</a> you may optionally
 include in the program name. Returns <tt>nil</tt> if not found.
 </p>
 <p>
@@ -733,8 +389,8 @@ CREDIT Daniel J. Berger &amp; Michael Granger
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000076_source')" id="l_M000076_source">show source</a> ]</p>
-  <div id="M000076_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000117_source')" id="l_M000117_source">show source</a> ]</p>
+  <div id="M000117_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/lore/facets/fileutils/which.rb, line 24</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">which</span>(<span class="ruby-identifier">prog</span>, <span class="ruby-identifier">path</span>=<span class="ruby-constant">ENV</span>[<span class="ruby-value str">'PATH'</span>])