Control: reassign -1 sphinx-common, developers-reference On 23/05/26 10:59 pm, Holger Levsen wrote: > package: lintian, sphinx-common, developers-reference > tags: help > > hi, > > when running lintian on the developers-reference binary packages > I get: > > W: developers-reference-de: embedded-javascript-library please use sphinx > [usr/share/developers-reference/de/_static/language_data.js] > W: developers-reference-fr: embedded-javascript-library please use sphinx > [usr/share/developers-reference/fr/_static/language_data.js] > W: developers-reference-it: embedded-javascript-library please use sphinx > [usr/share/developers-reference/it/_static/language_data.js] > W: developers-reference-ja: embedded-javascript-library please use sphinx > [usr/share/developers-reference/ja/_static/language_data.js] > W: developers-reference-ru: embedded-javascript-library please use sphinx > [usr/share/developers-reference/ru/_static/language_data.js] > > while dev-ref uses "dh $@ --with sphinxdoc" and this also works in general, > which eg can be seen in the binary package developers-reference which ships > /usr/share/developers-reference/_static/language_data.js as a link to > /usr/share/javascript/sphinxdoc/1.0/language_data.js > > As you might guess from me assigning this bug to three packages I'm not > really sure where the bugs are: > > 1.) I think lintian is buggy because it doesn't detect that all those > developers-reference-$lang packages already use sphinx. So the advice > "please use sphinx" is clearly wrong.
Lintian checks if the file in the question is either a regular file or a hardlink; it will skip symlinks. In this case, your assertion that this is link is wrong. I unpacked developers-reference-de and see: $ ls -la ./usr/share/developers-reference/de/_static/language_data.js -rw-r--r-- 1 nilesh nilesh 10911 May 19 16:53 ./usr/share/developers-reference/de/_static/language_data.js This appears as a regular file to me, and lintian would detect this as a embedded copy without using symlinks to sphinx javascript files. So there is something wrong with the shipped files. As another data point, libuv1-doc package (recently uploaded a new revision) also ships these files[1] (/usr/share/doc/libuv1/html/_static/language_data.js) but it does not emit those lintian warnings[2] This file correctly ships as a symlink $ dpkg -c libuv1-doc_1.51.0-2_all.deb | grep language_data lrwxrwxrwx root/root 0 2025-08-24 21:18 ./usr/share/doc/libuv1/html/_static/language_data.js -> ../../../../javascript/sphinxdoc/1.0/language_data.js Even developers-reference binary package gets this right $ dpkg -c developers-reference_14.9_all.deb | grep language_data lrwxrwxrwx root/root 0 2026-05-19 16:53 ./usr/share/developers-reference/_static/language_data.js -> ../../javascript/sphinxdoc/1.0/language_data.js That means sphinxdoc is doing its job for developers-reference, but there is something problematic in rest of the binary packages. I don't think there's anything for lintian to do here, hence re-assigning. Hope that's okay. [1] https://packages.debian.org/sid/all/libuv1-doc/filelist [2] https://udd.debian.org/lintian/?packages=libuv1-doc Best, Nilesh
