facets 2.4.3 → 2.4.4

data/doc/rdoc/core/classes/Exception.html

@@ -58,8 +58,6 @@
         <td>In:</td>
         <td>
 <a href="../files/lib/core/facets/exception/suppress_rb.html">lib/core/facets/exception/suppress.rb</a>
-<a href="../files/lib/core/facets/exception/detail_rb.html">lib/core/facets/exception/detail.rb</a>
-<a href="../files/lib/core/facets/exception/suppress_rb.html">lib/core/facets/exception/suppress.rb</a>
 <a href="../files/lib/core/facets/exception/detail_rb.html">lib/core/facets/exception/detail.rb</a>
         </td>
       </tr>
@@ -85,10 +83,8 @@ Object
 
   <div class="sectiontitle">Methods</div>
   <ul>
-  <li><a href="#M000397">detail</a></li>
-  <li><a href="#M000395">detail</a></li>
-  <li><a href="#M000396">suppress</a></li>
-  <li><a href="#M000394">suppress</a></li>
+  <li><a href="#M000211">detail</a></li>
+  <li><a href="#M000210">suppress</a></li>
   </ul>
 
 
@@ -99,40 +95,7 @@ Object
 <div class="sectiontitle">Public Class methods</div>
 <div class="method">
   <div class="title">
-    <a name="M000396"></a><b>suppress</b>(*exception_classes) {|| ...}
-  </div>
-  <div class="description">
-  <p>
-Supress errors while executing a block, with execptions.
-</p>
-<pre>
- CREDIT: Trans
- CREDIT: David Heinemeier Hansson
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000396_source')" id="l_M000396_source">show source</a> ]</p>
-  <div id="M000396_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/exception/suppress.rb, line 8</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">suppress</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">exception_classes</span>)
-    <span class="ruby-identifier">exception_classes</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">e</span><span class="ruby-operator">|</span>
-      <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">e</span> <span class="ruby-operator">&lt;</span> <span class="ruby-keyword kw">self</span>
-        <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-node">&quot;exception #{e} not a subclass of #{self}&quot;</span>
-      <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">begin</span> <span class="ruby-keyword kw">yield</span>
-    <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">Exception</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">e</span>
-      <span class="ruby-identifier">raise</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">exception_classes</span>.<span class="ruby-identifier">any?</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">cls</span><span class="ruby-operator">|</span> <span class="ruby-identifier">e</span>.<span class="ruby-identifier">kind_of?</span>(<span class="ruby-identifier">cls</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="M000394"></a><b>suppress</b>(*exception_classes) {|| ...}
+    <a name="M000210"></a><b>suppress</b>(*exception_classes) {|| ...}
   </div>
   <div class="description">
   <p>
@@ -144,8 +107,8 @@ Supress errors while executing a block, with execptions.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000394_source')" id="l_M000394_source">show source</a> ]</p>
-  <div id="M000394_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000210_source')" id="l_M000210_source">show source</a> ]</p>
+  <div id="M000210_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/exception/suppress.rb, line 8</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">suppress</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">exception_classes</span>)
@@ -166,38 +129,7 @@ Supress errors while executing a block, with execptions.
 <div class="sectiontitle">Public Instance methods</div>
 <div class="method">
   <div class="title">
-    <a name="M000397"></a><b>detail</b>()
-  </div>
-  <div class="description">
-  <p>
-Pretty string output of exception/error object useful for helpful debug
-messages.
-</p>
-<p>
-Input: The <a href="Exception.html">Exception</a>/StandardError object
-</p>
-<p>
-Output: The pretty printed string
-</p>
-<pre>
- CREDIT: George Moschovitis
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000397_source')" id="l_M000397_source">show source</a> ]</p>
-  <div id="M000397_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/exception/detail.rb, line 14</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">detail</span>
-    <span class="ruby-keyword kw">return</span> <span class="ruby-node">%{#{message}\n  #{backtrace.join(&quot;\n  &quot;)}\n  LOGGED FROM: #{caller[0]}}</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000395"></a><b>detail</b>()
+    <a name="M000211"></a><b>detail</b>()
   </div>
   <div class="description">
   <p>
@@ -215,8 +147,8 @@ Output: The pretty printed string
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000395_source')" id="l_M000395_source">show source</a> ]</p>
-  <div id="M000395_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000211_source')" id="l_M000211_source">show source</a> ]</p>
+  <div id="M000211_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/exception/detail.rb, line 14</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">detail</span>

data/doc/rdoc/core/classes/FalseClass.html

@@ -83,8 +83,8 @@ Object
 
   <div class="sectiontitle">Methods</div>
   <ul>
-  <li><a href="#M000128">blank?</a></li>
-  <li><a href="#M000127">to_bool</a></li>
+  <li><a href="#M000073">blank?</a></li>
+  <li><a href="#M000072">to_bool</a></li>
   </ul>
 
 
@@ -95,11 +95,11 @@ Object
 <div class="sectiontitle">Public Instance methods</div>
 <div class="method">
   <div class="title">
-    <a name="M000128"></a><b>blank?</b>()
+    <a name="M000073"></a><b>blank?</b>()
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000128_source')" id="l_M000128_source">show source</a> ]</p>
-  <div id="M000128_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000073_source')" id="l_M000073_source">show source</a> ]</p>
+  <div id="M000073_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/blank.rb, line 26</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">blank?</span>
@@ -111,11 +111,11 @@ Object
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000127"></a><b>to_bool</b>()
+    <a name="M000072"></a><b>to_bool</b>()
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000127_source')" id="l_M000127_source">show source</a> ]</p>
-  <div id="M000127_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000072_source')" id="l_M000072_source">show source</a> ]</p>
+  <div id="M000072_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/boolean.rb, line 147</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_bool</span>

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

@@ -58,11 +58,7 @@
         <td>In:</td>
         <td>
 <a href="../files/lib/core/facets/file/rootname_rb.html">lib/core/facets/file/rootname.rb</a>
-<a href="../files/lib/core/facets/file/null_rb.html">lib/core/facets/file/null.rb</a>
-<a href="../files/lib/core/facets/file/write_rb.html">lib/core/facets/file/write.rb</a>
-<a href="../files/lib/core/facets/file/rewrite_rb.html">lib/core/facets/file/rewrite.rb</a>
-<a href="../files/lib/core/facets/file/read_rb.html">lib/core/facets/file/read.rb</a>
-<a href="../files/lib/core/facets/file/rootname_rb.html">lib/core/facets/file/rootname.rb</a>
+<a href="../files/lib/core/facets/file/split_root_rb.html">lib/core/facets/file/split_root.rb</a>
 <a href="../files/lib/core/facets/file/null_rb.html">lib/core/facets/file/null.rb</a>
 <a href="../files/lib/core/facets/file/write_rb.html">lib/core/facets/file/write.rb</a>
 <a href="../files/lib/core/facets/file/rewrite_rb.html">lib/core/facets/file/rewrite.rb</a>
@@ -91,28 +87,18 @@ Object
 
   <div class="sectiontitle">Methods</div>
   <ul>
-  <li><a href="#M000436">append</a></li>
-  <li><a href="#M000425">append</a></li>
-  <li><a href="#M000426">create</a></li>
-  <li><a href="#M000437">create</a></li>
-  <li><a href="#M000435">null</a></li>
-  <li><a href="#M000424">null</a></li>
-  <li><a href="#M000432">read_binary</a></li>
-  <li><a href="#M000443">read_binary</a></li>
-  <li><a href="#M000433">read_list</a></li>
-  <li><a href="#M000444">read_list</a></li>
-  <li><a href="#M000440">rewrite</a></li>
-  <li><a href="#M000429">rewrite</a></li>
-  <li><a href="#M000441">rewrite!</a></li>
-  <li><a href="#M000430">rewrite!</a></li>
-  <li><a href="#M000434">rootname</a></li>
-  <li><a href="#M000423">rootname</a></li>
-  <li><a href="#M000431">sanitize</a></li>
-  <li><a href="#M000442">sanitize</a></li>
-  <li><a href="#M000427">write</a></li>
-  <li><a href="#M000438">write</a></li>
-  <li><a href="#M000439">writelines</a></li>
-  <li><a href="#M000428">writelines</a></li>
+  <li><a href="#M000231">append</a></li>
+  <li><a href="#M000232">create</a></li>
+  <li><a href="#M000230">null</a></li>
+  <li><a href="#M000238">read_binary</a></li>
+  <li><a href="#M000239">read_list</a></li>
+  <li><a href="#M000235">rewrite</a></li>
+  <li><a href="#M000236">rewrite!</a></li>
+  <li><a href="#M000228">rootname</a></li>
+  <li><a href="#M000237">sanitize</a></li>
+  <li><a href="#M000229">split_root</a></li>
+  <li><a href="#M000233">write</a></li>
+  <li><a href="#M000234">writelines</a></li>
   </ul>
 
 
@@ -123,7 +109,7 @@ Object
 <div class="sectiontitle">Public Class methods</div>
 <div class="method">
   <div class="title">
-    <a name="M000436"></a><b>append</b>( file, str )
+    <a name="M000231"></a><b>append</b>( file, str )
   </div>
   <div class="description">
   <p>
@@ -134,8 +120,8 @@ Append to a file.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000436_source')" id="l_M000436_source">show source</a> ]</p>
-  <div id="M000436_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000231_source')" id="l_M000231_source">show source</a> ]</p>
+  <div id="M000231_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/file/write.rb, line 7</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">append</span>( <span class="ruby-identifier">file</span>, <span class="ruby-identifier">str</span> )
@@ -149,65 +135,7 @@ Append to a file.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000425"></a><b>append</b>( file, str )
-  </div>
-  <div class="description">
-  <p>
-Append to a file.
-</p>
-<pre>
-  CREDIT: George Moschovitis
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000425_source')" id="l_M000425_source">show source</a> ]</p>
-  <div id="M000425_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/file/write.rb, line 7</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">append</span>( <span class="ruby-identifier">file</span>, <span class="ruby-identifier">str</span> )
-    <span class="ruby-constant">File</span>.<span class="ruby-identifier">open</span>( <span class="ruby-identifier">file</span>, <span class="ruby-value str">'ab'</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-operator">&lt;&lt;</span> <span class="ruby-identifier">str</span>
-    }
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000426"></a><b>create</b>(path, str='', &amp;blk)
-  </div>
-  <div class="description">
-  <p>
-Creates a new file, or overwrites an existing file, and writes a string
-into it. Can also take a block just like File#open, which is yielded
-<em>after</em> the string is writ.
-</p>
-<pre>
-  str = 'The content for the file'
-  File.create('myfile.txt', str)
-
-  CREDIT: George Moschovitis
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000426_source')" id="l_M000426_source">show source</a> ]</p>
-  <div id="M000426_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/file/write.rb, line 23</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">create</span>(<span class="ruby-identifier">path</span>, <span class="ruby-identifier">str</span>=<span class="ruby-value str">''</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">blk</span>)
-    <span class="ruby-constant">File</span>.<span class="ruby-identifier">open</span>(<span class="ruby-identifier">path</span>, <span class="ruby-value str">'wb'</span>) <span class="ruby-keyword kw">do</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-operator">&lt;&lt;</span> <span class="ruby-identifier">str</span>
-      <span class="ruby-identifier">blk</span>.<span class="ruby-identifier">call</span>(<span class="ruby-identifier">f</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">blk</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="M000437"></a><b>create</b>(path, str='', &amp;blk)
+    <a name="M000232"></a><b>create</b>(path, str='', &amp;blk)
   </div>
   <div class="description">
   <p>
@@ -223,8 +151,8 @@ into it. Can also take a block just like File#open, which is yielded
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000437_source')" id="l_M000437_source">show source</a> ]</p>
-  <div id="M000437_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000232_source')" id="l_M000232_source">show source</a> ]</p>
+  <div id="M000232_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/file/write.rb, line 23</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">create</span>(<span class="ruby-identifier">path</span>, <span class="ruby-identifier">str</span>=<span class="ruby-value str">''</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">blk</span>)
@@ -239,19 +167,19 @@ into it. Can also take a block just like File#open, which is yielded
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000435"></a><b>null</b>()
+    <a name="M000230"></a><b>null</b>()
   </div>
   <div class="description">
   <p>
-Platform dependent <a href="File.html#M000424">null</a> device.
+Platform dependent <a href="File.html#M000230">null</a> device.
 </p>
 <pre>
   CREDIT: Daniel Burger
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000435_source')" id="l_M000435_source">show source</a> ]</p>
-  <div id="M000435_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000230_source')" id="l_M000230_source">show source</a> ]</p>
+  <div id="M000230_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/file/null.rb, line 7</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">null</span>
@@ -272,40 +200,7 @@ Platform dependent <a href="File.html#M000424">null</a> device.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000424"></a><b>null</b>()
-  </div>
-  <div class="description">
-  <p>
-Platform dependent <a href="File.html#M000424">null</a> device.
-</p>
-<pre>
-  CREDIT: Daniel Burger
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000424_source')" id="l_M000424_source">show source</a> ]</p>
-  <div id="M000424_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/file/null.rb, line 7</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">null</span>
-    <span class="ruby-keyword kw">case</span> <span class="ruby-constant">RUBY_PLATFORM</span>
-    <span class="ruby-keyword kw">when</span> <span class="ruby-regexp re">/mswin/i</span>
-      <span class="ruby-value str">'NUL'</span>
-    <span class="ruby-keyword kw">when</span> <span class="ruby-regexp re">/amiga/i</span>
-      <span class="ruby-value str">'NIL:'</span>
-    <span class="ruby-keyword kw">when</span> <span class="ruby-regexp re">/openvms/i</span>
-      <span class="ruby-value str">'NL:'</span>
-    <span class="ruby-keyword kw">else</span>
-      <span class="ruby-value str">'/dev/null'</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="M000432"></a><b>read_binary</b>(fname)
+    <a name="M000238"></a><b>read_binary</b>(fname)
   </div>
   <div class="description">
   <p>
@@ -316,8 +211,8 @@ Read in a file as binary data.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000432_source')" id="l_M000432_source">show source</a> ]</p>
-  <div id="M000432_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000238_source')" id="l_M000238_source">show source</a> ]</p>
+  <div id="M000238_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/file/read.rb, line 18</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">read_binary</span>(<span class="ruby-identifier">fname</span>)
@@ -331,33 +226,7 @@ Read in a file as binary data.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000443"></a><b>read_binary</b>(fname)
-  </div>
-  <div class="description">
-  <p>
-Read in a file as binary data.
-</p>
-<pre>
- CREDIT: George Moschovitis
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000443_source')" id="l_M000443_source">show source</a> ]</p>
-  <div id="M000443_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/file/read.rb, line 18</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">read_binary</span>(<span class="ruby-identifier">fname</span>)
-    <span class="ruby-identifier">open</span>(<span class="ruby-identifier">fname</span>, <span class="ruby-value str">'rb'</span>) {<span class="ruby-operator">|</span><span class="ruby-identifier">f</span><span class="ruby-operator">|</span>
-      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">f</span>.<span class="ruby-identifier">read</span>
-    }
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000433"></a><b>read_list</b>(filepath, chomp_string='')
+    <a name="M000239"></a><b>read_list</b>(filepath, chomp_string='')
   </div>
   <div class="description">
   <p>
@@ -369,8 +238,8 @@ Reads in a file, removes blank lines and remarks (lines starting with
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000433_source')" id="l_M000433_source">show source</a> ]</p>
-  <div id="M000433_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000239_source')" id="l_M000239_source">show source</a> ]</p>
+  <div id="M000239_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/file/read.rb, line 30</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">read_list</span>(<span class="ruby-identifier">filepath</span>, <span class="ruby-identifier">chomp_string</span>=<span class="ruby-value str">''</span>)
@@ -388,38 +257,7 @@ Reads in a file, removes blank lines and remarks (lines starting with
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000444"></a><b>read_list</b>(filepath, chomp_string='')
-  </div>
-  <div class="description">
-  <p>
-Reads in a file, removes blank lines and remarks (lines starting with
-&#8217;#&#8217;) and then returns an array of all the remaining lines.
-</p>
-<pre>
-  CREDIT: Trans
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000444_source')" id="l_M000444_source">show source</a> ]</p>
-  <div id="M000444_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/file/read.rb, line 30</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">read_list</span>(<span class="ruby-identifier">filepath</span>, <span class="ruby-identifier">chomp_string</span>=<span class="ruby-value str">''</span>)
-    <span class="ruby-identifier">farr</span> = <span class="ruby-keyword kw">nil</span>
-    <span class="ruby-identifier">farr</span> = <span class="ruby-identifier">read</span>(<span class="ruby-identifier">filepath</span>).<span class="ruby-identifier">split</span>(<span class="ruby-value str">&quot;\n&quot;</span>)
-    <span class="ruby-identifier">farr</span>.<span class="ruby-identifier">collect!</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">line</span><span class="ruby-operator">|</span>
-      <span class="ruby-identifier">l</span> = <span class="ruby-identifier">line</span>.<span class="ruby-identifier">strip</span>.<span class="ruby-identifier">chomp</span>(<span class="ruby-identifier">chomp_string</span>)
-      (<span class="ruby-identifier">l</span>.<span class="ruby-identifier">empty?</span> <span class="ruby-keyword kw">or</span> <span class="ruby-identifier">l</span>[<span class="ruby-value">0</span>,<span class="ruby-value">1</span>] <span class="ruby-operator">==</span> <span class="ruby-value str">'#'</span>) <span class="ruby-operator">?</span> <span class="ruby-keyword kw">nil</span> <span class="ruby-operator">:</span> <span class="ruby-identifier">l</span>
-    }
-    <span class="ruby-identifier">farr</span>.<span class="ruby-identifier">compact</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000440"></a><b>rewrite</b>(name, mode = &quot;&quot;) {|| ...}
+    <a name="M000235"></a><b>rewrite</b>(name, mode = &quot;&quot;) {|| ...}
   </div>
   <div class="description">
   <p>
@@ -437,7 +275,7 @@ exception.
 <p>
 Mode can either be &quot;b&quot; or &quot;+&quot; and specifies to open the
 file in binary mode (no mapping of the plattform&#8216;s newlines to
-&quot;\n&quot; is done) or to <a href="File.html#M000425">append</a> to it.
+&quot;\n&quot; is done) or to <a href="File.html#M000231">append</a> to it.
 </p>
 <pre>
   # Reverse contents of &quot;message&quot;
@@ -448,7 +286,7 @@ file in binary mode (no mapping of the plattform&#8216;s newlines to
 </pre>
 <p>
 IMPORTANT: The old version of this method required in place modification of
-the file string. The new version will <a href="File.html#M000427">write</a>
+the file string. The new version will <a href="File.html#M000233">write</a>
 whatever the block returns instead!!!
 </p>
 <pre>
@@ -456,8 +294,8 @@ whatever the block returns instead!!!
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000440_source')" id="l_M000440_source">show source</a> ]</p>
-  <div id="M000440_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000235_source')" id="l_M000235_source">show source</a> ]</p>
+  <div id="M000235_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/file/rewrite.rb, line 28</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">rewrite</span>(<span class="ruby-identifier">name</span>, <span class="ruby-identifier">mode</span> = <span class="ruby-value str">&quot;&quot;</span>) <span class="ruby-comment cmt">#:yield:</span>
@@ -490,82 +328,11 @@ whatever the block returns instead!!!
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000429"></a><b>rewrite</b>(name, mode = &quot;&quot;) {|| ...}
+    <a name="M000236"></a><b>rewrite!</b>(name, mode = &quot;&quot;) {|| ...}
   </div>
   <div class="description">
   <p>
-Opens a file as a string and writes back the string to the file at the end
-of the block.
-</p>
-<p>
-Returns the number of written bytes or <tt>nil</tt> if the file
-wasn&#8216;t modified.
-</p>
-<p>
-Note that the file will even be written back in case the block raises an
-exception.
-</p>
-<p>
-Mode can either be &quot;b&quot; or &quot;+&quot; and specifies to open the
-file in binary mode (no mapping of the plattform&#8216;s newlines to
-&quot;\n&quot; is done) or to <a href="File.html#M000425">append</a> to it.
-</p>
-<pre>
-  # Reverse contents of &quot;message&quot;
-  File.rewrite(&quot;message&quot;) { |str| str.reverse }
-
-  # Replace &quot;foo&quot; by &quot;bar&quot; in &quot;binary&quot;
-  File.rewrite(&quot;binary&quot;, &quot;b&quot;) { |str| str.gsub(&quot;foo&quot;, &quot;bar&quot;) }
-</pre>
-<p>
-IMPORTANT: The old version of this method required in place modification of
-the file string. The new version will <a href="File.html#M000427">write</a>
-whatever the block returns instead!!!
-</p>
-<pre>
- CREDIT: George Moschovitis
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000429_source')" id="l_M000429_source">show source</a> ]</p>
-  <div id="M000429_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/file/rewrite.rb, line 28</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">rewrite</span>(<span class="ruby-identifier">name</span>, <span class="ruby-identifier">mode</span> = <span class="ruby-value str">&quot;&quot;</span>) <span class="ruby-comment cmt">#:yield:</span>
-    <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">block_given?</span>
-      <span class="ruby-identifier">raise</span>(<span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">&quot;Need to supply block to File.rewrite&quot;</span>)
-    <span class="ruby-keyword kw">end</span>
-
-    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">mode</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Numeric</span>) <span class="ruby-keyword kw">then</span>
-      <span class="ruby-identifier">flag</span>, <span class="ruby-identifier">mode</span> = <span class="ruby-identifier">mode</span>, <span class="ruby-value str">&quot;&quot;</span>
-      <span class="ruby-identifier">mode</span> <span class="ruby-operator">+=</span> <span class="ruby-value str">&quot;b&quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">flag</span> <span class="ruby-operator">&amp;</span> <span class="ruby-constant">File</span><span class="ruby-operator">::</span><span class="ruby-constant">Constants</span><span class="ruby-operator">::</span><span class="ruby-constant">BINARY</span> <span class="ruby-operator">!=</span> <span class="ruby-value">0</span>
-      <span class="ruby-identifier">mode</span> <span class="ruby-operator">+=</span> <span class="ruby-value str">&quot;+&quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">flag</span> <span class="ruby-operator">&amp;</span> <span class="ruby-constant">File</span><span class="ruby-operator">::</span><span class="ruby-constant">Constants</span><span class="ruby-operator">::</span><span class="ruby-constant">APPEND</span> <span class="ruby-operator">!=</span> <span class="ruby-value">0</span>
-    <span class="ruby-keyword kw">else</span>
-      <span class="ruby-identifier">mode</span>.<span class="ruby-identifier">delete!</span>(<span class="ruby-value str">&quot;^b+&quot;</span>)
-    <span class="ruby-keyword kw">end</span>
-
-    <span class="ruby-identifier">old_str</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">open</span>(<span class="ruby-identifier">name</span>, <span class="ruby-node">&quot;r#{mode}&quot;</span>) { <span class="ruby-operator">|</span><span class="ruby-identifier">file</span><span class="ruby-operator">|</span> <span class="ruby-identifier">file</span>.<span class="ruby-identifier">read</span> } <span class="ruby-comment cmt">#rescue &quot;&quot;</span>
-    <span class="ruby-identifier">old_str</span> = <span class="ruby-identifier">str</span>.<span class="ruby-identifier">clone</span>
-
-    <span class="ruby-keyword kw">begin</span>
-      <span class="ruby-identifier">new_str</span> = <span class="ruby-keyword kw">yield</span>(<span class="ruby-identifier">old_str</span>)
-    <span class="ruby-keyword kw">ensure</span>
-      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">old_str</span> <span class="ruby-operator">!=</span> <span class="ruby-identifier">new_str</span>
-        <span class="ruby-constant">File</span>.<span class="ruby-identifier">open</span>(<span class="ruby-identifier">name</span>, <span class="ruby-node">&quot;w#{mode}&quot;</span>) { <span class="ruby-operator">|</span><span class="ruby-identifier">file</span><span class="ruby-operator">|</span> <span class="ruby-identifier">file</span>.<span class="ruby-identifier">write</span>(<span class="ruby-identifier">new_str</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="M000441"></a><b>rewrite!</b>(name, mode = &quot;&quot;) {|| ...}
-  </div>
-  <div class="description">
-  <p>
-In place version of <a href="File.html#M000429">rewrite</a>. This version
+In place version of <a href="File.html#M000235">rewrite</a>. This version
 of method requires that the string be modified in place within the block.
 </p>
 <pre>
@@ -577,8 +344,8 @@ of method requires that the string be modified in place within the block.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000441_source')" id="l_M000441_source">show source</a> ]</p>
-  <div id="M000441_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000236_source')" id="l_M000236_source">show source</a> ]</p>
+  <div id="M000236_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/file/rewrite.rb, line 62</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">rewrite!</span>(<span class="ruby-identifier">name</span>, <span class="ruby-identifier">mode</span> = <span class="ruby-value str">&quot;&quot;</span>) <span class="ruby-comment cmt">#:yield:</span>
@@ -611,91 +378,7 @@ of method requires that the string be modified in place within the block.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000430"></a><b>rewrite!</b>(name, mode = &quot;&quot;) {|| ...}
-  </div>
-  <div class="description">
-  <p>
-In place version of <a href="File.html#M000429">rewrite</a>. This version
-of method requires that the string be modified in place within the block.
-</p>
-<pre>
-  # Reverse contents of &quot;message&quot;
-  File.rewrite(&quot;message&quot;) { |str| str.reverse! }
-
-  # Replace &quot;foo&quot; by &quot;bar&quot; in &quot;binary&quot;
-  File.rewrite(&quot;binary&quot;, &quot;b&quot;) { |str| str.gsub!(&quot;foo&quot;, &quot;bar&quot;) }
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000430_source')" id="l_M000430_source">show source</a> ]</p>
-  <div id="M000430_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/file/rewrite.rb, line 62</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">rewrite!</span>(<span class="ruby-identifier">name</span>, <span class="ruby-identifier">mode</span> = <span class="ruby-value str">&quot;&quot;</span>) <span class="ruby-comment cmt">#:yield:</span>
-    <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">block_given?</span>
-      <span class="ruby-identifier">raise</span>(<span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">&quot;Need to supply block to File.rewrite&quot;</span>)
-    <span class="ruby-keyword kw">end</span>
-
-    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">mode</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Numeric</span>) <span class="ruby-keyword kw">then</span>
-      <span class="ruby-identifier">flag</span>, <span class="ruby-identifier">mode</span> = <span class="ruby-identifier">mode</span>, <span class="ruby-value str">&quot;&quot;</span>
-      <span class="ruby-identifier">mode</span> <span class="ruby-operator">+=</span> <span class="ruby-value str">&quot;b&quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">flag</span> <span class="ruby-operator">&amp;</span> <span class="ruby-constant">File</span><span class="ruby-operator">::</span><span class="ruby-constant">Constants</span><span class="ruby-operator">::</span><span class="ruby-constant">BINARY</span> <span class="ruby-operator">!=</span> <span class="ruby-value">0</span>
-      <span class="ruby-identifier">mode</span> <span class="ruby-operator">+=</span> <span class="ruby-value str">&quot;+&quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">flag</span> <span class="ruby-operator">&amp;</span> <span class="ruby-constant">File</span><span class="ruby-operator">::</span><span class="ruby-constant">Constants</span><span class="ruby-operator">::</span><span class="ruby-constant">APPEND</span> <span class="ruby-operator">!=</span> <span class="ruby-value">0</span>
-    <span class="ruby-keyword kw">else</span>
-      <span class="ruby-identifier">mode</span>.<span class="ruby-identifier">delete!</span>(<span class="ruby-value str">&quot;^b+&quot;</span>)
-    <span class="ruby-keyword kw">end</span>
-
-    <span class="ruby-identifier">old_str</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">open</span>(<span class="ruby-identifier">name</span>, <span class="ruby-node">&quot;r#{mode}&quot;</span>) { <span class="ruby-operator">|</span><span class="ruby-identifier">file</span><span class="ruby-operator">|</span> <span class="ruby-identifier">file</span>.<span class="ruby-identifier">read</span> } <span class="ruby-comment cmt">#rescue &quot;&quot;</span>
-    <span class="ruby-identifier">new_str</span> = <span class="ruby-identifier">str</span>.<span class="ruby-identifier">clone</span>
-
-    <span class="ruby-keyword kw">begin</span>
-      <span class="ruby-keyword kw">yield</span>(<span class="ruby-identifier">new_str</span>)
-    <span class="ruby-keyword kw">ensure</span>
-      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">old_str</span> <span class="ruby-operator">!=</span> <span class="ruby-identifier">new_str</span>
-        <span class="ruby-constant">File</span>.<span class="ruby-identifier">open</span>(<span class="ruby-identifier">name</span>, <span class="ruby-node">&quot;w#{mode}&quot;</span>) { <span class="ruby-operator">|</span><span class="ruby-identifier">file</span><span class="ruby-operator">|</span> <span class="ruby-identifier">file</span>.<span class="ruby-identifier">write</span>(<span class="ruby-identifier">str</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="M000434"></a><b>rootname</b>(path)
-  </div>
-  <div class="description">
-  <p>
-Returns onlt the first portion of the directory of a file path name.
-</p>
-<pre>
-  File.rootname('lib/jump.rb')  #=&gt; 'lib'
-  File.rootname('/jump.rb')     #=&gt; '/'
-  File.rootname('jump.rb')      #=&gt; '.'
-
-  CREDIT: Trans
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000434_source')" id="l_M000434_source">show source</a> ]</p>
-  <div id="M000434_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/file/rootname.rb, line 12</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">rootname</span>(<span class="ruby-identifier">path</span>)
-    <span class="ruby-comment cmt"># this should be fairly robust</span>
-    <span class="ruby-identifier">path_re</span> = <span class="ruby-constant">Regexp</span>.<span class="ruby-identifier">new</span>(<span class="ruby-value str">'['</span> <span class="ruby-operator">+</span> <span class="ruby-constant">Regexp</span>.<span class="ruby-identifier">escape</span>(<span class="ruby-constant">File</span><span class="ruby-operator">::</span><span class="ruby-constant">Separator</span> <span class="ruby-operator">+</span> <span class="ruby-value str">%q{\/}</span>) <span class="ruby-operator">+</span> <span class="ruby-value str">']'</span>)
-
-    <span class="ruby-identifier">head</span>, <span class="ruby-identifier">tail</span> = <span class="ruby-identifier">path</span>.<span class="ruby-identifier">split</span>(<span class="ruby-identifier">path_re</span>, <span class="ruby-value">2</span>)
-    <span class="ruby-keyword kw">return</span> <span class="ruby-value str">'.'</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">path</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">head</span>
-    <span class="ruby-keyword kw">return</span> <span class="ruby-value str">'/'</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">head</span>.<span class="ruby-identifier">empty?</span>
-    <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">head</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000423"></a><b>rootname</b>(path)
+    <a name="M000228"></a><b>rootname</b>(path)
   </div>
   <div class="description">
   <p>
@@ -710,8 +393,8 @@ Returns onlt the first portion of the directory of a file path name.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000423_source')" id="l_M000423_source">show source</a> ]</p>
-  <div id="M000423_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000228_source')" id="l_M000228_source">show source</a> ]</p>
+  <div id="M000228_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/file/rootname.rb, line 12</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">rootname</span>(<span class="ruby-identifier">path</span>)
@@ -729,7 +412,7 @@ Returns onlt the first portion of the directory of a file path name.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000431"></a><b>sanitize</b>(filename)
+    <a name="M000237"></a><b>sanitize</b>(filename)
   </div>
   <div class="description">
   <p>
@@ -740,8 +423,8 @@ Cleans up a filename to ensure it will work on filesystem.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000431_source')" id="l_M000431_source">show source</a> ]</p>
-  <div id="M000431_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000237_source')" id="l_M000237_source">show source</a> ]</p>
+  <div id="M000237_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/file/read.rb, line 7</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">sanitize</span>(<span class="ruby-identifier">filename</span>)
@@ -756,56 +439,16 @@ Cleans up a filename to ensure it will work on filesystem.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000442"></a><b>sanitize</b>(filename)
-  </div>
-  <div class="description">
-  <p>
-Cleans up a filename to ensure it will work on filesystem.
-</p>
-<pre>
- CREDIT: George Moschovitis
-</pre>
+    <a name="M000229"></a><b>split_root</b>(path)
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000442_source')" id="l_M000442_source">show source</a> ]</p>
-  <div id="M000442_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000229_source')" id="l_M000229_source">show source</a> ]</p>
+  <div id="M000229_source" class="dyn-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/core/facets/file/read.rb, line 7</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">sanitize</span>(<span class="ruby-identifier">filename</span>)
-    <span class="ruby-identifier">filename</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">basename</span>(<span class="ruby-identifier">filename</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-value str">&quot;\\&quot;</span>, <span class="ruby-value str">&quot;/&quot;</span>)) <span class="ruby-comment cmt"># work-around for IE</span>
-    <span class="ruby-identifier">filename</span>.<span class="ruby-identifier">gsub!</span>(<span class="ruby-regexp re">/[^a-zA-Z0-9\.\-\+_]/</span>,<span class="ruby-value str">&quot;_&quot;</span>)
-    <span class="ruby-identifier">filename</span> = <span class="ruby-node">&quot;_#{filename}&quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">filename</span> <span class="ruby-operator">=~</span> <span class="ruby-regexp re">/^\.+$/</span>
-    <span class="ruby-identifier">filename</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000427"></a><b>write</b>(path, data)
-  </div>
-  <div class="description">
-  <p>
-Writes the given data to the given path and closes the file. This is done
-in binary mode, complementing <tt>IO.read</tt> in standard Ruby.
-</p>
-<p>
-Returns the number of bytes written.
-</p>
-<pre>
-  CREDIT: Gavin Sinclair
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000427_source')" id="l_M000427_source">show source</a> ]</p>
-  <div id="M000427_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/file/write.rb, line 37</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">write</span>(<span class="ruby-identifier">path</span>, <span class="ruby-identifier">data</span>)
-    <span class="ruby-constant">File</span>.<span class="ruby-identifier">open</span>(<span class="ruby-identifier">path</span>, <span class="ruby-value str">&quot;wb&quot;</span>) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">file</span><span class="ruby-operator">|</span>
-      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">file</span>.<span class="ruby-identifier">write</span>(<span class="ruby-identifier">data</span>)
-    <span class="ruby-keyword kw">end</span>
+<span class="ruby-comment cmt"># File lib/core/facets/file/split_root.rb, line 4</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">split_root</span>(<span class="ruby-identifier">path</span>)
+    <span class="ruby-identifier">path_re</span> = <span class="ruby-constant">Regexp</span>.<span class="ruby-identifier">new</span>(<span class="ruby-value str">'['</span> <span class="ruby-operator">+</span> <span class="ruby-constant">Regexp</span>.<span class="ruby-identifier">escape</span>(<span class="ruby-constant">File</span><span class="ruby-operator">::</span><span class="ruby-constant">Separator</span> <span class="ruby-operator">+</span> <span class="ruby-value str">%q{\/}</span>) <span class="ruby-operator">+</span> <span class="ruby-value str">']'</span>)
+    <span class="ruby-identifier">path</span>.<span class="ruby-identifier">split</span>(<span class="ruby-identifier">path_re</span>, <span class="ruby-value">2</span>)
   <span class="ruby-keyword kw">end</span>
 </pre>
   </div>
@@ -813,7 +456,7 @@ Returns the number of bytes written.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000438"></a><b>write</b>(path, data)
+    <a name="M000233"></a><b>write</b>(path, data)
   </div>
   <div class="description">
   <p>
@@ -828,8 +471,8 @@ Returns the number of bytes written.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000438_source')" id="l_M000438_source">show source</a> ]</p>
-  <div id="M000438_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000233_source')" id="l_M000233_source">show source</a> ]</p>
+  <div id="M000233_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/file/write.rb, line 37</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">write</span>(<span class="ruby-identifier">path</span>, <span class="ruby-identifier">data</span>)
@@ -843,47 +486,7 @@ Returns the number of bytes written.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000439"></a><b>writelines</b>(path, data)
-  </div>
-  <div class="description">
-  <p>
-Writes the given array of data to the given path and closes the file. This
-is done in binary mode, complementing <tt>IO.readlines</tt> in standard
-Ruby.
-</p>
-<p>
-Note that <tt>readlines</tt> (the standard Ruby method) returns an array of
-lines <em>with newlines intact</em>, whereas <tt><a
-href="File.html#M000428">writelines</a></tt> uses <tt>puts</tt>, and so
-appends newlines if necessary. In this small way, <tt>readlines</tt> and
-<tt><a href="File.html#M000428">writelines</a></tt> are not exact
-opposites.
-</p>
-<p>
-Returns <tt>nil</tt>.
-</p>
-<pre>
-  CREDIT: Noah Gibbs
-  CREDIT: Gavin Sinclair
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000439_source')" id="l_M000439_source">show source</a> ]</p>
-  <div id="M000439_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/file/write.rb, line 57</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">writelines</span>(<span class="ruby-identifier">path</span>, <span class="ruby-identifier">data</span>)
-    <span class="ruby-constant">File</span>.<span class="ruby-identifier">open</span>(<span class="ruby-identifier">path</span>, <span class="ruby-value str">&quot;wb&quot;</span>) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">file</span><span class="ruby-operator">|</span>
-      <span class="ruby-identifier">file</span>.<span class="ruby-identifier">puts</span>(<span class="ruby-identifier">data</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="M000428"></a><b>writelines</b>(path, data)
+    <a name="M000234"></a><b>writelines</b>(path, data)
   </div>
   <div class="description">
   <p>
@@ -894,9 +497,9 @@ Ruby.
 <p>
 Note that <tt>readlines</tt> (the standard Ruby method) returns an array of
 lines <em>with newlines intact</em>, whereas <tt><a
-href="File.html#M000428">writelines</a></tt> uses <tt>puts</tt>, and so
+href="File.html#M000234">writelines</a></tt> uses <tt>puts</tt>, and so
 appends newlines if necessary. In this small way, <tt>readlines</tt> and
-<tt><a href="File.html#M000428">writelines</a></tt> are not exact
+<tt><a href="File.html#M000234">writelines</a></tt> are not exact
 opposites.
 </p>
 <p>
@@ -908,8 +511,8 @@ Returns <tt>nil</tt>.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000428_source')" id="l_M000428_source">show source</a> ]</p>
-  <div id="M000428_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000234_source')" id="l_M000234_source">show source</a> ]</p>
+  <div id="M000234_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/file/write.rb, line 57</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">writelines</span>(<span class="ruby-identifier">path</span>, <span class="ruby-identifier">data</span>)