Some more clarification, particularly regexps

I think the changes are pretty self-explanatory. I think if you accept this, it'll get merged to the pull request to the master on pydata... but feel free to re-jigger the merge however you'd like.