added a few javadoc comments