mash.rb in facets-2.5.0

- old
+ new

@@ -1,18 +1,17 @@
 module Enumerable
 
-  # Like <tt>#map</tt>/<tt>#collect</tt>, but generates a Hash.  The block
+  # Like <tt>#map</tt>/<tt>#collect</tt>, but generates a Hash. The block
   # is expected to return two values: the key and the value for the new hash.
   #
   #   numbers  = (1..3)
   #   squares  = numbers.mash { |n| [n, n*n] }   # { 1=>1, 2=>4, 3=>9 }
   #   sq_roots = numbers.mash { |n| [n*n, n] }   # { 1=>1, 4=>2, 9=>3 }
   #
-  # CREDIT: Trans
-  # CREDIT: Andrew Dudzik (adudzik)
+  # The name "mash" stands for "map hash".
   #
-  # NOTE: Would #correlate would be better?
+  # CREDIT: Andrew Dudzik (adudzik), Trans
 
   def mash(&yld)
     if yld
       inject({}) do |h, *kv| # Used to be inject({}) do |h,kv|
         r = *yld[*kv]        # The *-op works differnt from to_a on single element hash!!!
@@ -23,10 +22,10 @@
     else
       Enumerator.new(self,:graph)  # Used to be Hash[*self.to_a] or Hash[*self.to_a.flatten]
     end
   end
 
-  # Alias for #mash. This is the original name for this method.
+  # Alias for #mash. This is the original name of this method.
   alias_method :graph, :mash
 
 end
 