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

Jason Gunthorpe
2016-09-23T21:38:19Z

On Fri, Sep 23, 2016 at 09:23:42PM +0000, Hefty, Sean wrote:
> > rsocket.7 had an errant text substitution that never worked, it is
> > a good idea to have the man pages use the correct paths, so let
> > us have cmake run them through.
> >
> > Any man page ending in '.in' will be substituted automatically.
> >
> > Signed-off-by: Jason Gunthorpe <jgunthorpe-ePGOBjL8dl3ta4EC/59zMFaTQe2KTcn/@public.gmane.org>
>
> Acked-by: Sean Hefty <sean.hefty-ral2JQCrhuEAvxtiuMwx3w@public.gmane.org>
>
> FWIW, I'm in favor of replacing the man pages with markdown and then
> generating the man pages from that. I volunteer someone else to do
> that work.

I concur, and someone else should do the work ..

We could begin by requiring all new man pages to be in markdown
format. Do you do this in libfabric? What conversion tool do you like?

I've used rst for this in the past with reasonable results..

Jason