updated Javadocs