PIVOT-976: More Javadoc corrections (warnings found by Java 8) in twenty files. Still many, many more Javadoc warnings left to fix.