Create manpage and distribute with the software about mal HOT 4 OPEN

Generating man pages on the process of PUBLISHING the package would nice. As I do by generating the correct rst formatted README for the pypi page. The main idea is have a easy way to edit the manpage as source (like a markdown) and generating a manpage-formatted file on setup.py and packing that file with the the package itself.

When a user install the mal package -- by pip or whatever be -- I would expect that the manpage of mal would be installed as well.

from mal.

What about pandoc?

from mal.

I know pandoc and already use for some things (markdown -> rst for the pypi pages), but I didn't thought before that we can use pandoc for that too... Well, my thing with this is getting a automatized way to setup this without more managing things. Sphinx is great to deal and they generate manpages. But the biggest problem is: how we package this feature to be installed as a pip package? I don't know how to do that (yet).

from mal.

I guess by saying that, you are mentioning generating man pages on user installs other than manually pushing generated man page to master?

I bet you already know but ranger handles that good.

from mal.