I'm not sure whether this is a user error or pandoc being too eager.
When using pandoc to generate man pages, it's common to have lots of
"--" (two dashes) for command line options. This is left as-is in the
html output, for example, but the man output converts these into \[em],
which means on text terminals these look like a single dash, and
furthermore copy-paste into a shell is broken.
It is possible to quote the first dash (i.e. write "\--"), but this
becomes cumbersome when writing long documents, and it's very easy to
forget doing it.
Thoughts? Would it make more sense to do this only when the --smart
option is on, as the man page implies already (but seems to be untrue)?
I've changed pandoc so it doesn't automatically use --smart
for man output.
Thanks, that makes sense. Yay!