doc: clarify that shuffle returns a permuted copy of its argument.