README.md updated to reflect changes to the API

I've updated the README to match the current API (code example now compiles). The last line with the superset is a bit messy. There may be a better way?