updated README to match the new API

Also rewrite usage information to make it more clear