added javadoc comments part 2