Bug#1013384: petsc4py: FTBFS with Sphinx 5.0, docutils 0.18: make[1]: *** [debian/rules:77: override_dh_sphinxdoc-indep] Error 255

[Lucas Nussbaum]

Source: petsc4py
Version: 3.16.6-1
Severity: important
Tags: ftbfs
User: mitya57 at debian.org
Usertags: sphinx5.0

Hi,

petsc4py fails to build with Sphinx 5.0 and docutils 0.18, both of which
are currently available in experimental.

Relevant part (hopefully):
> make[1]: Entering directory '/<<PKGBUILDDIR>>'
> dh_installdocs -i
> dh_installdocs: warning: Cannot auto-detect main package for python-petsc4py-doc.  If the default is wrong, please use --doc-main-package
> rm debian/python-petsc4py-doc/usr/share/doc/python-petsc4py-doc/usrman/_static/jquery*.js
> ln -sf /usr/share/javascript/jquery/jquery.js debian/python-petsc4py-doc/usr/share/doc/python-petsc4py-doc/usrman/_static/jquery.js
> rm debian/python-petsc4py-doc/usr/share/doc/python-petsc4py-doc/usrman/_static/underscore*.js
> ln -sf /usr/share/javascript/underscore/underscore.js debian/python-petsc4py-doc/usr/share/doc/python-petsc4py-doc/usrman/_static/underscore.js
> make[1]: Leaving directory '/<<PKGBUILDDIR>>'
>    dh_installdocs -O--buildsystem=pybuild -Npython3-petsc4py -Npython3-petsc4py-real -Npython3-petsc4py-complex -Npython3-petsc4py-64-real -Npython3-petsc4py-64-complex -Npython-petsc4py-doc
>    debian/rules override_dh_sphinxdoc-indep
> make[1]: Entering directory '/<<PKGBUILDDIR>>'
> dh_sphinxdoc -i --exclude=searchtools.js --exclude=doctools.js
> unexpected end of string while parsing JSON string, at character offset 2 (before "ocnames:["citing","i...") at /usr/bin/dh_sphinxdoc line 245.
> make[1]: *** [debian/rules:77: override_dh_sphinxdoc-indep] Error 255


The full build log is available from:
http://qa-logs.debian.net/2022/06/23/petsc4py_3.16.6-1_unstable_sphinx-exp.log

Please see [1] for Sphinx changelog and [2] for Docutils changelog.

Also see [3] for the list of deprecated/removed APIs in Sphinx and possible
alternatives to them.

In case you have questions, please Cc sphinx at packages.debian.org on reply.

[1]: https://www.sphinx-doc.org/en/master/changes.html
[2]: https://repo.or.cz/docutils.git/blob/refs/tags/docutils-0.18.1:/RELEASE-NOTES.txt
[3]: https://www.sphinx-doc.org/en/master/extdev/deprecated.html#dev-deprecated-apis

All bugs filed during this archive rebuild are listed at:
https://bugs.debian.org/cgi-bin/pkgreport.cgi?tag=sphinx5.0;users=mitya57@debian.org
or:
https://udd.debian.org/bugs/?release=na&merged=ign&fnewerval=7&flastmodval=7&fusertag=only&fusertagtag=sphinx5.0&fusertaguser=mitya57@debian.org&allbugs=1&cseverity=1&ctags=1&caffected=1#results

If you reassign this bug to another package, please marking it as 'affects'-ing
this package. See https://www.debian.org/Bugs/server-control#affects