[smcameron]

If you create and distribute an executable for linux/unix, and you don't create a man page for it, you are committing a crime against humanity.

[runlevel1]

And pandoc makes it easy:

https://eddieantonio.ca/blog/2015/12/18/authoring-manpages-i...

[eichin]

Huh, I wonder how close that is to what `ronn` does (also markdown to man, via a couple of paths, written in ruby.)

[enriquto]

> If you create and distribute an executable for linux/unix, and you don't create a man page for it, you are committing a crime against humanity.

I agree.

And it's so easy to do! As long as your program has a --help option, creating the manpage simply amounts to calling help2man. Just add this to your makefile:

    foo.1 : foo ; help2man -N foo > foo.1