added javadoc comments to interface