Cleaning up comments

Removing unnecessary phpdoc @package & @uses and adding clarity to a couple of the class comments