[Python-modules-team] Bug#712426: /usr/bin/dh_sphinxdoc: dh_sphinxdoc: fails with "unknown JavaScript code"

[Jakub Wilk]

* Nikolaus Rath <Nikolaus at rath.org>, 2013-06-15, 14:26:
>For the s3ql-beta package (not yet uploaded),

(And it build-depends on packages not in the archive, so I can't 
test-build it myself...)

>dh_sphinxdoc fails with:
>
>   dh_installdocs
>      dh_sphinxdoc
>      dh_sphinxdoc: error: unknown JavaScript code:
>      debian/s3ql-beta/usr/share/doc/s3ql-beta/html/_static/jquery.js
>      make: *** [binary] Error 255
>
>I think this may be related to the documentation being generated with 
>python3-sphinx (rather than python-sphinx).

I don't think this should make any difference.

What does

head -n1 debian/s3ql-beta/usr/share/doc/s3ql-beta/html/_static/jquery.js

say?

>On a related note, if dh_sphinxdoc cannot identify a JavaScript code, 
>wouldn't it be more appropriate to just include it in the package 
>instead of bailing out?

Maybe the error message is not very clear. What it was meant to say, is 
that it found a .js with a filename indicating it should be symlinked, 
but with unexpected contents. So no, in such situation dh_sphinxdoc 
should not continue; that'd defeat its purpose. (And there's always -X 
for the cases when maintainer know what he's doing and really doesn't 
want dh_sphinxdoc to touch a file.)

-- 
Jakub Wilk