completed some javadocs