implement javadoc and adjust existing javadoc