code: @Deprecated
    public static int[] permutation(final int numElements, final Random rng) {
      final int[] permutation = arange(numElements);
      shuffle(permutation, checkNotNull(rng));
      return permutation;
    }
docs: Produces a permutation of the integers from 0 (inclusive) to numElements (exclusive) which can
  then be used to permute other things.
  
  @deprecated Use {@link com.bbn.bue.common.math.Permutation#createForNElements(int, Random)}
  instead, which prevents bugs due to being inconsistent about how to interpret the permutation
  array.