patch some javadoc warnings

This should fix some javadoc warnings in our code.