improve javadoc api