Cleanup inline documentation

* Drop non-informative "@since always" tags.
* Drop some self-explanatory descriptions.
* Add some missing tags.
Restore disputed tags
Merge pull request #5 from DataValues/doc-cleanup

Cleanup inline documentation