added javadoc coments