added javadoc: