add a bit of javadoc