Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]


Groups > linux.debian.bugs.dist > #1189345 > unrolled thread

Bug#1065595: cyrus-sasl2: Please add nodoc build profile to allow disabling documentation

Started byJohn Paul Adrian Glaubitz <glaubitz@physik.fu-berlin.de>
First post2024-03-07 08:40 +0100
Last post2024-03-08 16:40 +0100
Articles 2 — 2 participants

Back to article view | Back to linux.debian.bugs.dist


Contents

  Bug#1065595: cyrus-sasl2: Please add nodoc build profile to allow disabling documentation John Paul Adrian Glaubitz <glaubitz@physik.fu-berlin.de> - 2024-03-07 08:40 +0100
    Bug#1065595: cyrus-sasl2: Please add nodoc build profile to allow disabling documentation Helmut Grohne <helmut@subdivi.de> - 2024-03-08 16:40 +0100

#1189345 — Bug#1065595: cyrus-sasl2: Please add nodoc build profile to allow disabling documentation

FromJohn Paul Adrian Glaubitz <glaubitz@physik.fu-berlin.de>
Date2024-03-07 08:40 +0100
SubjectBug#1065595: cyrus-sasl2: Please add nodoc build profile to allow disabling documentation
Message-ID<Ifgw9-eYME-3@gated-at.bofh.it>
Source: cyrus-sasl2
Version: 2.1.28+dfsg1-4
Severity: normal
User: helmutg@debian.org
Usertags: rebootstrap
X-Debbugs-Cc: helmutg@debian.org

Hello,

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.

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

Thanks,
Adrian

--
 .''`.  John Paul Adrian Glaubitz
: :' :  Debian Developer
`. `'   Physicist
  `-    GPG: 62FF 8A75 84E0 2956 9546  0006 7426 3B37 F5B5 F913

[toc] | [next] | [standalone]


#1189457

FromHelmut Grohne <helmut@subdivi.de>
Date2024-03-08 16:40 +0100
Message-ID<IfKud-fhem-19@gated-at.bofh.it>
In reply to#1189345
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

[toc] | [prev] | [standalone]


Back to top | Article view | linux.debian.bugs.dist


csiph-web