updated javadoc

updated javadoc and made note of another perf improvement