clarify some javadoc