added javadoc to 2 methods