added javadoc commentary