more thorough javadoc comments in MarkerHandler