Update the API in the README. FIxes #1

I *think* this is right but let me know if I've missed the mark.