PSR2 edits and docblock updates

 - Updated docblocks to reflect the current API and signatures.
 - Updated minor edits for PSR2 compliance.
 - Added IETF Draft proposal link to readme.
More CS fixes for PSR-2
Merge pull request #11 from zircote/feature/api-doc-blocks-cleanup

PSR2 edits and docblock updates