Package: dh-make Version: 2.202102 Severity: normal The dh-make template for python packages sets up debian/rules with a special case for docs built using sphinx:
# And uncomment the following lines #override_dh_auto_build: export http_proxy=127.0.0.1:9 #override_dh_auto_build: export https_proxy=127.0.0.1:9 #override_dh_auto_build: # dh_auto_build # PYTHONPATH=. python3 -m sphinx -N -bhtml \ # docs/ build/html # HTML generator # PYTHONPATH=. python3 -m sphinx -N -bman \ # docs/ build/man # Manpage generator If that template is used then it will set up a doc build for every arch build. This is not what we usually want. -doc packages are normally arch:all, so building for all arches is usually wasteful. In some cases it's actually destructive. On some of the more obscure architectures the doc build fails, which makes that arch FTBFS unecessarily. That last problem can be avoided just by setting up the doc build as arch-independent: # And uncomment the following lines #override_dh_auto_build-indep: export http_proxy=127.0.0.1:9 #override_dh_auto_build-indep: export https_proxy=127.0.0.1:9 #override_dh_auto_build-indep: # dh_auto_build # PYTHONPATH=. python3 -m sphinx -N -bhtml \ # docs/ build/html # HTML generator # PYTHONPATH=. python3 -m sphinx -N -bman \ # docs/ build/man # Manpage generator
