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

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



> 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.
--
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



[Index of Archives]     [Linux USB Devel]     [Video for Linux]     [Linux Audio Users]     [Photo]     [Yosemite News]     [Yosemite Photos]     [Linux Kernel]     [Linux SCSI]     [XFree86]
  Powered by Linux