From: James Edward Gray II <james@...>
Date: 2005-12-21T01:46:41+09:00
Subject: Array Documentation Issues

Let's start with:

$ ri -T Array.indices
---------------------------------------------------------- Array#indices
      array.indexes( i1, i2, ... iN )   -> an_array
      array.indices( i1, i2, ... iN )   -> an_array
------------------------------------------------------------------------
      Deprecated; use Array#select.

To me, that reads similar to "Bathtub out-of-order, use nearest  
sink."  Can we switch that to
"use Array#values_at"?  I think that's a much closer fit.

Then we have:

$ ri -T Array.initialize_copy
-------------------------------------------------- Array#initialize_copy
      array.replace(other_array)  -> array
------------------------------------------------------------------------
      Replaces the contents of self with the contents of other_array,
      truncating or expanding if necessary.

         a = [ "a", "b", "c", "d", "e" ]
         a.replace([ "x", "y", "z" ])   #=> ["x", "y", "z"]
         a                              #=> ["x", "y", "z"]

I'm not sure what that was *suppose* to say, but I'm betting (and  
hoping) it wasn't that.

I'll be happy to make patches, if people agree with me.  (Though  
someone has to tell me what the second one is supposed to say.)

James Edward Gray II