update readme and javadoc