added javadoc comments to methods