adds more javadoc