#1126 - add javadoc for skip overlaps