adding more javadoc