Documentation: Pathspec, Dirtab and Helper Classes

This adds some descriptive comments and method documentation to `Pathspec`, `PathspecElementPattern`, `PathspecElementPattern::SubPattern` and `Dirtab`. Working with that code yesterday after one month revealed a need for this. ;-)