PIVOT-976: Some Javadoc fixes (according to Java 8). Some of the files that have only a few warnings (although the tool stops listing at 100 warnings, so there are still an unknown number to be found).