improved javadocs