javadoc clarification

see issue #101