Update README.md

It was out of date with the latest API.  I also cleaned up the
feature explanations and notes.