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 python-sphinx. It still makes for a noticeably leaner and faster docs build.
I shall revisit how/where to shoehorn that in without disrupting things.
Subsequently, getting a docs package to build will be detached from the main build/packages while making use of the same debian resources as much as possible (likely with symlinks), so I'm still _not_ going to force docs to be built and/or packaged along with the main build.
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 python-sphinx. It still makes for a noticeably leaner and faster docs build.
I shall revisit how/where to shoehorn that in without disrupting things.
Subsequently, getting a docs package to build will be detached from the main build/packages while making use of the same debian resources as much as possible (likely with symlinks), so I'm still _not_ going to force docs to be built and/or packaged along with the main build.