I'm having some trouble with the "All methods should have a Javadoc comment" rule.
1) For the "compareTo" method within the Comparable interface, a single non-Javadoc comment is flagged. "Allow non-javadoc comments with only a single @see tag" is checked.
2) For the "compareTo" method within the Comparable interface, if I change the comment to be a Javadoc comment with just a single @see comment I then get a violation for "missing @return tag" and "missing @param tag". It seems the "Check @param tags" and "Check @return tags" settings argue with the "Allow comments with only a single @see tag" setting.