minor refactor and javadoc clarification
1 file changed