#197: polished and documented
#197: documented in README.md