README and javadoc updates