Add missing docblocks
Fix up docblocks for best phpDocumentor2 output
Add phpdoc.xml config for phpDocumentor2
Initial script to generate and fixup docs

- Currently has some mojibake, adding extraneous &Acirc; in multiple locations.
Don't fix top nav as this has been fixed upstream

This solves the mojibake issue also
Fixup docblocks
Merge pull request #52 from dshafik/phpdocumentor2

Many docblock fixes + move to phpDocumentor2 docs
Update README to reflect switch to phpDocumentor2

- Removed Doxygen references
- Added phpDocumentor2 installation info
- Updated docs URL to use github.io domain