adding more javadoc comments
finalizing java doc comments