added a tid bit of javadoc