added the javadocs