added javadoc comments for all public methods