DOC: Add example to extract docstring, and re-explain change to match.
@jreback, I added examples per your request in #5099. Also, I rewrote the explanation of how `str.match` is changing, which I left confusing and wordy before.
