improved javadoc