phpdoc updates

Moved validblah methods to bottom together, added phpdoc blocks comments, updated some.