[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#1009797: apt: support "nodoc" build profile



Hi,

On Sun, Apr 17, 2022 at 06:50:19PM -0700, Vagrant Cascadian wrote:
> This also allows building functional apt packages with a smaller
> dependency chain, so might help with bootstrapping efforts too!

Bootstrap usually doesn't care about arch:all packages, so that argument
doesn't work that well here. I would even say it works against you:


> I thought docbook* and xsltproc could also be excluded from the
> Build-Depends, but that triggered some other build failures.

They (alongside po4a) are used to build the manpages which we ship in
our arch:any packages (we could go with apt-common, but while that
saves mirror space, it could waste system space as you now have manpages
installed for things you haven't installed… or we go with multiple
apt-common packages which increases complexity and overhead… so far we
haven't gone down this road as it seems not very beneficial in the end).

We certainly could improve support for nodoc (upon your patch) by not
building the manpages in this profile which could indeed help boot-
strapping (although they never asked so far, which I am somewhat
surprised now to be honest) – but it would also end up changing the
contents of every package and hence spoil src:apt reproducibility in
that it will be reproducible on paper, but nobody can actually use the
result.


> Of course, ideally building documentation reproducibly would be very
> nice as well, so it would be good to eventually fix the underlying
> issues in doxygen:
> 
>   https://tests.reproducible-builds.org/debian/issues/unstable/nondeterminstic_todo_identifiers_in_documentation_generated_by_doxygen_issue.html
>   https://tests.reproducible-builds.org/debian/issues/unstable/nondeterministic_ordering_in_documentation_generated_by_doxygen_issue.html

It seems like hard issue(s) to solve and I am certainly not up to work
on this, but there seem not too many effected, so perhaps its worthwhile
to go the route of a nodoxygen (or pkg.*.nodoxygen) profile instead as
it would mean less variation and e.g. a reproducible binary apt package
would at least mean something as everyone has that variant installed.

I would at least be happy to beat our build system into omitting just
the doxygen part rather than some (currently with patch) or all
(possible future) docs. Shouldn't be hard (= famous last words).


Best regards

David Kalnischkies

Attachment: signature.asc
Description: PGP signature


Reply to: