* Sandro Tosi <mo...@debian.org>, 2012-01-22, 01:34:
Right, it's only a warning about translations.js.

In theory we _could_ move translations to the libjs-* package and then symlink them too, but this is probably too much hassle for very little benefit.

if translates.js is the same for all the projects using sphinx then it probably makes sense to symlink it,

I believe that this is the case, yes.
but it's also true that there's only one occurrence of translate.js in all debian packages, so probably we can also wait and see how the situation evolves.

Right, that's why I was reluctant to do this. Also, translations take a good amount of space:

$ du -sh /usr/share/javascript/{jquery,underscore,sphinxdoc} 
/usr/share/sphinx/locale
356K    /usr/share/javascript/jquery
52K     /usr/share/javascript/underscore
76K     /usr/share/javascript/sphinxdoc
220K    /usr/share/sphinx/locale

Well, maybe the way to go is to declare that dh_sphinxdoc doesn't support translated documentation (neither translations.js nor searchtools.js), possibly improve error messages, and then clone&reassign the bug to virtualenvwrapper?

That'd mean that if we ever had to update Sphinx's javascript code e.g. because new version of jQuery broke it, we'd have to rebuild virtualenvwrapper, but that's not a big deal, since it's team-maintained (especially when you compare it to number of package that doesn't use dh_sphinxdoc at all...).

But it we decide that not symlinking translations.js is by design, then we should also silence the warning.

that too, or differentiate the warning and error messages (that are now the same, which could be a bit misleading).

Right. I fixed this in svn. Now it's:

$ dh_sphinxdoc
dh_sphinxdoc: ignoring unknown JavaScript code: 
debian/virtualenvwrapper/usr/share/doc/virtualenvwrapper/ja/html/_static/translations.js
dh_sphinxdoc: error: unknown JavaScript code: 
debian/virtualenvwrapper/usr/share/doc/virtualenvwrapper/ja/html/_static/searchtools.js

--
Jakub Wilk



--
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org

Reply via email to