facets 0.7.1 → 0.7.2

data/ANN

@@ -1,23 +1,27 @@
 Hi--
 
-Exciting news: Ruby Facets 0.7 is out! This version goes ballistic, converging
-with the now defunct Carats library. All the Carats files are now available 
-directly from Facets.
+Exciting news! Ruby Facets 0.7 series is out. And this version goes ballistic.
+All of what was in the Carats library is now available directly from Facets!
 
-Here's a list of some of the changes for 0.7.0:
+Here's a list of some of the changes for the current version 0.7.1:
 
 * The Carats library has been ported into the Facet lib. These files sit in the 
   main lib directory 'facet/' above the "atomic" methods which are all in 
   subdirectories 'facet/{module|class}/'. This layout works well, and allows for
   everything to be provided from the same location.
 
-* All methods with names containing non-alphanumeric characters now have facet
-  files without those special characters. This removes some incompatibilites
-  with some file systems. Names ending in !, ? or = have simply have had that 
-  characeter removed. Others have been given suitable names and suffixed with '-op'.
+* All methods with names containing non-alphanumeric characters are now CGI-escaped.
+  This removes some incompatibilites with some file systems. For instance Object#in?
+  is now stored in object/in%3F.rb.
 
-* A number of "require collection" files have been added. These require multiple
-  realted "atoms" at once, for greater convenience.
+* So one doesn't have to fuss with these escape chars, a new method has been added,
+  kernel/require_facet, which automatically does the substitutions.
+
+* An expiremental file, facet.rb, had been added that allows automatic requiring of 
+  atomic methods. It uses object/method_missing to require the methods on demand.
+
+* A number of "molecular" files have been added. These require multiple
+  related "atoms" at once for greater convenience.
 
 * A few methods that were grouped together in the same file have been separated
   into their own files. (This is more feasible thanks to the additional
@@ -29,10 +33,13 @@ Here's a list of some of the changes for 0.7.0:
   deprecated in favor of some more generalized methods that serves the same 
   purposes, matchdata/matchtree and matchdata/matchset.
 
-* Added module/include_as.
+* Added module/include_as which allows one to include a module but within a specified
+  namespace.
 
-* Added array/permute.
+* Added array/permute which applys a block to each permutation.
 
+As for the rest. Well, this thing is HUGE! There's no way I can go into it all here.
+So dig in and check it out.
 
 If you have any extension methods that you use and think may be of benefit
 to others, please submit them. And, of course, please let me know if you 
@@ -46,4 +53,3 @@ or via the Ruby Muse mailing list, suby-ruby at berlios.de
 
 Thanks,
 T.
-

data/ChangeLog

@@ -1,19 +1,28 @@
 
 --- !!history
 
+v0.7.2:
+- Added a class method dir/recurse which allows one to loop through a dir and all its
+  subdirs, etc. It also has an alias #ls_r. Thanks goes to George Maschovitis for this.
+- Changed array/permute to array/each_permutation.
+
+v0.7.1:
+- Added facet.rb, although expiremental it makes it possible to use atomic methods without
+  specificaly requiring them. It uses Object#method_missing to require them as needed.
+- Improved on "molecules", i.e. files that require numerous related atoms in a single go.
+  These will see a great deal of continued improvement in the future.
+
 v0.7.0:
 - All methods with names containing non-alphanumeric characters now have facet
   files without those special characters. This removes some incompatibilites with 
-  certain systems (including Windows). Names ending in !, ? or = have simply been
-  removed. Others have been given suitable names an sufficxed with '-op'.
-- An new lib directory 'facets/' (notice the pluralization) has been created to 
-  contain various special collections of facet methods (via multiple requires).
-- A few methods that were grouped together in the same file have been separated 
-  into their own files. This is more feasible now b/c the collectives in 'facets/'
-  are avaialble.
-- The method array/put has been changed to array/top (it is an alias for #unshift).
+  certain systems (including Windows). All such symbols have been replaced with
+  CGI escape sequences, for instance 'in?.rb' becomes 'in%3F.rb'. To avoid having
+  to use these "ugly" names, a new method has been added, kernel/require_facet.
+- Methods that were grouped together in the same file have been separated 
+  into their own files. Pure Atomicity has been achieved!
+- The method array/put has been dropped in favor of array/top (as a better alias for #unshift).
 - Methods #matchdata/post_match_from and #matchdata/pre_match_from have deprecated
-  in favor of some more generalized methods that serves the same purposes,
+  in favor of more generalized methods that serves the same purposes,
   matchdata/matchtree and matchdata/matchset.
 - Added module/include_as.
 - Added array/permute.

data/README

@@ -1,35 +1,40 @@
 
 = Ruby Facets
 
+== What is this?
 
-=== Introduction to Ruby's Atomic Library
+Ruby Facets is the a collection of general, pure-Ruby extensions
+and additions for the Ruby programming language. The extensions are known
+as the Atomic Methods, design falls into
+two parts: the Atomic Methods and the CMMs (Classes, Modules and Mixins).
 
-Ruby Facets (Fantastic Atomic Core Extensions), is an growing
-collection of methods to complement Ruby's core and standard libs.
-It is an _atomic_ library in that the methods are, to the greatest
-degree reaonable, packaged individually so that each can be _required_
-independently. This gives the programmer greater control to include only
-the extra methods that are actually needed and thus boost runtime 
-efficiency a bit. The package currently contains over 300 atomic methods,
-spanning over 26 classes and modules.
+=== The Atomic Library
 
-In addition to the atomic methods Facets also includes a large collection 
-of addon classes, modules and mixins (which generally utilizing Facets' 
-atomic methods). [Note: These used to exit in a separate lib called Carats.
-This has been deprecated in favor of a single package.]
+The heart of Ruby Facets, which truth be told stands for Fantastic Atomic Core Extensions,
+is an growing collection of methods to complement Ruby's core and standard
+libs. It is an _atomic_ library in that the methods are packaged individually
+so that each can be _required_ independently. This gives the programmer greater 
+control to include only the extra methods he or she actually needs.
+The package currently contains over 300 atomic methods, spanning over 26 classes and modules.
+
+=== The Classes, Modules and Mixins
+
+In addition to the atomic methods, Facets also includes a large collection 
+of addon classes, modules and mixins. [Note: These used to reside in a separate lib
+called Carats. This has been deprecated in favor of a single package.]
 
 In short, through a single package, the Ruby programmer is treated to a
 plethora of programming tools.
 
 
-=== Calibre
+== Calibre
 
 Ruby Facets is part of the Calibre project. You can learn more at:
 
   http://calibre.rubyforge.com
 
 
-=== Installation
+== Installation
 
 The easiest way to install is via RubyGems. On the command line enter:
 
@@ -43,7 +48,7 @@ For example:
   > sudo ruby setup.rb
 
 
-=== Usage
+== Usage
 
 There are quite a few methods, classes and modules. For detailed usage it is best
 to refer to the API RDocs. Most is well documented. Assistance in 
@@ -93,8 +98,11 @@ fall into a subdirectory, and can always be require accordingly:
 
   require 'facet/{file-name}'
 
+As for actual examples, well that might require a book.
+But again, refer to the API docs.
 
-=== Contribute
+
+== Contribute
 
 The project thrives on contribution. Please feel free to offer any
 extension you wish. The criteria for inclusion is fairly light:
@@ -106,17 +114,10 @@ If it meets these requirements then it will in all likelihood
 be accepted into the main facets lib. 
 
 
-=== Mascot
-
-Does evey good project need a mascot? Well then, Facets
-has the Raspberry. Why the Raspberry? Because it is 
-Red and Faceted, of course. :)
-
-
-=== Authorship
+== Authorship
 
 This collection was put together by, and largely written by Thomas Sawyer
-(aka T. Onoma). He can be reached via email at transami at runbox.com.
+(aka T. Onoma). He can be reached via email at transfire at gmail.com.
 
 Some parts of this collection were written and/or inspired by other
 persons. Fortunately nearly all were copyrighted under the same open
@@ -125,17 +126,54 @@ copyright notice with the source code. In all cases, I have made every
 effort to give credit where credit is due. You will find these thanks
 and acknowledgements at the beginning of the source code.
 
+* Thomas Sawyer
+* Paul Brannan
+* Renald Buter
+* Hal Fulton
+* Gavin Sinclair
+* Michael Granger
+* Michael Neumann
+* Florian Frank
+* Mohammad Khan
+* Derek Lewis
+* Thomas-Ivo Heinen
+* Jan Molic
+
+This package is a collection of work by many persons. 
+The actual code on is licensed according to the original authors
+desires, being one of the following: Ruby, GPL, LGPL, MIT, or Artistic.
+Copies of these licenses should accompany this document. Any piece of code
+not specifically laballed shall fall under the Ruby License.
+   
+[Please Note: I am working to make sure everything is labeled appropriately.
+Please forgive me if I have not done so in a particular place --just let 
+me know and I will fix.]
+
+Also, I would like to ask all those authors, whose code is collected here,
+to consider allowing me to move to the Ruby license, so one license can serve
+for all.
+
+
+== License
+
 The collection per collection is licensed as follows:
 
   Ruby Facets, the Fantastic Atomic Core Extensions
-  Copyright (c) 2004 Thomas Sawyer
+  Copyright (c) 2004,2005 Thomas Sawyer
   Ruby License
 
 The Ruby license is a dual license that also provides for use of the GPL.
 A copy of both licenses should accompany this document.
 
 
-=== Pitch
+== Mascot
+
+Does evey good project need a mascot? Well then, Facets
+has the Raspberry. Why the Raspberry? Because it is 
+Red and Faceted, of course. :)
+
+
+== Pitch
 
   ALL YOUR BASE ARE BELONG TO RUBY
 

data/Reapfile

@@ -2,7 +2,7 @@
 
 TITLE: &title Ruby Facets
 NAME: &pkg facets
-VERSION: '0.7.1'
+VERSION: '0.7.2'
 AUTHOR: Trans
 EMAIL: transfire@gmail.com
 HOMEPAGE: "http://calibre.rubyforge.org"

data/TODO

@@ -40,3 +40,28 @@ Using only the block is possibly with SCRIPT_LINES__ or File access and is quite
 
 * Could use a better String#word_wrap method.
 
+
+- Minor:
+  - ordered-hash, would like an improved version.
+  - nil-comparable, works but I think could done better.
+  - lisp, there may be other places where #pair! is needed.
+  - interval, add infinity as possible sentinal.
+  - duckhunter (might be able to use Functor as decoy/probe)
+
+- Misc:
+  - interface
+  - detach
+
+- Tests:
+  - binaryreader
+  - binding_of_caller
+  - coroutine, currently just checks for no error raised
+  - heap
+  - io-reactor
+  - io-redirect
+  - semaphore
+  - tracepoint
+  - 1st, needs some sort of refinement
+  - lisp, needs to be vastly expanded 
+  - lisp_format, code use a few more tests
+

data/Version

@@ -1,6 +1,8 @@
+0.7.2 George II
+0.7.1 Quick George
 0.7.0 Georgian Transform
 0.6.3 Gemstone
-0.6.2 Refinement
+0.6.2 Refinement I
 0.6.1 Florian's Mixes
 0.6.0 Florian's Onslaught
 0.5.0 First Release

data/doc/atomic-rdoc/classes/Array.html

@@ -216,40 +216,40 @@
       <h3 class="section-bar">Methods</h3>
 
       <div class="name-list">
-      <a href="#M000052">[]</a>&nbsp;&nbsp;
-      <a href="#M000048">[]=</a>&nbsp;&nbsp;
-      <a href="#M000058">at_rand</a>&nbsp;&nbsp;
-      <a href="#M000060">at_rand!</a>&nbsp;&nbsp;
-      <a href="#M000077">body</a>&nbsp;&nbsp;
-      <a href="#M000074">combinations</a>&nbsp;&nbsp;
-      <a href="#M000053">delete_values</a>&nbsp;&nbsp;
-      <a href="#M000067">delete_values_at</a>&nbsp;&nbsp;
-      <a href="#M000080">each_by</a>&nbsp;&nbsp;
-      <a href="#M000073">each_combination</a>&nbsp;&nbsp;
-      <a href="#M000079">each_slice</a>&nbsp;&nbsp;
-      <a href="#M000047">each_unique_pair</a>&nbsp;&nbsp;
-      <a href="#M000049">first=</a>&nbsp;&nbsp;
-      <a href="#M000062">foot</a>&nbsp;&nbsp;
-      <a href="#M000068">head</a>&nbsp;&nbsp;
-      <a href="#M000064">index_range</a>&nbsp;&nbsp;
-      <a href="#M000076">last=</a>&nbsp;&nbsp;
-      <a href="#M000056">last_index</a>&nbsp;&nbsp;
-      <a href="#M000075">middle</a>&nbsp;&nbsp;
-      <a href="#M000071">permute</a>&nbsp;&nbsp;
-      <a href="#M000061">pick</a>&nbsp;&nbsp;
-      <a href="#M000069">pos</a>&nbsp;&nbsp;
-      <a href="#M000059">rand_index</a>&nbsp;&nbsp;
-      <a href="#M000063">range</a>&nbsp;&nbsp;
-      <a href="#M000070">rotate</a>&nbsp;&nbsp;
-      <a href="#M000054">rotate!</a>&nbsp;&nbsp;
-      <a href="#M000050">select!</a>&nbsp;&nbsp;
-      <a href="#M000072">shuffle</a>&nbsp;&nbsp;
-      <a href="#M000055">shuffle!</a>&nbsp;&nbsp;
-      <a href="#M000078">store</a>&nbsp;&nbsp;
-      <a href="#M000051">tail</a>&nbsp;&nbsp;
-      <a href="#M000057">thru</a>&nbsp;&nbsp;
-      <a href="#M000065">to_b</a>&nbsp;&nbsp;
-      <a href="#M000066">to_h</a>&nbsp;&nbsp;
+      <a href="#M000053">[]</a>&nbsp;&nbsp;
+      <a href="#M000049">[]=</a>&nbsp;&nbsp;
+      <a href="#M000059">at_rand</a>&nbsp;&nbsp;
+      <a href="#M000061">at_rand!</a>&nbsp;&nbsp;
+      <a href="#M000078">body</a>&nbsp;&nbsp;
+      <a href="#M000075">combinations</a>&nbsp;&nbsp;
+      <a href="#M000054">delete_values</a>&nbsp;&nbsp;
+      <a href="#M000068">delete_values_at</a>&nbsp;&nbsp;
+      <a href="#M000081">each_by</a>&nbsp;&nbsp;
+      <a href="#M000074">each_combination</a>&nbsp;&nbsp;
+      <a href="#M000080">each_slice</a>&nbsp;&nbsp;
+      <a href="#M000048">each_unique_pair</a>&nbsp;&nbsp;
+      <a href="#M000050">first=</a>&nbsp;&nbsp;
+      <a href="#M000063">foot</a>&nbsp;&nbsp;
+      <a href="#M000069">head</a>&nbsp;&nbsp;
+      <a href="#M000065">index_range</a>&nbsp;&nbsp;
+      <a href="#M000077">last=</a>&nbsp;&nbsp;
+      <a href="#M000057">last_index</a>&nbsp;&nbsp;
+      <a href="#M000076">middle</a>&nbsp;&nbsp;
+      <a href="#M000072">permute</a>&nbsp;&nbsp;
+      <a href="#M000062">pick</a>&nbsp;&nbsp;
+      <a href="#M000070">pos</a>&nbsp;&nbsp;
+      <a href="#M000060">rand_index</a>&nbsp;&nbsp;
+      <a href="#M000064">range</a>&nbsp;&nbsp;
+      <a href="#M000071">rotate</a>&nbsp;&nbsp;
+      <a href="#M000055">rotate!</a>&nbsp;&nbsp;
+      <a href="#M000051">select!</a>&nbsp;&nbsp;
+      <a href="#M000073">shuffle</a>&nbsp;&nbsp;
+      <a href="#M000056">shuffle!</a>&nbsp;&nbsp;
+      <a href="#M000079">store</a>&nbsp;&nbsp;
+      <a href="#M000052">tail</a>&nbsp;&nbsp;
+      <a href="#M000058">thru</a>&nbsp;&nbsp;
+      <a href="#M000066">to_b</a>&nbsp;&nbsp;
+      <a href="#M000067">to_h</a>&nbsp;&nbsp;
       </div>
     </div>
 
@@ -357,12 +357,12 @@ Alias for pop, which removes and returns the last element in an array.
     <div id="methods">
       <h3 class="section-bar">Public Class methods</h3>
 
-      <div id="method-M000074" class="method-detail">
-        <a name="M000074"></a>
+      <div id="method-M000075" class="method-detail">
+        <a name="M000075"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000074.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000074.html');return false;">
+          <a href="Array.src/M000075.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000075.html');return false;">
           <span class="method-name">combinations</span><span class="method-args">(head, *rest)</span>
           </a>
         </div>
@@ -398,12 +398,12 @@ produces
 
       <h3 class="section-bar">Public Instance methods</h3>
 
-      <div id="method-M000052" class="method-detail">
-        <a name="M000052"></a>
+      <div id="method-M000053" class="method-detail">
+        <a name="M000053"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000052.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000052.html');return false;">
+          <a href="Array.src/M000053.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000053.html');return false;">
           <span class="method-name">[]</span><span class="method-args">(*args)</span>
           </a>
         </div>
@@ -425,12 +425,12 @@ Modifies #[] to accept an array of indexes.
         </div>
       </div>
 
-      <div id="method-M000048" class="method-detail">
-        <a name="M000048"></a>
+      <div id="method-M000049" class="method-detail">
+        <a name="M000049"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000048.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000048.html');return false;">
+          <a href="Array.src/M000049.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000049.html');return false;">
           <span class="method-name">[]=</span><span class="method-args">(*args)</span>
           </a>
         </div>
@@ -453,12 +453,12 @@ Modifies #[]= to accept an array of indexes for assignment.
         </div>
       </div>
 
-      <div id="method-M000058" class="method-detail">
-        <a name="M000058"></a>
+      <div id="method-M000059" class="method-detail">
+        <a name="M000059"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000058.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000058.html');return false;">
+          <a href="Array.src/M000059.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000059.html');return false;">
           <span class="method-name">at_rand</span><span class="method-args">( number=nil, exclusive=true )</span>
           </a>
         </div>
@@ -489,19 +489,19 @@ values are returned.
         </div>
       </div>
 
-      <div id="method-M000060" class="method-detail">
-        <a name="M000060"></a>
+      <div id="method-M000061" class="method-detail">
+        <a name="M000061"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000060.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000060.html');return false;">
+          <a href="Array.src/M000061.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000061.html');return false;">
           <span class="method-name">at_rand!</span><span class="method-args">(number=nil)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-Same as <a href="Array.html#M000058">at_rand</a>, but acts in place
+Same as <a href="Array.html#M000059">at_rand</a>, but acts in place
 removing the element from the array. This is necessarily exclusive.
 </p>
 <pre>
@@ -518,12 +518,12 @@ removing the element from the array. This is necessarily exclusive.
         </div>
       </div>
 
-      <div id="method-M000077" class="method-detail">
-        <a name="M000077"></a>
+      <div id="method-M000078" class="method-detail">
+        <a name="M000078"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000077.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000077.html');return false;">
+          <a href="Array.src/M000078.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000078.html');return false;">
           <span class="method-name">body</span><span class="method-args">()</span>
           </a>
         </div>
@@ -541,12 +541,12 @@ element.
         </div>
       </div>
 
-      <div id="method-M000053" class="method-detail">
-        <a name="M000053"></a>
+      <div id="method-M000054" class="method-detail">
+        <a name="M000054"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000053.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000053.html');return false;">
+          <a href="Array.src/M000054.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000054.html');return false;">
           <span class="method-name">delete_values</span><span class="method-args">(*values)</span>
           </a>
         </div>
@@ -565,12 +565,12 @@ Delete multiple values from array.
         </div>
       </div>
 
-      <div id="method-M000067" class="method-detail">
-        <a name="M000067"></a>
+      <div id="method-M000068" class="method-detail">
+        <a name="M000068"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000067.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000067.html');return false;">
+          <a href="Array.src/M000068.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000068.html');return false;">
           <span class="method-name">delete_values_at</span><span class="method-args">(*selectors)</span>
           </a>
         </div>
@@ -592,8 +592,8 @@ Delete multiple values from array given indexes or index range.
         </div>
       </div>
 
-      <div id="method-M000080" class="method-detail">
-        <a name="M000080"></a>
+      <div id="method-M000081" class="method-detail">
+        <a name="M000081"></a>
 
         <div class="method-heading">
           <span class="method-name">each_by</span><span class="method-args">(n=nil, &amp;yld)</span>
@@ -601,17 +601,17 @@ Delete multiple values from array given indexes or index range.
       
         <div class="method-description">
           <p>
-Alias for <a href="Array.html#M000079">each_slice</a>
+Alias for <a href="Array.html#M000080">each_slice</a>
 </p>
         </div>
       </div>
 
-      <div id="method-M000073" class="method-detail">
-        <a name="M000073"></a>
+      <div id="method-M000074" class="method-detail">
+        <a name="M000074"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000073.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000073.html');return false;">
+          <a href="Array.src/M000074.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000074.html');return false;">
           <span class="method-name">each_combination</span><span class="method-args">(k=2) {|self.values_at(*idx)| ...}</span>
           </a>
         </div>
@@ -638,12 +638,12 @@ produces
         </div>
       </div>
 
-      <div id="method-M000079" class="method-detail">
-        <a name="M000079"></a>
+      <div id="method-M000080" class="method-detail">
+        <a name="M000080"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000079.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000079.html');return false;">
+          <a href="Array.src/M000080.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000080.html');return false;">
           <span class="method-name">each_slice</span><span class="method-args">(n=nil, &amp;yld)</span>
           </a>
         </div>
@@ -660,18 +660,18 @@ then the arity of the block determines the slicing quantity.
 </pre>
 <p>
 This is a specialized version <a
-href="Enumerable.html#M000335">Enumerable#each_slice</a> but optimized
+href="Enumerable.html#M000338">Enumerable#each_slice</a> but optimized
 specifically for <a href="Array.html">Array</a>.
 </p>
         </div>
       </div>
 
-      <div id="method-M000047" class="method-detail">
-        <a name="M000047"></a>
+      <div id="method-M000048" class="method-detail">
+        <a name="M000048"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000047.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000047.html');return false;">
+          <a href="Array.src/M000048.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000048.html');return false;">
           <span class="method-name">each_unique_pair</span><span class="method-args">(&amp;yld)</span>
           </a>
         </div>
@@ -713,17 +713,17 @@ prduces
 </pre>
 <p>
 This is equivalent to <tt><a
-href="Array.html#M000073">each_combination</a>(2){ &#8230; }</tt>.
+href="Array.html#M000074">each_combination</a>(2){ &#8230; }</tt>.
 </p>
         </div>
       </div>
 
-      <div id="method-M000049" class="method-detail">
-        <a name="M000049"></a>
+      <div id="method-M000050" class="method-detail">
+        <a name="M000050"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000049.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000049.html');return false;">
+          <a href="Array.src/M000050.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000050.html');return false;">
           <span class="method-name">first=</span><span class="method-args">(x)</span>
           </a>
         </div>
@@ -742,12 +742,12 @@ Change the first element.
         </div>
       </div>
 
-      <div id="method-M000062" class="method-detail">
-        <a name="M000062"></a>
+      <div id="method-M000063" class="method-detail">
+        <a name="M000063"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000062.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000062.html');return false;">
+          <a href="Array.src/M000063.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000063.html');return false;">
           <span class="method-name">foot</span><span class="method-args">()</span>
           </a>
         </div>
@@ -762,12 +762,12 @@ Like last but returns the last element in an array.
         </div>
       </div>
 
-      <div id="method-M000068" class="method-detail">
-        <a name="M000068"></a>
+      <div id="method-M000069" class="method-detail">
+        <a name="M000069"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000068.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000068.html');return false;">
+          <a href="Array.src/M000069.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000069.html');return false;">
           <span class="method-name">head</span><span class="method-args">()</span>
           </a>
         </div>
@@ -782,8 +782,8 @@ Like first but returns the first element in a new array.
         </div>
       </div>
 
-      <div id="method-M000064" class="method-detail">
-        <a name="M000064"></a>
+      <div id="method-M000065" class="method-detail">
+        <a name="M000065"></a>
 
         <div class="method-heading">
           <span class="method-name">index_range</span><span class="method-args">(a=nil,z=nil)</span>
@@ -791,17 +791,17 @@ Like first but returns the first element in a new array.
       
         <div class="method-description">
           <p>
-Alias for <a href="Array.html#M000063">range</a>
+Alias for <a href="Array.html#M000064">range</a>
 </p>
         </div>
       </div>
 
-      <div id="method-M000076" class="method-detail">
-        <a name="M000076"></a>
+      <div id="method-M000077" class="method-detail">
+        <a name="M000077"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000076.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000076.html');return false;">
+          <a href="Array.src/M000077.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000077.html');return false;">
           <span class="method-name">last=</span><span class="method-args">(x)</span>
           </a>
         </div>
@@ -820,12 +820,12 @@ Change the last element.
         </div>
       </div>
 
-      <div id="method-M000056" class="method-detail">
-        <a name="M000056"></a>
+      <div id="method-M000057" class="method-detail">
+        <a name="M000057"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000056.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000056.html');return false;">
+          <a href="Array.src/M000057.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000057.html');return false;">
           <span class="method-name">last_index</span><span class="method-args">()</span>
           </a>
         </div>
@@ -842,12 +842,12 @@ Returns the last index of the array. Returns nil is array has no elements.
         </div>
       </div>
 
-      <div id="method-M000075" class="method-detail">
-        <a name="M000075"></a>
+      <div id="method-M000076" class="method-detail">
+        <a name="M000076"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000075.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000075.html');return false;">
+          <a href="Array.src/M000076.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000076.html');return false;">
           <span class="method-name">middle</span><span class="method-args">(offset=0)</span>
           </a>
         </div>
@@ -872,12 +872,12 @@ of the two center elements is indexed as orgin (0).
         </div>
       </div>
 
-      <div id="method-M000071" class="method-detail">
-        <a name="M000071"></a>
+      <div id="method-M000072" class="method-detail">
+        <a name="M000072"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000071.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000071.html');return false;">
+          <a href="Array.src/M000072.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000072.html');return false;">
           <span class="method-name">permute</span><span class="method-args">(prefixed=[]) {|prefixed + self| ...}</span>
           </a>
         </div>
@@ -903,8 +903,8 @@ produces
         </div>
       </div>
 
-      <div id="method-M000061" class="method-detail">
-        <a name="M000061"></a>
+      <div id="method-M000062" class="method-detail">
+        <a name="M000062"></a>
 
         <div class="method-heading">
           <span class="method-name">pick</span><span class="method-args">(number=nil)</span>
@@ -912,17 +912,17 @@ produces
       
         <div class="method-description">
           <p>
-Alias for <a href="Array.html#M000060">at_rand!</a>
+Alias for <a href="Array.html#M000061">at_rand!</a>
 </p>
         </div>
       </div>
 
-      <div id="method-M000069" class="method-detail">
-        <a name="M000069"></a>
+      <div id="method-M000070" class="method-detail">
+        <a name="M000070"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000069.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000069.html');return false;">
+          <a href="Array.src/M000070.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000070.html');return false;">
           <span class="method-name">pos</span><span class="method-args">(i)</span>
           </a>
         </div>
@@ -941,12 +941,12 @@ to -1.
         </div>
       </div>
 
-      <div id="method-M000059" class="method-detail">
-        <a name="M000059"></a>
+      <div id="method-M000060" class="method-detail">
+        <a name="M000060"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000059.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000059.html');return false;">
+          <a href="Array.src/M000060.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000060.html');return false;">
           <span class="method-name">rand_index</span><span class="method-args">( number=nil, exclusive=true )</span>
           </a>
         </div>
@@ -974,12 +974,12 @@ indexes are returned.
         </div>
       </div>
 
-      <div id="method-M000063" class="method-detail">
-        <a name="M000063"></a>
+      <div id="method-M000064" class="method-detail">
+        <a name="M000064"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000063.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000063.html');return false;">
+          <a href="Array.src/M000064.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000064.html');return false;">
           <span class="method-name">range</span><span class="method-args">(a=nil,z=nil)</span>
           </a>
         </div>
@@ -998,12 +998,12 @@ returns the range from first to last.
         </div>
       </div>
 
-      <div id="method-M000070" class="method-detail">
-        <a name="M000070"></a>
+      <div id="method-M000071" class="method-detail">
+        <a name="M000071"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000070.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000070.html');return false;">
+          <a href="Array.src/M000071.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000071.html');return false;">
           <span class="method-name">rotate</span><span class="method-args">(n=1)</span>
           </a>
         </div>
@@ -1029,19 +1029,19 @@ A negative parameter reverses the order from front to back.
         </div>
       </div>
 
-      <div id="method-M000054" class="method-detail">
-        <a name="M000054"></a>
+      <div id="method-M000055" class="method-detail">
+        <a name="M000055"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000054.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000054.html');return false;">
+          <a href="Array.src/M000055.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000055.html');return false;">
           <span class="method-name">rotate!</span><span class="method-args">(n=1)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-Same as <a href="Array.html#M000070">rotate</a>, but acts in place.
+Same as <a href="Array.html#M000071">rotate</a>, but acts in place.
 </p>
 <pre>
   require 'facet/array/rotate'
@@ -1053,12 +1053,12 @@ Same as <a href="Array.html#M000070">rotate</a>, but acts in place.
         </div>
       </div>
 
-      <div id="method-M000050" class="method-detail">
-        <a name="M000050"></a>
+      <div id="method-M000051" class="method-detail">
+        <a name="M000051"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000050.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000050.html');return false;">
+          <a href="Array.src/M000051.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000051.html');return false;">
           <span class="method-name">select!</span><span class="method-args">( {|| ...}</span>
           </a>
         </div>
@@ -1077,12 +1077,12 @@ As with select but modifies the <a href="Array.html">Array</a> in place.
         </div>
       </div>
 
-      <div id="method-M000072" class="method-detail">
-        <a name="M000072"></a>
+      <div id="method-M000073" class="method-detail">
+        <a name="M000073"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000072.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000072.html');return false;">
+          <a href="Array.src/M000073.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000073.html');return false;">
           <span class="method-name">shuffle</span><span class="method-args">()</span>
           </a>
         </div>
@@ -1099,19 +1099,19 @@ Randomize the order of an array.
         </div>
       </div>
 
-      <div id="method-M000055" class="method-detail">
-        <a name="M000055"></a>
+      <div id="method-M000056" class="method-detail">
+        <a name="M000056"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000055.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000055.html');return false;">
+          <a href="Array.src/M000056.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000056.html');return false;">
           <span class="method-name">shuffle!</span><span class="method-args">()</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-As with <a href="Array.html#M000072">shuffle</a> but modifies the array in
+As with <a href="Array.html#M000073">shuffle</a> but modifies the array in
 place. The algorithm used here is known as a Fisher-Yates shuffle.
 </p>
 <pre>
@@ -1124,8 +1124,8 @@ place. The algorithm used here is known as a Fisher-Yates shuffle.
         </div>
       </div>
 
-      <div id="method-M000078" class="method-detail">
-        <a name="M000078"></a>
+      <div id="method-M000079" class="method-detail">
+        <a name="M000079"></a>
 
         <div class="method-heading">
           <span class="method-name">store</span><span class="method-args">(*args)</span>
@@ -1138,12 +1138,12 @@ Alias for #[]=
         </div>
       </div>
 
-      <div id="method-M000051" class="method-detail">
-        <a name="M000051"></a>
+      <div id="method-M000052" class="method-detail">
+        <a name="M000052"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000051.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000051.html');return false;">
+          <a href="Array.src/M000052.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000052.html');return false;">
           <span class="method-name">tail</span><span class="method-args">()</span>
           </a>
         </div>
@@ -1158,12 +1158,12 @@ Returns an array from second element to last element.
         </div>
       </div>
 
-      <div id="method-M000057" class="method-detail">
-        <a name="M000057"></a>
+      <div id="method-M000058" class="method-detail">
+        <a name="M000058"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000057.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000057.html');return false;">
+          <a href="Array.src/M000058.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000058.html');return false;">
           <span class="method-name">thru</span><span class="method-args">( from, to )</span>
           </a>
         </div>
@@ -1181,12 +1181,12 @@ Fetch values from a start index thru an end index.
         </div>
       </div>
 
-      <div id="method-M000065" class="method-detail">
-        <a name="M000065"></a>
+      <div id="method-M000066" class="method-detail">
+        <a name="M000066"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000065.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000065.html');return false;">
+          <a href="Array.src/M000066.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000066.html');return false;">
           <span class="method-name">to_b</span><span class="method-args">()</span>
           </a>
         </div>
@@ -1198,12 +1198,12 @@ Boolean conversion for not empty?
         </div>
       </div>
 
-      <div id="method-M000066" class="method-detail">
-        <a name="M000066"></a>
+      <div id="method-M000067" class="method-detail">
+        <a name="M000067"></a>
 
         <div class="method-heading">
-          <a href="Array.src/M000066.html" target="Code" class="method-signature"
-            onclick="popupCode('Array.src/M000066.html');return false;">
+          <a href="Array.src/M000067.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000067.html');return false;">
           <span class="method-name">to_h</span><span class="method-args">(values=nil)</span>
           </a>
         </div>
@@ -1213,7 +1213,7 @@ Boolean conversion for not empty?
 Produces a hash for an <a href="Array.html">Array</a>, or two arrays.
 </p>
 <p>
-If no parameter is given, <a href="Array.html#M000066">to_h</a> expects the
+If no parameter is given, <a href="Array.html#M000067">to_h</a> expects the
 receiving array to be associative.
 </p>
 <pre>