add a bit more javadoc