On Thu, Mar 07, 2024 at 08:37:12AM +0100, John Paul Adrian Glaubitz wrote:
> cyrus-sasl2 is one of the core dependencies required for bootstrapping Debian
> but requires the Pyton package Sphinx for building documentation. This can be
> easily avoided by removing the "doc-html" target during build. This way, the
> python3-sphinx-rtd-theme build dependency can be omitted.

Hmm, yes. This has kinda been addressed for the cross case by annotating
the relevant dependency :native, but I see how this is still relevant
natively.

> It would be ideal for a "nodoc" build profile which I am asking to be added 
> here.

Please don't. cyrus-sasl2 has split out its documentation to an Arch:all
package. As such, doing an arch-only build should already skip
documentation. I see that this is not how cyrus-sasl2 is packaged, but
demoting the sphinx dependency to Build-Depends-Indep is a much better
solution, because nodoc is a gross mess and you never know what goes
missing there. Instead, with the arch/indep split, we have a quite good
understanding of what the build output will be. It also means that
buildds immediately benefit from the change and you don't have to do a
binary upload.

So please don't do nodoc. Do a proper arch/indep split instead.

Helmut

Reply via email to