facets 2.4.3 → 2.4.4

data/METADATA

@@ -1,6 +1,6 @@
 ---
 project  : facets
-version  : 2.4.3
+version  : 2.4.4
 released : 2008-08-14
 
 title     : Facets

data/NEWS

@@ -1,60 +1,40 @@
 = Release Notes
 
-Facets 2.4.3 is now out in the wild. The release is primarily a maintenance
-release --fixing a handful of small bugs and adding some small feature
-improvements, but a few significant changes are also present. Here's
-an overview:
-
-== Major Changes
-
-* Changed File#rewrite to not use the in-place change of the string.
-* Deprecate Hash#keys_to_s and Hash#keys_to_sym.
-* Renamed Class#to_pathname and #to_methodname to #pathize and #methodize.
-* Deprecated Console:: namespace for ANSICode.
-* Added Time#trunc and Time#round to Core.
-* Added Ken Bloom's DictionaryMatcher class (will be renamed in future version)
-* Added Array#recursively and fixed bug in Hash#recursively.
-* Added kernel/instance method which provides a fluent interface to private object space.
-* Moved Mentalguy's lazy.rb to core!
-* Added Indexable and Stackable to core.
-* Deprecated ruby.rb, which was a sort 1.9 compatibility layer.
-* The ruby.rb methods were moved to core, wrapped in a 1.9 condition.
-
-== Minor Changes
-
-* Fixed Time#hence changed years when changing months.
-* Fixed Time#hence to flip year correctly when adding months.
-* Added optional argument to Dictionary#first and #last.
-* Improved File#rootname --it is now more robust.
-* Made FileUtils#whereis a module_function again.
-* Although not perceptible to the end user, there are now three divisions lib/core, lib/lore, lib/more.
-* Created Lore library to house extensions to Ruby's standard library.
-
-Note that this release does not include a setup.rb script. We are working
-on a new version of this script, which we plan to include in the next release.
-
-Special thanks to:
-
-* Ken Bloom
-* Nick Caruso
-* Evgeniy Dolzhenko
-* Andy Freeman
-* Tomasz Muras
-* Dave Myron
-
-And of course, to anyone else I failed to mention that has contributed.
-
-As a REMINDER, Facets 2.4+ now encourages:
-
-  require 'facets'
-
-This is better than cherry-picking methods. It may seem counter-intuitive,
-but it actually proves more advantages to do this for the sake of
-improved interoperability. The practice of cherry-picking can become 
-problematic if other dependent libraries have cherry-picked different
-methods. In those cases these distinctions go unaccounted and untested.
-
-Facets is almost fully interoperable with ActiveSupport and Ruby 1.9.
-We will continue to improve this interoperability in upcoming releases.
-
+Facets 2.4.4 includes a major bug fix that caused Facets not to load properly,
+having to do with a Time extension. The problem has been fixed. In addition,
+this release put Facets only a few pending adjustments away from full
+Rails/ActiveSupport compatibility.
+
+
+### Mon Sep 01 23:40:19 -0400 2008
+
+* 7 Major Enhancements
+
+    * Added string/mask providing powerful string manipulation.  (#997)
+    * BasicObject is now just a synonm for BlankSlate unless Ruby 1.9.  (#1000)
+    * Added Symbol#plain?, Symbol#query? and Symbol#setter?  (#1011)
+    * Removed Time#to_date. 
+      * Due to clobberd RI Docs (!) this should have been in Lore lib date.rb
+      * Moved to Lore date.rb. (#1012)
+    * Re-added date.rb to lore library, and removed from core.  (#1014)
+    * Much improved date.rb extension now in Lore library.  (#1027)
+    * Deprecated kernel/suppress. Use Exception.suppress from now on.  (#1040)
+
+* 8 Minor Enhancements
+
+    * Moved style.rb to string/stylize.rb  (#998)
+    * Renamed string/subtract to string/op_sub. 
+      Old name will remain for time being for compatability. (#1002)
+    * Module#instance_method_define? now only applies to public methods.  (#1003)
+    * Array#index accepts a block (one of the few core overrides).  (#1004)
+    * Moved Hash#<< from hash/update.rb to hash/op_push.rb  (#1005)
+    * Add facets class files (eg. facets/string) have been made dynamic.  (#1013)
+    * Moved variablize methods out of metaid.rb and into separate files (string/ and symbol/).  (#1042)
+    * Added Time#advance.  (#1046)
+
+* 3 Bug Fixes
+
+    * Hash#<< now return self  (#1001)
+    * OpenStruct#to_h dups internal table.  (#1015)
+    * Fixed require of string/xor in bicrypt.rb.  (#1039)
 

data/demo/bench/bench_load.rb

@@ -0,0 +1,56 @@
+require 'benchmark'
+
+# Load check all libs.
+
+def test_load
+
+  while !File.directory?('lib/core/facets') do
+    Dir.chdir('..')
+  end
+
+  abort "Can't find project root." unless File.directory?('lib/core/facets')
+
+  @scripts = {}
+
+  Dir.chdir('lib/core') do
+    @scripts[:core] = Dir.glob('facets/*.rb')
+    @scripts[:core].uniq!
+  end
+
+  Dir.chdir('lib/lore') do
+    @scripts[:lore] = Dir.glob('facets/*.rb')
+    @scripts[:lore].uniq!
+  end
+
+  Dir.chdir('lib/more') do
+    @scripts[:more] = Dir.glob('facets/*.rb')
+    @scripts[:more].uniq!
+  end
+
+  $:.unshift('lib/core')
+  $:.unshift('lib/lore')
+  $:.unshift('lib/more')
+
+  $VERBOSE = nil
+
+  Benchmark.bm do |x|
+    x.report("core"){ require_scripts(:core) }
+    x.report("lore"){ require_scripts(:lore) }
+    x.report("more"){ require_scripts(:more) }
+  end
+end
+
+def require_scripts(key)
+  @scripts[key].each do |file|
+    begin
+      require file
+    rescue Exception => e
+      puts file
+      puts e.message
+    end
+  end
+end
+
+if $0 == __FILE__
+  test_load
+end

data/doc/news/news-2.0.5

@@ -0,0 +1,8 @@
+== 2.0.5 / 2007-11-07
+
+* Added final methods Gavin Sinclair's Extensions project (contributed by Noah Gibbs).
+* Fixes bug with Dictionary#initialize
+* Fixes bug with Hash#-
+* Also improves changelog production.
+* Made #alias_method_chain compatible with current ActiveSupport version.
+

data/doc/news/news-2.1.0

@@ -0,0 +1,9 @@
+== 2.1.0 / 2007-11-10
+
+* command.rb has been completely rewritten. The API has changed completely!
+* There is no longer a Commmand::Optoins class. Use Console::Arguments instead.
+* Added BiCrypt class to crypt.rb for simple two-way encyrption.
+* module/attr.rb now has attr_reader!, attr_writer! and attr_accessor!
+* All attr_xxx methods have coresponding alias_xxx methods.
+* Fixed bug in Enumerable#cluster_by which returned nil instead of [].
+

data/doc/news/news-2.1.1

@@ -0,0 +1,5 @@
+== 2.1.1 / 2007-11-16
+
+* Fixed bug in command.rb that clobbered options.
+* Added kernel/ergo.rb.
+

data/doc/news/news-2.1.2

@@ -0,0 +1,6 @@
+== 2.1.2 / 2007-11-22
+
+* Dir::multiglob no longer handels -/+ modifiers. Use FileList instead.
+* Fixed task/install script.
+* Improved task/changes.
+

data/doc/news/news-2.1.3

@@ -0,0 +1,5 @@
+== 2.1.3 / 2007-11-28
+
+* Fixed minor oddity in Enumerable/collate.
+* Fixed major issue with 2.1.2 where it would not core facets correctly.
+

data/doc/news/news-2.2.0

@@ -0,0 +1,14 @@
+== 2.2.0 / 2007-12-13
+
+* A lot of rdoc updates to core extensions --as promised ;)
+* Just about every method now has at least a brief explinaiton and an example.
+* integer/bitmask.rb has changed a bit --pun intended ;) Deprecated some methods and now use "~" instead of "-" to clear bits.
+* The name Array#unzip didn't makes sense, it was renamed to #modulate (though #collate seems better?)
+* Renamed Enumerable#collate to #mash (Map hASH); #collate and #graph remain aliases for the time being.
+* Deprecated Module#include_and_extend. Just use both silly.
+* More lib pp_s.rb has been removed. Use #pretty_inspect instead.
+* Split binding extensions up a bit more finely --eval.rb sprouted here.rb, self.rb and defined.rb.
+* Move Time#stamp out of conversion.rb and into time/ dir, and remove to_s alias.
+* Preliminary addition of Matthew Harris' excellent duration.rb lib (will integrate with times.rb better in future).
+* Added if clauses to handle upcoming Ruby 1.9 gracefully. Facets should now be just about ready for use with 1.9.
+

data/doc/news/news-2.2.1

@@ -0,0 +1,4 @@
+== 2.2.1 / 2007-12-22
+
+* Got rid of methods subdir. All method redirects are in core/.
+

data/doc/news/news-2.3.0

@@ -0,0 +1,6 @@
+== 2.3.0 / 2008-02-01
+
+* Reorganized library into smaller groups: core, more, class and mixin.
+* Added tracepoint.rb back to the library.
+* Fixed multiglob_r bug, so it will NOT follow symlinks.
+

data/doc/news/{NEWS-2.4.0 → news-2.4.0}

@@ -30,7 +30,7 @@ has been improved. In addition, we are getting very close to full
 ActiveSupport, and Ruby 1.9, interoperability. Expect this
 to be complete in the next minor release or two.
 
-= Previous Notes
+== Previously
 
 (2.3.0) Amoung other changes with this release, cloneable.rb is
 now a true deep dup/clone mixin; tracepoint.rb returns
@@ -50,3 +50,21 @@ as well as attr_reader!, attr_writer! and attr_accessor!
 for flag attributes, plus alias_xxx methods for all
 attr_xxx methods.
 
+
+### CHANGELOG 2.4.0 / 2008-03-24
+
+* String#to_re and String#to_rx have swapped default behaviors. #to_rx escapes, #to_re does not.
+* The Console namespace is being deprecated. command.rb and arguments.rb now use CLI naemspace.
+* #compare_on and #equate_on are now "mixin methods" Comparable() and Equateable().
+* Enumerable#product, #combintations and #permutations have change to be Ruby 1.9 compatible.
+* thread.rb, map_send, et al, block is passed to send instead of yielding on result.
+* namespace.rb has been renamed to methodspace.rb.
+* Ruby 1.9 defined a new Proc#curry method, so Facets version has been made compatible.
+* The old curry method is now called #partial, as in "partial application".
+* Deprecated interface.rb. Perhaps a better approach but nonetheless extraneous.
+* Deprecated paramix.rb. A better way is to use a capitialized methods. (Perhaps a lib for that?)
+* Brought back a few web related libs, htmlfilter.rb and cssfilter.rb in particular.
+* camelcase and snakecase are core extensions. For specialized styles use String#style in style.rb.
+* This was a fairly large and fast-paced update, so unfortunately not all changes are listed this time.
+
+

data/doc/news/news-2.4.1

@@ -0,0 +1,8 @@
+== 2.4.1 / 2008-04-03
+
+* Comparing to ActiveSupport, found 63 extension clashes, but most are due to 1.9 features and the rest should be compatible.
+* A much improved paramix.rb has been returned to the library; but please note it's not quite finished yet.
+* Reatomized a number of Kernel and String methods. Reatomization is nearly complete.
+* Deprecated behavior.rb. It was not robust.
+* Added basex.rb, library for working in any encoding base using any character set (base62 is the default).
+

data/doc/news/news-2.4.2

@@ -0,0 +1,4 @@
+== 2.4.2 / 2008-08-12
+
+* See 2.4.3. This was just a test release that was available for only one day.
+

data/doc/news/news-2.4.3

@@ -0,0 +1,78 @@
+= Release Notes -- 2.4.3
+
+== Major Changes
+
+* Changed File#rewrite to not use the in-place change of the string.
+* Deprecate Hash#keys_to_s and Hash#keys_to_sym.
+* Renamed Class#to_pathname and #to_methodname to #pathize and #methodize.
+* Deprecated Console:: namespace for ANSICode.
+* Added Time#trunc and Time#round to Core.
+* Added Ken Bloom's DictionaryMatcher class (will be renamed in future version)
+* Added Array#recursively and fixed bug in Hash#recursively.
+* Added kernel/instance method which provides a fluent interface to private object space.
+* Moved Mentalguy's lazy.rb to core!
+* Added Indexable and Stackable to core.
+* Deprecated ruby.rb, which was a sort 1.9 compatibility layer.
+* The ruby.rb methods were moved to core, wrapped in a 1.9 condition.
+
+== Minor Changes
+
+* Fixed Time#hence changed years when changing months.
+* Fixed Time#hence to flip year correctly when adding months.
+* Added optional argument to Dictionary#first and #last.
+* Improved File#rootname --it is now more robust.
+* Made FileUtils#whereis a module_function again.
+* Although not perceptible to the end user, there are now three divisions lib/core, lib/lore, lib/more.
+* Created Lore library to house extensions to Ruby's standard library.
+
+Note that this release does not include a setup.rb script. We are working
+on a new version of this script, which we plan to include in the next release.
+
+Special thanks to:
+
+* Ken Bloom
+* Nick Caruso
+* Evgeniy Dolzhenko
+* Andy Freeman
+* Tomasz Muras
+* Dave Myron
+
+And of course, to anyone else I failed to mention that has contributed.
+
+As a REMINDER, Facets 2.4+ now encourages:
+
+  require 'facets'
+
+This is better than cherry-picking methods. It may seem counter-intuitive,
+but it actually proves more advantages to do this for the sake of
+improved interoperability. The practice of cherry-picking can become 
+problematic if other dependent libraries have cherry-picked different
+methods. In those cases these distinctions go unaccounted and untested.
+
+Facets is almost fully interoperable with ActiveSupport and Ruby 1.9.
+We will continue to improve this interoperability in upcoming releases.
+
+
+### CHANGELOG 2.4.3 / 2008-08-14
+
+* Fixed Time#hence changed years when changing months.
+* Deprecate Hash#keys_to_s and Hash#keys_to_sym.
+* Renamed Class#to_pathname and #to_methodname to #pathize and #methodize.
+* Added Sting#pathize and String#methodize.
+* Deprecated Console:: namespace for ANSICode.
+* Added Time#trunc and Time#round to Core.
+* Added Ken Bloom's DictionaryMatcher class (will be renamed in future version)
+* IMPORTANT! Changed File#rewrite to not use the inplace change of the string.
+* Added Array#recursively and fixed bug in Hash#recursively.
+* Fixed Time#hence to flip year correctly when adding months.
+* Added optional argument to Dictionary#first and #last.
+* Added kernel/instance method which provides a fluent interface to private object space.
+* Moved Mentalguy's lazy.rb to core!
+* Added Stackable and Indexable to core.
+* Removed ruby.rb, which was a sort 1.9 compatibility lib. The methods are now in core.
+* Improved File#rootname --much more robust now.
+* Made FileUtils#whereis a module_function again.
+* Although not perceptable to the end user, there are now three libs (lib/core, lib/lore, lib/more).
+* Created Lore library to house extensions to Ruby's standard library.
+
+

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

@@ -69,22 +69,7 @@
 <a href="../files/lib/core/facets/array/traverse_rb.html">lib/core/facets/array/traverse.rb</a>
 <a href="../files/lib/core/facets/array/permutation_rb.html">lib/core/facets/array/permutation.rb</a>
 <a href="../files/lib/core/facets/array/select_rb.html">lib/core/facets/array/select.rb</a>
-<a href="../files/lib/core/facets/array/only_rb.html">lib/core/facets/array/only.rb</a>
-<a href="../files/lib/core/facets/array/delete_rb.html">lib/core/facets/array/delete.rb</a>
-<a href="../files/lib/core/facets/array/combination_rb.html">lib/core/facets/array/combination.rb</a>
-<a href="../files/lib/core/facets/array/splice_rb.html">lib/core/facets/array/splice.rb</a>
-<a href="../files/lib/core/facets/array/stackable_rb.html">lib/core/facets/array/stackable.rb</a>
-<a href="../files/lib/core/facets/array/pad_rb.html">lib/core/facets/array/pad.rb</a>
-<a href="../files/lib/core/facets/array/product_rb.html">lib/core/facets/array/product.rb</a>
-<a href="../files/lib/core/facets/array/recursively_rb.html">lib/core/facets/array/recursively.rb</a>
-<a href="../files/lib/core/facets/array/not_empty_rb.html">lib/core/facets/array/not_empty.rb</a>
-<a href="../files/lib/core/facets/array/rotate_rb.html">lib/core/facets/array/rotate.rb</a>
-<a href="../files/lib/core/facets/array/conjoin_rb.html">lib/core/facets/array/conjoin.rb</a>
-<a href="../files/lib/core/facets/array/indexable_rb.html">lib/core/facets/array/indexable.rb</a>
-<a href="../files/lib/core/facets/array/merge_rb.html">lib/core/facets/array/merge.rb</a>
-<a href="../files/lib/core/facets/array/traverse_rb.html">lib/core/facets/array/traverse.rb</a>
-<a href="../files/lib/core/facets/array/permutation_rb.html">lib/core/facets/array/permutation.rb</a>
-<a href="../files/lib/core/facets/array/select_rb.html">lib/core/facets/array/select.rb</a>
+<a href="../files/lib/core/facets/array/index_rb.html">lib/core/facets/array/index.rb</a>
 <a href="../files/lib/core/facets/array/only_rb.html">lib/core/facets/array/only.rb</a>
 <a href="../files/lib/core/facets/array/delete_rb.html">lib/core/facets/array/delete.rb</a>
 <a href="../files/lib/core/facets/array/combination_rb.html">lib/core/facets/array/combination.rb</a>
@@ -116,58 +101,36 @@ Object
 
   <div class="sectiontitle">Methods</div>
   <ul>
-  <li><a href="#M000256">**</a></li>
-  <li><a href="#M000235">**</a></li>
-  <li><a href="#M000272">combination</a></li>
-  <li><a href="#M000251">combination</a></li>
-  <li><a href="#M000262">conjoin</a></li>
-  <li><a href="#M000241">conjoin</a></li>
-  <li><a href="#M000248">delete_unless</a></li>
-  <li><a href="#M000269">delete_unless</a></li>
-  <li><a href="#M000249">delete_values</a></li>
-  <li><a href="#M000270">delete_values</a></li>
-  <li><a href="#M000271">delete_values_at</a></li>
-  <li><a href="#M000250">delete_values_at</a></li>
-  <li><a href="#M000263">merge!</a></li>
-  <li><a href="#M000242">merge!</a></li>
-  <li><a href="#M000238">not_empty?</a></li>
-  <li><a href="#M000259">not_empty?</a></li>
-  <li><a href="#M000268">only</a></li>
-  <li><a href="#M000247">only</a></li>
-  <li><a href="#M000274">pad</a></li>
-  <li><a href="#M000253">pad</a></li>
-  <li><a href="#M000275">pad!</a></li>
-  <li><a href="#M000254">pad!</a></li>
-  <li><a href="#M000245">permutation</a></li>
-  <li><a href="#M000266">permutation</a></li>
-  <li><a href="#M000255">product</a></li>
-  <li><a href="#M000234">product</a></li>
-  <li><a href="#M000236">recursively</a></li>
-  <li><a href="#M000257">recursively</a></li>
-  <li><a href="#M000258">recursively!</a></li>
-  <li><a href="#M000237">recursively!</a></li>
-  <li><a href="#M000239">rotate</a></li>
-  <li><a href="#M000260">rotate</a></li>
-  <li><a href="#M000261">rotate!</a></li>
-  <li><a href="#M000240">rotate!</a></li>
-  <li><a href="#M000246">select!</a></li>
-  <li><a href="#M000267">select!</a></li>
-  <li><a href="#M000273">splice</a></li>
-  <li><a href="#M000252">splice</a></li>
-  <li><a href="#M000233">to_b</a></li>
-  <li><a href="#M000232">to_h</a></li>
-  <li><a href="#M000264">traverse</a></li>
-  <li><a href="#M000243">traverse</a></li>
-  <li><a href="#M000244">traverse!</a></li>
-  <li><a href="#M000265">traverse!</a></li>
+  <li><a href="#M000129">**</a></li>
+  <li><a href="#M000146">combination</a></li>
+  <li><a href="#M000135">conjoin</a></li>
+  <li><a href="#M000143">delete_unless</a></li>
+  <li><a href="#M000144">delete_values</a></li>
+  <li><a href="#M000145">delete_values_at</a></li>
+  <li><a href="#M000141">index</a></li>
+  <li><a href="#M000136">merge!</a></li>
+  <li><a href="#M000132">not_empty?</a></li>
+  <li><a href="#M000142">only</a></li>
+  <li><a href="#M000148">pad</a></li>
+  <li><a href="#M000149">pad!</a></li>
+  <li><a href="#M000139">permutation</a></li>
+  <li><a href="#M000128">product</a></li>
+  <li><a href="#M000130">recursively</a></li>
+  <li><a href="#M000131">recursively!</a></li>
+  <li><a href="#M000133">rotate</a></li>
+  <li><a href="#M000134">rotate!</a></li>
+  <li><a href="#M000140">select!</a></li>
+  <li><a href="#M000147">splice</a></li>
+  <li><a href="#M000127">to_b</a></li>
+  <li><a href="#M000126">to_h</a></li>
+  <li><a href="#M000137">traverse</a></li>
+  <li><a href="#M000138">traverse!</a></li>
   </ul>
 
 <div class="sectiontitle">Included Modules</div>
 <ul>
   <li><a href="Indexable.html">Indexable</a></li>
   <li><a href="Stackable.html">Stackable</a></li>
-  <li><a href="Indexable.html">Indexable</a></li>
-  <li><a href="Stackable.html">Stackable</a></li>
 </ul>
 
 
@@ -177,32 +140,22 @@ Object
 <div class="sectiontitle">Public Instance methods</div>
 <div class="method">
   <div class="title">
-    <a name="M000256"></a><b>**</b>(*enums, &amp;block)
-  </div>
-  <div class="description">
-  <p>
-Alias for <a href="Array.html#M000234">product</a>
-</p>
-  </div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000235"></a><b>**</b>(*enums, &amp;block)
+    <a name="M000129"></a><b>**</b>(*enums, &amp;block)
   </div>
   <div class="description">
   <p>
-Alias for <a href="Array.html#M000234">product</a>
+Alias for <a href="Array.html#M000128">product</a>
 </p>
   </div>
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000272"></a><b>combination</b>(k=2) {|s.values_at(*idx)| ...}
+    <a name="M000146"></a><b>combination</b>(k=2) {|s.values_at(*idx)| ...}
   </div>
   <div class="description">
   <p>
 Yields the block to each unique <a
-href="Array.html#M000251">combination</a> of <em>n</em> elements.
+href="Array.html#M000146">combination</a> of <em>n</em> elements.
 </p>
 <pre>
   a = %w|a b c d|
@@ -222,8 +175,8 @@ CREDIT: Florian Gross
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000272_source')" id="l_M000272_source">show source</a> ]</p>
-  <div id="M000272_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000146_source')" id="l_M000146_source">show source</a> ]</p>
+  <div id="M000146_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/array/combination.rb, line 21</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">combination</span>(<span class="ruby-identifier">k</span>=<span class="ruby-value">2</span>)
@@ -250,60 +203,7 @@ CREDIT: Florian Gross
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000251"></a><b>combination</b>(k=2) {|s.values_at(*idx)| ...}
-  </div>
-  <div class="description">
-  <p>
-Yields the block to each unique <a
-href="Array.html#M000251">combination</a> of <em>n</em> elements.
-</p>
-<pre>
-  a = %w|a b c d|
-  a.combination(3)
-</pre>
-<p>
-produces
-</p>
-<pre>
-  [[&quot;a&quot;, &quot;b&quot;, &quot;c&quot;],
-   [&quot;a&quot;, &quot;b&quot;, &quot;d&quot;],
-   [&quot;a&quot;, &quot;c&quot;, &quot;d&quot;],
-   [&quot;b&quot;, &quot;c&quot;, &quot;d&quot;]]
-</pre>
-<p>
-CREDIT: Florian Gross
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000251_source')" id="l_M000251_source">show source</a> ]</p>
-  <div id="M000251_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/combination.rb, line 21</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">combination</span>(<span class="ruby-identifier">k</span>=<span class="ruby-value">2</span>)
-      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">block_given?</span>
-        <span class="ruby-identifier">s</span> = <span class="ruby-identifier">to_a</span>
-        <span class="ruby-identifier">n</span> = <span class="ruby-identifier">s</span>.<span class="ruby-identifier">size</span>
-        <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">unless</span> (<span class="ruby-value">1</span><span class="ruby-operator">..</span><span class="ruby-identifier">n</span>) <span class="ruby-operator">===</span> <span class="ruby-identifier">k</span>
-        <span class="ruby-identifier">idx</span> = (<span class="ruby-value">0</span><span class="ruby-operator">...</span><span class="ruby-identifier">k</span>).<span class="ruby-identifier">to_a</span>
-        <span class="ruby-identifier">loop</span> <span class="ruby-keyword kw">do</span>
-          <span class="ruby-keyword kw">yield</span> <span class="ruby-identifier">s</span>.<span class="ruby-identifier">values_at</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">idx</span>)
-          <span class="ruby-identifier">i</span> = <span class="ruby-identifier">k</span> <span class="ruby-operator">-</span> <span class="ruby-value">1</span>
-          <span class="ruby-identifier">i</span> <span class="ruby-operator">-=</span> <span class="ruby-value">1</span> <span class="ruby-keyword kw">while</span> <span class="ruby-identifier">idx</span>[<span class="ruby-identifier">i</span>] <span class="ruby-operator">==</span> <span class="ruby-identifier">n</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">k</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">i</span>
-          <span class="ruby-keyword kw">break</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">i</span> <span class="ruby-operator">&lt;</span> <span class="ruby-value">0</span>
-          <span class="ruby-identifier">idx</span>[<span class="ruby-identifier">i</span>] <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
-          (<span class="ruby-identifier">i</span> <span class="ruby-operator">+</span> <span class="ruby-value">1</span> <span class="ruby-operator">...</span> <span class="ruby-identifier">k</span>).<span class="ruby-identifier">each</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">j</span><span class="ruby-operator">|</span> <span class="ruby-identifier">idx</span>[<span class="ruby-identifier">j</span>] = <span class="ruby-identifier">idx</span>[<span class="ruby-identifier">i</span>] <span class="ruby-operator">+</span> <span class="ruby-identifier">j</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">i</span>}
-        <span class="ruby-keyword kw">end</span>
-      <span class="ruby-keyword kw">else</span>
-        <span class="ruby-identifier">to_enum</span>(<span class="ruby-identifier">:combination</span>, <span class="ruby-identifier">k</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="M000262"></a><b>conjoin</b>(*args) {|i, *slice(i,2)| ...}
+    <a name="M000135"></a><b>conjoin</b>(*args) {|i, *slice(i,2)| ...}
   </div>
   <div class="description">
   <p>
@@ -338,8 +238,8 @@ no longer the case. You must specifically provide these parameters.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000262_source')" id="l_M000262_source">show source</a> ]</p>
-  <div id="M000262_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000135_source')" id="l_M000135_source">show source</a> ]</p>
+  <div id="M000135_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/array/conjoin.rb, line 30</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">conjoin</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
@@ -374,105 +274,7 @@ no longer the case. You must specifically provide these parameters.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000241"></a><b>conjoin</b>(*args) {|i, *slice(i,2)| ...}
-  </div>
-  <div class="description">
-  <p>
-This is more advnaced form of join. It allows for fine control of
-separators.
-</p>
-<p>
-NOTE: The old version used to default it&#8216;s separator to &quot;,
-&quot; and default the terminating separator to &quot; and &quot;. This is
-no longer the case. You must specifically provide these parameters.
-</p>
-<pre>
-  [1,2,3].conjoin
-  =&gt; &quot;123&quot;
-
-  [1,2,3].conjoin(', ', ' and ')
-  =&gt; &quot;1, 2 and 3
-
-  [1,2,3].conjoin(', ', :last =&gt; ' or ')
-  =&gt; &quot;1, 2 or 3
-
-  [1,2,3].conjoin('; ', -1 =&gt; ' &amp; ')
-  =&gt; &quot;1; 2 &amp; 3
-
-  [1,2,3,4].conjoin{ |i, a, b| i % 2 == 0 ? '.' : '-' }
-  =&gt; &quot;1.2-3.4&quot;
-
-  [1,1,2,2].conjoin{ |i, a, b| a == b ? '=' : '!=' }
-  =&gt; &quot;1=1!=2=2&quot;
-
- CREDIT: Trans
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000241_source')" id="l_M000241_source">show source</a> ]</p>
-  <div id="M000241_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/conjoin.rb, line 30</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">conjoin</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
-    <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">first</span>.<span class="ruby-identifier">to_s</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">size</span> <span class="ruby-operator">&lt;</span> <span class="ruby-value">2</span>
-
-    <span class="ruby-identifier">sep</span> = []
-
-    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">block_given?</span>
-      (<span class="ruby-identifier">size</span> <span class="ruby-operator">-</span> <span class="ruby-value">1</span>).<span class="ruby-identifier">times</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">i</span><span class="ruby-operator">|</span>
-        <span class="ruby-identifier">sep</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-keyword kw">yield</span>(<span class="ruby-identifier">i</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">slice</span>(<span class="ruby-identifier">i</span>,<span class="ruby-value">2</span>))
-      <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">else</span>
-      <span class="ruby-identifier">options</span>   = (<span class="ruby-constant">Hash</span><span class="ruby-operator">===</span><span class="ruby-identifier">args</span>.<span class="ruby-identifier">last</span>) <span class="ruby-operator">?</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">pop</span> <span class="ruby-operator">:</span> {}
-      <span class="ruby-identifier">separator</span> = <span class="ruby-identifier">args</span>.<span class="ruby-identifier">shift</span> <span class="ruby-operator">||</span> <span class="ruby-value str">&quot;&quot;</span>
-      <span class="ruby-identifier">options</span>[<span class="ruby-value">-1</span>] = <span class="ruby-identifier">args</span>.<span class="ruby-identifier">shift</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">empty?</span>
-
-      <span class="ruby-identifier">sep</span> = [<span class="ruby-identifier">separator</span>] <span class="ruby-operator">*</span> (<span class="ruby-identifier">size</span> <span class="ruby-operator">-</span> <span class="ruby-value">1</span>)
-
-      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">options</span>.<span class="ruby-identifier">key?</span>(<span class="ruby-identifier">:last</span>)
-        <span class="ruby-identifier">options</span>[<span class="ruby-value">-1</span>] = <span class="ruby-identifier">options</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">:last</span>)
-      <span class="ruby-keyword kw">end</span>
-
-      <span class="ruby-identifier">options</span>[<span class="ruby-value">-1</span>] <span class="ruby-operator">||=</span> <span class="ruby-value str">&quot; and &quot;</span>
-
-      <span class="ruby-identifier">options</span>.<span class="ruby-identifier">each</span>{<span class="ruby-operator">|</span><span class="ruby-identifier">i</span>, <span class="ruby-identifier">s</span><span class="ruby-operator">|</span> <span class="ruby-identifier">sep</span>[<span class="ruby-identifier">i</span>] = <span class="ruby-identifier">s</span>}
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-identifier">zip</span>(<span class="ruby-identifier">sep</span>).<span class="ruby-identifier">join</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000248"></a><b>delete_unless</b>(&amp;block)
-  </div>
-  <div class="description">
-  <p>
-Inverse of delete_if.
-</p>
-<pre>
-  [1,2,3].delete_unless{ |x| x &lt; 2 }
-  =&gt; [1,2]
-
- CREDIT: Daniel Schierbeck
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000248_source')" id="l_M000248_source">show source</a> ]</p>
-  <div id="M000248_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/delete.rb, line 10</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">delete_unless</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
-    <span class="ruby-identifier">delete_if</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">element</span><span class="ruby-operator">|</span> <span class="ruby-keyword kw">not</span> <span class="ruby-identifier">block</span>.<span class="ruby-identifier">call</span>(<span class="ruby-identifier">element</span>) }
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000269"></a><b>delete_unless</b>(&amp;block)
+    <a name="M000143"></a><b>delete_unless</b>(&amp;block)
   </div>
   <div class="description">
   <p>
@@ -486,8 +288,8 @@ Inverse of delete_if.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000269_source')" id="l_M000269_source">show source</a> ]</p>
-  <div id="M000269_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000143_source')" id="l_M000143_source">show source</a> ]</p>
+  <div id="M000143_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/array/delete.rb, line 10</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">delete_unless</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
@@ -499,38 +301,7 @@ Inverse of delete_if.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000249"></a><b>delete_values</b>(*values)
-  </div>
-  <div class="description">
-  <p>
-Delete multiple values from array.
-</p>
-<pre>
-  a = [1,2,3,4]
-  a.delete_values(1,2)   #=&gt; [1,2]
-  a                      #=&gt; [3,4]
-</pre>
-<p>
-CREDIT: Trans
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000249_source')" id="l_M000249_source">show source</a> ]</p>
-  <div id="M000249_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/delete.rb, line 22</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>)
-    <span class="ruby-identifier">d</span> = []
-    <span class="ruby-identifier">values</span>.<span class="ruby-identifier">each</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">v</span><span class="ruby-operator">|</span> <span class="ruby-identifier">d</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">delete</span>(<span class="ruby-identifier">v</span>) }
-    <span class="ruby-identifier">d</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000270"></a><b>delete_values</b>(*values)
+    <a name="M000144"></a><b>delete_values</b>(*values)
   </div>
   <div class="description">
   <p>
@@ -546,8 +317,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000270_source')" id="l_M000270_source">show source</a> ]</p>
-  <div id="M000270_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000144_source')" id="l_M000144_source">show source</a> ]</p>
+  <div id="M000144_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/array/delete.rb, line 22</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>)
@@ -561,11 +332,12 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000271"></a><b>delete_values_at</b>(*selectors)
+    <a name="M000145"></a><b>delete_values_at</b>(*selectors)
   </div>
   <div class="description">
   <p>
-Delete multiple values from array given indexes or index range.
+Delete multiple values from array given indexes or <a
+href="Array.html#M000141">index</a> range.
 </p>
 <pre>
   a = [1,2,3,4]
@@ -583,8 +355,8 @@ NOTE: It would be nice to see delete_at incorporate this funcitonaility.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000271_source')" id="l_M000271_source">show source</a> ]</p>
-  <div id="M000271_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000145_source')" id="l_M000145_source">show source</a> ]</p>
+  <div id="M000145_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/array/delete.rb, line 43</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">selectors</span>)
@@ -609,83 +381,33 @@ NOTE: It would be nice to see delete_at incorporate this funcitonaility.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000250"></a><b>delete_values_at</b>(*selectors)
+    <a name="M000141"></a><b>index</b>(obj=nil) {|self[i]| ...}
   </div>
   <div class="description">
   <p>
-Delete multiple values from array given indexes or index range.
+Allows <a href="Array.html#M000141">index</a> to accept a block.
 </p>
-<pre>
-  a = [1,2,3,4]
-  a.delete_values_at(1,2)   #=&gt; [2,3]
-  a                         #=&gt; [1,4]
-  a = [1,2,3,4]
-  a.delete_values_at(0..2)  #=&gt; [1,2,3]
-  a                         #=&gt; [4]
-</pre>
 <p>
-NOTE: It would be nice to see delete_at incorporate this funcitonaility.
-</p>
-<pre>
- CREDIT: Trans
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000250_source')" id="l_M000250_source">show source</a> ]</p>
-  <div id="M000250_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/delete.rb, line 43</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">selectors</span>)
-    <span class="ruby-identifier">idx</span> = []
-    <span class="ruby-identifier">selectors</span>.<span class="ruby-identifier">each</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">i</span><span class="ruby-operator">|</span>
-      <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">i</span>
-      <span class="ruby-keyword kw">when</span> <span class="ruby-constant">Range</span>
-        <span class="ruby-identifier">idx</span>.<span class="ruby-identifier">concat</span>( <span class="ruby-identifier">i</span>.<span class="ruby-identifier">to_a</span> )
-      <span class="ruby-keyword kw">else</span>
-        <span class="ruby-identifier">idx</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">i</span>.<span class="ruby-identifier">to_i</span>
-      <span class="ruby-keyword kw">end</span>
-    }
-    <span class="ruby-identifier">idx</span>.<span class="ruby-identifier">uniq!</span>
-    <span class="ruby-identifier">dvals</span> = <span class="ruby-identifier">values_at</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">idx</span>)
-    <span class="ruby-identifier">idx</span> = (<span class="ruby-value">0</span><span class="ruby-operator">...</span><span class="ruby-identifier">size</span>).<span class="ruby-identifier">to_a</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">idx</span>
-    <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">replace</span>( <span class="ruby-identifier">values_at</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">idx</span>) )
-    <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">dvals</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000263"></a><b>merge!</b>( other )
-  </div>
-  <div class="description">
-  <p>
-In place merge.
+OVERRIDE! This is one of the bery few core overrides in Facets.
 </p>
-<pre>
-  a = [1,2]
-  a.merge! [2,3]
-  a =&gt; [1,2,3]
-
- CREDIT: Trans
-</pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000263_source')" id="l_M000263_source">show source</a> ]</p>
-  <div id="M000263_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000141_source')" id="l_M000141_source">show source</a> ]</p>
+  <div id="M000141_source" class="dyn-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/merge.rb, line 11</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">merge!</span>( <span class="ruby-identifier">other</span> )
-    <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">replace</span>(<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">merge</span>(<span class="ruby-identifier">other</span>))
-  <span class="ruby-keyword kw">end</span>
+<span class="ruby-comment cmt"># File lib/core/facets/array/index.rb, line 14</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">index</span>(<span class="ruby-identifier">obj</span>=<span class="ruby-keyword kw">nil</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">facets_override_of_index</span>(<span class="ruby-identifier">obj</span>) <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">block_given?</span>
+      <span class="ruby-identifier">i</span>=<span class="ruby-value">0</span>; <span class="ruby-identifier">i</span><span class="ruby-operator">+=</span><span class="ruby-value">1</span> <span class="ruby-keyword kw">until</span> <span class="ruby-keyword kw">yield</span>(<span class="ruby-keyword kw">self</span>[<span class="ruby-identifier">i</span>])
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">i</span>
+    <span class="ruby-keyword kw">end</span>
 </pre>
   </div>
 </div>
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000242"></a><b>merge!</b>( other )
+    <a name="M000136"></a><b>merge!</b>( other )
   </div>
   <div class="description">
   <p>
@@ -700,8 +422,8 @@ In place merge.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000242_source')" id="l_M000242_source">show source</a> ]</p>
-  <div id="M000242_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000136_source')" id="l_M000136_source">show source</a> ]</p>
+  <div id="M000136_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/array/merge.rb, line 11</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">merge!</span>( <span class="ruby-identifier">other</span> )
@@ -713,32 +435,7 @@ In place merge.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000238"></a><b>not_empty?</b>()
-  </div>
-  <div class="description">
-  <p>
-Not empty?
-</p>
-<pre>
-  [].not_empty?     #=&gt; false
-  [1,2].not_empty?  #=&gt; true
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000238_source')" id="l_M000238_source">show source</a> ]</p>
-  <div id="M000238_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/not_empty.rb, line 8</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">not_empty?</span>
-    <span class="ruby-operator">!</span><span class="ruby-identifier">empty?</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000259"></a><b>not_empty?</b>()
+    <a name="M000132"></a><b>not_empty?</b>()
   </div>
   <div class="description">
   <p>
@@ -750,8 +447,8 @@ Not empty?
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000259_source')" id="l_M000259_source">show source</a> ]</p>
-  <div id="M000259_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000132_source')" id="l_M000132_source">show source</a> ]</p>
+  <div id="M000132_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/array/not_empty.rb, line 8</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">not_empty?</span>
@@ -763,44 +460,11 @@ Not empty?
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000268"></a><b>only</b>()
-  </div>
-  <div class="description">
-  <p>
-Returns the <em><a href="Array.html#M000247">only</a></em> element in the
-array. Raises an IndexError if the array&#8216;s size is not 1.
-</p>
-<pre>
-  [5].only      # -&gt; 5
-  [1,2,3].only  # -&gt; IndexError
-  [].only       # -&gt; IndexError
-
- CREDIT: Gavin Sinclair
- CREDIT: Noah Gibbs
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000268_source')" id="l_M000268_source">show source</a> ]</p>
-  <div id="M000268_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/only.rb, line 13</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">only</span>
-    <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">size</span> <span class="ruby-operator">==</span> <span class="ruby-value">1</span>
-      <span class="ruby-identifier">raise</span> <span class="ruby-constant">IndexError</span>, <span class="ruby-value str">&quot;Array#only called on non-single-element array&quot;</span>
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-identifier">first</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000247"></a><b>only</b>()
+    <a name="M000142"></a><b>only</b>()
   </div>
   <div class="description">
   <p>
-Returns the <em><a href="Array.html#M000247">only</a></em> element in the
+Returns the <em><a href="Array.html#M000142">only</a></em> element in the
 array. Raises an IndexError if the array&#8216;s size is not 1.
 </p>
 <pre>
@@ -813,8 +477,8 @@ array. Raises an IndexError if the array&#8216;s size is not 1.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000247_source')" id="l_M000247_source">show source</a> ]</p>
-  <div id="M000247_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000142_source')" id="l_M000142_source">show source</a> ]</p>
+  <div id="M000142_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/array/only.rb, line 13</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">only</span>
@@ -829,7 +493,7 @@ array. Raises an IndexError if the array&#8216;s size is not 1.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000274"></a><b>pad</b>(len, val=nil)
+    <a name="M000148"></a><b>pad</b>(len, val=nil)
   </div>
   <div class="description">
   <p>
@@ -849,8 +513,8 @@ beginning of the array.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000274_source')" id="l_M000274_source">show source</a> ]</p>
-  <div id="M000274_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000148_source')" id="l_M000148_source">show source</a> ]</p>
+  <div id="M000148_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/array/pad.rb, line 14</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">pad</span>(<span class="ruby-identifier">len</span>, <span class="ruby-identifier">val</span>=<span class="ruby-keyword kw">nil</span>)
@@ -867,82 +531,11 @@ beginning of the array.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000253"></a><b>pad</b>(len, val=nil)
+    <a name="M000149"></a><b>pad!</b>(len, val=nil)
   </div>
   <div class="description">
   <p>
-Pad an array with a given <tt>value</tt> upto a given <tt>length</tt>.
-</p>
-<pre>
-  [0,1,2].pad(6,&quot;a&quot;)  #=&gt; [0,1,2,&quot;a&quot;,&quot;a&quot;,&quot;a&quot;]
-</pre>
-<p>
-If <tt>length</tt> is a negative number padding will be added to the
-beginning of the array.
-</p>
-<pre>
-  [0,1,2].pad(-6,&quot;a&quot;)  #=&gt; [&quot;a&quot;,&quot;a&quot;,&quot;a&quot;,0,1,2]
-
- CREDIT: Richard Laugesen
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000253_source')" id="l_M000253_source">show source</a> ]</p>
-  <div id="M000253_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/pad.rb, line 14</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">pad</span>(<span class="ruby-identifier">len</span>, <span class="ruby-identifier">val</span>=<span class="ruby-keyword kw">nil</span>)
-    <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">dup</span> <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;=</span> <span class="ruby-identifier">len</span>.<span class="ruby-identifier">abs</span>
-    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">len</span> <span class="ruby-operator">&lt;</span> <span class="ruby-value">0</span>
-      <span class="ruby-constant">Array</span>.<span class="ruby-identifier">new</span>((<span class="ruby-identifier">len</span><span class="ruby-operator">+</span><span class="ruby-identifier">size</span>).<span class="ruby-identifier">abs</span>,<span class="ruby-identifier">val</span>) <span class="ruby-operator">+</span> <span class="ruby-keyword kw">self</span>
-    <span class="ruby-keyword kw">else</span>
-      <span class="ruby-keyword kw">self</span> <span class="ruby-operator">+</span> <span class="ruby-constant">Array</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">len</span><span class="ruby-operator">-</span><span class="ruby-identifier">size</span>,<span class="ruby-identifier">val</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="M000275"></a><b>pad!</b>(len, val=nil)
-  </div>
-  <div class="description">
-  <p>
-Like <a href="Array.html#M000253">pad</a> but changes the array in place.
-</p>
-<pre>
-   a = [0,1,2]
-   a.pad!(6,&quot;x&quot;)
-   a  #=&gt; [0,1,2,&quot;x&quot;,&quot;x&quot;,&quot;x&quot;]
-
- CREDIT: Richard Laugesen
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000275_source')" id="l_M000275_source">show source</a> ]</p>
-  <div id="M000275_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/pad.rb, line 31</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">pad!</span>(<span class="ruby-identifier">len</span>, <span class="ruby-identifier">val</span>=<span class="ruby-keyword kw">nil</span>)
-    <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">self</span> <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;=</span> <span class="ruby-identifier">len</span>.<span class="ruby-identifier">abs</span>
-    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">len</span> <span class="ruby-operator">&lt;</span> <span class="ruby-value">0</span>
-      <span class="ruby-identifier">replace</span> <span class="ruby-constant">Array</span>.<span class="ruby-identifier">new</span>((<span class="ruby-identifier">len</span><span class="ruby-operator">+</span><span class="ruby-identifier">size</span>).<span class="ruby-identifier">abs</span>,<span class="ruby-identifier">val</span>) <span class="ruby-operator">+</span> <span class="ruby-keyword kw">self</span>
-    <span class="ruby-keyword kw">else</span>
-      <span class="ruby-identifier">concat</span> <span class="ruby-constant">Array</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">len</span><span class="ruby-operator">-</span><span class="ruby-identifier">size</span>,<span class="ruby-identifier">val</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="M000254"></a><b>pad!</b>(len, val=nil)
-  </div>
-  <div class="description">
-  <p>
-Like <a href="Array.html#M000253">pad</a> but changes the array in place.
+Like <a href="Array.html#M000148">pad</a> but changes the array in place.
 </p>
 <pre>
    a = [0,1,2]
@@ -953,8 +546,8 @@ Like <a href="Array.html#M000253">pad</a> but changes the array in place.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000254_source')" id="l_M000254_source">show source</a> ]</p>
-  <div id="M000254_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000149_source')" id="l_M000149_source">show source</a> ]</p>
+  <div id="M000149_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/array/pad.rb, line 31</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">pad!</span>(<span class="ruby-identifier">len</span>, <span class="ruby-identifier">val</span>=<span class="ruby-keyword kw">nil</span>)
@@ -962,59 +555,21 @@ Like <a href="Array.html#M000253">pad</a> but changes the array in place.
     <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">len</span> <span class="ruby-operator">&lt;</span> <span class="ruby-value">0</span>
       <span class="ruby-identifier">replace</span> <span class="ruby-constant">Array</span>.<span class="ruby-identifier">new</span>((<span class="ruby-identifier">len</span><span class="ruby-operator">+</span><span class="ruby-identifier">size</span>).<span class="ruby-identifier">abs</span>,<span class="ruby-identifier">val</span>) <span class="ruby-operator">+</span> <span class="ruby-keyword kw">self</span>
     <span class="ruby-keyword kw">else</span>
-      <span class="ruby-identifier">concat</span> <span class="ruby-constant">Array</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">len</span><span class="ruby-operator">-</span><span class="ruby-identifier">size</span>,<span class="ruby-identifier">val</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="M000245"></a><b>permutation</b>(n=size) {|[]| ...}
-  </div>
-  <div class="description">
-  <p>
-Permutation provids the possible orders of an enumerable. Each is indexed
-by a <a href="Array.html#M000245">permutation</a> number. The maximum
-number of arrangements is the factorial of the size of the array.
-</p>
-<pre>
- CREDIT: Shin-ichiro Hara
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000245_source')" id="l_M000245_source">show source</a> ]</p>
-  <div id="M000245_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/permutation.rb, line 11</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">permutation</span>(<span class="ruby-identifier">n</span>=<span class="ruby-identifier">size</span>)
-      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">size</span> <span class="ruby-operator">&lt;</span> <span class="ruby-identifier">n</span> <span class="ruby-keyword kw">or</span> <span class="ruby-identifier">n</span> <span class="ruby-operator">&lt;</span> <span class="ruby-value">0</span>
-      <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">n</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span>
-        <span class="ruby-keyword kw">yield</span>([])
-      <span class="ruby-keyword kw">else</span>
-        <span class="ruby-keyword kw">self</span>[<span class="ruby-value">1</span><span class="ruby-operator">..</span><span class="ruby-value">-1</span>].<span class="ruby-identifier">permutation</span>(<span class="ruby-identifier">n</span> <span class="ruby-operator">-</span> <span class="ruby-value">1</span>) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">x</span><span class="ruby-operator">|</span>
-          (<span class="ruby-value">0</span><span class="ruby-operator">...</span><span class="ruby-identifier">n</span>).<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">i</span><span class="ruby-operator">|</span>
-            <span class="ruby-keyword kw">yield</span>(<span class="ruby-identifier">x</span>[<span class="ruby-value">0</span><span class="ruby-operator">...</span><span class="ruby-identifier">i</span>] <span class="ruby-operator">+</span> [<span class="ruby-identifier">first</span>] <span class="ruby-operator">+</span> <span class="ruby-identifier">x</span>[<span class="ruby-identifier">i</span><span class="ruby-operator">..</span><span class="ruby-value">-1</span>])
-          <span class="ruby-keyword kw">end</span>
-        <span class="ruby-keyword kw">end</span>
-        <span class="ruby-keyword kw">self</span>[<span class="ruby-value">1</span><span class="ruby-operator">..</span><span class="ruby-value">-1</span>].<span class="ruby-identifier">permutation</span>(<span class="ruby-identifier">n</span>) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">x</span><span class="ruby-operator">|</span>
-          <span class="ruby-keyword kw">yield</span>(<span class="ruby-identifier">x</span>)
-        <span class="ruby-keyword kw">end</span>
-      <span class="ruby-keyword kw">end</span>
+      <span class="ruby-identifier">concat</span> <span class="ruby-constant">Array</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">len</span><span class="ruby-operator">-</span><span class="ruby-identifier">size</span>,<span class="ruby-identifier">val</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="M000266"></a><b>permutation</b>(n=size) {|[]| ...}
+    <a name="M000139"></a><b>permutation</b>(n=size) {|[]| ...}
   </div>
   <div class="description">
   <p>
 Permutation provids the possible orders of an enumerable. Each is indexed
-by a <a href="Array.html#M000245">permutation</a> number. The maximum
+by a <a href="Array.html#M000139">permutation</a> number. The maximum
 number of arrangements is the factorial of the size of the array.
 </p>
 <pre>
@@ -1022,8 +577,8 @@ number of arrangements is the factorial of the size of the array.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000266_source')" id="l_M000266_source">show source</a> ]</p>
-  <div id="M000266_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000139_source')" id="l_M000139_source">show source</a> ]</p>
+  <div id="M000139_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/array/permutation.rb, line 11</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">permutation</span>(<span class="ruby-identifier">n</span>=<span class="ruby-identifier">size</span>)
@@ -1047,62 +602,11 @@ number of arrangements is the factorial of the size of the array.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000255"></a><b>product</b>(*enums, &amp;block)
-  </div>
-  <div class="description">
-  <p>
-Provides the cross-<a href="Array.html#M000234">product</a> of two or more
-Enumerables. This is the class-level method. The instance method calls on
-this.
-</p>
-<pre>
-  Enumerable.cartesian_product([1,2], [4], [&quot;apple&quot;, &quot;banana&quot;])
-  #=&gt; [[1, 4, &quot;apple&quot;], [1, 4, &quot;banana&quot;], [2, 4, &quot;apple&quot;], [2, 4, &quot;banana&quot;]]
-
-  Enumerable.cartesian_product([1,2], [3,4])
-  #=&gt; [[1, 3], [1, 4], [2, 3], [2, 4]]
-
-  a = []
-  [1,2].cart([4,5]){|elem| a &lt;&lt; elem }
-  a  #=&gt; [[1, 4],[1, 5],[2, 4],[2, 5]]
-
- CREDIT: Thomas Hafner
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000255_source')" id="l_M000255_source">show source</a> ]</p>
-  <div id="M000255_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/product.rb, line 21</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">product</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">enums</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
-      <span class="ruby-identifier">enums</span>.<span class="ruby-identifier">unshift</span> <span class="ruby-keyword kw">self</span>
-      <span class="ruby-identifier">result</span> = [[]]
-      <span class="ruby-keyword kw">while</span> [] <span class="ruby-operator">!=</span> <span class="ruby-identifier">enums</span>
-        <span class="ruby-identifier">t</span>, <span class="ruby-identifier">result</span> = <span class="ruby-identifier">result</span>, []
-        <span class="ruby-identifier">b</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">enums</span> = <span class="ruby-identifier">enums</span>
-        <span class="ruby-identifier">t</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">a</span><span class="ruby-operator">|</span>
-          <span class="ruby-identifier">b</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">n</span><span class="ruby-operator">|</span>
-            <span class="ruby-identifier">result</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">a</span> <span class="ruby-operator">+</span> [<span class="ruby-identifier">n</span>]
-          <span class="ruby-keyword kw">end</span>
-        <span class="ruby-keyword kw">end</span>
-      <span class="ruby-keyword kw">end</span>
-      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">block_given?</span>
-        <span class="ruby-identifier">result</span>.<span class="ruby-identifier">each</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">e</span><span class="ruby-operator">|</span> <span class="ruby-identifier">block</span>.<span class="ruby-identifier">call</span>(<span class="ruby-identifier">e</span>) }
-      <span class="ruby-keyword kw">else</span>
-        <span class="ruby-identifier">result</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="M000234"></a><b>product</b>(*enums, &amp;block)
+    <a name="M000128"></a><b>product</b>(*enums, &amp;block)
   </div>
   <div class="description">
   <p>
-Provides the cross-<a href="Array.html#M000234">product</a> of two or more
+Provides the cross-<a href="Array.html#M000128">product</a> of two or more
 Enumerables. This is the class-level method. The instance method calls on
 this.
 </p>
@@ -1122,12 +626,11 @@ this.
   </div>
 <div class="aka">
   This method is also aliased as
-  <a href="Array.html#M000235">**</a>
-  <a href="Array.html#M000256">**</a>
+  <a href="Array.html#M000129">**</a>
 </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000234_source')" id="l_M000234_source">show source</a> ]</p>
-  <div id="M000234_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000128_source')" id="l_M000128_source">show source</a> ]</p>
+  <div id="M000128_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/array/product.rb, line 21</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">product</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">enums</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
@@ -1154,49 +657,11 @@ this.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000236"></a><b>recursively</b>() {|a| ...}
-  </div>
-  <div class="description">
-  <p>
-Apply a block to hash, and <a href="Array.html#M000236">recursively</a>
-apply that block to each subhash.
-</p>
-<pre>
-  arr = [&quot;a&quot;, [&quot;b&quot;, &quot;c&quot;, nil], nil]
-  arr.recursively{|a| a.compact! }
-  =&gt; [&quot;a&quot;, [&quot;b&quot;, &quot;c&quot;]]
-</pre>
-<p>
-TODO: Can this be generalized in Enumerbale?
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000236_source')" id="l_M000236_source">show source</a> ]</p>
-  <div id="M000236_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/recursively.rb, line 12</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>)
-    <span class="ruby-identifier">a</span> = <span class="ruby-identifier">inject</span>([]) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">array</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">array</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">value</span>.<span class="ruby-identifier">recursively</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
-      <span class="ruby-keyword kw">else</span>
-        <span class="ruby-identifier">array</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">value</span>
-      <span class="ruby-keyword kw">end</span>
-      <span class="ruby-identifier">array</span>
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">yield</span> <span class="ruby-identifier">a</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000257"></a><b>recursively</b>() {|a| ...}
+    <a name="M000130"></a><b>recursively</b>() {|a| ...}
   </div>
   <div class="description">
   <p>
-Apply a block to hash, and <a href="Array.html#M000236">recursively</a>
+Apply a block to hash, and <a href="Array.html#M000130">recursively</a>
 apply that block to each subhash.
 </p>
 <pre>
@@ -1209,8 +674,8 @@ TODO: Can this be generalized in Enumerbale?
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000257_source')" id="l_M000257_source">show source</a> ]</p>
-  <div id="M000257_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000130_source')" id="l_M000130_source">show source</a> ]</p>
+  <div id="M000130_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/array/recursively.rb, line 12</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>)
@@ -1230,37 +695,16 @@ TODO: Can this be generalized in Enumerbale?
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000258"></a><b>recursively!</b>(&amp;block)
-  </div>
-  <div class="description">
-  <p>
-In place form of <a href="Array.html#M000236">recursively</a>.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000258_source')" id="l_M000258_source">show source</a> ]</p>
-  <div id="M000258_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/recursively.rb, line 26</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>)
-    <span class="ruby-identifier">replace</span>(<span class="ruby-identifier">recursively</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>))
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000237"></a><b>recursively!</b>(&amp;block)
+    <a name="M000131"></a><b>recursively!</b>(&amp;block)
   </div>
   <div class="description">
   <p>
-In place form of <a href="Array.html#M000236">recursively</a>.
+In place form of <a href="Array.html#M000130">recursively</a>.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000237_source')" id="l_M000237_source">show source</a> ]</p>
-  <div id="M000237_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000131_source')" id="l_M000131_source">show source</a> ]</p>
+  <div id="M000131_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/array/recursively.rb, line 26</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>)
@@ -1272,43 +716,7 @@ In place form of <a href="Array.html#M000236">recursively</a>.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000239"></a><b>rotate</b>(n=1)
-  </div>
-  <div class="description">
-  <p>
-Rotates an array&#8216;s elements from back to front n times.
-</p>
-<pre>
-  [1,2,3].rotate      #=&gt; [3,1,2]
-  [3,1,2].rotate      #=&gt; [2,3,1]
-  [3,1,2].rotate      #=&gt; [1,2,3]
-  [1,2,3].rotate(3)   #=&gt; [1,2,3]
-</pre>
-<p>
-A negative parameter reverses the order from front to back.
-</p>
-<pre>
-  [1,2,3].rotate(-1)  #=&gt; [2,3,1]
-
- CREDIT: Florian Gross
- CREDIT: Thomas Sawyer
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000239_source')" id="l_M000239_source">show source</a> ]</p>
-  <div id="M000239_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/rotate.rb, line 17</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">rotate</span>(<span class="ruby-identifier">n</span>=<span class="ruby-value">1</span>)
-    <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">dup</span>.<span class="ruby-identifier">rotate!</span>(<span class="ruby-identifier">n</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000260"></a><b>rotate</b>(n=1)
+    <a name="M000133"></a><b>rotate</b>(n=1)
   </div>
   <div class="description">
   <p>
@@ -1331,8 +739,8 @@ A negative parameter reverses the order from front to back.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000260_source')" id="l_M000260_source">show source</a> ]</p>
-  <div id="M000260_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000133_source')" id="l_M000133_source">show source</a> ]</p>
+  <div id="M000133_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/array/rotate.rb, line 17</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">rotate</span>(<span class="ruby-identifier">n</span>=<span class="ruby-value">1</span>)
@@ -1344,47 +752,11 @@ A negative parameter reverses the order from front to back.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000261"></a><b>rotate!</b>(n=1)
-  </div>
-  <div class="description">
-  <p>
-Same as <a href="Array.html#M000239">rotate</a>, but acts in place.
-</p>
-<pre>
-  a = [1,2,3]
-  a.rotate!
-  a  #=&gt; [3,1,2]
-
- CREDIT: Florian Gross
- CREDIT: Thomas Sawyer
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000261_source')" id="l_M000261_source">show source</a> ]</p>
-  <div id="M000261_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/rotate.rb, line 30</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">rotate!</span>(<span class="ruby-identifier">n</span>=<span class="ruby-value">1</span>)
-    <span class="ruby-identifier">n</span> = <span class="ruby-identifier">n</span>.<span class="ruby-identifier">to_int</span>
-    <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">self</span> <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">n</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span> <span class="ruby-keyword kw">or</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">empty?</span>)
-    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">n</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>
-      <span class="ruby-identifier">n</span>.<span class="ruby-identifier">abs</span>.<span class="ruby-identifier">times</span>{ <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">unshift</span>( <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">pop</span> ) }
-    <span class="ruby-keyword kw">else</span>
-      <span class="ruby-identifier">n</span>.<span class="ruby-identifier">abs</span>.<span class="ruby-identifier">times</span>{ <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">push</span>( <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">shift</span> ) }
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">self</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000240"></a><b>rotate!</b>(n=1)
+    <a name="M000134"></a><b>rotate!</b>(n=1)
   </div>
   <div class="description">
   <p>
-Same as <a href="Array.html#M000239">rotate</a>, but acts in place.
+Same as <a href="Array.html#M000133">rotate</a>, but acts in place.
 </p>
 <pre>
   a = [1,2,3]
@@ -1396,8 +768,8 @@ Same as <a href="Array.html#M000239">rotate</a>, but acts in place.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000240_source')" id="l_M000240_source">show source</a> ]</p>
-  <div id="M000240_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000134_source')" id="l_M000134_source">show source</a> ]</p>
+  <div id="M000134_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/array/rotate.rb, line 30</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">rotate!</span>(<span class="ruby-identifier">n</span>=<span class="ruby-value">1</span>)
@@ -1416,35 +788,7 @@ Same as <a href="Array.html#M000239">rotate</a>, but acts in place.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000246"></a><b>select!</b>( {|| ...}
-  </div>
-  <div class="description">
-  <p>
-As with select but modifies the <a href="Array.html">Array</a> in place.
-</p>
-<pre>
-  a = [1,2,3,4,5,6,7,8,9,10]
-  a.select!{ |e| e % 2 == 0 }
-  a  #=&gt; [2,4,6,8,10]
-
- CREDIT: Gavin Sinclair
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000246_source')" id="l_M000246_source">show source</a> ]</p>
-  <div id="M000246_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/select.rb, line 11</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">select!</span>  <span class="ruby-comment cmt"># :yield:</span>
-    <span class="ruby-identifier">reject!</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">e</span><span class="ruby-operator">|</span> <span class="ruby-keyword kw">not</span> <span class="ruby-keyword kw">yield</span>(<span class="ruby-identifier">e</span>) }
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000267"></a><b>select!</b>( {|| ...}
+    <a name="M000140"></a><b>select!</b>( {|| ...}
   </div>
   <div class="description">
   <p>
@@ -1459,8 +803,8 @@ As with select but modifies the <a href="Array.html">Array</a> in place.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000267_source')" id="l_M000267_source">show source</a> ]</p>
-  <div id="M000267_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000140_source')" id="l_M000140_source">show source</a> ]</p>
+  <div id="M000140_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/array/select.rb, line 11</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">select!</span>  <span class="ruby-comment cmt"># :yield:</span>
@@ -1472,49 +816,11 @@ As with select but modifies the <a href="Array.html">Array</a> in place.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000273"></a><b>splice</b>(*args)
-  </div>
-  <div class="description">
-  <p>
-Splice acts a <a href="Array.html#M000251">combination</a> of slice! and
-store. If two arguments are given it calls store. If a single argument is
-give it calls slice!.
-</p>
-<pre>
-  a = [1,2,3]
-  a.splice(1)    #=&gt; 2
-  a              #=&gt; [1,3]
-
-  a = [1,2,3]
-  a.splice(1,4)  #=&gt; 4
-  a              #=&gt;[1,4,3]
-
- CREDIT: Trans
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000273_source')" id="l_M000273_source">show source</a> ]</p>
-  <div id="M000273_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/splice.rb, line 17</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">splice</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
-    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">==</span> <span class="ruby-value">1</span>
-      <span class="ruby-identifier">slice!</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
-    <span class="ruby-keyword kw">else</span>
-      <span class="ruby-identifier">store</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
-    <span class="ruby-keyword kw">end</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000252"></a><b>splice</b>(*args)
+    <a name="M000147"></a><b>splice</b>(*args)
   </div>
   <div class="description">
   <p>
-Splice acts a <a href="Array.html#M000251">combination</a> of slice! and
+Splice acts a <a href="Array.html#M000146">combination</a> of slice! and
 store. If two arguments are given it calls store. If a single argument is
 give it calls slice!.
 </p>
@@ -1531,8 +837,8 @@ give it calls slice!.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000252_source')" id="l_M000252_source">show source</a> ]</p>
-  <div id="M000252_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000147_source')" id="l_M000147_source">show source</a> ]</p>
+  <div id="M000147_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/array/splice.rb, line 17</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">splice</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
@@ -1548,7 +854,7 @@ give it calls slice!.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000233"></a><b>to_b</b>()
+    <a name="M000127"></a><b>to_b</b>()
   </div>
   <div class="description">
   <p>
@@ -1556,8 +862,8 @@ Boolean conversion for not empty?
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000233_source')" id="l_M000233_source">show source</a> ]</p>
-  <div id="M000233_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000127_source')" id="l_M000127_source">show source</a> ]</p>
+  <div id="M000127_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/boolean.rb, line 60</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_b</span>
@@ -1569,7 +875,7 @@ Boolean conversion for not empty?
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000232"></a><b>to_h</b>(arrayed=nil)
+    <a name="M000126"></a><b>to_h</b>(arrayed=nil)
   </div>
   <div class="description">
   <p>
@@ -1597,8 +903,8 @@ functionality is as simple as:
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000232_source')" id="l_M000232_source">show source</a> ]</p>
-  <div id="M000232_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000126_source')" id="l_M000126_source">show source</a> ]</p>
+  <div id="M000126_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/to_hash.rb, line 20</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_h</span>(<span class="ruby-identifier">arrayed</span>=<span class="ruby-keyword kw">nil</span>)
@@ -1622,11 +928,11 @@ functionality is as simple as:
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000264"></a><b>traverse</b>() {|item| ...}
+    <a name="M000137"></a><b>traverse</b>() {|item| ...}
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000264_source')" id="l_M000264_source">show source</a> ]</p>
-  <div id="M000264_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000137_source')" id="l_M000137_source">show source</a> ]</p>
+  <div id="M000137_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/array/traverse.rb, line 5</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">traverse</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
@@ -1644,49 +950,11 @@ functionality is as simple as:
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000243"></a><b>traverse</b>() {|item| ...}
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000243_source')" id="l_M000243_source">show source</a> ]</p>
-  <div id="M000243_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/traverse.rb, line 5</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">traverse</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
-    <span class="ruby-identifier">map</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">item</span><span class="ruby-operator">|</span>
-      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">item</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">class</span>)
-        <span class="ruby-identifier">item</span>.<span class="ruby-identifier">traverse</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
-      <span class="ruby-keyword kw">else</span>
-        <span class="ruby-keyword kw">yield</span> <span class="ruby-identifier">item</span>
-      <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">end</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000244"></a><b>traverse!</b>(&amp;block)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000244_source')" id="l_M000244_source">show source</a> ]</p>
-  <div id="M000244_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/traverse.rb, line 17</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">traverse!</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
-    <span class="ruby-identifier">replace</span>(<span class="ruby-identifier">traverse</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>))
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000265"></a><b>traverse!</b>(&amp;block)
+    <a name="M000138"></a><b>traverse!</b>(&amp;block)
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000265_source')" id="l_M000265_source">show source</a> ]</p>
-  <div id="M000265_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000138_source')" id="l_M000138_source">show source</a> ]</p>
+  <div id="M000138_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/array/traverse.rb, line 17</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">traverse!</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)