added javadoc comments to new methods