Permutation: examples and more methods.
Documentation tweaks

Hopefully this will run on readthedocs.org!