Correctly escape "-" in options in man page

Autogenerated man pages are using - instead of \- for the options.
Change the option formatter to escape - correctly.
Scrub extra rst markup from man pages

Many tools have a --manpage option that generates a man page using an
autoformatter of the --help output. The output may contain some raw rst
constructs that are groff errors, so filtering them out makes man happier.
Preserve blank lines in description for paragraphs