updated README.md to new semantics