RE: [PATCH 05/13] Have cmake run man pages through text substitution

Hefty, Sean
2016-09-26T15:19:53Z

> Infiniband-diags uses rst through rst2man. But if I had to do it over
> I would probably do it different. rst2man is not always installed and
> has caused build issues for some people. Whatever tool we use I would
> recommend it be something common. I'm not too familiar with markdown.
> Is this really common now?

Only by those who want to provide actual documentation.

Libfabric uses a daemon that checks for updates to the markdown pages. If it finds any, it generates the man page and commits those changes to the source tree. So the tar file always has the actual man page. Our tool selection was based on what worked well with github and web page generation.