HBASE-984 Fix javadoc warnings This is probably the first of several patches to fix javadoc warnings. Jira issue will remain open until we create the release candidate.