Improve JavaDoc, including style fixes

-------------
Created by MOE: http://code.google.com/p/moe-java
MOE_MIGRATED_REVID=68555036
3 files changed
tree: 42b0e2e40c4fc1ea36c365617adbf5ecdffce5d3
  1. core/
  2. stub/
  3. testing/
  4. LICENSE