facets 2.4.4 → 2.4.5

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

@@ -32,12 +32,12 @@
           if( elem.style.display == "block" )
           {
             elem.style.display = "none"
-            link.innerHTML = "show source"
+            link.innerHTML = "+"
           }
           else
           {
             elem.style.display = "block"
-            link.innerHTML = "hide source"
+            link.innerHTML = "-"
           }
         }
 
@@ -71,11 +71,14 @@
 
   <div class="description"><h1><a href="Indexable.html">Indexable</a></h1>
 <p>
-<a href="Indexable.html">Indexable</a> is a mixin that provides index based
-methods, working soley with four methods: index, slice, splice and size.
+<a href="Indexable.html">Indexable</a> is a mixin that provides <a
+href="Indexable.html#M000326">index</a> based methods, working soley with
+four methods: <a href="Indexable.html#M000326">index</a>, slice, splice and
+size.
 </p>
 <p>
-These methods work in harmony. Where index returns a position of a given
+These methods work in harmony. Where <a
+href="Indexable.html#M000326">index</a> returns a position of a given
 element, slice returns elements for given positions. splice is like slice
 but replaces the given position with new values. This mehtod is not part of
 ruby core, but it generally just an alias for #[]=, just as slice is an
@@ -87,25 +90,24 @@ indexable object.
 
 
   <div class="sectiontitle">Methods</div>
-  <ul>
-  <li><a href="#M000308">body</a></li>
-  <li><a href="#M000318">ends</a></li>
-  <li><a href="#M000312">first</a></li>
-  <li><a href="#M000316">first!</a></li>
-  <li><a href="#M000314">first=</a></li>
-  <li><a href="#M000307">foot</a></li>
-  <li><a href="#M000305">head</a></li>
-  <li><a href="#M000320">index_of</a></li>
-  <li><a href="#M000313">last</a></li>
-  <li><a href="#M000317">last!</a></li>
-  <li><a href="#M000315">last=</a></li>
-  <li><a href="#M000309">mid</a></li>
-  <li><a href="#M000310">middle</a></li>
-  <li><a href="#M000319">pos</a></li>
-  <li><a href="#M000321">range</a></li>
-  <li><a href="#M000306">tail</a></li>
-  <li><a href="#M000311">thru</a></li>
-  </ul>
+  <span style="padding-right: 5px;"><a href="#M000314">body</a></span>
+  <span style="padding-right: 5px;"><a href="#M000324">ends</a></span>
+  <span style="padding-right: 5px;"><a href="#M000318">first</a></span>
+  <span style="padding-right: 5px;"><a href="#M000322">first!</a></span>
+  <span style="padding-right: 5px;"><a href="#M000320">first=</a></span>
+  <span style="padding-right: 5px;"><a href="#M000313">foot</a></span>
+  <span style="padding-right: 5px;"><a href="#M000311">head</a></span>
+  <span style="padding-right: 5px;"><a href="#M000326">index</a></span>
+  <span style="padding-right: 5px;"><a href="#M000327">index_of</a></span>
+  <span style="padding-right: 5px;"><a href="#M000319">last</a></span>
+  <span style="padding-right: 5px;"><a href="#M000323">last!</a></span>
+  <span style="padding-right: 5px;"><a href="#M000321">last=</a></span>
+  <span style="padding-right: 5px;"><a href="#M000315">mid</a></span>
+  <span style="padding-right: 5px;"><a href="#M000316">middle</a></span>
+  <span style="padding-right: 5px;"><a href="#M000325">pos</a></span>
+  <span style="padding-right: 5px;"><a href="#M000328">range</a></span>
+  <span style="padding-right: 5px;"><a href="#M000312">tail</a></span>
+  <span style="padding-right: 5px;"><a href="#M000317">thru</a></span>
 
 
 
@@ -115,12 +117,12 @@ indexable object.
 <div class="sectiontitle">Public Instance methods</div>
 <div class="method">
   <div class="title">
-    <a name="M000308"></a><b>body</b>()
+    <a name="M000314"></a><b>body</b>()
   </div>
   <div class="description">
   <p>
-Returns an array of the <a href="Indexable.html#M000312">first</a> element
-upto, but not including, the <a href="Indexable.html#M000313">last</a>
+Returns an array of the <a href="Indexable.html#M000318">first</a> element
+upto, but not including, the <a href="Indexable.html#M000319">last</a>
 element.
 </p>
 <pre>
@@ -128,8 +130,8 @@ element.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000308_source')" id="l_M000308_source">show source</a> ]</p>
-  <div id="M000308_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000314_source')" id="l_M000314_source">+</a> ]</p>
+  <div id="M000314_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/indexable.rb, line 71</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">body</span>
@@ -141,13 +143,14 @@ element.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000318"></a><b>ends</b>()
+    <a name="M000324"></a><b>ends</b>()
   </div>
   <div class="description">
   <p>
-A shorting of &quot;<a href="Indexable.html#M000318">ends</a> at&quot;,
-returns the <a href="Indexable.html#M000313">last</a> index of the
-indexable object. Returns nil if there are no elements.
+A shorting of &quot;<a href="Indexable.html#M000324">ends</a> at&quot;,
+returns the <a href="Indexable.html#M000319">last</a> <a
+href="Indexable.html#M000326">index</a> of the indexable object. Returns
+nil if there are no elements.
 </p>
 <pre>
   [1,2,3,4,5].ends  #=&gt; 4
@@ -157,8 +160,8 @@ This nearly equivalent to +size - 1+.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000318_source')" id="l_M000318_source">show source</a> ]</p>
-  <div id="M000318_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000324_source')" id="l_M000324_source">+</a> ]</p>
+  <div id="M000324_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/indexable.rb, line 192</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">ends</span>
@@ -171,19 +174,19 @@ This nearly equivalent to +size - 1+.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000312"></a><b>first</b>(n=1)
+    <a name="M000318"></a><b>first</b>(n=1)
   </div>
   <div class="description">
   <p>
-Returns <a href="Indexable.html#M000312">first</a> <em>n</em> elements.
+Returns <a href="Indexable.html#M000318">first</a> <em>n</em> elements.
 </p>
 <pre>
   &quot;Hello World&quot;.first(3)  #=&gt; &quot;Hel&quot;
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000312_source')" id="l_M000312_source">show source</a> ]</p>
-  <div id="M000312_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000318_source')" id="l_M000318_source">+</a> ]</p>
+  <div id="M000318_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/indexable.rb, line 130</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">first</span>(<span class="ruby-identifier">n</span>=<span class="ruby-value">1</span>)
@@ -195,11 +198,11 @@ Returns <a href="Indexable.html#M000312">first</a> <em>n</em> elements.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000316"></a><b>first!</b>()
+    <a name="M000322"></a><b>first!</b>()
   </div>
   <div class="description">
   <p>
-Remove and return the <a href="Indexable.html#M000312">first</a> element.
+Remove and return the <a href="Indexable.html#M000318">first</a> element.
 </p>
 <pre>
   a = [1,2,3]
@@ -208,8 +211,8 @@ Remove and return the <a href="Indexable.html#M000312">first</a> element.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000316_source')" id="l_M000316_source">show source</a> ]</p>
-  <div id="M000316_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000322_source')" id="l_M000322_source">+</a> ]</p>
+  <div id="M000322_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/indexable.rb, line 170</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">first!</span>
@@ -221,11 +224,11 @@ Remove and return the <a href="Indexable.html#M000312">first</a> element.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000314"></a><b>first=</b>(x)
+    <a name="M000320"></a><b>first=</b>(x)
   </div>
   <div class="description">
   <p>
-Change the <a href="Indexable.html#M000312">first</a> element.
+Change the <a href="Indexable.html#M000318">first</a> element.
 </p>
 <pre>
   a = [&quot;a&quot;,&quot;y&quot;,&quot;z&quot;]
@@ -234,8 +237,8 @@ Change the <a href="Indexable.html#M000312">first</a> element.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000314_source')" id="l_M000314_source">show source</a> ]</p>
-  <div id="M000314_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000320_source')" id="l_M000320_source">+</a> ]</p>
+  <div id="M000320_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/indexable.rb, line 150</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">first=</span>(<span class="ruby-identifier">x</span>)
@@ -247,20 +250,20 @@ Change the <a href="Indexable.html#M000312">first</a> element.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000307"></a><b>foot</b>()
+    <a name="M000313"></a><b>foot</b>()
   </div>
   <div class="description">
   <p>
-Like <a href="Indexable.html#M000313">last</a>, returning the <a
-href="Indexable.html#M000313">last</a> element in an array.
+Like <a href="Indexable.html#M000319">last</a>, returning the <a
+href="Indexable.html#M000319">last</a> element in an array.
 </p>
 <pre>
   [1,2,3].foot  #=&gt; [3]
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000307_source')" id="l_M000307_source">show source</a> ]</p>
-  <div id="M000307_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000313_source')" id="l_M000313_source">+</a> ]</p>
+  <div id="M000313_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/indexable.rb, line 58</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">foot</span>
@@ -272,20 +275,20 @@ href="Indexable.html#M000313">last</a> element in an array.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000305"></a><b>head</b>()
+    <a name="M000311"></a><b>head</b>()
   </div>
   <div class="description">
   <p>
-Like <a href="Indexable.html#M000312">first</a> but returns the <a
-href="Indexable.html#M000312">first</a> element in a new array.
+Like <a href="Indexable.html#M000318">first</a> but returns the <a
+href="Indexable.html#M000318">first</a> element in a new array.
 </p>
 <pre>
   [1,2,3].head  #=&gt; [1]
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000305_source')" id="l_M000305_source">show source</a> ]</p>
-  <div id="M000305_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000311_source')" id="l_M000311_source">+</a> ]</p>
+  <div id="M000311_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/indexable.rb, line 41</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">head</span>
@@ -297,30 +300,39 @@ href="Indexable.html#M000312">first</a> element in a new array.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000320"></a><b>index_of</b>(obj=nil) {|self[i]| ...}
+    <a name="M000326"></a><b>index</b>(obj=nil) {|slice(i)| ...}
   </div>
   <div class="description">
   <p>
-Returns the index of the <a href="Indexable.html#M000312">first</a> element
-to satisfy the block condition. This is simply index with a block.
+Returns the <a href="Indexable.html#M000326">index</a> of the <a
+href="Indexable.html#M000318">first</a> element equal to the given object
+or satisfying the block condition.
 </p>
 <pre>
-  [1,2,3,4].index_of { |e| e == 3 }  #=&gt; 2
-  [1,2,3,4].index_of { |e| e &gt; 3 }   #=&gt; 3
+  [1,2,3,4].index{ |e| e == 3 }  #=&gt; 2
+  [1,2,3,4].index{ |e| e &gt; 3 }   #=&gt; 3
 </pre>
-<p>
-TODO: Remove Array#index_of when Ruby 1.9 adds block to index.
-</p>
   </div>
+<div class="aka">
+  This method is also aliased as
+  <a href="Indexable.html#M000327">index_of</a>
+</div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000320_source')" id="l_M000320_source">show source</a> ]</p>
-  <div id="M000320_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/indexable.rb, line 219</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">index_of</span>(<span class="ruby-identifier">obj</span>=<span class="ruby-keyword kw">nil</span>,<span class="ruby-operator">&amp;</span><span class="ruby-identifier">blk</span>)
-    <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">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>
+  <p class="source-link">[ <a href="javascript:toggleSource('M000326_source')" id="l_M000326_source">+</a> ]</p>
+  <div id="M000326_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/core/facets/indexable.rb, line 217</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">if</span> <span class="ruby-identifier">block_given?</span>
+      <span class="ruby-identifier">size</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-keyword kw">return</span> <span class="ruby-identifier">i</span> <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">yield</span>(<span class="ruby-identifier">slice</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">size</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-keyword kw">return</span> <span class="ruby-identifier">i</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">obj</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">slice</span>(<span class="ruby-identifier">i</span>)
+      <span class="ruby-keyword kw">end</span>
+    <span class="ruby-keyword kw">end</span>
+    <span class="ruby-keyword kw">nil</span>
   <span class="ruby-keyword kw">end</span>
 </pre>
   </div>
@@ -328,19 +340,29 @@ TODO: Remove Array#index_of when Ruby 1.9 adds block to index.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000313"></a><b>last</b>(n=1)
+    <a name="M000327"></a><b>index_of</b>(obj=nil, &amp;block)
+  </div>
+  <div class="description">
+  <p>
+Alias for <a href="Indexable.html#M000326">index</a>
+</p>
+  </div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000319"></a><b>last</b>(n=1)
   </div>
   <div class="description">
   <p>
-Returns <a href="Indexable.html#M000313">last</a> <em>n</em> elements.
+Returns <a href="Indexable.html#M000319">last</a> <em>n</em> elements.
 </p>
 <pre>
   &quot;Hello World&quot;.last(3)  #=&gt; &quot;rld&quot;
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000313_source')" id="l_M000313_source">show source</a> ]</p>
-  <div id="M000313_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000319_source')" id="l_M000319_source">+</a> ]</p>
+  <div id="M000319_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/indexable.rb, line 138</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">last</span>(<span class="ruby-identifier">n</span>=<span class="ruby-value">1</span>)
@@ -354,11 +376,11 @@ Returns <a href="Indexable.html#M000313">last</a> <em>n</em> elements.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000317"></a><b>last!</b>()
+    <a name="M000323"></a><b>last!</b>()
   </div>
   <div class="description">
   <p>
-Remove and return the <a href="Indexable.html#M000313">last</a> element.
+Remove and return the <a href="Indexable.html#M000319">last</a> element.
 </p>
 <pre>
   a = [1,2,3]
@@ -367,8 +389,8 @@ Remove and return the <a href="Indexable.html#M000313">last</a> element.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000317_source')" id="l_M000317_source">show source</a> ]</p>
-  <div id="M000317_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000323_source')" id="l_M000323_source">+</a> ]</p>
+  <div id="M000323_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/indexable.rb, line 180</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">last!</span>
@@ -380,11 +402,11 @@ Remove and return the <a href="Indexable.html#M000313">last</a> element.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000315"></a><b>last=</b>(x)
+    <a name="M000321"></a><b>last=</b>(x)
   </div>
   <div class="description">
   <p>
-Change the <a href="Indexable.html#M000313">last</a> element.
+Change the <a href="Indexable.html#M000319">last</a> element.
 </p>
 <pre>
   a = [1,2,5]
@@ -393,8 +415,8 @@ Change the <a href="Indexable.html#M000313">last</a> element.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000315_source')" id="l_M000315_source">show source</a> ]</p>
-  <div id="M000315_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000321_source')" id="l_M000321_source">+</a> ]</p>
+  <div id="M000321_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/indexable.rb, line 160</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">last=</span>(<span class="ruby-identifier">x</span>)
@@ -406,16 +428,16 @@ Change the <a href="Indexable.html#M000313">last</a> element.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000309"></a><b>mid</b>(offset=0)
+    <a name="M000315"></a><b>mid</b>(offset=0)
   </div>
   <div class="description">
   <p>
-Returns the <a href="Indexable.html#M000310">middle</a> element of an
+Returns the <a href="Indexable.html#M000316">middle</a> element of an
 array, or the element offset from <a
-href="Indexable.html#M000310">middle</a> if the parameter is given.
+href="Indexable.html#M000316">middle</a> if the parameter is given.
 Even-sized arrays, not having an exact <a
-href="Indexable.html#M000310">middle</a>, return the <a
-href="Indexable.html#M000310">middle</a>-right element.
+href="Indexable.html#M000316">middle</a>, return the <a
+href="Indexable.html#M000316">middle</a>-right element.
 </p>
 <pre>
   [1,2,3,4,5].mid        #=&gt; 3
@@ -430,8 +452,8 @@ of the two center elements is indexed as orgin (0).
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000309_source')" id="l_M000309_source">show source</a> ]</p>
-  <div id="M000309_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000315_source')" id="l_M000315_source">+</a> ]</p>
+  <div id="M000315_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/indexable.rb, line 89</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">mid</span>(<span class="ruby-identifier">offset</span>=<span class="ruby-value">0</span>)
@@ -443,27 +465,27 @@ of the two center elements is indexed as orgin (0).
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000310"></a><b>middle</b>()
+    <a name="M000316"></a><b>middle</b>()
   </div>
   <div class="description">
   <p>
-Returns the <a href="Indexable.html#M000310">middle</a> element(s) of an
+Returns the <a href="Indexable.html#M000316">middle</a> element(s) of an
 array. Even-sized arrays, not having an exact <a
-href="Indexable.html#M000310">middle</a>, returns a two-element array of
-the two <a href="Indexable.html#M000310">middle</a> elements.
+href="Indexable.html#M000316">middle</a>, returns a two-element array of
+the two <a href="Indexable.html#M000316">middle</a> elements.
 </p>
 <pre>
   [1,2,3,4,5].middle        #=&gt; 3
   [1,2,3,4,5,6].middle      #=&gt; [3,4]
 </pre>
 <p>
-In contrast to <a href="Indexable.html#M000309">mid</a> which utilizes an
+In contrast to <a href="Indexable.html#M000315">mid</a> which utilizes an
 offset.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000310_source')" id="l_M000310_source">show source</a> ]</p>
-  <div id="M000310_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000316_source')" id="l_M000316_source">+</a> ]</p>
+  <div id="M000316_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/indexable.rb, line 102</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">middle</span>
@@ -480,12 +502,12 @@ offset.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000319"></a><b>pos</b>(i)
+    <a name="M000325"></a><b>pos</b>(i)
   </div>
   <div class="description">
   <p>
-Returns the positive ordinal index given a cardinal position, 1 to n or -n
-to -1.
+Returns the positive ordinal <a href="Indexable.html#M000326">index</a>
+given a cardinal position, 1 to n or -n to -1.
 </p>
 <pre>
   [1,2,3,4,5].pos(1)   #=&gt; 0
@@ -493,8 +515,8 @@ to -1.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000319_source')" id="l_M000319_source">show source</a> ]</p>
-  <div id="M000319_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000325_source')" id="l_M000325_source">+</a> ]</p>
+  <div id="M000325_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/indexable.rb, line 203</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">pos</span>(<span class="ruby-identifier">i</span>)
@@ -510,15 +532,15 @@ to -1.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000321"></a><b>range</b>(a=nil,z=nil)
+    <a name="M000328"></a><b>range</b>(a=nil,z=nil)
   </div>
   <div class="description">
   <p>
-Returns the index <a href="Indexable.html#M000321">range</a> between two
-elements. If no elements are given, returns the <a
-href="Indexable.html#M000321">range</a> from <a
-href="Indexable.html#M000312">first</a> to <a
-href="Indexable.html#M000313">last</a>.
+Returns the <a href="Indexable.html#M000326">index</a> <a
+href="Indexable.html#M000328">range</a> between two elements. If no
+elements are given, returns the <a href="Indexable.html#M000328">range</a>
+from <a href="Indexable.html#M000318">first</a> to <a
+href="Indexable.html#M000319">last</a>.
 </p>
 <pre>
   ['a','b','c','d'].range            #=&gt; 0..3
@@ -526,10 +548,10 @@ href="Indexable.html#M000313">last</a>.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000321_source')" id="l_M000321_source">show source</a> ]</p>
-  <div id="M000321_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000328_source')" id="l_M000328_source">+</a> ]</p>
+  <div id="M000328_source" class="dyn-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/core/facets/indexable.rb, line 234</span>
+<span class="ruby-comment cmt"># File lib/core/facets/indexable.rb, line 242</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">range</span>(<span class="ruby-identifier">a</span>=<span class="ruby-keyword kw">nil</span>,<span class="ruby-identifier">z</span>=<span class="ruby-keyword kw">nil</span>)
     <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">a</span>
       <span class="ruby-value">0</span><span class="ruby-operator">..</span>(<span class="ruby-identifier">size</span><span class="ruby-operator">-</span><span class="ruby-value">1</span>)
@@ -543,20 +565,20 @@ href="Indexable.html#M000313">last</a>.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000306"></a><b>tail</b>()
+    <a name="M000312"></a><b>tail</b>()
   </div>
   <div class="description">
   <p>
 Returns an array from second element to <a
-href="Indexable.html#M000313">last</a> element.
+href="Indexable.html#M000319">last</a> element.
 </p>
 <pre>
   [1,2,3].tail  #=&gt; [2,3]
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000306_source')" id="l_M000306_source">show source</a> ]</p>
-  <div id="M000306_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000312_source')" id="l_M000312_source">+</a> ]</p>
+  <div id="M000312_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/indexable.rb, line 49</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">tail</span>
@@ -568,12 +590,13 @@ href="Indexable.html#M000313">last</a> element.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000311"></a><b>thru</b>(from, to)
+    <a name="M000317"></a><b>thru</b>(from, to)
   </div>
   <div class="description">
   <p>
-Fetch values from a start index <a href="Indexable.html#M000311">thru</a>
-an end index.
+Fetch values from a start <a href="Indexable.html#M000326">index</a> <a
+href="Indexable.html#M000317">thru</a> an end <a
+href="Indexable.html#M000326">index</a>.
 </p>
 <pre>
   [1,2,3,4,5].thru(0,2)  #=&gt; [1,2,3]
@@ -581,8 +604,8 @@ an end index.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000311_source')" id="l_M000311_source">show source</a> ]</p>
-  <div id="M000311_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000317_source')" id="l_M000317_source">+</a> ]</p>
+  <div id="M000317_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/indexable.rb, line 116</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">thru</span>(<span class="ruby-identifier">from</span>, <span class="ruby-identifier">to</span>)