some more javadoc