add javadoc to some methods