Package not building on Debian Jessie due to Sphinx problems

[Jürgen Hermann]

No time to investigate right now, but putting the problem on record…

$ lsb_release -ds
Debian GNU/Linux 8.10 (jessie)
$ dpkg-buildpackage -us -uc -b
…
   dh_install
   debian/rules override_dh_installdocs
make[1]: Entering directory '…/src/dh-virtualenv'
python setup.py build_sphinx
running build_sphinx
creating …/src/dh-virtualenv/doc/_build
creating …/src/dh-virtualenv/doc/_build/doctrees
creating …/src/dh-virtualenv/doc/_build/html
Running Sphinx v1.5.5
loading pickled environment... not yet created
building [mo]: all of 0 po files
building [html]: all source files
updating environment: 5 added, 0 changed, 0 removed
reading sources... [100%] usage
…/src/dh-virtualenv/doc/usage.rst:66: WARNING: Inline literal start-string without end-string.
looking for now-outdated files... none found
pickling environment... done
checking consistency... …/src/dh-virtualenv/doc/dh_virtualenv.1.rst:: WARNING: document isn't included in any toctree
done
preparing documents... done
…/src/dh-virtualenv/doc/tutorial.rst:126: WARNING: Pygments lexer name u'\xabpkgname\xbb.triggers' is not known
writing output... [100%] usage
…/src/dh-virtualenv/doc/info.rst:131: WARNING: unknown option: -i
…/src/dh-virtualenv/doc/info.rst:131: WARNING: unknown option: -a
…/src/dh-virtualenv/doc/info.rst:132: WARNING: unknown option: -D
…/src/dh-virtualenv/doc/usage.rst:346: WARNING: unknown option: --no-site-packages
generating indices... genindex
writing additional pages... search
copying static files... WARNING: html_static_path entry u'…/src/dh-virtualenv/doc/_static' does not exist
done
copying extra files... done
dumping search index in English (code: en) ... done
dumping object inventory... done
build succeeded, 8 warnings.
dh_installdocs doc/_build/html
make[1]: Leaving directory '…/src/dh-virtualenv'
   dh_sphinxdoc
dh_sphinxdoc: debian/dh-virtualenv/usr/share/doc/dh-virtualenv/html/dh_virtualenv.1.rst.html is missing
debian/rules:4: recipe for target 'binary' failed

Removing --with-sphinxdoc and the override_dh_installdocs rule is the quickfix. The file

/usr/share/doc/dh-virtualenv/html/dh_virtualenv.1.html

does exist (and makes more sense than .rst.html).

And BTW, a version bump after a release reduces accidents due to confused / misinformed humans…

diff --git a/debian/changelog b/debian/changelog
index f545b16..52bd37e 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,3 +1,9 @@
+dh-virtualenv (1.1-1~~dev1) unstable; urgency=medium
+
+  * Non-maintainer upload.
+
+ -- Juergen Hermann <[e-mail]>  Wed, 20 Jun 2018 10:22:32 +0000
+
 dh-virtualenv (1.0-1) unstable; urgency=medium
 
   * New upstream release
diff --git a/setup.py b/setup.py
index 9eed067..3dc8837 100755
--- a/setup.py
+++ b/setup.py
@@ -25,7 +25,7 @@ from setuptools import setup
 
 project = dict(
     name='dh_virtualenv',
-    version='1.0',
+    version='1.1.dev1',
     author=u'Jyrki Pulliainen',
     author_email='[e-mail]',
     url='https://github.com/spotify/dh-virtualenv',

[Jyrki Pulliainen]

Good point with the version bump!

Looks like this is connected to the man page somehow. Interesting that this does not happen on sid builds

[Jürgen Hermann]

Older Sphinx version (see the warnings it spews out), or some detail changes in dh_sphinxdoc, …

PS: the "~~dev1" (doube ~) is intentional, and makes sure a release trumps this at any time.

[Jürgen Hermann]

#237 might fix this.