Improve dirperm documentation

Fixes #260