On Tue, 17 Mar 2015, Josh Durgin wrote: > 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. I think the original reason we didn't was just because there are a lot of dependencies for building the docs, so this inflates Build-Depends. That doesn't particularly bother me, though, if the deps do in fact exist. sage -- To unsubscribe from this list: send the line "unsubscribe ceph-devel" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
