Could use a UNIX man page

[drwebb]

Related to #74

It would be nice to provide a man page with the distribution packages that are installed on the user's system.

[bitemyapp]

@drwebb do you know of any Haskell projects that have examples of manpages and the installation thereof provided for as part of the install? Would make it easier for somebody to jump in and do this as a first ticket.

[drwebb]

I took a lucky guess and it looks like pandoc does it:
https://github.com/jgm/pandoc/blob/master/Makefile
I have never looked into it myself, but this might be a jumping off point.

[bitemyapp]

@drwebb excellent, thank you. Now a contributor knows where to look! 👍 🐻 😄

[chreekat]

See also the mini howto. Even if someone wants to start with markdown and convert with pandoc, it's still a nice reference for the structure of a man page.

[chrisdone]

One of the options parsers libraries does support generating man pages. Bas van Dyke made one at Better, but I don't recall in what form it was released.

[drwebb]

If there are no other takers, I'll try to throw up something for the next release and we can refine the generation later if I end up just writing it by hand.

[snoyberg]

Sold!

[drwebb]

Added a basic man page in c2e5af3. It's mostly hand written. Are we going to keep all the config parsers in Main.hs? It makes the a little inaccessible to an auto generation using pandoc.

pinging @manny-fp and @dysinger to remember to include them in their distro releases

[drwebb]

Closing this now for the moment, we should move to improving the current man page as part of the release process and look to auto generation in the future.