On 03/17/2015 09:40 AM, Ken Dreyer wrote:
I had a question about the way that we're handling man pages.
In 356a749f63181d401d16371446bb8dc4f196c2a6 , "rbd: regenerate rbd(8)
man page", it looks like man/rbd.8 was regenerated from doc/man/8/rbd.rst
It seems like it would be more efficient to avoid storing man pages in
Git and generate them dynamically at build time instead?
Yes, that'd be great!
https://github.com/ceph/ceph/blob/master/admin/manpage-howto.txt
"admin/build-doc" does a lot of things (including man page generation).
Could we simply run the "sphinx-build -b man" part at build time as a
part of "make"?
I don't see a reason not to. It's just a matter of making it work on all
the platforms we're building packages for. That might be annoying for
the entirety of build-doc, but for just building man pages it should
be simple.
Josh
--
To unsubscribe from this list: send the line "unsubscribe ceph-devel" in
the body of a message to [email protected]
More majordomo info at http://vger.kernel.org/majordomo-info.html
