Re: ANN: pandoc 1.14.1

[John MacFarlane <jgm-TVLZxgkOlNX2fBVCVOL8/A@public.gmane.org>]

Actually, looking at the man page situation, I'm tempted
to change to using one big man page (pandoc.1) instead of
pandoc.1 and pandoc_markdown.5.

Currently these are carved out of the README.  But parts
of pandoc.1 actually refer to sections that end up
in pandoc_markdown.5.

If we did this, we'd be closer to being able to generate
the man page using a straightforward pandoc command with
README and a custom template.  We'd also need custom
filters for the other transformations we do (remove links,
capitalize headers).

Man page generation would then be something like:

    pandoc README -t man -s --template man/man_template.1 \
      --filter man/removeLinks.hs \
      --filter man/capitalizeHeaders.hs \
      -o pandoc.1

I like that better than including `--man1` and `--man5`
in pandoc itself, and I don't know why I didn't think of
doing it this way.