update permutation docstring