[openstack-dev] [opinion-wanted] Clients man pages

Pete Zaitcev zaitcev at redhat.com
Thu May 23 15:02:45 UTC 2013


On Wed, 22 May 2013 07:46:45 -0400
Sean Dague <sean at dague.net> wrote:

> My experience is that you never get a good result trying to create man 
> pages out of comments embedded in the code.

Ditto

> I'd suggest doing rst in doc/source like is being done with other 
> projects. The sphinx rules can build man format easily enough.

Is there an example you can recommend?

-- Pete



More information about the OpenStack-dev mailing list