added a little bit of javadoc