Jani Nikula <jani at nikula.org> writes: > On Wed, 15 Jan 2014, David Bremner <david at tethera.net> wrote: >> From: David Bremner <bremner at debian.org>
> In short, I'm really tempted by using markdown as the format, not least > because it's what we use for the web pages. The big (also literally) > downside is pandoc (http://johnmacfarlane.net/pandoc/), the tool for > converting markdown to man. I don't mind its dependencies, others may > disagree. Are there any sensible alternatives to pandoc? To complicate things, if we did decide on something heavyweight I think I'd propose we think about rst instead of markdown. I don't rst as well as markdown, but markdown does feel a little too adhoc to me from time to time (e.g. a verbatim block forcing the end of a list and so on). As far as I can tell, there are many incompatible versions of markdown as soon as you start to want e.g. tables. In any case, rst -> man is supported by python-docutils. sphinx supports both man page generation and texinfo output. So that would be relatively lighter weight alternative (??) to pandoc. A more radical proposal would be to skip generating info and assuming everybody can browse html in emacs. That assumption is supposed to become less ludicrous in emacs24.4 with the inclusion of "eww". d