facets 2.5.0 → 2.5.1

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

@@ -73,7 +73,7 @@
 
 
   <div class="sectiontitle">Methods</div>
-  <span style="padding-right: 5px;"><a href="#M000342">root?</a></span>
+  <span style="padding-right: 5px;"><a href="#M000354">root?</a></span>
 
 
 
@@ -83,7 +83,7 @@
 <div class="sectiontitle">Public Instance methods</div>
 <div class="method">
   <div class="title">
-    <a name="M000342"></a><b>root?</b>(dir=nil)
+    <a name="M000354"></a><b>root?</b>(dir=nil)
   </div>
   <div class="description">
   <p>
@@ -94,8 +94,8 @@ CREDIT: Jeffrey Schwab
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000342_source')" id="l_M000342_source">+</a> ]</p>
-  <div id="M000342_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000354_source')" id="l_M000354_source">+</a> ]</p>
+  <div id="M000354_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/filetest/root.rb, line 9</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">root?</span>(<span class="ruby-identifier">dir</span>=<span class="ruby-keyword kw">nil</span>)

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

@@ -81,8 +81,8 @@ Object
 
 
   <div class="sectiontitle">Methods</div>
-  <span style="padding-right: 5px;"><a href="#M000206">round_at</a></span>
-  <span style="padding-right: 5px;"><a href="#M000207">round_to</a></span>
+  <span style="padding-right: 5px;"><a href="#M000217">round_at</a></span>
+  <span style="padding-right: 5px;"><a href="#M000218">round_to</a></span>
 
 
 
@@ -92,7 +92,7 @@ Object
 <div class="sectiontitle">Public Instance methods</div>
 <div class="method">
   <div class="title">
-    <a name="M000206"></a><b>round_at</b>( d )
+    <a name="M000217"></a><b>round_at</b>( d )
   </div>
   <div class="description">
   <p>
@@ -109,8 +109,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000206_source')" id="l_M000206_source">+</a> ]</p>
-  <div id="M000206_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000217_source')" id="l_M000217_source">+</a> ]</p>
+  <div id="M000217_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/numeric/round.rb, line 50</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">round_at</span>( <span class="ruby-identifier">d</span> ) <span class="ruby-comment cmt">#d=0</span>
@@ -122,7 +122,7 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000207"></a><b>round_to</b>( n )
+    <a name="M000218"></a><b>round_to</b>( n )
   </div>
   <div class="description">
   <p>
@@ -139,8 +139,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000207_source')" id="l_M000207_source">+</a> ]</p>
-  <div id="M000207_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000218_source')" id="l_M000218_source">+</a> ]</p>
+  <div id="M000218_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/numeric/round.rb, line 63</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">round_to</span>( <span class="ruby-identifier">n</span> ) <span class="ruby-comment cmt">#n=1</span>

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

@@ -99,9 +99,9 @@ accorrding to the operation applied to it.
 
 
   <div class="sectiontitle">Methods</div>
-  <span style="padding-right: 5px;"><a href="#M000223">method_missing</a></span>
-  <span style="padding-right: 5px;"><a href="#M000221">new</a></span>
-  <span style="padding-right: 5px;"><a href="#M000222">to_proc</a></span>
+  <span style="padding-right: 5px;"><a href="#M000234">method_missing</a></span>
+  <span style="padding-right: 5px;"><a href="#M000232">new</a></span>
+  <span style="padding-right: 5px;"><a href="#M000233">to_proc</a></span>
 
 
 
@@ -111,11 +111,11 @@ accorrding to the operation applied to it.
 <div class="sectiontitle">Public Class methods</div>
 <div class="method">
   <div class="title">
-    <a name="M000221"></a><b>new</b>(&amp;function)
+    <a name="M000232"></a><b>new</b>(&amp;function)
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000221_source')" id="l_M000221_source">+</a> ]</p>
-  <div id="M000221_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000232_source')" id="l_M000232_source">+</a> ]</p>
+  <div id="M000232_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/functor.rb, line 63</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">function</span>)
@@ -128,7 +128,7 @@ accorrding to the operation applied to it.
 <div class="sectiontitle">Public Instance methods</div>
 <div class="method">
   <div class="title">
-    <a name="M000223"></a><b>method_missing</b>(op, *args, &amp;blk)
+    <a name="M000234"></a><b>method_missing</b>(op, *args, &amp;blk)
   </div>
   <div class="description">
   <p>
@@ -136,8 +136,8 @@ Any action against the functor is processesd by the function.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000223_source')" id="l_M000223_source">+</a> ]</p>
-  <div id="M000223_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000234_source')" id="l_M000234_source">+</a> ]</p>
+  <div id="M000234_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/functor.rb, line 72</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">method_missing</span>(<span class="ruby-identifier">op</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">args</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">blk</span>)
@@ -149,11 +149,11 @@ Any action against the functor is processesd by the function.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000222"></a><b>to_proc</b>()
+    <a name="M000233"></a><b>to_proc</b>()
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000222_source')" id="l_M000222_source">+</a> ]</p>
-  <div id="M000222_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000233_source')" id="l_M000233_source">+</a> ]</p>
+  <div id="M000233_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/functor.rb, line 67</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_proc</span>

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

@@ -58,6 +58,7 @@
         <td>In:</td>
         <td>
 <a href="../files/lib/core/facets/to_hash_rb.html">lib/core/facets/to_hash.rb</a>
+<a href="../files/lib/core/facets/hash/new_with_rb.html">lib/core/facets/hash/new_with.rb</a>
 <a href="../files/lib/core/facets/hash/zipnew_rb.html">lib/core/facets/hash/zipnew.rb</a>
 <a href="../files/lib/core/facets/hash/update_values_rb.html">lib/core/facets/hash/update_values.rb</a>
 <a href="../files/lib/core/facets/hash/alias_rb.html">lib/core/facets/hash/alias.rb</a>
@@ -86,6 +87,7 @@
 <a href="../files/lib/core/facets/hash/to_struct_rb.html">lib/core/facets/hash/to_struct.rb</a>
 <a href="../files/lib/core/facets/hash/symbolize_keys_rb.html">lib/core/facets/hash/symbolize_keys.rb</a>
 <a href="../files/lib/core/facets/hash/join_rb.html">lib/core/facets/hash/join.rb</a>
+<a href="../files/lib/core/facets/hash/group_by_value_rb.html">lib/core/facets/hash/group_by_value.rb</a>
 <a href="../files/lib/core/facets/hash/replace_each_rb.html">lib/core/facets/hash/replace_each.rb</a>
 <a href="../files/lib/core/facets/hash/slice_rb.html">lib/core/facets/hash/slice.rb</a>
 <a href="../files/lib/core/facets/hash/op_add_rb.html">lib/core/facets/hash/op_add.rb</a>
@@ -118,62 +120,66 @@ Object
 
 
   <div class="sectiontitle">Methods</div>
-  <span style="padding-right: 5px;"><a href="#M000082">&amp;</a></span>
-  <span style="padding-right: 5px;"><a href="#M000097">*</a></span>
-  <span style="padding-right: 5px;"><a href="#M000125">+</a></span>
-  <span style="padding-right: 5px;"><a href="#M000083">-</a></span>
-  <span style="padding-right: 5px;"><a href="#M000098">&lt;&lt;</a></span>
-  <span style="padding-right: 5px;"><a href="#M000078">alias!</a></span>
-  <span style="padding-right: 5px;"><a href="#M000130">argumentize</a></span>
-  <span style="padding-right: 5px;"><a href="#M000079">autonew</a></span>
-  <span style="padding-right: 5px;"><a href="#M000109">collate</a></span>
-  <span style="padding-right: 5px;"><a href="#M000110">collate!</a></span>
-  <span style="padding-right: 5px;"><a href="#M000111">delete_unless</a></span>
-  <span style="padding-right: 5px;"><a href="#M000112">delete_values</a></span>
-  <span style="padding-right: 5px;"><a href="#M000113">delete_values_at</a></span>
-  <span style="padding-right: 5px;"><a href="#M000106">diff</a></span>
-  <span style="padding-right: 5px;"><a href="#M000090">each_with_key</a></span>
-  <span style="padding-right: 5px;"><a href="#M000084">except</a></span>
-  <span style="padding-right: 5px;"><a href="#M000085">except!</a></span>
-  <span style="padding-right: 5px;"><a href="#M000108">graph!</a></span>
-  <span style="padding-right: 5px;"><a href="#M000086">has_keys?</a></span>
-  <span style="padding-right: 5px;"><a href="#M000088">has_only_keys?</a></span>
-  <span style="padding-right: 5px;"><a href="#M000104">insert</a></span>
-  <span style="padding-right: 5px;"><a href="#M000099">inverse</a></span>
-  <span style="padding-right: 5px;"><a href="#M000121">join</a></span>
-  <span style="padding-right: 5px;"><a href="#M000087">keys?</a></span>
-  <span style="padding-right: 5px;"><a href="#M000107">mash!</a></span>
-  <span style="padding-right: 5px;"><a href="#M000089">only_keys?</a></span>
-  <span style="padding-right: 5px;"><a href="#M000100">recursive_merge</a></span>
-  <span style="padding-right: 5px;"><a href="#M000101">recursive_merge!</a></span>
-  <span style="padding-right: 5px;"><a href="#M000080">recursively</a></span>
-  <span style="padding-right: 5px;"><a href="#M000081">recursively!</a></span>
-  <span style="padding-right: 5px;"><a href="#M000126">rekey</a></span>
-  <span style="padding-right: 5px;"><a href="#M000127">rekey!</a></span>
-  <span style="padding-right: 5px;"><a href="#M000122">replace_each</a></span>
-  <span style="padding-right: 5px;"><a href="#M000091">reverse_merge</a></span>
-  <span style="padding-right: 5px;"><a href="#M000092">reverse_merge!</a></span>
-  <span style="padding-right: 5px;"><a href="#M000093">reverse_update</a></span>
-  <span style="padding-right: 5px;"><a href="#M000105">select!</a></span>
-  <span style="padding-right: 5px;"><a href="#M000123">slice</a></span>
-  <span style="padding-right: 5px;"><a href="#M000124">slice!</a></span>
-  <span style="padding-right: 5px;"><a href="#M000119">stringify_keys</a></span>
-  <span style="padding-right: 5px;"><a href="#M000120">stringify_keys!</a></span>
-  <span style="padding-right: 5px;"><a href="#M000115">swap!</a></span>
-  <span style="padding-right: 5px;"><a href="#M000117">symbolize_keys</a></span>
-  <span style="padding-right: 5px;"><a href="#M000118">symbolize_keys!</a></span>
-  <span style="padding-right: 5px;"><a href="#M000075">to_h</a></span>
-  <span style="padding-right: 5px;"><a href="#M000102">to_proc</a></span>
-  <span style="padding-right: 5px;"><a href="#M000103">to_proc_with_reponse</a></span>
-  <span style="padding-right: 5px;"><a href="#M000116">to_struct</a></span>
-  <span style="padding-right: 5px;"><a href="#M000094">traverse</a></span>
-  <span style="padding-right: 5px;"><a href="#M000095">traverse!</a></span>
-  <span style="padding-right: 5px;"><a href="#M000128">update_each</a></span>
-  <span style="padding-right: 5px;"><a href="#M000129">update_keys</a></span>
-  <span style="padding-right: 5px;"><a href="#M000077">update_values</a></span>
-  <span style="padding-right: 5px;"><a href="#M000114">weave</a></span>
-  <span style="padding-right: 5px;"><a href="#M000076">zipnew</a></span>
-  <span style="padding-right: 5px;"><a href="#M000096">|</a></span>
+  <span style="padding-right: 5px;"><a href="#M000114">&amp;</a></span>
+  <span style="padding-right: 5px;"><a href="#M000129">*</a></span>
+  <span style="padding-right: 5px;"><a href="#M000158">+</a></span>
+  <span style="padding-right: 5px;"><a href="#M000115">-</a></span>
+  <span style="padding-right: 5px;"><a href="#M000130">&lt;&lt;</a></span>
+  <span style="padding-right: 5px;"><a href="#M000110">alias!</a></span>
+  <span style="padding-right: 5px;"><a href="#M000163">argumentize</a></span>
+  <span style="padding-right: 5px;"><a href="#M000111">autonew</a></span>
+  <span style="padding-right: 5px;"><a href="#M000141">collate</a></span>
+  <span style="padding-right: 5px;"><a href="#M000142">collate!</a></span>
+  <span style="padding-right: 5px;"><a href="#M000105">dearray_singluar_values</a></span>
+  <span style="padding-right: 5px;"><a href="#M000104">dearray_values</a></span>
+  <span style="padding-right: 5px;"><a href="#M000143">delete_unless</a></span>
+  <span style="padding-right: 5px;"><a href="#M000144">delete_values</a></span>
+  <span style="padding-right: 5px;"><a href="#M000145">delete_values_at</a></span>
+  <span style="padding-right: 5px;"><a href="#M000138">diff</a></span>
+  <span style="padding-right: 5px;"><a href="#M000122">each_with_key</a></span>
+  <span style="padding-right: 5px;"><a href="#M000116">except</a></span>
+  <span style="padding-right: 5px;"><a href="#M000117">except!</a></span>
+  <span style="padding-right: 5px;"><a href="#M000140">graph!</a></span>
+  <span style="padding-right: 5px;"><a href="#M000154">group_by_value</a></span>
+  <span style="padding-right: 5px;"><a href="#M000118">has_keys?</a></span>
+  <span style="padding-right: 5px;"><a href="#M000120">has_only_keys?</a></span>
+  <span style="padding-right: 5px;"><a href="#M000136">insert</a></span>
+  <span style="padding-right: 5px;"><a href="#M000131">inverse</a></span>
+  <span style="padding-right: 5px;"><a href="#M000153">join</a></span>
+  <span style="padding-right: 5px;"><a href="#M000119">keys?</a></span>
+  <span style="padding-right: 5px;"><a href="#M000139">mash!</a></span>
+  <span style="padding-right: 5px;"><a href="#M000107">new_with</a></span>
+  <span style="padding-right: 5px;"><a href="#M000121">only_keys?</a></span>
+  <span style="padding-right: 5px;"><a href="#M000132">recursive_merge</a></span>
+  <span style="padding-right: 5px;"><a href="#M000133">recursive_merge!</a></span>
+  <span style="padding-right: 5px;"><a href="#M000112">recursively</a></span>
+  <span style="padding-right: 5px;"><a href="#M000113">recursively!</a></span>
+  <span style="padding-right: 5px;"><a href="#M000159">rekey</a></span>
+  <span style="padding-right: 5px;"><a href="#M000160">rekey!</a></span>
+  <span style="padding-right: 5px;"><a href="#M000155">replace_each</a></span>
+  <span style="padding-right: 5px;"><a href="#M000123">reverse_merge</a></span>
+  <span style="padding-right: 5px;"><a href="#M000124">reverse_merge!</a></span>
+  <span style="padding-right: 5px;"><a href="#M000125">reverse_update</a></span>
+  <span style="padding-right: 5px;"><a href="#M000137">select!</a></span>
+  <span style="padding-right: 5px;"><a href="#M000156">slice</a></span>
+  <span style="padding-right: 5px;"><a href="#M000157">slice!</a></span>
+  <span style="padding-right: 5px;"><a href="#M000151">stringify_keys</a></span>
+  <span style="padding-right: 5px;"><a href="#M000152">stringify_keys!</a></span>
+  <span style="padding-right: 5px;"><a href="#M000147">swap!</a></span>
+  <span style="padding-right: 5px;"><a href="#M000149">symbolize_keys</a></span>
+  <span style="padding-right: 5px;"><a href="#M000150">symbolize_keys!</a></span>
+  <span style="padding-right: 5px;"><a href="#M000106">to_h</a></span>
+  <span style="padding-right: 5px;"><a href="#M000134">to_proc</a></span>
+  <span style="padding-right: 5px;"><a href="#M000135">to_proc_with_reponse</a></span>
+  <span style="padding-right: 5px;"><a href="#M000148">to_struct</a></span>
+  <span style="padding-right: 5px;"><a href="#M000126">traverse</a></span>
+  <span style="padding-right: 5px;"><a href="#M000127">traverse!</a></span>
+  <span style="padding-right: 5px;"><a href="#M000161">update_each</a></span>
+  <span style="padding-right: 5px;"><a href="#M000162">update_keys</a></span>
+  <span style="padding-right: 5px;"><a href="#M000109">update_values</a></span>
+  <span style="padding-right: 5px;"><a href="#M000146">weave</a></span>
+  <span style="padding-right: 5px;"><a href="#M000108">zipnew</a></span>
+  <span style="padding-right: 5px;"><a href="#M000128">|</a></span>
 
 
 
@@ -183,7 +189,7 @@ Object
 <div class="sectiontitle">Public Class methods</div>
 <div class="method">
   <div class="title">
-    <a name="M000079"></a><b>autonew</b>(*args)
+    <a name="M000111"></a><b>autonew</b>(*args)
   </div>
   <div class="description">
   <pre>
@@ -206,8 +212,8 @@ CREDIT: Trans, Jan Molic
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000079_source')" id="l_M000079_source">+</a> ]</p>
-  <div id="M000079_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000111_source')" id="l_M000111_source">+</a> ]</p>
+  <div id="M000111_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/autonew.rb, line 19</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">autonew</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
@@ -221,7 +227,34 @@ CREDIT: Trans, Jan Molic
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000076"></a><b>zipnew</b>(keys,values)
+    <a name="M000107"></a><b>new_with</b>( {|| ...}
+  </div>
+  <div class="description">
+  <p>
+Instantiate a new hash with a default value determined by the block.
+</p>
+<p>
+<a href="Hash.html#M000107">Hash.new_with</a> { [] }
+</p>
+<p>
+CREDIT: Pit Capitan
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000107_source')" id="l_M000107_source">+</a> ]</p>
+  <div id="M000107_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/core/facets/hash/new_with.rb, line 10</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">new_with</span> <span class="ruby-comment cmt">#:yield:</span>
+    <span class="ruby-identifier">new</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">h</span>, <span class="ruby-identifier">k</span><span class="ruby-operator">|</span> <span class="ruby-identifier">h</span>[<span class="ruby-identifier">k</span>] = <span class="ruby-keyword kw">yield</span> }
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000108"></a><b>zipnew</b>(keys,values)
   </div>
   <div class="description">
   <p>
@@ -236,8 +269,8 @@ CREDIT: Trans, Ara T. Howard
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000076_source')" id="l_M000076_source">+</a> ]</p>
-  <div id="M000076_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000108_source')" id="l_M000108_source">+</a> ]</p>
+  <div id="M000108_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/zipnew.rb, line 11</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">zipnew</span>(<span class="ruby-identifier">keys</span>,<span class="ruby-identifier">values</span>) <span class="ruby-comment cmt"># or some better name</span>
@@ -252,7 +285,7 @@ CREDIT: Trans, Ara T. Howard
 <div class="sectiontitle">Public Instance methods</div>
 <div class="method">
   <div class="title">
-    <a name="M000082"></a><b>&amp;</b>(other)
+    <a name="M000114"></a><b>&amp;</b>(other)
   </div>
   <div class="description">
   <p>
@@ -277,8 +310,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000082_source')" id="l_M000082_source">+</a> ]</p>
-  <div id="M000082_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000114_source')" id="l_M000114_source">+</a> ]</p>
+  <div id="M000114_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/op_and.rb, line 19</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-operator">&amp;</span>(<span class="ruby-identifier">other</span>)
@@ -299,7 +332,7 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000097"></a><b>*</b>(other)
+    <a name="M000129"></a><b>*</b>(other)
   </div>
   <div class="description">
   <p>
@@ -317,8 +350,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000097_source')" id="l_M000097_source">+</a> ]</p>
-  <div id="M000097_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000129_source')" id="l_M000129_source">+</a> ]</p>
+  <div id="M000129_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/op_mul.rb, line 13</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-operator">*</span>(<span class="ruby-identifier">other</span>)
@@ -330,7 +363,7 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000125"></a><b>+</b>(other)
+    <a name="M000158"></a><b>+</b>(other)
   </div>
   <div class="description">
   <p>
@@ -341,8 +374,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000125_source')" id="l_M000125_source">+</a> ]</p>
-  <div id="M000125_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000158_source')" id="l_M000158_source">+</a> ]</p>
+  <div id="M000158_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/op_add.rb, line 7</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-operator">+</span>(<span class="ruby-identifier">other</span>)
@@ -354,7 +387,7 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000083"></a><b>-</b>(other)
+    <a name="M000115"></a><b>-</b>(other)
   </div>
   <div class="description">
   <p>
@@ -367,8 +400,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000083_source')" id="l_M000083_source">+</a> ]</p>
-  <div id="M000083_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000115_source')" id="l_M000115_source">+</a> ]</p>
+  <div id="M000115_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/op_sub.rb, line 9</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-operator">-</span>(<span class="ruby-identifier">other</span>)
@@ -392,7 +425,7 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000098"></a><b>&lt;&lt;</b>(other)
+    <a name="M000130"></a><b>&lt;&lt;</b>(other)
   </div>
   <div class="description">
   <p>
@@ -403,8 +436,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000098_source')" id="l_M000098_source">+</a> ]</p>
-  <div id="M000098_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000130_source')" id="l_M000130_source">+</a> ]</p>
+  <div id="M000130_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/op_push.rb, line 8</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-operator">&lt;&lt;</span>(<span class="ruby-identifier">other</span>)
@@ -421,7 +454,7 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000078"></a><b>alias!</b>(newkey, oldkey)
+    <a name="M000110"></a><b>alias!</b>(newkey, oldkey)
   </div>
   <div class="description">
   <p>
@@ -456,8 +489,8 @@ TODO: Rename to aliaskey or something else.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000078_source')" id="l_M000078_source">+</a> ]</p>
-  <div id="M000078_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000110_source')" id="l_M000110_source">+</a> ]</p>
+  <div id="M000110_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/alias.rb, line 25</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">alias!</span>(<span class="ruby-identifier">newkey</span>, <span class="ruby-identifier">oldkey</span>)
@@ -470,7 +503,7 @@ TODO: Rename to aliaskey or something else.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000130"></a><b>argumentize</b>(args_field=nil)
+    <a name="M000163"></a><b>argumentize</b>(args_field=nil)
   </div>
   <div class="description">
   <p>
@@ -484,8 +517,8 @@ Turn a hash into arguments.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000130_source')" id="l_M000130_source">+</a> ]</p>
-  <div id="M000130_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000163_source')" id="l_M000163_source">+</a> ]</p>
+  <div id="M000163_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/argumentize.rb, line 10</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">argumentize</span>(<span class="ruby-identifier">args_field</span>=<span class="ruby-keyword kw">nil</span>)
@@ -504,7 +537,7 @@ Turn a hash into arguments.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000109"></a><b>collate</b>(other_hash)
+    <a name="M000141"></a><b>collate</b>(other_hash)
   </div>
   <div class="description">
   <p>
@@ -516,16 +549,40 @@ to be arrays representing the values from both hashes.
   #=&gt; { :a=&gt;[1,3], :b=&gt;[2,4], :c=&gt;[5] }
 </pre>
 <p>
-CREDIT: Gavin Kistner (Phrogz)
+CREDIT: Tilo Sloboda CREDIT: Gavin Kistner (Phrogz)
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000109_source')" id="l_M000109_source">+</a> ]</p>
-  <div id="M000109_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000141_source')" id="l_M000141_source">+</a> ]</p>
+  <div id="M000141_source" class="dyn-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/core/facets/hash/collate.rb, line 11</span>
+<span class="ruby-comment cmt"># File lib/core/facets/hash/collate.rb, line 12</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">collate</span>(<span class="ruby-identifier">other_hash</span>)
-    <span class="ruby-identifier">dup</span>.<span class="ruby-identifier">collate!</span>(<span class="ruby-identifier">other_hash</span>)
+    <span class="ruby-identifier">h</span> = <span class="ruby-constant">Hash</span>.<span class="ruby-identifier">new</span>
+    <span class="ruby-comment cmt"># Prepare, ensuring every existing key is already an Array</span>
+    <span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">key</span>, <span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
+      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">value</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Array</span>)
+        <span class="ruby-identifier">h</span>[<span class="ruby-identifier">key</span>] = <span class="ruby-identifier">value</span>
+      <span class="ruby-keyword kw">else</span>
+        <span class="ruby-identifier">h</span>[<span class="ruby-identifier">key</span>] = [<span class="ruby-identifier">value</span>]
+      <span class="ruby-keyword kw">end</span>
+    <span class="ruby-keyword kw">end</span>
+    <span class="ruby-comment cmt"># Collate with values from other_hash</span>
+    <span class="ruby-identifier">other_hash</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">key</span>, <span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
+      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">h</span>[<span class="ruby-identifier">key</span>]
+        <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">value</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Array</span>)
+          <span class="ruby-identifier">h</span>[<span class="ruby-identifier">key</span>].<span class="ruby-identifier">concat</span>(<span class="ruby-identifier">value</span>)
+        <span class="ruby-keyword kw">else</span>
+          <span class="ruby-identifier">h</span>[<span class="ruby-identifier">key</span>] <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">value</span>
+        <span class="ruby-keyword kw">end</span>
+      <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">value</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Array</span>)
+        <span class="ruby-identifier">h</span>[<span class="ruby-identifier">key</span>] = <span class="ruby-identifier">value</span>
+      <span class="ruby-keyword kw">else</span>
+        <span class="ruby-identifier">h</span>[<span class="ruby-identifier">key</span>] = [<span class="ruby-identifier">value</span>]
+      <span class="ruby-keyword kw">end</span>
+    <span class="ruby-keyword kw">end</span>
+    <span class="ruby-comment cmt">#each{ |key, value| value.uniq! } if options[ :uniq ]</span>
+    <span class="ruby-identifier">h</span>
   <span class="ruby-keyword kw">end</span>
 </pre>
   </div>
@@ -533,44 +590,98 @@ CREDIT: Gavin Kistner (Phrogz)
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000110"></a><b>collate!</b>(other_hash)
+    <a name="M000142"></a><b>collate!</b>(other_hash)
   </div>
   <div class="description">
   <p>
-The same as <a href="Hash.html#M000109">collate</a>, but modifies the
+The same as <a href="Hash.html#M000141">collate</a>, but modifies the
 receiver in place.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000110_source')" id="l_M000110_source">+</a> ]</p>
-  <div id="M000110_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000142_source')" id="l_M000142_source">+</a> ]</p>
+  <div id="M000142_source" class="dyn-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/core/facets/hash/collate.rb, line 17</span>
+<span class="ruby-comment cmt"># File lib/core/facets/hash/collate.rb, line 42</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">collate!</span>(<span class="ruby-identifier">other_hash</span>)
-    <span class="ruby-comment cmt"># Prepare, ensuring every existing key is already an Array</span>
-    <span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">key</span>, <span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
-      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">value</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Array</span>)
-        <span class="ruby-keyword kw">self</span>[<span class="ruby-identifier">key</span>] = <span class="ruby-identifier">value</span>
+    <span class="ruby-identifier">result</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">collate</span>(<span class="ruby-identifier">other_hash</span>)
+    <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">replace</span>(<span class="ruby-identifier">result</span>)
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000105"></a><b>dearray_singluar_values</b>()
+  </div>
+  <div class="description">
+  <p>
+Any array values with less one or no elements will have the element or nil
+set as the value instead.
+</p>
+<pre>
+  h = { :a=&gt;[1], :b=&gt;[1,2], :c=&gt;3, :d=&gt;[] }
+  h.dearray_singluar_values  #=&gt; { :a=&gt;1, :b=&gt;[1,2], :c=&gt;3, :d=&gt;nil }
+</pre>
+<p>
+CREDIT: Trans
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000105_source')" id="l_M000105_source">+</a> ]</p>
+  <div id="M000105_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/core/facets/to_hash.rb, line 34</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">dearray_singluar_values</span>
+    <span class="ruby-identifier">h</span> = {}
+    <span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">k</span>,<span class="ruby-identifier">v</span><span class="ruby-operator">|</span>
+      <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">v</span>
+      <span class="ruby-keyword kw">when</span> <span class="ruby-constant">Array</span>
+        <span class="ruby-identifier">h</span>[<span class="ruby-identifier">k</span>] = (<span class="ruby-identifier">v</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&lt;</span> <span class="ruby-value">2</span>) <span class="ruby-operator">?</span> <span class="ruby-identifier">v</span>[<span class="ruby-value">0</span>] <span class="ruby-operator">:</span> <span class="ruby-identifier">v</span>
       <span class="ruby-keyword kw">else</span>
-        <span class="ruby-keyword kw">self</span>[<span class="ruby-identifier">key</span>] = [<span class="ruby-identifier">value</span>]
+        <span class="ruby-identifier">h</span>[<span class="ruby-identifier">k</span>] = <span class="ruby-identifier">v</span>
       <span class="ruby-keyword kw">end</span>
     <span class="ruby-keyword kw">end</span>
-    <span class="ruby-comment cmt"># Collate with values from other_hash</span>
-    <span class="ruby-identifier">other_hash</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">key</span>, <span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
-      <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">self</span>[<span class="ruby-identifier">key</span>]
-        <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">value</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Array</span>)
-          <span class="ruby-keyword kw">self</span>[<span class="ruby-identifier">key</span>].<span class="ruby-identifier">concat</span>( <span class="ruby-identifier">value</span> )
-        <span class="ruby-keyword kw">else</span>
-          <span class="ruby-keyword kw">self</span>[<span class="ruby-identifier">key</span>] <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">value</span>
-        <span class="ruby-keyword kw">end</span>
-      <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">value</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Array</span>)
-        <span class="ruby-keyword kw">self</span>[<span class="ruby-identifier">key</span>] = <span class="ruby-identifier">value</span>
+    <span class="ruby-identifier">h</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000104"></a><b>dearray_values</b>(index=0)
+  </div>
+  <div class="description">
+  <p>
+Any array values with less one or no elements will have the element or nil
+set as the value instead.
+</p>
+<pre>
+  h = { :a=&gt;[1], :b=&gt;[1,2], :c=&gt;3, :d=&gt;[] }
+  h.dearray_values  #=&gt; { :a=&gt;1, :b=&gt;1, :c=&gt;3, :d=&gt;nil }
+</pre>
+<p>
+CREDIT: Trans
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000104_source')" id="l_M000104_source">+</a> ]</p>
+  <div id="M000104_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/core/facets/to_hash.rb, line 13</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">dearray_values</span>(<span class="ruby-identifier">index</span>=<span class="ruby-value">0</span>)
+    <span class="ruby-identifier">h</span> = {}
+    <span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">k</span>,<span class="ruby-identifier">v</span><span class="ruby-operator">|</span>
+      <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">v</span>
+      <span class="ruby-keyword kw">when</span> <span class="ruby-constant">Array</span>
+        <span class="ruby-identifier">h</span>[<span class="ruby-identifier">k</span>] = <span class="ruby-identifier">v</span>[<span class="ruby-identifier">index</span>] <span class="ruby-operator">||</span> <span class="ruby-identifier">v</span>[<span class="ruby-value">-1</span>]
       <span class="ruby-keyword kw">else</span>
-        <span class="ruby-keyword kw">self</span>[<span class="ruby-identifier">key</span>] = [<span class="ruby-identifier">value</span>]
+        <span class="ruby-identifier">h</span>[<span class="ruby-identifier">k</span>] = <span class="ruby-identifier">v</span>
       <span class="ruby-keyword kw">end</span>
     <span class="ruby-keyword kw">end</span>
-    <span class="ruby-comment cmt">#each{ |key, value| value.uniq! } if options[ :uniq ]</span>
-    <span class="ruby-keyword kw">self</span>
+    <span class="ruby-identifier">h</span>
   <span class="ruby-keyword kw">end</span>
 </pre>
   </div>
@@ -578,7 +689,7 @@ receiver in place.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000111"></a><b>delete_unless</b>( {|| ...}
+    <a name="M000143"></a><b>delete_unless</b>( {|| ...}
   </div>
   <div class="description">
   <p>
@@ -589,8 +700,8 @@ CREDIT: Daniel Schierbeck
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000111_source')" id="l_M000111_source">+</a> ]</p>
-  <div id="M000111_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000143_source')" id="l_M000143_source">+</a> ]</p>
+  <div id="M000143_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/delete.rb, line 11</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">delete_unless</span> <span class="ruby-comment cmt">#:yield:</span>
@@ -602,7 +713,7 @@ CREDIT: Daniel Schierbeck
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000112"></a><b>delete_values</b>(*values)
+    <a name="M000144"></a><b>delete_values</b>(*values)
   </div>
   <div class="description">
   <p>
@@ -619,8 +730,8 @@ CREDIT: Daniel Schierbeck
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000112_source')" id="l_M000112_source">+</a> ]</p>
-  <div id="M000112_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000144_source')" id="l_M000144_source">+</a> ]</p>
+  <div id="M000144_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/delete.rb, line 24</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">delete_values</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">values</span>)
@@ -632,7 +743,7 @@ CREDIT: Daniel Schierbeck
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000113"></a><b>delete_values_at</b>(*keys, &amp;yld)
+    <a name="M000145"></a><b>delete_values_at</b>(*keys, &amp;yld)
   </div>
   <div class="description">
   <p>
@@ -655,8 +766,8 @@ CREDIT: Daniel Schierbeck
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000113_source')" id="l_M000113_source">+</a> ]</p>
-  <div id="M000113_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000145_source')" id="l_M000145_source">+</a> ]</p>
+  <div id="M000145_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/delete.rb, line 42</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">delete_values_at</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">keys</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">yld</span>)
@@ -668,7 +779,7 @@ CREDIT: Daniel Schierbeck
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000106"></a><b>diff</b>(hash)
+    <a name="M000138"></a><b>diff</b>(hash)
   </div>
   <div class="description">
   <p>
@@ -676,8 +787,8 @@ Difference comparison of two hashes.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000106_source')" id="l_M000106_source">+</a> ]</p>
-  <div id="M000106_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000138_source')" id="l_M000138_source">+</a> ]</p>
+  <div id="M000138_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/diff.rb, line 5</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">diff</span>(<span class="ruby-identifier">hash</span>)
@@ -691,7 +802,7 @@ Difference comparison of two hashes.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000090"></a><b>each_with_key</b>( &amp;yld )
+    <a name="M000122"></a><b>each_with_key</b>( &amp;yld )
   </div>
   <div class="description">
   <p>
@@ -703,8 +814,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000090_source')" id="l_M000090_source">+</a> ]</p>
-  <div id="M000090_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000122_source')" id="l_M000122_source">+</a> ]</p>
+  <div id="M000122_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/keys.rb, line 40</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">each_with_key</span>( <span class="ruby-operator">&amp;</span><span class="ruby-identifier">yld</span> )
@@ -716,7 +827,7 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000084"></a><b>except</b>(*less_keys)
+    <a name="M000116"></a><b>except</b>(*less_keys)
   </div>
   <div class="description">
   <p>
@@ -724,8 +835,8 @@ Returns a new hash less the given keys.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000084_source')" id="l_M000084_source">+</a> ]</p>
-  <div id="M000084_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000116_source')" id="l_M000116_source">+</a> ]</p>
+  <div id="M000116_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/except.rb, line 5</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">except</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">less_keys</span>)
@@ -737,7 +848,7 @@ Returns a new hash less the given keys.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000085"></a><b>except!</b>(*less_keys)
+    <a name="M000117"></a><b>except!</b>(*less_keys)
   </div>
   <div class="description">
   <p>
@@ -751,8 +862,8 @@ keys removed.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000085_source')" id="l_M000085_source">+</a> ]</p>
-  <div id="M000085_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000117_source')" id="l_M000117_source">+</a> ]</p>
+  <div id="M000117_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/except.rb, line 18</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">except!</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">less_keys</span>)
@@ -766,7 +877,7 @@ keys removed.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000108"></a><b>graph!</b>(&amp;yld)
+    <a name="M000140"></a><b>graph!</b>(&amp;yld)
   </div>
   <div class="description">
   <p>
@@ -776,7 +887,80 @@ Alias for mash!
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000086"></a><b>has_keys?</b>(*check_keys)
+    <a name="M000154"></a><b>group_by_value</b>()
+  </div>
+  <div class="description">
+  <p>
+Like group_by, but allows hash values to be grouped with weeding out the
+keys.
+</p>
+<pre>
+  Example:
+
+  birthdays = {...}   # Maps each person to his/her birthday.
+</pre>
+<p>
+Now I want to have the list of people that have their birthday on a
+specific date. This can be done by creating a hash first, using group_by:
+</p>
+<pre>
+  birthdays.group_by{|person, birthday| birthday}
+</pre>
+<p>
+This returns:
+</p>
+<p>
+{date=&gt;[[person1, date], [person2, date], [person3, date]]}
+</p>
+<p>
+&#8230; which is a bit inconvient. Too many dates. I would rather like to
+have:
+</p>
+<pre>
+  {date=&gt;[person1, person2, person3]]}
+</pre>
+<p>
+This can be achieved by:
+</p>
+<pre>
+  birthdays.inject!({}){|h, (person, date)| (h[date] ||= []) &lt;&lt; person}
+</pre>
+<p>
+I&#8216;ve used this pattern just once too often, so I moved the code to <a
+href="Hash.html">Hash</a> (and <a href="Enumerable.html">Enumerable</a>,
+for associative arrays). Here&#8216;s the cleaner code:
+</p>
+<p>
+birthdays.group_by_value
+</p>
+<pre>
+  h = {&quot;A&quot;=&gt;1, &quot;B&quot;=&gt;1, &quot;C&quot;=&gt;1, &quot;D&quot;=&gt;2, &quot;E&quot;=&gt;2, &quot;F&quot;=&gt;2, &quot;G&quot;=&gt;3, &quot;H&quot;=&gt;3, &quot;I&quot;=&gt;3}
+
+  h.group_by{|k, v| v}    # ==&gt; {1=&gt;[[&quot;A&quot;, 1], [&quot;B&quot;, 1], [&quot;C&quot;, 1]], 2=&gt;[[&quot;D&quot;, 2], [&quot;E&quot;, 2], [&quot;F&quot;, 2]], 3=&gt;[[&quot;G&quot;, 3], [&quot;H&quot;, 3], [&quot;I&quot;, 3]]}
+  h.group_by_value        # ==&gt; {1=&gt;[&quot;A&quot;, &quot;B&quot;, &quot;C&quot;], 2=&gt;[&quot;D&quot;, &quot;E&quot;, &quot;F&quot;], 3=&gt;[&quot;G&quot;, &quot;H&quot;, &quot;I&quot;]}
+  h.sort.group_by_value   # ==&gt; [[1, [&quot;A&quot;, &quot;B&quot;, &quot;C&quot;]], [2, [&quot;D&quot;, &quot;E&quot;, &quot;F&quot;]], [3, [&quot;G&quot;, &quot;H&quot;, &quot;I&quot;]]]
+</pre>
+<p>
+CREDIT: Erik Veenstra
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000154_source')" id="l_M000154_source">+</a> ]</p>
+  <div id="M000154_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/core/facets/hash/group_by_value.rb, line 42</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">group_by_value</span>
+    <span class="ruby-identifier">res</span> = {}
+    <span class="ruby-identifier">each</span>{<span class="ruby-operator">|</span><span class="ruby-identifier">k</span>, <span class="ruby-identifier">v</span><span class="ruby-operator">|</span> (<span class="ruby-identifier">res</span>[<span class="ruby-identifier">v</span>] <span class="ruby-operator">||=</span> []) <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">k</span>}
+    <span class="ruby-identifier">res</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000118"></a><b>has_keys?</b>(*check_keys)
   </div>
   <div class="description">
   <p>
@@ -793,11 +977,11 @@ CREDIT: Trans
   </div>
 <div class="aka">
   This method is also aliased as
-  <a href="Hash.html#M000087">keys?</a>
+  <a href="Hash.html#M000119">keys?</a>
 </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000086_source')" id="l_M000086_source">+</a> ]</p>
-  <div id="M000086_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000118_source')" id="l_M000118_source">+</a> ]</p>
+  <div id="M000118_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/keys.rb, line 12</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">has_keys?</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">check_keys</span>)
@@ -810,7 +994,7 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000088"></a><b>has_only_keys?</b>(*check_keys)
+    <a name="M000120"></a><b>has_only_keys?</b>(*check_keys)
   </div>
   <div class="description">
   <p>
@@ -828,11 +1012,11 @@ CREDIT: Trans
   </div>
 <div class="aka">
   This method is also aliased as
-  <a href="Hash.html#M000089">only_keys?</a>
+  <a href="Hash.html#M000121">only_keys?</a>
 </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000088_source')" id="l_M000088_source">+</a> ]</p>
-  <div id="M000088_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000120_source')" id="l_M000120_source">+</a> ]</p>
+  <div id="M000120_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/keys.rb, line 28</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">has_only_keys?</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">check_keys</span>)
@@ -845,7 +1029,7 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000104"></a><b>insert</b>(name, value)
+    <a name="M000136"></a><b>insert</b>(name, value)
   </div>
   <div class="description">
   <p>
@@ -859,8 +1043,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000104_source')" id="l_M000104_source">+</a> ]</p>
-  <div id="M000104_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000136_source')" id="l_M000136_source">+</a> ]</p>
+  <div id="M000136_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/insert.rb, line 10</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">insert</span>(<span class="ruby-identifier">name</span>, <span class="ruby-identifier">value</span>)
@@ -877,11 +1061,11 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000099"></a><b>inverse</b>()
+    <a name="M000131"></a><b>inverse</b>()
   </div>
   <div class="description">
   <p>
-Create a &quot;true&quot; <a href="Hash.html#M000099">inverse</a> hash by
+Create a &quot;true&quot; <a href="Hash.html#M000131">inverse</a> hash by
 storing mutliple values in Arrays.
 </p>
 <pre>
@@ -897,8 +1081,8 @@ CREDIT: Tilo Sloboda
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000099_source')" id="l_M000099_source">+</a> ]</p>
-  <div id="M000099_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000131_source')" id="l_M000131_source">+</a> ]</p>
+  <div id="M000131_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/inverse.rb, line 14</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">inverse</span>
@@ -918,7 +1102,7 @@ CREDIT: Tilo Sloboda
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000121"></a><b>join</b>(pair_divider='', elem_divider='')
+    <a name="M000153"></a><b>join</b>(pair_divider='', elem_divider='')
   </div>
   <div class="description">
   <p>
@@ -929,8 +1113,8 @@ CREDIT: Mauricio Fernandez
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000121_source')" id="l_M000121_source">+</a> ]</p>
-  <div id="M000121_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000153_source')" id="l_M000153_source">+</a> ]</p>
+  <div id="M000153_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/join.rb, line 7</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">join</span>(<span class="ruby-identifier">pair_divider</span>=<span class="ruby-value str">''</span>, <span class="ruby-identifier">elem_divider</span>=<span class="ruby-value str">''</span>)
@@ -944,7 +1128,7 @@ CREDIT: Mauricio Fernandez
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000087"></a><b>keys?</b>(*check_keys)
+    <a name="M000119"></a><b>keys?</b>(*check_keys)
   </div>
   <div class="description">
   <p>
@@ -954,7 +1138,7 @@ Alias for has_keys?
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000107"></a><b>mash!</b>(&amp;yld)
+    <a name="M000139"></a><b>mash!</b>(&amp;yld)
   </div>
   <div class="description">
   <p>
@@ -967,11 +1151,11 @@ In place version of mash.
   </div>
 <div class="aka">
   This method is also aliased as
-  <a href="Hash.html#M000108">graph!</a>
+  <a href="Hash.html#M000140">graph!</a>
 </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000107_source')" id="l_M000107_source">+</a> ]</p>
-  <div id="M000107_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000139_source')" id="l_M000139_source">+</a> ]</p>
+  <div id="M000139_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/mash.rb, line 10</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">mash!</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">yld</span>)
@@ -983,7 +1167,7 @@ In place version of mash.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000089"></a><b>only_keys?</b>(*check_keys)
+    <a name="M000121"></a><b>only_keys?</b>(*check_keys)
   </div>
   <div class="description">
   <p>
@@ -993,17 +1177,17 @@ Alias for has_only_keys?
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000100"></a><b>recursive_merge</b>(other)
+    <a name="M000132"></a><b>recursive_merge</b>(other)
   </div>
   <div class="description">
   <p>
-Same as Hash#merge but <a href="Hash.html#M000080">recursively</a> merges
+Same as Hash#merge but <a href="Hash.html#M000112">recursively</a> merges
 sub-hashes.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000100_source')" id="l_M000100_source">+</a> ]</p>
-  <div id="M000100_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000132_source')" id="l_M000132_source">+</a> ]</p>
+  <div id="M000132_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/recursive_merge.rb, line 5</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">recursive_merge</span>(<span class="ruby-identifier">other</span>)
@@ -1024,17 +1208,17 @@ sub-hashes.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000101"></a><b>recursive_merge!</b>(other)
+    <a name="M000133"></a><b>recursive_merge!</b>(other)
   </div>
   <div class="description">
   <p>
-Same as Hash#merge! but <a href="Hash.html#M000080">recursively</a> merges
+Same as Hash#merge! but <a href="Hash.html#M000112">recursively</a> merges
 sub-hashes.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000101_source')" id="l_M000101_source">+</a> ]</p>
-  <div id="M000101_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000133_source')" id="l_M000133_source">+</a> ]</p>
+  <div id="M000133_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/recursive_merge.rb, line 20</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">recursive_merge!</span>(<span class="ruby-identifier">other</span>)
@@ -1054,11 +1238,11 @@ sub-hashes.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000080"></a><b>recursively</b>() {|h| ...}
+    <a name="M000112"></a><b>recursively</b>() {|h| ...}
   </div>
   <div class="description">
   <p>
-Apply a block to hash, and <a href="Hash.html#M000080">recursively</a>
+Apply a block to hash, and <a href="Hash.html#M000112">recursively</a>
 apply that block to each subhash.
 </p>
 <pre>
@@ -1068,8 +1252,8 @@ apply that block to each subhash.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000080_source')" id="l_M000080_source">+</a> ]</p>
-  <div id="M000080_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000112_source')" id="l_M000112_source">+</a> ]</p>
+  <div id="M000112_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/recursively.rb, line 10</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">recursively</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
@@ -1089,11 +1273,11 @@ apply that block to each subhash.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000081"></a><b>recursively!</b>(&amp;block)
+    <a name="M000113"></a><b>recursively!</b>(&amp;block)
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000081_source')" id="l_M000081_source">+</a> ]</p>
-  <div id="M000081_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000113_source')" id="l_M000113_source">+</a> ]</p>
+  <div id="M000113_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/recursively.rb, line 24</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">recursively!</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
@@ -1105,7 +1289,7 @@ apply that block to each subhash.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000126"></a><b>rekey</b>(*args, &amp;block)
+    <a name="M000159"></a><b>rekey</b>(*args, &amp;block)
   </div>
   <div class="description">
   <p>
@@ -1144,8 +1328,8 @@ CREDIT: Trans, Gavin Kistner
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000126_source')" id="l_M000126_source">+</a> ]</p>
-  <div id="M000126_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000159_source')" id="l_M000159_source">+</a> ]</p>
+  <div id="M000159_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/rekey.rb, line 32</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">rekey</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
@@ -1157,11 +1341,11 @@ CREDIT: Trans, Gavin Kistner
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000127"></a><b>rekey!</b>(*args, &amp;block)
+    <a name="M000160"></a><b>rekey!</b>(*args, &amp;block)
   </div>
   <div class="description">
   <p>
-Synonym for <a href="Hash.html#M000126">Hash#rekey</a>, but modifies the
+Synonym for <a href="Hash.html#M000159">Hash#rekey</a>, but modifies the
 receiver in place (and returns it).
 </p>
 <pre>
@@ -1174,8 +1358,8 @@ CREDIT: Trans, Gavin Kistner
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000127_source')" id="l_M000127_source">+</a> ]</p>
-  <div id="M000127_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000160_source')" id="l_M000160_source">+</a> ]</p>
+  <div id="M000160_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/rekey.rb, line 44</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">rekey!</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
@@ -1201,11 +1385,11 @@ CREDIT: Trans, Gavin Kistner
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000122"></a><b>replace_each</b>( {|| ...}
+    <a name="M000155"></a><b>replace_each</b>( {|| ...}
   </div>
   <div class="description">
   <p>
-Same as <a href="Hash.html#M000128">update_each</a>, but deletes the key
+Same as <a href="Hash.html#M000161">update_each</a>, but deletes the key
 element first.
 </p>
 <p>
@@ -1213,8 +1397,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000122_source')" id="l_M000122_source">+</a> ]</p>
-  <div id="M000122_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000155_source')" id="l_M000155_source">+</a> ]</p>
+  <div id="M000155_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/replace_each.rb, line 7</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">replace_each</span>  <span class="ruby-comment cmt"># :yield:</span>
@@ -1230,7 +1414,7 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000091"></a><b>reverse_merge</b>(other)
+    <a name="M000123"></a><b>reverse_merge</b>(other)
   </div>
   <div class="description">
   <p>
@@ -1249,8 +1433,8 @@ in doesn&#8216;t already have those keys set.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000091_source')" id="l_M000091_source">+</a> ]</p>
-  <div id="M000091_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000123_source')" id="l_M000123_source">+</a> ]</p>
+  <div id="M000123_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/merge.rb, line 15</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">reverse_merge</span>(<span class="ruby-identifier">other</span>)
@@ -1262,20 +1446,20 @@ in doesn&#8216;t already have those keys set.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000092"></a><b>reverse_merge!</b>(other)
+    <a name="M000124"></a><b>reverse_merge!</b>(other)
   </div>
   <div class="description">
   <p>
-Inplace form of <a href="Hash.html#M000091">reverse_merge</a>.
+Inplace form of <a href="Hash.html#M000123">reverse_merge</a>.
 </p>
   </div>
 <div class="aka">
   This method is also aliased as
-  <a href="Hash.html#M000093">reverse_update</a>
+  <a href="Hash.html#M000125">reverse_update</a>
 </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000092_source')" id="l_M000092_source">+</a> ]</p>
-  <div id="M000092_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000124_source')" id="l_M000124_source">+</a> ]</p>
+  <div id="M000124_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/merge.rb, line 21</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">reverse_merge!</span>(<span class="ruby-identifier">other</span>)
@@ -1287,17 +1471,17 @@ Inplace form of <a href="Hash.html#M000091">reverse_merge</a>.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000093"></a><b>reverse_update</b>(other)
+    <a name="M000125"></a><b>reverse_update</b>(other)
   </div>
   <div class="description">
   <p>
-Alias for <a href="Hash.html#M000091">reverse_merge</a>!
+Alias for <a href="Hash.html#M000123">reverse_merge</a>!
 </p>
   </div>
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000105"></a><b>select!</b>() {|k,v| ...}
+    <a name="M000137"></a><b>select!</b>() {|k,v| ...}
   </div>
   <div class="description">
   <p>
@@ -1308,8 +1492,8 @@ CREDIT: Gavin Sinclair, Noah Gibbs
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000105_source')" id="l_M000105_source">+</a> ]</p>
-  <div id="M000105_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000137_source')" id="l_M000137_source">+</a> ]</p>
+  <div id="M000137_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/select.rb, line 8</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">select!</span>
@@ -1321,7 +1505,7 @@ CREDIT: Gavin Sinclair, Noah Gibbs
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000123"></a><b>slice</b>(*keep_keys)
+    <a name="M000156"></a><b>slice</b>(*keep_keys)
   </div>
   <div class="description">
   <p>
@@ -1329,8 +1513,8 @@ Returns a new hash with only the given keys.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000123_source')" id="l_M000123_source">+</a> ]</p>
-  <div id="M000123_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000156_source')" id="l_M000156_source">+</a> ]</p>
+  <div id="M000156_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/slice.rb, line 9</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">slice</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">keep_keys</span>)
@@ -1346,7 +1530,7 @@ Returns a new hash with only the given keys.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000124"></a><b>slice!</b>(*keep_keys)
+    <a name="M000157"></a><b>slice!</b>(*keep_keys)
   </div>
   <div class="description">
   <p>
@@ -1360,8 +1544,8 @@ hash of keys removed.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000124_source')" id="l_M000124_source">+</a> ]</p>
-  <div id="M000124_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000157_source')" id="l_M000157_source">+</a> ]</p>
+  <div id="M000157_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/slice.rb, line 24</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">slice!</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">keep_keys</span>)
@@ -1375,7 +1559,7 @@ hash of keys removed.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000119"></a><b>stringify_keys</b>(&amp;filter)
+    <a name="M000151"></a><b>stringify_keys</b>(&amp;filter)
   </div>
   <div class="description">
   <p>
@@ -1390,12 +1574,12 @@ limits conversion to only a certain selection of keys.
 </pre>
 <p>
 This method is considered archaic. Use <a
-href="Hash.html#M000126">rekey</a> instead.
+href="Hash.html#M000159">rekey</a> instead.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000119_source')" id="l_M000119_source">+</a> ]</p>
-  <div id="M000119_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000151_source')" id="l_M000151_source">+</a> ]</p>
+  <div id="M000151_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/symbolize_keys.rb, line 54</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">stringify_keys</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">filter</span>)
@@ -1411,11 +1595,11 @@ href="Hash.html#M000126">rekey</a> instead.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000120"></a><b>stringify_keys!</b>(&amp;filter)
+    <a name="M000152"></a><b>stringify_keys!</b>(&amp;filter)
   </div>
   <div class="description">
   <p>
-Synonym for <a href="Hash.html#M000119">Hash#stringify_keys</a>, but
+Synonym for <a href="Hash.html#M000151">Hash#stringify_keys</a>, but
 modifies the receiver in place and returns it. With a <tt>filter</tt>
 parameter, limits conversion to only a certain selection of keys.
 </p>
@@ -1426,12 +1610,12 @@ parameter, limits conversion to only a certain selection of keys.
 </pre>
 <p>
 This method is considered archaic. Use <a
-href="Hash.html#M000126">rekey</a> instead.
+href="Hash.html#M000159">rekey</a> instead.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000120_source')" id="l_M000120_source">+</a> ]</p>
-  <div id="M000120_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000152_source')" id="l_M000152_source">+</a> ]</p>
+  <div id="M000152_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/symbolize_keys.rb, line 73</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">stringify_keys!</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">filter</span>)
@@ -1447,7 +1631,7 @@ href="Hash.html#M000126">rekey</a> instead.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000115"></a><b>swap!</b>(key1, key2)
+    <a name="M000147"></a><b>swap!</b>(key1, key2)
   </div>
   <div class="description">
   <p>
@@ -1461,8 +1645,8 @@ CREDIT: Gavin Sinclair
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000115_source')" id="l_M000115_source">+</a> ]</p>
-  <div id="M000115_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000147_source')" id="l_M000147_source">+</a> ]</p>
+  <div id="M000147_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/swap.rb, line 9</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">swap!</span>(<span class="ruby-identifier">key1</span>, <span class="ruby-identifier">key2</span>)
@@ -1477,7 +1661,7 @@ CREDIT: Gavin Sinclair
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000117"></a><b>symbolize_keys</b>(&amp;filter)
+    <a name="M000149"></a><b>symbolize_keys</b>(&amp;filter)
   </div>
   <div class="description">
   <p>
@@ -1492,12 +1676,12 @@ conversion to only a certain selection of keys.
 </pre>
 <p>
 This method is considered archaic. Use <a
-href="Hash.html#M000126">rekey</a> instead.
+href="Hash.html#M000159">rekey</a> instead.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000117_source')" id="l_M000117_source">+</a> ]</p>
-  <div id="M000117_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000149_source')" id="l_M000149_source">+</a> ]</p>
+  <div id="M000149_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/symbolize_keys.rb, line 20</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">symbolize_keys</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">filter</span>)
@@ -1513,11 +1697,11 @@ href="Hash.html#M000126">rekey</a> instead.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000118"></a><b>symbolize_keys!</b>(&amp;filter)
+    <a name="M000150"></a><b>symbolize_keys!</b>(&amp;filter)
   </div>
   <div class="description">
   <p>
-Synonym for <a href="Hash.html#M000117">Hash#symbolize_keys</a>, but
+Synonym for <a href="Hash.html#M000149">Hash#symbolize_keys</a>, but
 modifies the receiver in place and returns it. With a <tt>filter</tt>
 parameter, limits conversion to only a certain selection of keys.
 </p>
@@ -1528,12 +1712,12 @@ parameter, limits conversion to only a certain selection of keys.
 </pre>
 <p>
 This method is considered archaic. Use <a
-href="Hash.html#M000126">rekey</a> instead.
+href="Hash.html#M000159">rekey</a> instead.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000118_source')" id="l_M000118_source">+</a> ]</p>
-  <div id="M000118_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000150_source')" id="l_M000150_source">+</a> ]</p>
+  <div id="M000150_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/symbolize_keys.rb, line 37</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">symbolize_keys!</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">filter</span>)
@@ -1549,7 +1733,7 @@ href="Hash.html#M000126">rekey</a> instead.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000075"></a><b>to_h</b>()
+    <a name="M000106"></a><b>to_h</b>()
   </div>
   <div class="description">
   <p>
@@ -1563,10 +1747,10 @@ CREDIT: Forian Gross
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000075_source')" id="l_M000075_source">+</a> ]</p>
-  <div id="M000075_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000106_source')" id="l_M000106_source">+</a> ]</p>
+  <div id="M000106_source" class="dyn-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/core/facets/to_hash.rb, line 54</span>
+<span class="ruby-comment cmt"># File lib/core/facets/to_hash.rb, line 254</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_h</span>; <span class="ruby-identifier">rehash</span>; <span class="ruby-keyword kw">end</span>
 </pre>
   </div>
@@ -1574,7 +1758,7 @@ CREDIT: Forian Gross
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000102"></a><b>to_proc</b>()
+    <a name="M000134"></a><b>to_proc</b>()
   </div>
   <div class="description">
   <p>
@@ -1594,8 +1778,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000102_source')" id="l_M000102_source">+</a> ]</p>
-  <div id="M000102_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000134_source')" id="l_M000134_source">+</a> ]</p>
+  <div id="M000134_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/to_proc.rb, line 15</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_proc</span>
@@ -1612,14 +1796,14 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000103"></a><b>to_proc_with_reponse</b>()
+    <a name="M000135"></a><b>to_proc_with_reponse</b>()
   </div>
   <div class="description">
   <p>
-A fault-tolerent version of <a href="Hash.html#M000102">to_proc</a>.
+A fault-tolerent version of <a href="Hash.html#M000134">to_proc</a>.
 </p>
 <p>
-It works just like <a href="Hash.html#M000102">to_proc</a>, but the block
+It works just like <a href="Hash.html#M000134">to_proc</a>, but the block
 will make sure# the object responds to the assignment.
 </p>
 <p>
@@ -1627,8 +1811,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000103_source')" id="l_M000103_source">+</a> ]</p>
-  <div id="M000103_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000135_source')" id="l_M000135_source">+</a> ]</p>
+  <div id="M000135_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/to_proc.rb, line 31</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_proc_with_reponse</span>
@@ -1645,7 +1829,7 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000116"></a><b>to_struct</b>(struct_name)
+    <a name="M000148"></a><b>to_struct</b>(struct_name)
   </div>
   <div class="description">
   <p>
@@ -1664,8 +1848,8 @@ CREDIT: Daniel Berger
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000116_source')" id="l_M000116_source">+</a> ]</p>
-  <div id="M000116_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000148_source')" id="l_M000148_source">+</a> ]</p>
+  <div id="M000148_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/to_struct.rb, line 12</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_struct</span>(<span class="ruby-identifier">struct_name</span>)
@@ -1677,7 +1861,7 @@ CREDIT: Daniel Berger
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000094"></a><b>traverse</b>(&amp;b)
+    <a name="M000126"></a><b>traverse</b>(&amp;b)
   </div>
   <div class="description">
   <p>
@@ -1705,8 +1889,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000094_source')" id="l_M000094_source">+</a> ]</p>
-  <div id="M000094_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000126_source')" id="l_M000126_source">+</a> ]</p>
+  <div id="M000126_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/traverse.rb, line 18</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">traverse</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">b</span>)
@@ -1723,11 +1907,11 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000095"></a><b>traverse!</b>(&amp;b)
+    <a name="M000127"></a><b>traverse!</b>(&amp;b)
   </div>
   <div class="description">
   <p>
-In place version of <a href="Hash.html#M000094">traverse</a>, which
+In place version of <a href="Hash.html#M000126">traverse</a>, which
 traverses the hash and its subhashes, executing the given block on the key
 and value.
 </p>
@@ -1741,8 +1925,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000095_source')" id="l_M000095_source">+</a> ]</p>
-  <div id="M000095_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000127_source')" id="l_M000127_source">+</a> ]</p>
+  <div id="M000127_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/traverse.rb, line 36</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">traverse!</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">b</span>)
@@ -1754,13 +1938,13 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000128"></a><b>update_each</b>( {|| ...}
+    <a name="M000161"></a><b>update_each</b>( {|| ...}
   </div>
   <div class="description">
   <p>
 Iterates through each pair and updates a the hash in place. This is
 formally equivalent to mash! But does not use mash to accomplish the task.
-Hence <a href="Hash.html#M000128">update_each</a> is probably a touch
+Hence <a href="Hash.html#M000161">update_each</a> is probably a touch
 faster.
 </p>
 <p>
@@ -1768,8 +1952,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000128_source')" id="l_M000128_source">+</a> ]</p>
-  <div id="M000128_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000161_source')" id="l_M000161_source">+</a> ]</p>
+  <div id="M000161_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/update_each.rb, line 10</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">update_each</span>  <span class="ruby-comment cmt"># :yield:</span>
@@ -1784,7 +1968,7 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000129"></a><b>update_keys</b>( {|| ...}
+    <a name="M000162"></a><b>update_keys</b>( {|| ...}
   </div>
   <div class="description">
   <p>
@@ -1800,8 +1984,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000129_source')" id="l_M000129_source">+</a> ]</p>
-  <div id="M000129_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000162_source')" id="l_M000162_source">+</a> ]</p>
+  <div id="M000162_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/update_keys.rb, line 11</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">update_keys</span> <span class="ruby-comment cmt">#:yield:</span>
@@ -1817,7 +2001,7 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000077"></a><b>update_values</b>( {|| ...}
+    <a name="M000109"></a><b>update_values</b>( {|| ...}
   </div>
   <div class="description">
   <p>
@@ -1833,8 +2017,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000077_source')" id="l_M000077_source">+</a> ]</p>
-  <div id="M000077_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000109_source')" id="l_M000109_source">+</a> ]</p>
+  <div id="M000109_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/update_values.rb, line 11</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">update_values</span> <span class="ruby-comment cmt">#:yield:</span>
@@ -1850,7 +2034,7 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000114"></a><b>weave</b>(h)
+    <a name="M000146"></a><b>weave</b>(h)
   </div>
   <div class="description">
   <p>
@@ -1897,8 +2081,8 @@ CREDIT: Thomas Sawyer
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000114_source')" id="l_M000114_source">+</a> ]</p>
-  <div id="M000114_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000146_source')" id="l_M000146_source">+</a> ]</p>
+  <div id="M000146_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/weave.rb, line 40</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">weave</span>(<span class="ruby-identifier">h</span>)
@@ -1947,19 +2131,19 @@ CREDIT: Thomas Sawyer
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000096"></a><b>|</b>(other)
+    <a name="M000128"></a><b>|</b>(other)
   </div>
   <div class="description">
   <p>
-Operator for <a href="Hash.html#M000091">reverse_merge</a>.
+Operator for <a href="Hash.html#M000123">reverse_merge</a>.
 </p>
 <p>
 CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000096_source')" id="l_M000096_source">+</a> ]</p>
-  <div id="M000096_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000128_source')" id="l_M000128_source">+</a> ]</p>
+  <div id="M000128_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/hash/op_or.rb, line 7</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-operator">|</span>(<span class="ruby-identifier">other</span>)