added javadoc for abstract functions