Add phpDocumentor comments throughout to improve IDE support

This addresses issue #2.

This also allows you to create documentation for all the classes and methods using [phpDocumentor](http://www.phpdoc.org/)
@mikealmond ,

Sorry, by functional changes I meant changes made outside of comment blocks. Essentially your first two commits. Thanks again!