fix javadoc warnings and polish