refined javadoc