Index: array.c
===================================================================
--- array.c (revision 24126)
+++ array.c (working copy)
@@ -3526,9 +3526,11 @@
* array.sample -> obj
* array.sample(n) -> an_array
*
- * Choose a random element, or the random +n+ elements, from the array.
- * If the array is empty, the first form returns nil
, and the
- * second form returns an empty array.
+ * Choose a random element or +n+ random elements from the array. The elements
+ * are chosen by using random and unique indices into the array in order to
+ * ensure that an element doesn't repeat itself unless the array already
+ * contained duplicate elements. If the array is empty the first form returns
+ * nil
and the second form returns an empty array.
*
*/