[Python-modules-team] Bug#876048: Incorrect return status in sphinx-build

[Russ Allbery]

Package: python3-sphinx
Version: 1.6.3-2
Severity: normal

sphinx-build is not exiting with a non-zero status when building PDF
documentation fails.  This makes it harder to find build errors.

mithrandir:~/dvl/debian/policy$ sphinx-build -M latexpdf policy policy/_build
Running Sphinx v1.6.3
loading pickled environment... done
building [mo]: targets for 0 po files that are out of date
building [latex]: all documents
updating environment: 0 added, 0 changed, 0 removed
looking for now-outdated files... none found
processing policy.tex...index ch-scope ch-archive ch-binary ch-source ch-controlfields ch-maintainerscripts ch-relationships ch-sharedlibs ch-opersys ch-files ch-customized-programs ch-docs ap-pkg-scope ap-pkg-binarypkg ap-pkg-sourcepkg ap-pkg-controlfields ap-pkg-conffiles ap-pkg-alternatives ap-pkg-diversions ap-process ap-flowcharts upgrading-checklist ap-license 
resolving references...
writing... done
copying images... [100%] images/debian-policy-upgrade.png                       
copying TeX support files...
done
build succeeded.
latexmk -pdf -dvi- -ps-  'policy.tex'
make: latexmk: Command not found
Makefile:33: recipe for target 'policy.pdf' failed
make: *** [policy.pdf] Error 127
mithrandir:~/dvl/debian/policy$ echo $?
0

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

Kernel: Linux 4.12.0-1-amd64 (SMP w/4 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8), LANGUAGE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)

Versions of packages python3-sphinx depends on:
ii  python3            3.5.3-3
ii  python3-alabaster  0.7.8-1
ii  python3-babel      2.4.0+dfsg.1-2
ii  python3-docutils   0.13.1+dfsg-2
ii  python3-imagesize  0.7.1-1
ii  python3-jinja2     2.9.6-1
ii  python3-pygments   2.2.0+dfsg-1
ii  python3-requests   2.18.1-1
ii  python3-six        1.10.0-4
ii  sphinx-common      1.6.3-2

Versions of packages python3-sphinx recommends:
pn  python3-pil  <none>

Versions of packages python3-sphinx suggests:
pn  dvipng                     <none>
ii  imagemagick-6.q16          8:6.9.7.4+dfsg-16
pn  latexmk                    <none>
pn  libjs-mathjax              <none>
pn  python3-sphinx-rtd-theme   <none>
pn  sphinx-doc                 <none>
ii  texlive-fonts-recommended  2017.20170818-1
pn  texlive-generic-extra      <none>
ii  texlive-latex-extra        2017.20170818-1
ii  texlive-latex-recommended  2017.20170818-1

-- no debconf information