[Debian-astro-maintainers] Bug#1042600: imexam: FTBFS with Sphinx 7.1, docutils 0.20: make[1]: *** [debian/rules:14: override_dh_installdocs-indep] Error 25

[Lucas Nussbaum]

Source: imexam
Version: 0.9.1-4
Severity: important
Tags: ftbfs
User: python-modules-team at lists.alioth.debian.org
Usertags: sphinx7.1

Hi,

imexam fails to build with Sphinx 7.1 and docutils 0.20, both of which
are currently available in experimental.

Relevant part (hopefully):
> make[1]: Entering directory '/<<PKGBUILDDIR>>'
> python3 setup.py build_sphinx
> /usr/lib/python3/dist-packages/pythran/tables.py:4530: FutureWarning: In the future `np.bool` will be defined as the corresponding NumPy scalar.
>   if not hasattr(numpy, method):
> /usr/lib/python3/dist-packages/pythran/tables.py:4563: FutureWarning: In the future `np.bytes` will be defined as the corresponding NumPy scalar.
>   obj = getattr(themodule, elem)
> Sphinx is not installed, can't build documents!!
> 
> Cython found
> /usr/lib/python3/dist-packages/setuptools/dist.py:745: SetuptoolsDeprecationWarning: Invalid dash-separated options
> !!
> 
>         ********************************************************************************
>         Usage of dash-separated 'description-file' will not be supported in future
>         versions. Please use the underscore name 'description_file' instead.
> 
>         By 2023-Sep-26, you need to update your project and remove deprecated calls
>         or your builds will no longer be supported.
> 
>         See https://setuptools.pypa.io/en/latest/userguide/declarative_config.html for details.
>         ********************************************************************************
> 
> !!
>   opt = self.warn_dash_deprecation(opt, section)
> /usr/lib/python3/dist-packages/setuptools/dist.py:745: SetuptoolsDeprecationWarning: Invalid dash-separated options
> !!
> 
>         ********************************************************************************
>         Usage of dash-separated 'upload-dir' will not be supported in future
>         versions. Please use the underscore name 'upload_dir' instead.
> 
>         By 2023-Sep-26, you need to update your project and remove deprecated calls
>         or your builds will no longer be supported.
> 
>         See https://setuptools.pypa.io/en/latest/userguide/declarative_config.html for details.
>         ********************************************************************************
> 
> !!
>   opt = self.warn_dash_deprecation(opt, section)
> /usr/lib/python3/dist-packages/setuptools/dist.py:745: SetuptoolsDeprecationWarning: Invalid dash-separated options
> !!
> 
>         ********************************************************************************
>         Usage of dash-separated 'show-response' will not be supported in future
>         versions. Please use the underscore name 'show_response' instead.
> 
>         By 2023-Sep-26, you need to update your project and remove deprecated calls
>         or your builds will no longer be supported.
> 
>         See https://setuptools.pypa.io/en/latest/userguide/declarative_config.html for details.
>         ********************************************************************************
> 
> !!
>   opt = self.warn_dash_deprecation(opt, section)
> /usr/lib/python3/dist-packages/setuptools/__init__.py:84: _DeprecatedInstaller: setuptools.installer and fetch_build_eggs are deprecated.
> !!
> 
>         ********************************************************************************
>         Requirements should be satisfied by a PEP 517 installer.
>         If you are using pip, you can try `pip install --use-pep517`.
>         ********************************************************************************
> 
> !!
>   dist.fetch_build_eggs(dist.setup_requires)
> WARNING: The wheel package is not available.
> /usr/lib/python3/dist-packages/setuptools/dist.py:945: DistDeprecationWarning: use_2to3 is ignored.
>   ep.load()(self, ep.name, value)
> running build_sphinx
> error: error in setup.cfg: command 'BuildSphinx' has no such option 'source_dir'
> make[1]: [debian/rules:13: override_dh_installdocs-indep] Error 1 (ignored)
> dh_installdocs
> dh_installdocs: error: Cannot find (any matches for) "docs/_build/html" (tried in ., debian/tmp)
> 
> make[1]: *** [debian/rules:14: override_dh_installdocs-indep] Error 25


The full build log is available from:
http://qa-logs.debian.net/2023/07/30/exp/imexam_0.9.1-4_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.

Some notable changes in Sphinx 6 and Sphinx 7:

- Sphinx no longer includes jquery.js and underscore.js by default.
  Please use python3-sphinxcontrib.jquery package if you are using a custom
  template and it still needs jquery.

- The setup.py build_sphinx command was removed. Please instead call
  sphinx-build or "python3 -m sphinx" directly.

- For packages using the extlinks extension, the caption should contain
  exactly one "%s" placeholder (if caption is not None).

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.20.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=sphinx7.1;users=python-modules-team@lists.alioth.debian.org
or:
https://udd.debian.org/bugs/?release=na&merged=ign&fnewerval=7&flastmodval=7&fusertag=only&fusertagtag=sphinx7.1&fusertaguser=python-modules-team@lists.alioth.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