bin/gen_release_notes.py: more robust rST escaping

This copies code from the xml2rst to escape rST strings. Hopefully this will be more robust than what we've done so far.

I really wish docutils would have utils for this directly, seems kinda essential.