javadoc added/clarified