[debhelper-devel] Bug#886108: debhelper: dh_installdocs -A at compat=11 installs docs in wrong place

[Niels Thykier]

Control: tags -1 moreinfo

On Tue, 02 Jan 2018 12:28:13 +0100 Tomasz Buchert <tomasz at debian.org> wrote:
> Package: debhelper
> Version: 11
> Severity: normal
> 
> Dear Maintainer,
> 
> I wanted to switch nghttp2 to compat=11, but this causes binaries-have-file-
> conflict:
> 
> W: nghttp2 source: binaries-have-file-conflict libnghttp2-dev libnghttp2-doc
> usr/share/doc/libnghttp2-dev/AUTHORS
> W: nghttp2 source: binaries-have-file-conflict libnghttp2-dev libnghttp2-doc
> usr/share/doc/libnghttp2-dev/README.rst.gz
> 
> The conflicting files are installed in /usr/share/doc/libnghttp2-dev, although
> the package is libnghttp2-doc.
> 
> What happens is that "dh_installdocs -A" (which I have in debian/rules) does
> autodetection magic which decides to put the docs of libnghttp2-dev in
> libnghttp2-doc. The culprit is the code in compute_doc_main_package which
> special-cases lib/doc packages, I believe
> 
> This can be worked around by using --doc-main-package, but I think there is
> something wrong happening here.
> 
> 
> 
> [...]

Hi,

It is documented in the compat level changes (man 7 debhelper) that
there is a change in install location and that it is in order to easily
comply with Policy 12.3 (since 3.9.7).

It is certainly unfortunate that the -A option for dh_installdocs (and
dh_installexamples) now trigger a file-conflict by default.  I am all
ears to what a better solution would be with -A and Policy 12.3.

Thanks,
~Niels