More work on documentation, still not complete.

Also reversed the order of parameters passed to 'peel'. This makes it easier to explain in the documentation what 'peel' does.