Javadoc for annotations and fixes to existing.

Adds Javadocs for all the annotations. I also went through and
corrected every other javadoc that was triggering a warning
during generation.
Merge pull request #406 from basho/orm-and-annotation-docs

Javadoc for annotations and fixes to existing.