suppress JDK8 compilation errors and warnings for #93

I added and modified some comments to meet the Javadoc Spec of JDK 8.