Update README.rst

Document options and update doctests.