facets 2.5.0 → 2.5.1

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

@@ -133,7 +133,7 @@ CREDIT: Trans
 Simply returns itself. Helpful when converting strings to regular
 expressions, where regexp might occur as well —in the same vien as
 using to_s on symbols. The parameter is actaully a dummy parameter to
-coincide with <a href="String.html#M000255">String#to_re</a>.
+coincide with <a href="String.html#M000267">String#to_re</a>.
 </p>
 <pre>
   /abc/.to_re  #=&gt; /abc/

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

@@ -72,9 +72,9 @@
   <div class="description"><h1><a href="Stackable.html">Stackable</a></h1>
 <p>
 <a href="Stackable.html">Stackable</a> mixin provides <a
-href="Stackable.html#M000335">pop</a>, <a
-href="Stackable.html#M000336">push</a>, <a
-href="Stackable.html#M000337">pull</a>, etc. It depends on slice, splice
+href="Stackable.html#M000347">pop</a>, <a
+href="Stackable.html#M000348">push</a>, <a
+href="Stackable.html#M000349">pull</a>, etc. It depends on slice, splice
 and insert.
 </p>
 </div>
@@ -82,13 +82,13 @@ and insert.
 
 
   <div class="sectiontitle">Methods</div>
-  <span style="padding-right: 5px;"><a href="#M000341">peek</a></span>
-  <span style="padding-right: 5px;"><a href="#M000339">poke</a></span>
-  <span style="padding-right: 5px;"><a href="#M000335">pop</a></span>
-  <span style="padding-right: 5px;"><a href="#M000337">pull</a></span>
-  <span style="padding-right: 5px;"><a href="#M000336">push</a></span>
-  <span style="padding-right: 5px;"><a href="#M000338">shift</a></span>
-  <span style="padding-right: 5px;"><a href="#M000340">unshift</a></span>
+  <span style="padding-right: 5px;"><a href="#M000353">peek</a></span>
+  <span style="padding-right: 5px;"><a href="#M000351">poke</a></span>
+  <span style="padding-right: 5px;"><a href="#M000347">pop</a></span>
+  <span style="padding-right: 5px;"><a href="#M000349">pull</a></span>
+  <span style="padding-right: 5px;"><a href="#M000348">push</a></span>
+  <span style="padding-right: 5px;"><a href="#M000350">shift</a></span>
+  <span style="padding-right: 5px;"><a href="#M000352">unshift</a></span>
 
 
 
@@ -98,7 +98,7 @@ and insert.
 <div class="sectiontitle">Public Instance methods</div>
 <div class="method">
   <div class="title">
-    <a name="M000341"></a><b>peek</b>()
+    <a name="M000353"></a><b>peek</b>()
   </div>
   <div class="description">
   <p>
@@ -111,8 +111,8 @@ Peek at the top of the stack.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000341_source')" id="l_M000341_source">+</a> ]</p>
-  <div id="M000341_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000353_source')" id="l_M000353_source">+</a> ]</p>
+  <div id="M000353_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/stackable.rb, line 81</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">peek</span>
@@ -124,7 +124,7 @@ Peek at the top of the stack.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000339"></a><b>poke</b>(x)
+    <a name="M000351"></a><b>poke</b>(x)
   </div>
   <div class="description">
   <p>
@@ -139,11 +139,11 @@ Poke item onto the stack.
   </div>
 <div class="aka">
   This method is also aliased as
-  <a href="Stackable.html#M000340">unshift</a>
+  <a href="Stackable.html#M000352">unshift</a>
 </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000339_source')" id="l_M000339_source">+</a> ]</p>
-  <div id="M000339_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000351_source')" id="l_M000351_source">+</a> ]</p>
+  <div id="M000351_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/stackable.rb, line 69</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">poke</span>(<span class="ruby-identifier">x</span>)
@@ -155,7 +155,7 @@ Poke item onto the stack.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000335"></a><b>pop</b>()
+    <a name="M000347"></a><b>pop</b>()
   </div>
   <div class="description">
   <p>
@@ -168,8 +168,8 @@ Pop item off stack.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000335_source')" id="l_M000335_source">+</a> ]</p>
-  <div id="M000335_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000347_source')" id="l_M000347_source">+</a> ]</p>
+  <div id="M000347_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/stackable.rb, line 37</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">pop</span>
@@ -181,7 +181,7 @@ Pop item off stack.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000337"></a><b>pull</b>()
+    <a name="M000349"></a><b>pull</b>()
   </div>
   <div class="description">
   <p>
@@ -195,11 +195,11 @@ Pull item off the stack.
   </div>
 <div class="aka">
   This method is also aliased as
-  <a href="Stackable.html#M000338">shift</a>
+  <a href="Stackable.html#M000350">shift</a>
 </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000337_source')" id="l_M000337_source">+</a> ]</p>
-  <div id="M000337_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000349_source')" id="l_M000349_source">+</a> ]</p>
+  <div id="M000349_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/stackable.rb, line 56</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">pull</span>
@@ -211,7 +211,7 @@ Pull item off the stack.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000336"></a><b>push</b>(x)
+    <a name="M000348"></a><b>push</b>(x)
   </div>
   <div class="description">
   <p>
@@ -223,8 +223,8 @@ Push item onto the stack.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000336_source')" id="l_M000336_source">+</a> ]</p>
-  <div id="M000336_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000348_source')" id="l_M000348_source">+</a> ]</p>
+  <div id="M000348_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/stackable.rb, line 46</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">push</span>(<span class="ruby-identifier">x</span>)
@@ -236,21 +236,21 @@ Push item onto the stack.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000338"></a><b>shift</b>()
+    <a name="M000350"></a><b>shift</b>()
   </div>
   <div class="description">
   <p>
-Alias for <a href="Stackable.html#M000337">pull</a>
+Alias for <a href="Stackable.html#M000349">pull</a>
 </p>
   </div>
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000340"></a><b>unshift</b>(x)
+    <a name="M000352"></a><b>unshift</b>(x)
   </div>
   <div class="description">
   <p>
-Alias for <a href="Stackable.html#M000339">poke</a>
+Alias for <a href="Stackable.html#M000351">poke</a>
 </p>
   </div>
 </div>

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

@@ -60,6 +60,7 @@
 <a href="../files/lib/core/facets/boolean_rb.html">lib/core/facets/boolean.rb</a>
 <a href="../files/lib/core/facets/comparable/cmp_rb.html">lib/core/facets/comparable/cmp.rb</a>
 <a href="../files/lib/core/facets/string/shatter_rb.html">lib/core/facets/string/shatter.rb</a>
+<a href="../files/lib/core/facets/string/file_rb.html">lib/core/facets/string/file.rb</a>
 <a href="../files/lib/core/facets/string/to_re_rb.html">lib/core/facets/string/to_re.rb</a>
 <a href="../files/lib/core/facets/string/fold_rb.html">lib/core/facets/string/fold.rb</a>
 <a href="../files/lib/core/facets/string/start_with_rb.html">lib/core/facets/string/start_with.rb</a>
@@ -123,68 +124,69 @@ Object
 
 
   <div class="sectiontitle">Methods</div>
-  <span style="padding-right: 5px;"><a href="#M000271">-</a></span>
-  <span style="padding-right: 5px;"><a href="#M000311">^</a></span>
-  <span style="padding-right: 5px;"><a href="#M000265">align</a></span>
-  <span style="padding-right: 5px;"><a href="#M000268">align_center</a></span>
-  <span style="padding-right: 5px;"><a href="#M000267">align_left</a></span>
-  <span style="padding-right: 5px;"><a href="#M000266">align_right</a></span>
-  <span style="padding-right: 5px;"><a href="#M000313">blank?</a></span>
-  <span style="padding-right: 5px;"><a href="#M000299">bracket</a></span>
-  <span style="padding-right: 5px;"><a href="#M000300">bracket!</a></span>
-  <span style="padding-right: 5px;"><a href="#M000289">bytes</a></span>
-  <span style="padding-right: 5px;"><a href="#M000260">camelcase</a></span>
-  <span style="padding-right: 5px;"><a href="#M000282">capitalized?</a></span>
-  <span style="padding-right: 5px;"><a href="#M000305">chars</a></span>
-  <span style="padding-right: 5px;"><a href="#M000297">cleave</a></span>
-  <span style="padding-right: 5px;"><a href="#M000253">cmp</a></span>
-  <span style="padding-right: 5px;"><a href="#M000272">compress_lines</a></span>
-  <span style="padding-right: 5px;"><a href="#M000304">dequote</a></span>
-  <span style="padding-right: 5px;"><a href="#M000279">divide</a></span>
-  <span style="padding-right: 5px;"><a href="#M000283">downcase?</a></span>
-  <span style="padding-right: 5px;"><a href="#M000278">each_char</a></span>
-  <span style="padding-right: 5px;"><a href="#M000312">each_word</a></span>
-  <span style="padding-right: 5px;"><a href="#M000259">end_with?</a></span>
-  <span style="padding-right: 5px;"><a href="#M000285">expand_tab</a></span>
-  <span style="padding-right: 5px;"><a href="#M000286">expand_tabs</a></span>
-  <span style="padding-right: 5px;"><a href="#M000257">fold</a></span>
-  <span style="padding-right: 5px;"><a href="#M000291">indent</a></span>
-  <span style="padding-right: 5px;"><a href="#M000276">index_all</a></span>
-  <span style="padding-right: 5px;"><a href="#M000296">interpolate</a></span>
-  <span style="padding-right: 5px;"><a href="#M000306">lchomp</a></span>
-  <span style="padding-right: 5px;"><a href="#M000307">lchomp!</a></span>
-  <span style="padding-right: 5px;"><a href="#M000298">line_wrap</a></span>
-  <span style="padding-right: 5px;"><a href="#M000261">lines</a></span>
-  <span style="padding-right: 5px;"><a href="#M000280">margin</a></span>
-  <span style="padding-right: 5px;"><a href="#M000270">methodize</a></span>
-  <span style="padding-right: 5px;"><a href="#M000262">modulize</a></span>
-  <span style="padding-right: 5px;"><a href="#M000281">mscan</a></span>
-  <span style="padding-right: 5px;"><a href="#M000287">natcmp</a></span>
-  <span style="padding-right: 5px;"><a href="#M000310">nchar</a></span>
-  <span style="padding-right: 5px;"><a href="#M000292">outdent</a></span>
-  <span style="padding-right: 5px;"><a href="#M000290">pathize</a></span>
-  <span style="padding-right: 5px;"><a href="#M000303">quote</a></span>
-  <span style="padding-right: 5px;"><a href="#M000273">range</a></span>
-  <span style="padding-right: 5px;"><a href="#M000274">range_all</a></span>
-  <span style="padding-right: 5px;"><a href="#M000275">range_of_line</a></span>
-  <span style="padding-right: 5px;"><a href="#M000309">rewrite</a></span>
-  <span style="padding-right: 5px;"><a href="#M000254">shatter</a></span>
-  <span style="padding-right: 5px;"><a href="#M000277">snakecase</a></span>
-  <span style="padding-right: 5px;"><a href="#M000308">splice</a></span>
-  <span style="padding-right: 5px;"><a href="#M000258">start_with?</a></span>
-  <span style="padding-right: 5px;"><a href="#M000269">tab</a></span>
-  <span style="padding-right: 5px;"><a href="#M000294">tabto</a></span>
-  <span style="padding-right: 5px;"><a href="#M000293">titlecase</a></span>
-  <span style="padding-right: 5px;"><a href="#M000252">to_b</a></span>
-  <span style="padding-right: 5px;"><a href="#M000255">to_re</a></span>
-  <span style="padding-right: 5px;"><a href="#M000256">to_rx</a></span>
-  <span style="padding-right: 5px;"><a href="#M000301">unbracket</a></span>
-  <span style="padding-right: 5px;"><a href="#M000302">unbracket!</a></span>
-  <span style="padding-right: 5px;"><a href="#M000284">upcase?</a></span>
-  <span style="padding-right: 5px;"><a href="#M000288">variablize</a></span>
-  <span style="padding-right: 5px;"><a href="#M000263">word_wrap</a></span>
-  <span style="padding-right: 5px;"><a href="#M000264">word_wrap!</a></span>
-  <span style="padding-right: 5px;"><a href="#M000295">words</a></span>
+  <span style="padding-right: 5px;"><a href="#M000283">-</a></span>
+  <span style="padding-right: 5px;"><a href="#M000323">^</a></span>
+  <span style="padding-right: 5px;"><a href="#M000277">align</a></span>
+  <span style="padding-right: 5px;"><a href="#M000280">align_center</a></span>
+  <span style="padding-right: 5px;"><a href="#M000279">align_left</a></span>
+  <span style="padding-right: 5px;"><a href="#M000278">align_right</a></span>
+  <span style="padding-right: 5px;"><a href="#M000325">blank?</a></span>
+  <span style="padding-right: 5px;"><a href="#M000311">bracket</a></span>
+  <span style="padding-right: 5px;"><a href="#M000312">bracket!</a></span>
+  <span style="padding-right: 5px;"><a href="#M000301">bytes</a></span>
+  <span style="padding-right: 5px;"><a href="#M000272">camelcase</a></span>
+  <span style="padding-right: 5px;"><a href="#M000294">capitalized?</a></span>
+  <span style="padding-right: 5px;"><a href="#M000317">chars</a></span>
+  <span style="padding-right: 5px;"><a href="#M000309">cleave</a></span>
+  <span style="padding-right: 5px;"><a href="#M000264">cmp</a></span>
+  <span style="padding-right: 5px;"><a href="#M000284">compress_lines</a></span>
+  <span style="padding-right: 5px;"><a href="#M000316">dequote</a></span>
+  <span style="padding-right: 5px;"><a href="#M000291">divide</a></span>
+  <span style="padding-right: 5px;"><a href="#M000295">downcase?</a></span>
+  <span style="padding-right: 5px;"><a href="#M000290">each_char</a></span>
+  <span style="padding-right: 5px;"><a href="#M000324">each_word</a></span>
+  <span style="padding-right: 5px;"><a href="#M000271">end_with?</a></span>
+  <span style="padding-right: 5px;"><a href="#M000297">expand_tab</a></span>
+  <span style="padding-right: 5px;"><a href="#M000298">expand_tabs</a></span>
+  <span style="padding-right: 5px;"><a href="#M000266">file</a></span>
+  <span style="padding-right: 5px;"><a href="#M000269">fold</a></span>
+  <span style="padding-right: 5px;"><a href="#M000303">indent</a></span>
+  <span style="padding-right: 5px;"><a href="#M000288">index_all</a></span>
+  <span style="padding-right: 5px;"><a href="#M000308">interpolate</a></span>
+  <span style="padding-right: 5px;"><a href="#M000318">lchomp</a></span>
+  <span style="padding-right: 5px;"><a href="#M000319">lchomp!</a></span>
+  <span style="padding-right: 5px;"><a href="#M000310">line_wrap</a></span>
+  <span style="padding-right: 5px;"><a href="#M000273">lines</a></span>
+  <span style="padding-right: 5px;"><a href="#M000292">margin</a></span>
+  <span style="padding-right: 5px;"><a href="#M000282">methodize</a></span>
+  <span style="padding-right: 5px;"><a href="#M000274">modulize</a></span>
+  <span style="padding-right: 5px;"><a href="#M000293">mscan</a></span>
+  <span style="padding-right: 5px;"><a href="#M000299">natcmp</a></span>
+  <span style="padding-right: 5px;"><a href="#M000322">nchar</a></span>
+  <span style="padding-right: 5px;"><a href="#M000304">outdent</a></span>
+  <span style="padding-right: 5px;"><a href="#M000302">pathize</a></span>
+  <span style="padding-right: 5px;"><a href="#M000315">quote</a></span>
+  <span style="padding-right: 5px;"><a href="#M000285">range</a></span>
+  <span style="padding-right: 5px;"><a href="#M000286">range_all</a></span>
+  <span style="padding-right: 5px;"><a href="#M000287">range_of_line</a></span>
+  <span style="padding-right: 5px;"><a href="#M000321">rewrite</a></span>
+  <span style="padding-right: 5px;"><a href="#M000265">shatter</a></span>
+  <span style="padding-right: 5px;"><a href="#M000289">snakecase</a></span>
+  <span style="padding-right: 5px;"><a href="#M000320">splice</a></span>
+  <span style="padding-right: 5px;"><a href="#M000270">start_with?</a></span>
+  <span style="padding-right: 5px;"><a href="#M000281">tab</a></span>
+  <span style="padding-right: 5px;"><a href="#M000306">tabto</a></span>
+  <span style="padding-right: 5px;"><a href="#M000305">titlecase</a></span>
+  <span style="padding-right: 5px;"><a href="#M000263">to_b</a></span>
+  <span style="padding-right: 5px;"><a href="#M000267">to_re</a></span>
+  <span style="padding-right: 5px;"><a href="#M000268">to_rx</a></span>
+  <span style="padding-right: 5px;"><a href="#M000313">unbracket</a></span>
+  <span style="padding-right: 5px;"><a href="#M000314">unbracket!</a></span>
+  <span style="padding-right: 5px;"><a href="#M000296">upcase?</a></span>
+  <span style="padding-right: 5px;"><a href="#M000300">variablize</a></span>
+  <span style="padding-right: 5px;"><a href="#M000275">word_wrap</a></span>
+  <span style="padding-right: 5px;"><a href="#M000276">word_wrap!</a></span>
+  <span style="padding-right: 5px;"><a href="#M000307">words</a></span>
 
 
 
@@ -202,7 +204,7 @@ Object
 <div class="sectiontitle">Public Class methods</div>
 <div class="method">
   <div class="title">
-    <a name="M000296"></a><b>interpolate</b>(&amp;str)
+    <a name="M000308"></a><b>interpolate</b>(&amp;str)
   </div>
   <div class="description">
   <p>
@@ -222,8 +224,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000296_source')" id="l_M000296_source">+</a> ]</p>
-  <div id="M000296_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000308_source')" id="l_M000308_source">+</a> ]</p>
+  <div id="M000308_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/interpolate.rb, line 15</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">interpolate</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">str</span>)
@@ -236,7 +238,7 @@ CREDIT: Trans
 <div class="sectiontitle">Public Instance methods</div>
 <div class="method">
   <div class="title">
-    <a name="M000271"></a><b>-</b>(pattern)
+    <a name="M000283"></a><b>-</b>(pattern)
   </div>
   <div class="description">
   <p>
@@ -250,8 +252,8 @@ CREDIT: Benjamin David Oakes
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000271_source')" id="l_M000271_source">+</a> ]</p>
-  <div id="M000271_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000283_source')" id="l_M000283_source">+</a> ]</p>
+  <div id="M000283_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/op_sub.rb, line 9</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-operator">-</span>(<span class="ruby-identifier">pattern</span>)
@@ -263,21 +265,29 @@ CREDIT: Benjamin David Oakes
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000311"></a><b>^</b>(aString)
+    <a name="M000323"></a><b>^</b>(aString)
   </div>
   <div class="description">
   <p>
-XOR two string.
+Binary XOR of two strings.
 </p>
+<pre>
+  puts &quot;\000\000\001\001&quot; ^ &quot;\000\001\000\001&quot;
+  puts  &quot;\003\003\003&quot; ^ &quot;\000\001\002&quot;
+</pre>
 <p>
-TODO: This is used by crypt.rb, it needs to be documented.
+<em>produces</em>
 </p>
+<pre>
+  &quot;\000\001\001\000&quot;
+  &quot;\003\002\001&quot;
+</pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000311_source')" id="l_M000311_source">+</a> ]</p>
-  <div id="M000311_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000323_source')" id="l_M000323_source">+</a> ]</p>
+  <div id="M000323_source" class="dyn-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/xor.rb, line 7</span>
+<span class="ruby-comment cmt"># File lib/core/facets/string/xor.rb, line 13</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-operator">^</span>(<span class="ruby-identifier">aString</span>)
     <span class="ruby-identifier">a</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">unpack</span>(<span class="ruby-value str">'C'</span><span class="ruby-operator">*</span>(<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">length</span>))
     <span class="ruby-identifier">b</span> = <span class="ruby-identifier">aString</span>.<span class="ruby-identifier">unpack</span>(<span class="ruby-value str">'C'</span><span class="ruby-operator">*</span>(<span class="ruby-identifier">aString</span>.<span class="ruby-identifier">length</span>))
@@ -297,11 +307,11 @@ TODO: This is used by crypt.rb, it needs to be documented.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000265"></a><b>align</b>(direction, n, sep=&quot;\n&quot;, c=' ')
+    <a name="M000277"></a><b>align</b>(direction, n, sep=&quot;\n&quot;, c=' ')
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000265_source')" id="l_M000265_source">+</a> ]</p>
-  <div id="M000265_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000277_source')" id="l_M000277_source">+</a> ]</p>
+  <div id="M000277_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/align.rb, line 3</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">align</span>(<span class="ruby-identifier">direction</span>, <span class="ruby-identifier">n</span>, <span class="ruby-identifier">sep</span>=<span class="ruby-value str">&quot;\n&quot;</span>, <span class="ruby-identifier">c</span>=<span class="ruby-value str">' '</span>)
@@ -322,15 +332,15 @@ TODO: This is used by crypt.rb, it needs to be documented.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000268"></a><b>align_center</b>(n, sep=&quot;\n&quot;, c=' ')
+    <a name="M000280"></a><b>align_center</b>(n, sep=&quot;\n&quot;, c=' ')
   </div>
   <div class="description">
   <p>
 Centers each line of a string.
 </p>
 <p>
-The defualt alignment seperation is a new line (&quot;/n&quot;) This can be
-changed as can be the padding string which defaults to a single space
+The default alignment separation is a new line (&quot;\n&quot;). This can
+be changed as can be the padding string which defaults to a single space
 (&#8217; &#8217;).
 </p>
 <pre>
@@ -355,10 +365,10 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000268_source')" id="l_M000268_source">+</a> ]</p>
-  <div id="M000268_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000280_source')" id="l_M000280_source">+</a> ]</p>
+  <div id="M000280_source" class="dyn-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/align.rb, line 97</span>
+<span class="ruby-comment cmt"># File lib/core/facets/string/align.rb, line 98</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">align_center</span>(<span class="ruby-identifier">n</span>, <span class="ruby-identifier">sep</span>=<span class="ruby-value str">&quot;\n&quot;</span>, <span class="ruby-identifier">c</span>=<span class="ruby-value str">' '</span>)
     <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">center</span>(<span class="ruby-identifier">n</span>.<span class="ruby-identifier">to_i</span>,<span class="ruby-identifier">c</span>.<span class="ruby-identifier">to_s</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">sep</span><span class="ruby-operator">==</span><span class="ruby-keyword kw">nil</span>
     <span class="ruby-identifier">q</span> = <span class="ruby-identifier">split</span>(<span class="ruby-identifier">sep</span>.<span class="ruby-identifier">to_s</span>).<span class="ruby-identifier">collect</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">line</span><span class="ruby-operator">|</span>
@@ -372,15 +382,15 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000267"></a><b>align_left</b>(n, sep=&quot;\n&quot;, c=' ')
+    <a name="M000279"></a><b>align_left</b>(n, sep=&quot;\n&quot;, c=' ')
   </div>
   <div class="description">
   <p>
 Align a string to the left.
 </p>
 <p>
-The defualt alignment seperation is a new line (&quot;/n&quot;) This can be
-changes as can be the padding string which defaults to a single space
+The default alignment separation is a new line (&quot;\n&quot;). This can
+be changed as can be the padding string which defaults to a single space
 (&#8217; &#8217;).
 </p>
 <pre>
@@ -390,30 +400,30 @@ changes as can be the padding string which defaults to a single space
     so on
   EOS
 
-  puts s.align_left(2)
+  puts s.align_left(20, &quot;\n&quot;, '.')
 </pre>
 <p>
 <em>produces</em>
 </p>
 <pre>
-    This is a test
-    and
-    so on
+  This is a test......
+  and.................
+  so on...............
 </pre>
 <p>
 CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000267_source')" id="l_M000267_source">+</a> ]</p>
-  <div id="M000267_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000279_source')" id="l_M000279_source">+</a> ]</p>
+  <div id="M000279_source" class="dyn-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/align.rb, line 67</span>
+<span class="ruby-comment cmt"># File lib/core/facets/string/align.rb, line 68</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">align_left</span>(<span class="ruby-identifier">n</span>, <span class="ruby-identifier">sep</span>=<span class="ruby-value str">&quot;\n&quot;</span>, <span class="ruby-identifier">c</span>=<span class="ruby-value str">' '</span>)
     <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">ljust</span>(<span class="ruby-identifier">n</span>.<span class="ruby-identifier">to_i</span>,<span class="ruby-identifier">c</span>.<span class="ruby-identifier">to_s</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">sep</span><span class="ruby-operator">==</span><span class="ruby-keyword kw">nil</span>
-    <span class="ruby-identifier">q</span> = <span class="ruby-identifier">split</span>(<span class="ruby-identifier">sep</span>.<span class="ruby-identifier">to_s</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">line</span>.<span class="ruby-identifier">ljust</span>(<span class="ruby-identifier">n</span>.<span class="ruby-identifier">to_i</span>,<span class="ruby-identifier">c</span>.<span class="ruby-identifier">to_s</span>)
-    }
+    <span class="ruby-identifier">q</span> = <span class="ruby-identifier">split</span>(<span class="ruby-identifier">sep</span>.<span class="ruby-identifier">to_s</span>).<span class="ruby-identifier">map</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">line</span><span class="ruby-operator">|</span>
+      <span class="ruby-identifier">line</span>.<span class="ruby-identifier">strip</span>.<span class="ruby-identifier">ljust</span>(<span class="ruby-identifier">n</span>.<span class="ruby-identifier">to_i</span>,<span class="ruby-identifier">c</span>.<span class="ruby-identifier">to_s</span>)
+    <span class="ruby-keyword kw">end</span>
     <span class="ruby-identifier">q</span>.<span class="ruby-identifier">join</span>(<span class="ruby-identifier">sep</span>.<span class="ruby-identifier">to_s</span>)
   <span class="ruby-keyword kw">end</span>
 </pre>
@@ -422,13 +432,16 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000266"></a><b>align_right</b>(n, sep=&quot;\n&quot;, c=' ')
+    <a name="M000278"></a><b>align_right</b>(n, sep=&quot;\n&quot;, c=' ')
   </div>
   <div class="description">
   <p>
-Align a string to the right. The defualt alignment seperation is a new line
-(&quot;/n&quot;) This can be changes as can be the padding string which
-defaults to a single space (&#8217; &#8217;).
+Align a string to the right.
+</p>
+<p>
+The default alignment separation is a new line (&quot;\n&quot;). This can
+be changed as can be the padding string which defaults to a single space
+(&#8217; &#8217;).
 </p>
 <pre>
   s = &lt;&lt;-EOS
@@ -437,30 +450,30 @@ defaults to a single space (&#8217; &#8217;).
     so on
   EOS
 
-  puts s.align_right(2)
+  puts s.align_right(14)
 </pre>
 <p>
 <em>produces</em>
 </p>
 <pre>
-    This is a test
-               and
-             so on
+  This is a test
+             and
+           so on
 </pre>
 <p>
 CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000266_source')" id="l_M000266_source">+</a> ]</p>
-  <div id="M000266_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000278_source')" id="l_M000278_source">+</a> ]</p>
+  <div id="M000278_source" class="dyn-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/core/facets/string/align.rb, line 37</span>
+<span class="ruby-comment cmt"># File lib/core/facets/string/align.rb, line 38</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">align_right</span>(<span class="ruby-identifier">n</span>, <span class="ruby-identifier">sep</span>=<span class="ruby-value str">&quot;\n&quot;</span>, <span class="ruby-identifier">c</span>=<span class="ruby-value str">' '</span>)
     <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">rjust</span>(<span class="ruby-identifier">n</span>.<span class="ruby-identifier">to_i</span>,<span class="ruby-identifier">c</span>.<span class="ruby-identifier">to_s</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">sep</span><span class="ruby-operator">==</span><span class="ruby-keyword kw">nil</span>
-    <span class="ruby-identifier">q</span> = <span class="ruby-identifier">split</span>(<span class="ruby-identifier">sep</span>.<span class="ruby-identifier">to_s</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">q</span> = <span class="ruby-identifier">split</span>(<span class="ruby-identifier">sep</span>.<span class="ruby-identifier">to_s</span>).<span class="ruby-identifier">map</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">line</span><span class="ruby-operator">|</span>
       <span class="ruby-identifier">line</span>.<span class="ruby-identifier">rjust</span>(<span class="ruby-identifier">n</span>.<span class="ruby-identifier">to_i</span>,<span class="ruby-identifier">c</span>.<span class="ruby-identifier">to_s</span>)
-    }
+    <span class="ruby-keyword kw">end</span>
     <span class="ruby-identifier">q</span>.<span class="ruby-identifier">join</span>(<span class="ruby-identifier">sep</span>.<span class="ruby-identifier">to_s</span>)
   <span class="ruby-keyword kw">end</span>
 </pre>
@@ -469,7 +482,7 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000313"></a><b>blank?</b>()
+    <a name="M000325"></a><b>blank?</b>()
   </div>
   <div class="description">
   <p>
@@ -481,8 +494,8 @@ Is this string just whitespace?
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000313_source')" id="l_M000313_source">+</a> ]</p>
-  <div id="M000313_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000325_source')" id="l_M000325_source">+</a> ]</p>
+  <div id="M000325_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/blank.rb, line 50</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">blank?</span>
@@ -494,12 +507,12 @@ Is this string just whitespace?
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000299"></a><b>bracket</b>(bra, ket=nil)
+    <a name="M000311"></a><b>bracket</b>(bra, ket=nil)
   </div>
   <div class="description">
   <p>
 Return a new string embraced by given brakets. If only one <a
-href="String.html#M000299">bracket</a> char is given it will be placed on
+href="String.html#M000311">bracket</a> char is given it will be placed on
 either side.
 </p>
 <pre>
@@ -511,8 +524,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000299_source')" id="l_M000299_source">+</a> ]</p>
-  <div id="M000299_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000311_source')" id="l_M000311_source">+</a> ]</p>
+  <div id="M000311_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/bracket.rb, line 14</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">bracket</span>(<span class="ruby-identifier">bra</span>, <span class="ruby-identifier">ket</span>=<span class="ruby-keyword kw">nil</span>)
@@ -526,7 +539,7 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000300"></a><b>bracket!</b>(bra, ket=nil)
+    <a name="M000312"></a><b>bracket!</b>(bra, ket=nil)
   </div>
   <div class="description">
   <p>
@@ -537,8 +550,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000300_source')" id="l_M000300_source">+</a> ]</p>
-  <div id="M000300_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000312_source')" id="l_M000312_source">+</a> ]</p>
+  <div id="M000312_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/bracket.rb, line 24</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">bracket!</span>(<span class="ruby-identifier">bra</span>, <span class="ruby-identifier">ket</span>=<span class="ruby-keyword kw">nil</span>)
@@ -550,16 +563,16 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000289"></a><b>bytes</b>()
+    <a name="M000301"></a><b>bytes</b>()
   </div>
   <div class="description">
   <p>
-Upacks string into <a href="String.html#M000289">bytes</a>.
+Upacks string into <a href="String.html#M000301">bytes</a>.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000289_source')" id="l_M000289_source">+</a> ]</p>
-  <div id="M000289_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000301_source')" id="l_M000301_source">+</a> ]</p>
+  <div id="M000301_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/bytes.rb, line 8</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">bytes</span>
@@ -571,19 +584,19 @@ Upacks string into <a href="String.html#M000289">bytes</a>.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000260"></a><b>camelcase</b>(upcase_first_letter=true)
+    <a name="M000272"></a><b>camelcase</b>(upcase_first_letter=true)
   </div>
   <div class="description">
   <p>
-Converts a string to <a href="String.html#M000260">camelcase</a>.
+Converts a string to <a href="String.html#M000272">camelcase</a>.
 </p>
 <p>
-By default <a href="String.html#M000260">camelcase</a> convert to
+By default <a href="String.html#M000272">camelcase</a> convert to
 UpperCamelCase, If an argument is set to <tt>false</tt>, then <a
-href="String.html#M000260">camelcase</a> will produce lowerCamelCase.
+href="String.html#M000272">camelcase</a> will produce lowerCamelCase.
 </p>
 <p>
-<tt><a href="String.html#M000260">camelcase</a></tt> also converts
+<tt><a href="String.html#M000272">camelcase</a></tt> also converts
 &#8217;/&#8217; to &#8217;::&#8217; which is useful for converting paths to
 namespaces.
 </p>
@@ -597,8 +610,8 @@ Examples
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000260_source')" id="l_M000260_source">+</a> ]</p>
-  <div id="M000260_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000272_source')" id="l_M000272_source">+</a> ]</p>
+  <div id="M000272_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/camelcase.rb, line 16</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">camelcase</span>(<span class="ruby-identifier">upcase_first_letter</span>=<span class="ruby-keyword kw">true</span>)
@@ -615,7 +628,7 @@ Examples
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000282"></a><b>capitalized?</b>()
+    <a name="M000294"></a><b>capitalized?</b>()
   </div>
   <div class="description">
   <p>
@@ -631,8 +644,8 @@ CREDIT: Phil Tomson
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000282_source')" id="l_M000282_source">+</a> ]</p>
-  <div id="M000282_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000294_source')" id="l_M000294_source">+</a> ]</p>
+  <div id="M000294_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/capitalized.rb, line 11</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">capitalized?</span>
@@ -644,7 +657,7 @@ CREDIT: Phil Tomson
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000305"></a><b>chars</b>()
+    <a name="M000317"></a><b>chars</b>()
   </div>
   <div class="description">
   <p>
@@ -655,8 +668,8 @@ Returns an array of characters.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000305_source')" id="l_M000305_source">+</a> ]</p>
-  <div id="M000305_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000317_source')" id="l_M000317_source">+</a> ]</p>
+  <div id="M000317_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/chars.rb, line 9</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">chars</span>
@@ -668,7 +681,7 @@ Returns an array of characters.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000297"></a><b>cleave</b>(threshold=nil, len=nil)
+    <a name="M000309"></a><b>cleave</b>(threshold=nil, len=nil)
   </div>
   <div class="description">
   <p>
@@ -679,8 +692,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000297_source')" id="l_M000297_source">+</a> ]</p>
-  <div id="M000297_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000309_source')" id="l_M000309_source">+</a> ]</p>
+  <div id="M000309_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/cleave.rb, line 8</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">cleave</span>(<span class="ruby-identifier">threshold</span>=<span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">len</span>=<span class="ruby-keyword kw">nil</span>)
@@ -716,7 +729,7 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000253"></a><b>cmp</b>(other)
+    <a name="M000264"></a><b>cmp</b>(other)
   </div>
   <div class="description">
   <p>
@@ -734,8 +747,8 @@ CREDIT: Peter Vanbroekhoven
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000253_source')" id="l_M000253_source">+</a> ]</p>
-  <div id="M000253_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000264_source')" id="l_M000264_source">+</a> ]</p>
+  <div id="M000264_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/comparable/cmp.rb, line 31</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">cmp</span>(<span class="ruby-identifier">other</span>)
@@ -749,7 +762,7 @@ CREDIT: Peter Vanbroekhoven
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000272"></a><b>compress_lines</b>(spaced = true)
+    <a name="M000284"></a><b>compress_lines</b>(spaced = true)
   </div>
   <div class="description">
   <p>
@@ -767,8 +780,8 @@ Matches any whitespace (including newline) and replaces with a single space
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000272_source')" id="l_M000272_source">+</a> ]</p>
-  <div id="M000272_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000284_source')" id="l_M000284_source">+</a> ]</p>
+  <div id="M000284_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/compress_lines.rb, line 12</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">compress_lines</span>(<span class="ruby-identifier">spaced</span> = <span class="ruby-keyword kw">true</span>)
@@ -780,7 +793,7 @@ Matches any whitespace (including newline) and replaces with a single space
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000304"></a><b>dequote</b>()
+    <a name="M000316"></a><b>dequote</b>()
   </div>
   <div class="description">
   <p>
@@ -794,8 +807,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000304_source')" id="l_M000304_source">+</a> ]</p>
-  <div id="M000304_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000316_source')" id="l_M000316_source">+</a> ]</p>
+  <div id="M000316_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/bracket.rb, line 88</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">dequote</span>
@@ -819,7 +832,7 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000279"></a><b>divide</b>( re )
+    <a name="M000291"></a><b>divide</b>( re )
   </div>
   <div class="description">
   <p>
@@ -841,8 +854,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000279_source')" id="l_M000279_source">+</a> ]</p>
-  <div id="M000279_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000291_source')" id="l_M000291_source">+</a> ]</p>
+  <div id="M000291_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/divide.rb, line 15</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">divide</span>( <span class="ruby-identifier">re</span> )
@@ -855,7 +868,7 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000283"></a><b>downcase?</b>()
+    <a name="M000295"></a><b>downcase?</b>()
   </div>
   <div class="description">
   <p>
@@ -871,8 +884,8 @@ CREDIT: Phil Tomson
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000283_source')" id="l_M000283_source">+</a> ]</p>
-  <div id="M000283_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000295_source')" id="l_M000295_source">+</a> ]</p>
+  <div id="M000295_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/capitalized.rb, line 23</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">downcase?</span>
@@ -884,7 +897,7 @@ CREDIT: Phil Tomson
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000278"></a><b>each_char</b>() {|scanner.scan(char || break)| ...}
+    <a name="M000290"></a><b>each_char</b>() {|scanner.scan(char || break)| ...}
   </div>
   <div class="description">
   <p>
@@ -894,8 +907,8 @@ appropriately.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000278_source')" id="l_M000278_source">+</a> ]</p>
-  <div id="M000278_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000290_source')" id="l_M000290_source">+</a> ]</p>
+  <div id="M000290_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/each_char.rb, line 22</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">each_char</span>
@@ -908,7 +921,7 @@ appropriately.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000312"></a><b>each_word</b>(&amp;block)
+    <a name="M000324"></a><b>each_word</b>(&amp;block)
   </div>
   <div class="description">
   <p>
@@ -919,8 +932,8 @@ Iterate through each word of a string.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000312_source')" id="l_M000312_source">+</a> ]</p>
-  <div id="M000312_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000324_source')" id="l_M000324_source">+</a> ]</p>
+  <div id="M000324_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/each_word.rb, line 9</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">each_word</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
@@ -932,7 +945,7 @@ Iterate through each word of a string.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000259"></a><b>end_with?</b>(suffix)
+    <a name="M000271"></a><b>end_with?</b>(suffix)
   </div>
   <div class="description">
   <p>
@@ -947,8 +960,8 @@ CREDIT: Lucas Carlson, Blaine Cook
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000259_source')" id="l_M000259_source">+</a> ]</p>
-  <div id="M000259_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000271_source')" id="l_M000271_source">+</a> ]</p>
+  <div id="M000271_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/start_with.rb, line 23</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">end_with?</span>(<span class="ruby-identifier">suffix</span>)
@@ -960,7 +973,7 @@ CREDIT: Lucas Carlson, Blaine Cook
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000285"></a><b>expand_tab</b>(n=8)
+    <a name="M000297"></a><b>expand_tab</b>(n=8)
   </div>
   <div class="description">
   <p>
@@ -980,11 +993,11 @@ CREDIT: Gavin Sinclair, Noah Gibbs, GGaramuno
   </div>
 <div class="aka">
   This method is also aliased as
-  <a href="String.html#M000286">expand_tabs</a>
+  <a href="String.html#M000298">expand_tabs</a>
 </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000285_source')" id="l_M000285_source">+</a> ]</p>
-  <div id="M000285_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000297_source')" id="l_M000297_source">+</a> ]</p>
+  <div id="M000297_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/expand_tab.rb, line 13</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">expand_tab</span>(<span class="ruby-identifier">n</span>=<span class="ruby-value">8</span>)
@@ -1007,22 +1020,50 @@ CREDIT: Gavin Sinclair, Noah Gibbs, GGaramuno
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000286"></a><b>expand_tabs</b>(n=8)
+    <a name="M000298"></a><b>expand_tabs</b>(n=8)
   </div>
   <div class="description">
   <p>
-Alias for <a href="String.html#M000285">expand_tab</a>
+Alias for <a href="String.html#M000297">expand_tab</a>
 </p>
   </div>
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000257"></a><b>fold</b>(ignore_indented=false)
+    <a name="M000266"></a><b>file</b>()
+  </div>
+  <div class="description">
+  <p>
+Use fluent notation for making <a href="String.html#M000266">file</a>
+directives.
+</p>
+<pre>
+   '~/trans/Desktop/notes.txt'.file.mtime
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000266_source')" id="l_M000266_source">+</a> ]</p>
+  <div id="M000266_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/core/facets/string/file.rb, line 9</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">file</span>
+    <span class="ruby-identifier">f</span> = <span class="ruby-keyword kw">self</span>
+    <span class="ruby-constant">Functor</span>.<span class="ruby-identifier">new</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">op</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">a</span><span class="ruby-operator">|</span>
+      <span class="ruby-constant">File</span>.<span class="ruby-identifier">send</span>(<span class="ruby-identifier">op</span>, <span class="ruby-identifier">f</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">a</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="M000269"></a><b>fold</b>(ignore_indented=false)
   </div>
   <div class="description">
   <p>
-Returns a new string with all new <a href="String.html#M000261">lines</a>
-removed from adjacent <a href="String.html#M000261">lines</a> of text.
+Returns a new string with all new <a href="String.html#M000273">lines</a>
+removed from adjacent <a href="String.html#M000273">lines</a> of text.
 </p>
 <pre>
   s = &quot;This is\na test.\n\nIt clumps\nlines of text.&quot;
@@ -1043,8 +1084,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000257_source')" id="l_M000257_source">+</a> ]</p>
-  <div id="M000257_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000269_source')" id="l_M000269_source">+</a> ]</p>
+  <div id="M000269_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/fold.rb, line 19</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">fold</span>(<span class="ruby-identifier">ignore_indented</span>=<span class="ruby-keyword kw">false</span>)
@@ -1071,21 +1112,21 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000291"></a><b>indent</b>(n)
+    <a name="M000303"></a><b>indent</b>(n)
   </div>
   <div class="description">
   <p>
 Indent left or right by n spaces. (This used to be called <a
-href="String.html#M000269">tab</a> and aliased as <a
-href="String.html#M000291">indent</a>.)
+href="String.html#M000281">tab</a> and aliased as <a
+href="String.html#M000303">indent</a>.)
 </p>
 <p>
 CREDIT: Gavin Sinclair, Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000291_source')" id="l_M000291_source">+</a> ]</p>
-  <div id="M000291_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000303_source')" id="l_M000303_source">+</a> ]</p>
+  <div id="M000303_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/indent.rb, line 8</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">indent</span>(<span class="ruby-identifier">n</span>)
@@ -1101,7 +1142,7 @@ CREDIT: Gavin Sinclair, Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000276"></a><b>index_all</b>(s, reuse=false)
+    <a name="M000288"></a><b>index_all</b>(s, reuse=false)
   </div>
   <div class="description">
   <p>
@@ -1120,8 +1161,8 @@ in general too.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000276_source')" id="l_M000276_source">+</a> ]</p>
-  <div id="M000276_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000288_source')" id="l_M000288_source">+</a> ]</p>
+  <div id="M000288_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/range.rb, line 66</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">index_all</span>(<span class="ruby-identifier">s</span>, <span class="ruby-identifier">reuse</span>=<span class="ruby-keyword kw">false</span>)
@@ -1139,7 +1180,7 @@ in general too.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000306"></a><b>lchomp</b>(match)
+    <a name="M000318"></a><b>lchomp</b>(match)
   </div>
   <div class="description">
   <p>
@@ -1154,8 +1195,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000306_source')" id="l_M000306_source">+</a> ]</p>
-  <div id="M000306_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000318_source')" id="l_M000318_source">+</a> ]</p>
+  <div id="M000318_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/chomp.rb, line 10</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">lchomp</span>(<span class="ruby-identifier">match</span>)
@@ -1171,7 +1212,7 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000307"></a><b>lchomp!</b>(match)
+    <a name="M000319"></a><b>lchomp!</b>(match)
   </div>
   <div class="description">
   <p>
@@ -1186,8 +1227,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000307_source')" id="l_M000307_source">+</a> ]</p>
-  <div id="M000307_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000319_source')" id="l_M000319_source">+</a> ]</p>
+  <div id="M000319_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/chomp.rb, line 25</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">lchomp!</span>(<span class="ruby-identifier">match</span>)
@@ -1202,7 +1243,7 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000298"></a><b>line_wrap</b>(width, tabs=4)
+    <a name="M000310"></a><b>line_wrap</b>(width, tabs=4)
   </div>
   <div class="description">
   <p>
@@ -1223,8 +1264,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000298_source')" id="l_M000298_source">+</a> ]</p>
-  <div id="M000298_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000310_source')" id="l_M000310_source">+</a> ]</p>
+  <div id="M000310_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/line_wrap.rb, line 14</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">line_wrap</span>(<span class="ruby-identifier">width</span>, <span class="ruby-identifier">tabs</span>=<span class="ruby-value">4</span>)
@@ -1239,7 +1280,7 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000261"></a><b>lines</b>()
+    <a name="M000273"></a><b>lines</b>()
   </div>
   <div class="description">
   <p>
@@ -1250,8 +1291,8 @@ Returns an array of characters.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000261_source')" id="l_M000261_source">+</a> ]</p>
-  <div id="M000261_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000273_source')" id="l_M000273_source">+</a> ]</p>
+  <div id="M000273_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/lines.rb, line 9</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">lines</span>
@@ -1263,11 +1304,11 @@ Returns an array of characters.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000280"></a><b>margin</b>(n=0)
+    <a name="M000292"></a><b>margin</b>(n=0)
   </div>
   <div class="description">
   <p>
-Provides a <a href="String.html#M000280">margin</a> controlled string.
+Provides a <a href="String.html#M000292">margin</a> controlled string.
 </p>
 <pre>
   x = %Q{
@@ -1284,8 +1325,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000280_source')" id="l_M000280_source">+</a> ]</p>
-  <div id="M000280_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000292_source')" id="l_M000292_source">+</a> ]</p>
+  <div id="M000292_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/margin.rb, line 16</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">margin</span>(<span class="ruby-identifier">n</span>=<span class="ruby-value">0</span>)
@@ -1306,7 +1347,7 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000270"></a><b>methodize</b>()
+    <a name="M000282"></a><b>methodize</b>()
   </div>
   <div class="description">
   <p>
@@ -1317,8 +1358,8 @@ Translate a (class or module) name to a suitable method name.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000270_source')" id="l_M000270_source">+</a> ]</p>
-  <div id="M000270_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000282_source')" id="l_M000282_source">+</a> ]</p>
+  <div id="M000282_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/methodize.rb, line 7</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">methodize</span>
@@ -1334,14 +1375,14 @@ Translate a (class or module) name to a suitable method name.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000262"></a><b>modulize</b>()
+    <a name="M000274"></a><b>modulize</b>()
   </div>
   <div class="description">
   <p>
 Converts a string to module name representation.
 </p>
 <p>
-This is essentially <a href="String.html#M000260">camelcase</a>. It also
+This is essentially <a href="String.html#M000272">camelcase</a>. It also
 converts &#8217;/&#8217; to &#8217;::&#8217; which is useful for converting
 paths to namespaces.
 </p>
@@ -1354,8 +1395,8 @@ Examples
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000262_source')" id="l_M000262_source">+</a> ]</p>
-  <div id="M000262_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000274_source')" id="l_M000274_source">+</a> ]</p>
+  <div id="M000274_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/modulize.rb, line 13</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">modulize</span>
@@ -1370,7 +1411,7 @@ Examples
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000281"></a><b>mscan</b>(re) {|| ...}
+    <a name="M000293"></a><b>mscan</b>(re) {|| ...}
   </div>
   <div class="description">
   <p>
@@ -1382,8 +1423,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000281_source')" id="l_M000281_source">+</a> ]</p>
-  <div id="M000281_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000293_source')" id="l_M000293_source">+</a> ]</p>
+  <div id="M000293_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/mscan.rb, line 8</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">mscan</span>(<span class="ruby-identifier">re</span>) <span class="ruby-comment cmt">#:yield:</span>
@@ -1401,7 +1442,7 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000287"></a><b>natcmp</b>(str2, caseInsensitive=false)
+    <a name="M000299"></a><b>natcmp</b>(str2, caseInsensitive=false)
   </div>
   <div class="description">
   <p>
@@ -1424,8 +1465,8 @@ CREDIT: Alan Davies, Martin Pool
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000287_source')" id="l_M000287_source">+</a> ]</p>
-  <div id="M000287_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000299_source')" id="l_M000299_source">+</a> ]</p>
+  <div id="M000299_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/natcmp.rb, line 46</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">natcmp</span>(<span class="ruby-identifier">str2</span>, <span class="ruby-identifier">caseInsensitive</span>=<span class="ruby-keyword kw">false</span>)
@@ -1476,7 +1517,7 @@ CREDIT: Alan Davies, Martin Pool
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000310"></a><b>nchar</b>(n, replacement=nil)
+    <a name="M000322"></a><b>nchar</b>(n, replacement=nil)
   </div>
   <div class="description">
   <p>
@@ -1496,8 +1537,8 @@ Alternatively a replacement string can be given, which will replace the
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000310_source')" id="l_M000310_source">+</a> ]</p>
-  <div id="M000310_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000322_source')" id="l_M000322_source">+</a> ]</p>
+  <div id="M000322_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/nchar.rb, line 15</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">nchar</span>(<span class="ruby-identifier">n</span>, <span class="ruby-identifier">replacement</span>=<span class="ruby-keyword kw">nil</span>)
@@ -1515,7 +1556,7 @@ Alternatively a replacement string can be given, which will replace the
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000292"></a><b>outdent</b>(n)
+    <a name="M000304"></a><b>outdent</b>(n)
   </div>
   <div class="description">
   <p>
@@ -1526,8 +1567,8 @@ CREDIT: Noah Gibbs
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000292_source')" id="l_M000292_source">+</a> ]</p>
-  <div id="M000292_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000304_source')" id="l_M000304_source">+</a> ]</p>
+  <div id="M000304_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/indent.rb, line 20</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">outdent</span>(<span class="ruby-identifier">n</span>)
@@ -1539,7 +1580,7 @@ CREDIT: Noah Gibbs
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000290"></a><b>pathize</b>()
+    <a name="M000302"></a><b>pathize</b>()
   </div>
   <div class="description">
   <p>
@@ -1550,8 +1591,8 @@ Converts a (class or module) name to a unix path.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000290_source')" id="l_M000290_source">+</a> ]</p>
-  <div id="M000290_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000302_source')" id="l_M000302_source">+</a> ]</p>
+  <div id="M000302_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/pathize.rb, line 7</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">pathize</span>
@@ -1567,7 +1608,7 @@ Converts a (class or module) name to a unix path.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000303"></a><b>quote</b>(type=:s)
+    <a name="M000315"></a><b>quote</b>(type=:s)
   </div>
   <div class="description">
   <p>
@@ -1583,8 +1624,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000303_source')" id="l_M000303_source">+</a> ]</p>
-  <div id="M000303_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000315_source')" id="l_M000315_source">+</a> ]</p>
+  <div id="M000315_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/bracket.rb, line 69</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">quote</span>(<span class="ruby-identifier">type</span>=<span class="ruby-identifier">:s</span>)
@@ -1605,7 +1646,7 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000273"></a><b>range</b>(s, offset=0)
+    <a name="M000285"></a><b>range</b>(s, offset=0)
   </div>
   <div class="description">
   <p>
@@ -1619,8 +1660,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000273_source')" id="l_M000273_source">+</a> ]</p>
-  <div id="M000273_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000285_source')" id="l_M000285_source">+</a> ]</p>
+  <div id="M000285_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/range.rb, line 9</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">range</span>(<span class="ruby-identifier">s</span>, <span class="ruby-identifier">offset</span>=<span class="ruby-value">0</span>)
@@ -1635,11 +1676,11 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000274"></a><b>range_all</b>(s, reuse=false)
+    <a name="M000286"></a><b>range_all</b>(s, reuse=false)
   </div>
   <div class="description">
   <p>
-Like <a href="String.html#M000276">index_all</a> but returns an array of
+Like <a href="String.html#M000288">index_all</a> but returns an array of
 Ranges.
 </p>
 <pre>
@@ -1652,8 +1693,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000274_source')" id="l_M000274_source">+</a> ]</p>
-  <div id="M000274_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000286_source')" id="l_M000286_source">+</a> ]</p>
+  <div id="M000286_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/range.rb, line 24</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">range_all</span>(<span class="ruby-identifier">s</span>, <span class="ruby-identifier">reuse</span>=<span class="ruby-keyword kw">false</span>)
@@ -1675,7 +1716,7 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000275"></a><b>range_of_line</b>()
+    <a name="M000287"></a><b>range_of_line</b>()
   </div>
   <div class="description">
   <p>
@@ -1690,8 +1731,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000275_source')" id="l_M000275_source">+</a> ]</p>
-  <div id="M000275_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000287_source')" id="l_M000287_source">+</a> ]</p>
+  <div id="M000287_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/range.rb, line 46</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">range_of_line</span>
@@ -1708,7 +1749,7 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000309"></a><b>rewrite</b>(rules)
+    <a name="M000321"></a><b>rewrite</b>(rules)
   </div>
   <div class="description">
   <p>
@@ -1732,8 +1773,8 @@ CREDIT: George Moschovitis
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000309_source')" id="l_M000309_source">+</a> ]</p>
-  <div id="M000309_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000321_source')" id="l_M000321_source">+</a> ]</p>
+  <div id="M000321_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/rewrite.rb, line 18</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">rewrite</span>(<span class="ruby-identifier">rules</span>)
@@ -1750,7 +1791,7 @@ CREDIT: George Moschovitis
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000254"></a><b>shatter</b>( re )
+    <a name="M000265"></a><b>shatter</b>( re )
   </div>
   <div class="description">
   <p>
@@ -1772,8 +1813,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000254_source')" id="l_M000254_source">+</a> ]</p>
-  <div id="M000254_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000265_source')" id="l_M000265_source">+</a> ]</p>
+  <div id="M000265_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/shatter.rb, line 15</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">shatter</span>( <span class="ruby-identifier">re</span> )
@@ -1788,12 +1829,12 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000277"></a><b>snakecase</b>()
+    <a name="M000289"></a><b>snakecase</b>()
   </div>
   <div class="description">
   <p>
-The reverse of <tt><a href="String.html#M000260">camelcase</a></tt>. Makes
-an underscored of a <a href="String.html#M000260">camelcase</a> string.
+The reverse of <tt><a href="String.html#M000272">camelcase</a></tt>. Makes
+an underscored of a <a href="String.html#M000272">camelcase</a> string.
 </p>
 <p>
 Changes &#8217;::&#8217; to &#8217;/&#8217; to convert namespaces to paths.
@@ -1808,8 +1849,8 @@ Examples
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000277_source')" id="l_M000277_source">+</a> ]</p>
-  <div id="M000277_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000289_source')" id="l_M000289_source">+</a> ]</p>
+  <div id="M000289_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/snakecase.rb, line 12</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">snakecase</span>
@@ -1825,7 +1866,7 @@ Examples
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000308"></a><b>splice</b>(idx, sub=nil)
+    <a name="M000320"></a><b>splice</b>(idx, sub=nil)
   </div>
   <div class="description">
   <p>
@@ -1849,8 +1890,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000308_source')" id="l_M000308_source">+</a> ]</p>
-  <div id="M000308_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000320_source')" id="l_M000320_source">+</a> ]</p>
+  <div id="M000320_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/splice.rb, line 20</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">splice</span>(<span class="ruby-identifier">idx</span>, <span class="ruby-identifier">sub</span>=<span class="ruby-keyword kw">nil</span>)
@@ -1871,7 +1912,7 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000258"></a><b>start_with?</b>(prefix)
+    <a name="M000270"></a><b>start_with?</b>(prefix)
   </div>
   <div class="description">
   <p>
@@ -1886,8 +1927,8 @@ CREDIT: Lucas Carlson, Blaine Cook
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000258_source')" id="l_M000258_source">+</a> ]</p>
-  <div id="M000258_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000270_source')" id="l_M000270_source">+</a> ]</p>
+  <div id="M000270_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/start_with.rb, line 12</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">start_with?</span>(<span class="ruby-identifier">prefix</span>)
@@ -1899,7 +1940,7 @@ CREDIT: Lucas Carlson, Blaine Cook
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000269"></a><b>tab</b>(n)
+    <a name="M000281"></a><b>tab</b>(n)
   </div>
   <div class="description">
   <p>
@@ -1910,8 +1951,8 @@ CREDIT: Gavin Sinclair
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000269_source')" id="l_M000269_source">+</a> ]</p>
-  <div id="M000269_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000281_source')" id="l_M000281_source">+</a> ]</p>
+  <div id="M000281_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/tab.rb, line 12</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">tab</span>(<span class="ruby-identifier">n</span>)
@@ -1923,7 +1964,7 @@ CREDIT: Gavin Sinclair
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000294"></a><b>tabto</b>(n)
+    <a name="M000306"></a><b>tabto</b>(n)
   </div>
   <div class="description">
   <p>
@@ -1935,8 +1976,8 @@ CREDIT: Gavin Sinclair
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000294_source')" id="l_M000294_source">+</a> ]</p>
-  <div id="M000294_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000306_source')" id="l_M000306_source">+</a> ]</p>
+  <div id="M000306_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/tabto.rb, line 10</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">tabto</span>(<span class="ruby-identifier">n</span>)
@@ -1952,7 +1993,7 @@ CREDIT: Gavin Sinclair
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000293"></a><b>titlecase</b>()
+    <a name="M000305"></a><b>titlecase</b>()
   </div>
   <div class="description">
   <p>
@@ -1967,8 +2008,8 @@ CREDIT: Eliazar Parra
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000293_source')" id="l_M000293_source">+</a> ]</p>
-  <div id="M000293_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000305_source')" id="l_M000305_source">+</a> ]</p>
+  <div id="M000305_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/titlecase.rb, line 10</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">titlecase</span>
@@ -1980,7 +2021,7 @@ CREDIT: Eliazar Parra
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000252"></a><b>to_b</b>()
+    <a name="M000263"></a><b>to_b</b>()
   </div>
   <div class="description">
   <p>
@@ -2002,8 +2043,8 @@ Examples:
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000252_source')" id="l_M000252_source">+</a> ]</p>
-  <div id="M000252_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000263_source')" id="l_M000263_source">+</a> ]</p>
+  <div id="M000263_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/boolean.rb, line 43</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_b</span>
@@ -2022,7 +2063,7 @@ Examples:
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000255"></a><b>to_re</b>(esc=false)
+    <a name="M000267"></a><b>to_re</b>(esc=false)
   </div>
   <div class="description">
   <p>
@@ -2036,8 +2077,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000255_source')" id="l_M000255_source">+</a> ]</p>
-  <div id="M000255_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000267_source')" id="l_M000267_source">+</a> ]</p>
+  <div id="M000267_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/to_re.rb, line 9</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_re</span>(<span class="ruby-identifier">esc</span>=<span class="ruby-keyword kw">false</span>)
@@ -2049,7 +2090,7 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000256"></a><b>to_rx</b>(esc=true)
+    <a name="M000268"></a><b>to_rx</b>(esc=true)
   </div>
   <div class="description">
   <p>
@@ -2064,8 +2105,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000256_source')" id="l_M000256_source">+</a> ]</p>
-  <div id="M000256_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000268_source')" id="l_M000268_source">+</a> ]</p>
+  <div id="M000268_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/to_re.rb, line 21</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_rx</span>(<span class="ruby-identifier">esc</span>=<span class="ruby-keyword kw">true</span>)
@@ -2077,12 +2118,12 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000301"></a><b>unbracket</b>(bra=nil, ket=nil)
+    <a name="M000313"></a><b>unbracket</b>(bra=nil, ket=nil)
   </div>
   <div class="description">
   <p>
 Return a new string embraced by given brakets. If only one <a
-href="String.html#M000299">bracket</a> char is given it will be placed on
+href="String.html#M000311">bracket</a> char is given it will be placed on
 either side.
 </p>
 <pre>
@@ -2094,8 +2135,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000301_source')" id="l_M000301_source">+</a> ]</p>
-  <div id="M000301_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000313_source')" id="l_M000313_source">+</a> ]</p>
+  <div id="M000313_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/bracket.rb, line 37</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">unbracket</span>(<span class="ruby-identifier">bra</span>=<span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">ket</span>=<span class="ruby-keyword kw">nil</span>)
@@ -2119,7 +2160,7 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000302"></a><b>unbracket!</b>(bra=nil, ket=nil)
+    <a name="M000314"></a><b>unbracket!</b>(bra=nil, ket=nil)
   </div>
   <div class="description">
   <p>
@@ -2130,8 +2171,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000302_source')" id="l_M000302_source">+</a> ]</p>
-  <div id="M000302_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000314_source')" id="l_M000314_source">+</a> ]</p>
+  <div id="M000314_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/bracket.rb, line 57</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">unbracket!</span>(<span class="ruby-identifier">bra</span>=<span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">ket</span>=<span class="ruby-keyword kw">nil</span>)
@@ -2143,7 +2184,7 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000284"></a><b>upcase?</b>()
+    <a name="M000296"></a><b>upcase?</b>()
   </div>
   <div class="description">
   <p>
@@ -2159,8 +2200,8 @@ CREDIT: Phil Tomson
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000284_source')" id="l_M000284_source">+</a> ]</p>
-  <div id="M000284_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000296_source')" id="l_M000296_source">+</a> ]</p>
+  <div id="M000296_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/capitalized.rb, line 38</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">upcase?</span>
@@ -2172,7 +2213,7 @@ CREDIT: Phil Tomson
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000288"></a><b>variablize</b>()
+    <a name="M000300"></a><b>variablize</b>()
   </div>
   <div class="description">
   <p>
@@ -2181,8 +2222,8 @@ variable name. This also replaces non-valid characters with underscores.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000288_source')" id="l_M000288_source">+</a> ]</p>
-  <div id="M000288_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000300_source')" id="l_M000300_source">+</a> ]</p>
+  <div id="M000300_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/variablize.rb, line 7</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">variablize</span>
@@ -2195,7 +2236,7 @@ variable name. This also replaces non-valid characters with underscores.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000263"></a><b>word_wrap</b>( col_width=80 )
+    <a name="M000275"></a><b>word_wrap</b>( col_width=80 )
   </div>
   <div class="description">
   <p>
@@ -2221,8 +2262,8 @@ CREDIT: Gavin Kistner, Dayne Broderson
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000263_source')" id="l_M000263_source">+</a> ]</p>
-  <div id="M000263_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000275_source')" id="l_M000275_source">+</a> ]</p>
+  <div id="M000275_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/word_wrap.rb, line 18</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">word_wrap</span>( <span class="ruby-identifier">col_width</span>=<span class="ruby-value">80</span> )
@@ -2234,11 +2275,11 @@ CREDIT: Gavin Kistner, Dayne Broderson
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000264"></a><b>word_wrap!</b>( col_width=80 )
+    <a name="M000276"></a><b>word_wrap!</b>( col_width=80 )
   </div>
   <div class="description">
   <p>
-As with <a href="String.html#M000263">word_wrap</a>, but modifies the
+As with <a href="String.html#M000275">word_wrap</a>, but modifies the
 string in place.
 </p>
 <p>
@@ -2246,8 +2287,8 @@ CREDIT: Gavin Kistner, Dayne Broderson
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000264_source')" id="l_M000264_source">+</a> ]</p>
-  <div id="M000264_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000276_source')" id="l_M000276_source">+</a> ]</p>
+  <div id="M000276_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/word_wrap.rb, line 26</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">word_wrap!</span>( <span class="ruby-identifier">col_width</span>=<span class="ruby-value">80</span> )
@@ -2261,7 +2302,7 @@ CREDIT: Gavin Kistner, Dayne Broderson
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000295"></a><b>words</b>()
+    <a name="M000307"></a><b>words</b>()
   </div>
   <div class="description">
   <p>
@@ -2272,8 +2313,8 @@ Returns an array of characters.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000295_source')" id="l_M000295_source">+</a> ]</p>
-  <div id="M000295_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000307_source')" id="l_M000307_source">+</a> ]</p>
+  <div id="M000307_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/string/words.rb, line 7</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">words</span>