Remove @uses from phpdocs, with some minor corrections.

See #19.
Add details for @param tags in docblocks. Also remove any remaining @global tags. Fixes #19.
Merge branch 'phpdocs'