javadoc refinements