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.

**There are no code changes in this PR**