I found that I could not build the docs on Ubuntu 14.10 with the proper
packages installed. Kefu is looking into Asphyxiate which is very
tempermental. I installed an Ubuntu 11.10 in order to generate docs.
David
On 3/17/15 10:11 AM, Sage Weil wrote:
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 majord...@vger.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
--
To unsubscribe from this list: send the line "unsubscribe ceph-devel" in
the body of a message to majord...@vger.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html