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/)
@maximeprades @Nebopolis