updated some javadocs