add a few javadoc