Broadly improved the DocBlocks and other code cleanup

Now every php file has a header comment block with all the CakePHP standard stuff
Synced PHP version annotations
Fixed @license tag, url comes first
Removed all @subpackage, replaced by only @package
Fixed @package tags to reflect directory structure
Whitespace and other minor code cleanup
Fixed many @param and @return tags
Now phpDocumentator doesn't complain anything
Copied @since tags from file comment block to class, now appears in api docs, too
Merge pull request #75 from ravage84/docblock-improvements

Broadly improved the DocBlocks and other code cleanup