more javadocs added