Improve comments
* Add documentation and examples of ?m and ?k placeholders
* Fix typos
* Rewrite a couple of docstrings that were hard to understand or had bad English
Add examples from code comments to README.md