added a bit of javadoc