added a few javadocs