Complete README and a few name changes

* fill in README for users
* fix a JAR name, according to changed package name
* fix a deprecated method usage