javadoc update for clarity