various tweaks and cleanups

decided to do a PR against your PR so you can see what i am doing.
In match.rst if I'm not mistaken.