On Sun, Jul 17, 2016 at 09:48:00AM +0000, Niels Thykier wrote: > Neil Williams: > > On Sat, 16 Jul 2016 23:04:51 +0300 > > Shachar Shemesh <shac...@debian.org> wrote: > > > >> Another question I have is regarding packaging. The Policy suggests > >> that libargtable2-doc should install the docs > >> to /usr/share/doc/libargtable2. It seems that debhelper is not a > >> friend in that regard, pushing me to install > >> to /usr/share/doc/libargtable2-doc. Am I missing some option that > >> would make that easy? > > > > debhelper is doing the right thing. /usr/share/doc/libargtable2-doc/ is > > correct as the package name is foo-doc (it's not the source package > > name, it's the binary package name). > > > > Actually, 3.9.7 ratified that the documentation should go into the > "main" package.
Quoting https://www.debian.org/doc/debian-policy/upgrading-checklist.html#s-3.9.7.0 | 12.3 | | recommend to ship additional documentation for package pkg in a | separate package pkg-doc and install it into /usr/share/doc/pkg. FWIW I agree with both '"main package "should have documentation' and 'additional documentation in separate doc package'. > Accordingly, debhelper is /not/ doing as the Policy > mandates. I have added that in compat 11, as it will require changing > packages (e.g. doc-base files). Groeten Geert Stappers -- Leven en laten leven
