Added documentation for Array#sample

ruby · seanmarcia · Jan 3, 2012 · Jan 3, 2012 · 81a77fe64547da2446b44f1771755185d547c09a
commit 81a77fe64547da2446b44f1771755185d547c09a
diff --git a/array.c b/array.c
@@ -3952,7 +3952,10 @@ rb_ary_shuffle(int argc, VALUE *argv, VALUE ary)
  *  contained duplicate elements. If the array is empty the first form returns
  *  <code>nil</code> and the second form returns an empty array.
  *
- *  If +rng+ is given, it will be used as the random number generator.
+ *  
+ *     a = [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ]
+ *     a.sample         #=> [7]
+ *     a.sample(4)      #=> [6, 4, 2, 5]
  */