fix at least some JavaDoc warnings

This fixes some javadoc warnings and makes the build a little less noisy.