add some Javadocs