Sage, thank you much for your comment (#4). Tv, thanks for guidance and
letting me play along.
The ceph build already separates the main build from docs, and the
requirements for building are already quite substantial, so if someone
is up to the task of building deb packages on their own then the
This might be more to the specs Tv offered:
https://github.com/seanchannel/ceph/commit/08f13c95bf210f433636d00d76b725feee6d3a37
. took out --quiet so you can see what is going into venv,
. check for path to sphinx-build
. added explicit call to venv python
--
You received this bug notification
if it's a question of weather to install sphinx or kludge the use of it
from system packages, I'd say whichever is less likely to break at some
point later.
Otherwise; number one goal is Make Tv Happy.
--
You received this bug notification because you are a member of Ubuntu
Bugs, which is subscr
Comment #6 is incorrect, you don't need to install Sphinx in the
virtualenv, you just need to have the virtualenv active (so the
extensions can be found).
Here's one way to achieve that:
PYTHONPATH=`pwd`/../src/pybind ./virtualenv/bin/python /usr/bin/sphinx-
build -a -b dirhtml -d doctrees ../doc
just an update: Tv was right about the use of virtualenv: sphinx has to
be *built* in the presence of sphinx-ditaa and asphyxiate, not taken
from an installed system package. The burden on virtualenv can still be
minimised if all other deps are installed [from platform repos
(ubuntu)], but not pyth
I must agree w/ Tv that keeping the docs build separate helps source
users who don't need to deal with all that. Many other projects actually
do that ('cd doc; make html') due to substantial additional build deps.,
and I think I can take some cues from that.
The top Makefile could just include an
I think if we package them at all, they should probably be in the
regular debian directory so that they get built along with regular
releases... otherwise it will be a lot of additional work to build and
publish the packages. The rules or Makefile would probably need to do
things like clone sphinx
I can perhaps add a separate Makefile & debian under doc to build a
package for this if you are interested (via github & cephs contrib
guildlines).
--
You received this bug notification because you are a member of Ubuntu
Bugs, which is subscribed to Ubuntu.
https://bugs.launchpad.net/bugs/1056103
Got it, but the build prereqs for docs are not needed after they've been
generated. I transfered them to a system with none of that stuff and
they can be read in a browser or via local server just fine.
Once generated, the html docs can go into /usr/share/doc/ceph-doc from a
similarly named packag
We originally decided not to package the docs, as generating them ends
up requiring some fairly obscure packages, and we didn't want to force
everyone building ceph to install all of them. Some things like sphinx-
ditaa and asphyxiate were created from scratch, so they're not even
packaged currentl
** Changed in: ceph (Ubuntu)
Importance: Undecided => Low
** Changed in: ceph (Ubuntu)
Importance: Low => Wishlist
** Changed in: ceph (Ubuntu)
Status: New => Triaged
--
You received this bug notification because you are a member of Ubuntu
Bugs, which is subscribed to Ubuntu.
https
11 matches
Mail list logo
