On Mon, Sep 26, 2016 at 06:30:21AM +0000, Weiny, Ira wrote: > > > > 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@xxxxxxxxxxxxxxxxxxxx> > > > > > > Acked-by: Sean Hefty <sean.hefty@xxxxxxxxx> > > > > > > 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.. > > 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? Among hipsters - yes :) > > Ira > > > > > Jason > > -- > > To unsubscribe from this list: send the line "unsubscribe linux-rdma" in the > > body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at > > http://vger.kernel.org/majordomo-info.html > -- > To unsubscribe from this list: send the line "unsubscribe linux-rdma" in > the body of a message to majordomo@xxxxxxxxxxxxxxx > More majordomo info at http://vger.kernel.org/majordomo-info.html
Attachment:
signature.asc
Description: PGP signature