more javadocs written