update README to describe new changes & fix errors
version bump to 2.0.0

Since the recent interface changes break the previous API, this
is a major version bump.