#1150257 pillow: please define a nodoc build profile in order to trim the key package set

#1150257#5
Date:
2026-10-07 17:41:12 UTC
From:
To:
Hi Matthias,

I've been working for a while on reducing the key package set.
https://release.debian.org/key-packages.html


Pillow is a key package which is perfectly fine;
I'm a long-time happy user of this package myself.


Please consider the patch hereunder to avoid transitively
making Sphinx & Sphinx extensions key packages too.


Please note: python3-sphinx-rtd-theme was dropped altogheter
             as it it nowadays replaced by "furo".


Greetings

Alexandre
--- ../control  2026-10-07 19:30:30.011189892 +0200
+++ debian/control      2026-10-07 19:32:01.928069220 +0200
@@ -18,11 +18,14 @@
   libtiff5-dev | libtiff-dev, libwebp-dev, libraqm-dev,
   libimagequant-dev,
   libopenjp2-7-dev,
-Build-Depends-Indep: python3-doc,
-  python3-sphinx, python3-sphinx-rtd-theme,
-  python3-sphinx-issues, python3-sphinx-copybutton,
-  python3-sphinx-inline-tabs, python3-sphinxext-opengraph,
-  furo,
+Build-Depends-Indep:
+  furo <!nodoc>,
+  python3-doc <!nodoc>,
+  python3-sphinx <!nodoc>,
+  python3-sphinx-copybutton <!nodoc>,
+  python3-sphinx-inline-tabs <!nodoc>,
+  python3-sphinx-issues <!nodoc>,
+  python3-sphinxext-opengraph <!nodoc>,
 Rules-Requires-Root: binary-targets
 Standards-Version: 4.7.4
 Homepage: http://python-pillow.github.io/
--- ../rules    2026-10-07 19:32:36.043919822 +0200
+++ debian/rules        2026-10-07 19:34:06.112826460 +0200
@@ -28,7 +28,9 @@
        : # FIXME: do not ignore warnings ...
 #      -PYTHONPATH=$(CURDIR)/src:$(CURDIR)/$(lastword $(wildcard build/lib.*)) $(MAKE) -C docs html
        (cd src; tar cf - PIL) | (cd $(lastword $(wildcard build/lib.*)); tar xf -)
+ifeq (,$(filter nodoc,$(DEB_BUILD_PROFILES)))
        -PYTHONPATH=$(CURDIR)/$(lastword $(wildcard build/lib.*)) $(MAKE) -C docs html
+endif
        touch $@

 build-stamp: $(PY3VERS:%=build-stamp-python%) $(PY3VERS:%=check-stamp-python%)
@@ -134,7 +136,9 @@
        dh_testroot -i
        dh_installdocs -i
        dh_installdocs -ppython-pil-doc docs/_build/html
+ifeq (,$(filter nodoc,$(DEB_BUILD_PROFILES)))
        dh_sphinxdoc -ppython-pil-doc
+endif
        dh_installexamples -i
        dh_installchangelogs -i CHANGES.rst
        dh_python3 -i