enhanced javadoc