Improved The Docblocks

Let's update the docblocks to match the proposed PSR standard, and fix up the descriptions.