#149 fix some javadoc and compiler warnings

But I wanted to know Sue's configuration!