#149 fix some javadoc and compiler warnings

A tiny bit, yes. But that shouldn't be a real problem.