[Debian-med-packaging] Bug#963663: nitime: FTBFS with Sphinx 3.1: TypeError: add_directive() takes from 3 to 4 positional arguments but 5 were given

[Lucas Nussbaum]

Source: nitime
Version: 0.8.1-3
Severity: important
Tags: ftbfs
User: python-modules-team at lists.alioth.debian.org
Usertags: sphinx3.1

Hi,

nitime fails to build with Sphinx 3.1, currently available in
experimental.

Relevant part (hopefully):
> make[2]: Entering directory '/<<PKGBUILDDIR>>/doc'
> ../tools/make_examples.py --no-exec
> python3 ../tools/build_modref_templates.py
> WARNING: Empty - nitime
> WARNING: Empty - nitime.algorithms
> WARNING: Empty - nitime.analysis
> WARNING: Empty - nitime.fmri
> WARNING: Empty - nitime.version
> 26 files written
> Build API docs finished.
> sphinx-build -b html -d _build/doctrees   . _build/html
> Running Sphinx v3.1.1
> /<<PKGBUILDDIR>>/doc/conf.py:34: MatplotlibDeprecationWarning: 
> The mpl_toolkits.axes_grid module was deprecated in Matplotlib 2.1 and will be removed two minor releases later. Use mpl_toolkits.axes_grid1 and mpl_toolkits.axisartist, which provide the same functionality instead.
>   __import__(package, fromlist=parts)
> WARNING: while setting up extension ipython_console_highlighting: extension 'ipython_console_highlighting' has no setup() function; is it really a Sphinx extension module?
> 
> Exception occurred:
>   File "/<<PKGBUILDDIR>>/doc/sphinxext/only_directives.py", line 40, in setup
>     app.add_directive('htmlonly', html_only_directive, True, (0, 0, 0))
> TypeError: add_directive() takes from 3 to 4 positional arguments but 5 were given
> The full traceback has been saved in /tmp/sphinx-err-k48qa3n2.log, if you want to report the issue to the developers.
> Please also report this if it was a user error, so that a better error message can be provided next time.
> A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!
> make[2]: *** [Makefile:35: htmlonly] Error 2

The full build log is available from:
   http://qa-logs.debian.net/2020/06/23/nitime_0.8.1-3_unstable_sphinx-exp.log

Please see [1] for Sphinx changelog, which may give a hint of what changes in
Sphinx caused this error.

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

Sphinx 3.1 is going to be uploaded to unstable in a couple of weeks. When that
happens, the severity of this bug will be bumped to serious.

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

[1]: https://www.sphinx-doc.org/en/3.x/changes.html
[2]: https://www.sphinx-doc.org/en/3.x/extdev/deprecated.html

A list of current common problems and possible solutions is available at
http://wiki.debian.org/qa.debian.org/FTBFS . You're welcome to contribute!

About the archive rebuild: The rebuild was done on EC2 VM instances from
Amazon Web Services, using a clean, minimal and up-to-date chroot. Every
failed build was retried once to eliminate random failures.