add few javadocs