docs: Clarify that randomElements() does not repeat input elements

readme.md

@@ -107,6 +107,7 @@ Each of the generator properties (like `name`, `address`, and `lorem`) are calle
     randomFloat($nbMaxDecimals = NULL, $min = 0, $max = NULL) // 48.8932
     numberBetween($min = 1000, $max = 9000) // 8567
     randomLetter            // 'b'
+    // returns randomly ordered subsequence of a provided array
     randomElements($array = array ('a','b','c'), $count = 1) // array('c')
     randomElement($array = array ('a','b','c')) // 'b'
     shuffle('hello, world') // 'rlo,h eoldlw'

src/Faker/Provider/Base.php

@@ -156,7 +156,7 @@ public static function randomAscii()
     }
 
     /**
-     * Returns random elements from a provided array
+     * Returns random elements from a provided array (not repeating input indices)
      *
      * @param  array            $array Array to take elements from. Defaults to a-f
      * @param  integer          $count Number of elements to take.