Lots of doc block changes and reformatting of code.
Merge pull request #154 from findsorguk/docBlockPASLibrary

Lots of doc block changes and reformatting of code.