Bug#975941: add exception case to package-contains-documentation-outside-usr-share-doc if docs are linked to /usr/share/doc?
Package: lintian
Version: 2.102.0~bpo10+1
Severity: normal
Hi,
The case is software that provides, for example, html docs, and that
opens these docs using the standard F1 (file bar help) interface.
Such docs should of course also be present in /usr/share/doc. As I
see it, the question is whether the files should actually exist in
their upstream location--which in Debian translates to
/usr/share/foo/bar and have these docs linked to /usr/share/doc, or
whether they should be moved to /usr/share/doc and be linked back to
where the software expects them. Option three is maintaining a patch
for a Debian-specific location, but I don't think that's the right solution.
So, should Lintian not warn about
package-contains-documentation-outside-usr-share-doc if the package links the assets to /usr/share/doc, or should the Lintian information output recommend the inverse case (moving the docs to /usr/share/doc and linking them back to where the software expects them)?
I leave it to you :-)
Cheers,
Nicholas
-- System Information:
Debian Release: 10.6
APT prefers stable-debug
APT policy: (500, 'stable-debug'), (500, 'proposed-updates-debug'), (500, 'proposed-updates'), (500, 'stable')
Architecture: amd64 (x86_64)
Foreign Architectures: i386
Kernel: Linux 5.4.74-mainline-soft-realtime (SMP w/4 CPU cores; PREEMPT)
Kernel taint flags: TAINT_UNSIGNED_MODULE
Locale: LANG=en_CA.UTF-8, LC_CTYPE=en_CA.UTF-8 (charmap=UTF-8), LANGUAGE=en_CA:en (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled
Versions of packages lintian depends on:
ii binutils 2.31.1-16
ii bzip2 1.0.6-9.2~deb10u1
ii diffstat 1.62-1
ii dpkg 1.19.7
ii dpkg-dev 1.19.7
ii file 1:5.35-4+deb10u1
ii gettext 0.19.8.1-9
ii gpg 2.2.20-1~bpo10+1
ii intltool-debian 0.35.0+20060710.5
ii libapt-pkg-perl 0.1.34+b1
ii libarchive-zip-perl 1.64-1
ii libcapture-tiny-perl 0.48-1
ii libclass-xsaccessor-perl 1.19-3+b2
ii libclone-perl 0.41-1+b1
ii libconfig-tiny-perl 2.23-1
ii libcpanel-json-xs-perl 4.09-1
ii libdata-dpath-perl 0.57-2
ii libdata-validate-domain-perl 0.10-1
ii libdevel-size-perl 0.82-1+b1
ii libdpkg-perl 1.19.7
ii libemail-address-xs-perl 1.04-1+b1
ii libfile-basedir-perl 0.08-1
ii libfile-find-rule-perl 0.34-1
ii libfont-ttf-perl 1.06-1
ii libhtml-html5-entities-perl 0.004-1
ii libipc-run3-perl 0.048-1
ii libjson-maybexs-perl 1.004000-1
ii liblist-compare-perl 0.53-1
ii liblist-moreutils-perl 0.416-1+b4
ii liblist-utilsby-perl 0.11-1
ii libmoo-perl 2.003004-2
ii libmoox-aliases-perl 0.001006-1
ii libnamespace-clean-perl 0.27-1
ii libpath-tiny-perl 0.108-1
ii libperlio-gzip-perl 0.19-1+b5
ii libproc-processtable-perl 0.56-1
ii libsereal-decoder-perl 4.005+ds-1+b1
ii libsereal-encoder-perl 4.005+ds-1+b1
ii libtext-glob-perl 0.10-1
ii libtext-levenshteinxs-perl 0.03-4+b6
ii libtext-markdown-discount-perl 0.11-3+b1
ii libtext-xslate-perl 3.5.6-1+b1
ii libtime-duration-perl 1.20-1
ii libtime-moment-perl 0.44-1+b1
ii libtimedate-perl 2.3000-2+deb10u1
ii libtry-tiny-perl 0.30-1
ii libtype-tiny-perl 1.004004-1
ii libunicode-utf8-perl 0.62-1
ii liburi-perl 1.76-1
ii libxml-libxml-perl 2.0134+dfsg-1
ii libyaml-libyaml-perl 0.76+repack-1
ii lzip 1.21-3
ii lzop 1.03-4+b1
ii man-db 2.8.5-2
ii patchutils 0.3.4-2
ii perl [libdigest-sha-perl] 5.28.1-6+deb10u1
ii t1utils 1.41-3
ii unzip 6.0-23+deb10u1
ii xz-utils 5.2.4-1
lintian recommends no packages.
Versions of packages lintian suggests:
pn binutils-multiarch <none>
ii libtext-template-perl 1.55-1
-- no debconf information
Reply to: