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.