Re: Policy 12.3: should I rename?
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 <shachar@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
Reply to: