added javadoc to function repor