some more javadoc, why not