added javadocs to new methods