[Python-modules-team] Bug#961741: python3-sphinx: new release broke sphinx-build OUTPUTDIR

[Drew Parsons]

Package: python3-sphinx
Version: 2.4.3-3
Severity: grave
Justification: renders package unusable

The new release 2.4.3-3 appears to have broken sphinx-build. It no
longer recognises the OUTPUTDIR argument.

This causes numba to FTBFS (OUTPUTDIR here is
debian/numba-doc/usr/share/doc/numba-doc/html/):

     dh_install -i -O--buildsystem=pybuild
     debian/rules override_dh_installdocs
  make[1]: Entering directory '/home/projects/python/build/numba'
  dh_installdocs -A README.rst
  dh_installdocs: warning: Cannot auto-detect main package for numba-doc.  If the default is wrong, please use --doc-main-package
  cp -a docs CHANGE_LOG examples .pybuild/cpython3_3.8_numba/build
  http_proxy='127.0.0.1:9' /usr/share/sphinx/scripts/python3/sphinx-build /usr/bin/sphinx-build -N -bhtml \
  		   .pybuild/cpython3_3.8_numba/build/docs/source/ \
  		   debian/numba-doc/usr/share/doc/numba-doc/html/
  usage: sphinx-build [OPTIONS] SOURCEDIR OUTPUTDIR [FILENAMES...]
  sphinx-build: error: cannot find files ['debian/numba-doc/usr/share/doc/numba-doc/html/']
  make[1]: *** [debian/rules:27: override_dh_installdocs] Error 2


numba was building successfully with sphinx 2.4.3-2

Marking severity grave since it means other packages can't use sphinx
(via sphinx-build at least). It should be prevented from migration to
testing if that's the case.


-- System Information:
Debian Release: bullseye/sid
  APT prefers unstable
  APT policy: (500, 'unstable'), (1, 'experimental')
Architecture: amd64 (x86_64)
Foreign Architectures: i386

Kernel: Linux 5.6.0-1-amd64 (SMP w/8 CPU cores)
Kernel taint flags: TAINT_OOT_MODULE, TAINT_UNSIGNED_MODULE
Locale: LANG=en_AU.UTF-8, LC_CTYPE=en_AU.UTF-8 (charmap=UTF-8), LANGUAGE=en_AU:en (charmap=UTF-8)
Shell: /bin/sh linked to /usr/bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled

Versions of packages python3-sphinx depends on:
ii  python3            3.8.2-3
ii  python3-alabaster  0.7.8-1.1
ii  python3-babel      2.8.0+dfsg.1-3
ii  python3-distutils  3.8.3-2
ii  python3-docutils   0.16+dfsg-2
ii  python3-imagesize  1.2.0-2
ii  python3-jinja2     2.11.1-1
ii  python3-packaging  20.3-1.2
ii  python3-pygments   2.3.1+dfsg-3
ii  python3-requests   2.23.0+dfsg-2
ii  sphinx-common      2.4.3-3

Versions of packages python3-sphinx recommends:
ii  make         4.3-1
ii  python3-pil  7.0.0-4+b1

Versions of packages python3-sphinx suggests:
ii  dvipng                     1.15-1.1+b1
ii  fonts-freefont-otf         20120503-10
ii  imagemagick-6.q16          8:6.9.10.23+dfsg-2.1+b2
ii  latexmk                    1:4.69a-0.1
ii  libjs-mathjax              2.7.8+dfsg-1
ii  python3-lib2to3            3.8.3-2
ii  python3-sphinx-rtd-theme   0.4.3+dfsg-3
pn  python3-stemmer            <none>
pn  sphinx-doc                 <none>
ii  texlive-fonts-recommended  2020.20200522-1
ii  texlive-latex-extra        2020.20200522-1
ii  texlive-latex-recommended  2020.20200522-1
ii  texlive-plain-generic      2020.20200522-1

-- no debconf information