Bug#975941: add exception case to package-contains-documentation-outside-usr-share-doc if docs are linked to /usr/share/doc?
Nicholas D Steeves <nsteeves@gmail.com> writes:
> 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)?
If the files are used at runtime, Policy requires installing the files
outside of /usr/share/doc and linking them to /usr/share/doc. See Policy
12.3, second-to-last paragraph.
--
Russ Allbery (rra@debian.org) <https://www.eyrie.org/~eagle/>
Reply to: