[Python-modules-team] Bug#833791: dh_sphinxdoc: Fails to recognise Sphinx-generated documentation

Ben Finney ben+debian at benfinney.id.au
Mon Aug 8 16:47:23 UTC 2016


Package: sphinx-common
Version: 1.4.5-1
Severity: normal

The ‘dh_sphinxdoc’ command is failing to detect Sphinx-generated
documentation:

=====
$ ls -l doc/_build/html
total 368
drwxr-xr-x 2 pbuilder pbuilder  4096 Aug  8 16:16 _sources
drwxr-xr-x 5 pbuilder pbuilder  4096 Aug  8 16:16 _static
-rw-r--r-- 1 pbuilder pbuilder  8076 Aug  8 16:16 api.html
-rw-r--r-- 1 pbuilder pbuilder  7163 Aug  8 16:16 api_coverage.html
-rw-r--r-- 1 pbuilder pbuilder  6671 Aug  8 16:16 api_coveragedata.html
-rw-r--r-- 1 pbuilder pbuilder  7569 Aug  8 16:16 api_plugin.html
-rw-r--r-- 1 pbuilder pbuilder 13918 Aug  8 16:16 branch.html
-rw-r--r-- 1 pbuilder pbuilder 83255 Aug  8 16:16 changes.html
-rw-r--r-- 1 pbuilder pbuilder 34429 Aug  8 16:16 cmd.html
-rw-r--r-- 1 pbuilder pbuilder 23177 Aug  8 16:16 config.html
-rw-r--r-- 1 pbuilder pbuilder 16080 Aug  8 16:16 contributing.html
-rw-r--r-- 1 pbuilder pbuilder 13477 Aug  8 16:16 excluding.html
-rw-r--r-- 1 pbuilder pbuilder 11381 Aug  8 16:16 faq.html
-rw-r--r-- 1 pbuilder pbuilder 10705 Aug  8 16:16 howitworks.html
-rw-r--r-- 1 pbuilder pbuilder 12620 Aug  8 16:16 index.html
-rw-r--r-- 1 pbuilder pbuilder 10426 Aug  8 16:16 install.html
-rw-r--r-- 1 pbuilder pbuilder  1264 Aug  8 16:16 objects.inv
-rw-r--r-- 1 pbuilder pbuilder 10223 Aug  8 16:16 plugins.html
-rw-r--r-- 1 pbuilder pbuilder  5619 Aug  8 16:16 search.html
-rw-r--r-- 1 pbuilder pbuilder 18782 Aug  8 16:16 searchindex.js
-rw-r--r-- 1 pbuilder pbuilder 12502 Aug  8 16:16 source.html
-rw-r--r-- 1 pbuilder pbuilder 11360 Aug  8 16:16 subprocess.html
-rw-r--r-- 1 pbuilder pbuilder 10219 Aug  8 16:16 trouble.html

$ dh_sphinxdoc doc/_build/html
dh_sphinxdoc: Sphinx documentation not found at doc/_build/html/
=====

My (Perl-illiterate) reading of the ‘/usr/bin/dh_sphinxdoc’ source
leads me to infer that the “found Sphinx documentation” check should
be satisfied by the presence of both the ‘searchindex.js’ and
‘search.html’ files. So I don't understand the failure, above.


-- System Information:
Debian Release: stretch/sid
  APT prefers testing
  APT policy: (500, 'testing')
Architecture: amd64 (x86_64)

Kernel: Linux 4.6.0-1-amd64 (SMP w/8 CPU cores)
Locale: LANG=en_AU.UTF-8, LC_CTYPE=en_AU.UTF-8 (charmap=UTF-8) (ignored: LC_ALL set to en_AU.UTF-8)
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)

Versions of packages sphinx-common depends on:
ii  libjs-sphinxdoc  1.4.5-1

Versions of packages sphinx-common recommends:
ii  python-sphinx  1.4.5-1

sphinx-common suggests no packages.

-- no debconf information

-- 
 \     “Some mornings, it's just not worth chewing through the leather |
  `\                                             straps.” —Emo Philips |
_o__)                                                                  |
Ben Finney <ben at benfinney.id.au>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 819 bytes
Desc: not available
URL: <http://lists.alioth.debian.org/pipermail/python-modules-team/attachments/20160809/deb30c96/attachment.sig>


More information about the Python-modules-team mailing list