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

[Dmitry Shachnev]

On Thu, Jun 23, 2022 at 08:43:40AM +0200, Lucas Nussbaum wrote:
> 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

This happens because petsc4py does not rebuild documentation from source,
but installs pre-built files provided by upstream.

dh_sphinxdoc only supports the current Sphinx version, not the old version
used by upstream. I recommend to rebuild the documentation from source.

If you do this you also won't need to symlink JS files and also won't need
to pass --exclude options.

--
Dmitry Shachnev
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: not available
URL: <http://alioth-lists.debian.net/pipermail/debian-science-maintainers/attachments/20221203/68be8f09/attachment.sig>