[Pkg-ganeti-devel] Bug#789394: ganeti: FTBFS with Sphinx 1.3: fatal warnings

[Dmitry Shachnev]

Source: ganeti
Version: 2.12.4-1
User: python-modules-team at lists.alioth.debian.org
Usertags: sphinx1.3

ganeti FTBFS with Sphinx 1.3 (which is available in experimental):

  /bin/mkdir -p $dir && \
  PYTHONPATH=. ENABLE_MANPAGES= COPY_DOC=1 \
  ./autotools/run-in-tempdir autotools/sphinx-wrapper /usr/bin/sphinx-build -q -W -b html \
      -d . \
      -D version="2.12" \
      -D release="2.12.3" \
      -D graphviz_dot="/usr/bin/dot" \
      -D enable_manpages="" \
      doc /tmp/buildd/ganeti-2.12.3/$dir && \
  rm -f $dir/.buildinfo $dir/objects.inv

  Warning, treated as error:
  WARNING: invalid number u'' for config value 'enable_manpages', ignoring

  Makefile:4108: recipe for target 'doc/html/index.html' failed

There are two issues here:

1) conf.py defines enable_manpages boolean variable based on ENABLE_MANPAGES
   environment variable anyway, so you should not pass it via -D option (where
   it is either "" or "1", so wrong type).
   That line should be removed from configure.ac.

2) After fixing that, Sphinx will complain about default theme being
   deprecated with 1.3 (it has been renamed to classic). You should either
   use classic for 1.3, or let Sphinx decide about the theme itself by
   commenting out html_theme line in doc/conf.py.

Alternatively (I do not recommend doing that), if you remove -W option from
sphinx-build arguments, sphinx will treat warnings as non-fatal, and the build
will succeed.

--
Dmitry Shachnev
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 819 bytes
Desc: OpenPGP digital signature
URL: <http://lists.alioth.debian.org/pipermail/pkg-ganeti-devel/attachments/20150620/8f2855cc/attachment.sig>